Internal Transfer
Testing
POST
https://ws2-payments.datmanpay.com/antar/api/v1/transfers
Merchant-to-Merchant Transfer API
It is designed to support operational adjustments, reconciliation corrections, and manual settlements between accounts with full auditability.
Purpose
It is intended for use by financial operations or automated backend systems to correct balances, handle partial adjustments, and realign internal accounts without impacting end customers.
Note:
This API is not intended for end-user refunds or customer-initiated payments.
Use it only for merchant-level adjustments and platform-controlled operations.
Key Features
Every transfer is uniquely identified for audit and reconciliation purposes.
Transfers include descriptions and clearly specify both the source and destination merchants.
Supports both manual execution (via admin portals) and automated financial workflows.
All transactions are designed to be easily traceable with clear documentation for compliance and reporting.
Common Use Cases
| Scenario | Description |
|---|---|
| Balance adjustments | Correcting merchant account balances after internal reconciliation. |
| Partial refunds between merchants | Adjusting commission overpayments or re-allocating revenue shares. |
| Manual settlements | Reallocating funds between merchants for operational or business reasons. |
| Correction of split transfer errors | Resolving misallocations of previously processed transfers. |
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://ws2-payments.datmanpay.com/antar/api/v1/transfers' \
--header 'api_token: ' \
--header 'Content-Type: application/json' \
--data-raw '{
"amount": 123,
"currency": "USD",
"description": "SetupFee",
"merchant_reference": "XYZ1234573",
"source_merchant_id": 63155480,
"destination_merchant_id": 663192390
}'Response Response Example
202 - Success
{
"transfer_id": "TRFKXQMYA8MVYKW",
"amount": 120,
"currency": "GBP",
"description": "split-transfer-refund-907993",
"refrence": "528698590",
"source_merchant_id": 663208112,
"destination_merchant_id": 663208112,
"status": "accepted",
"reason": "Transfer accepted",
"created_at": "2025-03-25T12:34:56Z"
}Request
Header Params
api_token
stringÂ
required
Example:
{{API_KEY}}
Content-Type
stringÂ
required
Example:
application/json
Body Params application/json