Case Studies

Integration cases

Integration with «Соседи»

Ensure seamless integration of CartaMe mobile app users with the existing «Kupilka» loyalty program of the «Sosedi» retail chain, so that CartaMe users can automatically become full-fledged program participants and start earning rewards. The partner (the «Sosedi» chain) already had the «Kupilka» loyalty program running on the «SuperMag Loya» accounting system. The task was to ensure automatic participation of CartaMe mobile app users (unified Loyalty ID) in this program without double registration and without loss of accrual history. The data structure of «SuperMag Loya» was studied: the format of card storage, transactions, and points accrual rules. Entry points for the external API were identified. Changes were made to the module for receiving external requests in Loymax so that it correctly accepts and recognizes the CartaMe Loyalty ID as a valid member number of «Kupilka». Two-way token-based authentication and encryption of sensitive data (personal IDs, balance) during API exchange

Development stages

1
Review of the client's software and architecture
6 hrs
Conducted a comprehensive audit of the IT landscape of the «Sosedi» chain: accounting system, POS software, server equipment and network interaction between stores. Analyzed the current business processes of the loyalty program.
2
Analysis of data structure and integration points
11 hrs
Detailed analysis of the data structure of the «Sosedi» accounting system: counterparty directories, bonus accumulation registers, receipt and transaction storage formats. Identified optimal integration points to minimize interference with the existing software. Identified the need to refine the directories to support Loyalty ID. Result — a data exchange scheme with no conflict with existing processes.
3
Modification of the client's software to support CartaMe Loyalty ID
14 hrs
Made targeted changes to the «Sosedi» software: added fields for storing Loyalty ID in the counterparty directory, modified the POS module for participant identification, and configured background tasks for synchronization.
4
Development of API exchanges between servers
20 hrs
Created high-performance API bridges between the «Sosedi» servers and the CartaMe mobile app. Implemented: participant registration, bonus balance transfer, purchase history synchronization, and checkout transaction processing.
5
Configuration of secure exchange of personal data and bonus transactions
8 hrs
Implemented comprehensive protection of data exchange channels between the «Sosedi» and CartaMe systems: TLS 1.3 encryption, signing of each request, role-based access model, encryption of sensitive fields in the database, and complete logging of all personal data operations.
6
Implementation of protection mechanisms against spam, phishing and invalid requests
16 hrs
Configured a multi-level protection system for the «Sosedi» API: rate limiting by IP and by user, validation of incoming requests against allowlists, referrer and User-Agent verification, and anti-bot mechanisms.
7
Increasing fault tolerance under high loads
10 hrs
Conducted performance optimization for peak loads of the «Sosedi» chain (rush hours in convenience stores, pre-holiday days, mass promotions). Implemented: horizontal scaling of API servers, caching, message queuing, load balancing, automatic recovery from failures, and database replication.
8
Testing and launch of integration
2 hrs
Organized comprehensive testing with the participation of «Sosedi» chain employees
Connected product
What the client got:
• A CartaMe user logs into the app, after which their Loyalty ID is automatically used as the participant identifier for the «Kupilka» program.
• Purchase, accrual and redemption transactions are processed through a unified API gateway with data delivery control.
• Risks of desynchronization between systems were minimized through the use of queues, retries and data exchange control mechanisms.
Team
4
Total hours
87
Days
11
Technologies:
Kotlin Kotlin
Rest API Rest API
Swift Swift
Python Python
Project team:
Andrei
CEO
Victor
СТО
Andrei
Developer
Marina
Project manager
Head of Department
1
Chief Technology Officer
1
Developer
1
Project manager
1
Back to cases list