International Money Transfer System is a comprehensive international money transfer system designed to facilitate fast, secure, and efficient cross-border transactions between persons and businesses.
Transfer Types:
On-Demand Transfers For scenarios where the sender does not specify a particular receiving agent (bank or financial institution) at the time of transfer initiation. Instead, the transfer is made available "on-demand" across all authorized agents within the recipient's country. This model provides maximum convenience and flexibility for recipients.Use Case: Ideal for situations where the recipient may not have a designated bank account or prefers to collect the funds at their convenience from a wide network of agents (e.g., exchange offices, cash desks, retail points).Phone-Based Transfers For scenarios where the sender wants to direct funds to a specific receiving agent. This approach is often required when the sender has prior knowledge of the recipient’s bank or financial institution and wants to ensure funds are delivered to that particular entity.Use Case: Ideal for transfers where the recipient prefers to receive funds directly into their bank account, card, or when the sender specifies a particular agent for payout (e.g., corporate clients, payroll disbursements, direct-to-account payments).
To work with the IMTS API, a partner service needs credentials (Login and Password). These can be obtained by contacting the product support team via email: support@freedompay.kz.
Your email should include:
Service Name
Platforms (e.g., web, iOS, Android)
Contact Information of responsible personnel
Example Email
Subject: Request for Service Integration with IMTS API
Dear IMTS Support Team,
My name is [Your Name], representing the platform [Your Company Name]. We aim to integrate our service with the IMTS API for unified user authorization.
Service Name: [Your Service Name]
Platforms: [Platform List]
Contact Details:
- Name: [Responsible Person's Name]
- Position: [Position]
- Email: [Email Address]
- Phone: [Phone Number]
The request signature (pg_sig) is a cryptographic hash generated to ensure the integrity and authenticity of the request. It helps verify that the request data was not tampered with during transmission and that it was genuinely created by an authorized partner.
amount_from=100.50 currency_code_from=USD order_id=ORD123456 pg_salt=random_string receiver_country=KZ transfer_purpose=Family support transfer_type=send2. Concatenate values using semicolons100.50;USD;ORD123456;KZ;Family support;send3. Add the secret key (agent_secret)100.50;USD;ORD123456;KZ;Family support;send;agent_secret4. Generating the Signature Apply HMAC-SHA256:hmac_sha256("100.50;USD;ORD123456;KZ;Family support;send;agent_secret")5. Example of the generated hash:5a1d5f17e4c1f5a3b44c3f29b5e2d77cd11b1b5fefc3dcb5b1c2f8e73f9c22a1
To ensure the security of personal data transferred between IMTS and its partners, all personal data must be encrypted. This process uses symmetric encryption with a predefined partner_key.partner_key - generated during the initial integration with IMTS and issued by the IMTS manager to the AgentEncryption requirements
Encryption Method: Symmetric Data Encryption
Algorithm: AES (Advanced Encryption Standard)
Key Length: 256 bits
Encryption Key: partner_key (Provided by IMTS during integration)
Mode of Operation: AES-256-CBC (Cipher Block Chaining)
nitialization Vector (IV): Randomly generated for each encryption operation (recommended size: 16 bytes)
For the IMTS service to be able to send a callback, the Partner (agent) must send a URL to IMTS, which the IMTS service will contact to send notifications.
Universal notification service:
IMTS sends notifications to the Partner (agent) URL about a change in the status of a transfer or the receipt of a transfer by phone number, IBAN or PAN (in the future, the list of available notifications may be enriched).
