Payment Callback
Merchant system should implement API to receive callback from PTS. The PTS will send request to the callback_url
given in transaction request.
CAUTION
Please make sure the callback_url
you provided in payment request are valid and allow domain name of PTS to pass your firewall. Or it might cause transactions unsynchronizable.
Request (from PTS)
Content-Type: application/json
Param | Type | Required | Sign | Description |
---|---|---|---|---|
user_id | String | ✅ | ✅ | Merchant identification |
order_id | String | ✅ | ✅ | Payment order id of merchant system. The order id should be unique. |
transaction_id | String | ✅ | ✅ | PTS transaction id |
channel | String | ✅ | ✅ | Please refer to Currencies & Channels |
submit_currency | String | ✅ | ✅ | Submit currency |
submit_amount | Float | ✅ | ✅ | Submit amount (Support up to 6 decimal places) |
accept_currency | String | ✅ | ✅ | The currency real paid |
accept_amount | Float | ✅ | ✅ | Paid amount of accept currency (Support up to 6 decimal places) |
exchange_rate | Float | ✅ | ✅ | Exchange rate |
status | String | ✅ | ✅ | 0000 = Waiting 1000 = Processing 2000 = Success 3000 = Failed 4000 = Order error |
timestamp | Integer | ✅ | ✅ | Transaction last update timestamp (10 digits) |
submit_promo | Float | ❌ | ❌ | Submit amount promo(Support up to 6 decimal places) |
accept_promo | Float | ❌ | ❌ | Paid amount promo of accept currency (Support up to 6 decimal places) |
payment_address | String | ❌ | ❌ | Crypto exclusive, if need, please inform customer service staff |
receiving_address | String | ❌ | ❌ | Crypto exclusive, if need, please inform customer service staff |
sign | String | ✅ | ❌ | Signature string |
Response
Please return the string SUCCESS when callback is received. If there is anything wrong, please return the string FAILED.