Payment Callback
Callback URL
method | url |
---|---|
POST | Merchant provided callback URL |
Headers
Header Parameter | Description |
---|---|
timestamp | Request timestamp |
nonce | Random value |
country | Country CO |
appCode | Application ID |
Payin Callback
Parameter | Type | Required | Length | Description |
---|---|---|---|---|
merchantOrderNo | String | yes | 32 | Merchant’s order number |
tradeNo | String | yes | Platform’s order number | |
paymentOrderNo | String | yes | 30 | Platform’s unique payment transaction number for this collection |
status | Int | yes | Status code (2: Success) | |
paymentAmount | String | yes | Actual payment amount for this transaction | |
serviceAmount | String | yes | Service fee, e.g., 18.02 | |
paymentInfo | String | yes | Primary payment information, i.e., actual information used for the payment | |
paymentType | Int | yes | Payment method | |
completeTime | String | yes | Completion time of the transaction (local time zone), format: yyyy-MM-dd HH:mm:ss | |
errorMessage | String | no | Error message if the transaction failed | |
sign | String | yes | Signature |
{
"merchantOrderNo": "OrderNoExample", "tradeNo": "TS2501010001CO0000000000000000", "paymentOrderNo": "TSOPaymentOrderNoExample", "status": 2, "paymentAmount": "1000.00", "serviceAmount": "10.00", "paymentInfo": "https://www.paymentLinkExample.com", "paymentType": 204, "completeTime": "2025-01-01 00:00:00", "errorMessage": null, "sign": "TEEMO_SIGN"
}
Callback Response
Field | Type | Required | Description |
---|---|---|---|
SUCCESS | String | yes | Must return "SUCCESS" or the callback will be retried |
{ SUCCESS
}