Skip to content

Payout Webhook

WARNING

This endpoint is provided by the merchant. The platform calls it when a payout succeeds or fails. When receiving a server-to-server notification, respond with HTTP 200; otherwise the platform retries up to 5 times. Respond within 3 seconds; slower responses are treated as callback failures.

Best practices

  1. Treat payment as successful when status==200 && orderStatus="SUCCESS"
  2. Refund: status==200 && orderStatus="REFUND" (often from bank risk returns). A success callback is usually sent earlier
  3. If your business handling fails, respond with HTTP 400 or 500 (non-200)
  4. The platform may send duplicate status callbacks; if already processed, still return HTTP 200
  5. Always verify callback IP and signature
  6. Keep callback response time as short as possible

Sandbox callback IP

13.214.67.82

Endpoint

POST /callback_url

Request Parameters

FieldTypeRequiredDescription
statusintegerYesStatus — 200 success
msgstringYesMessage
memberIdstringYesMerchant ID
mchOrderNostringYesMerchant order number
platOrderNostringYesPlatform order number
orderStatusstringYesOrder status
amountnumberYesCredited amount
feenumberYesFee
signstringYesSignature
timeEndintegerYesCompletion timestamp — Unix timestamp in seconds
utrstringNoUTR (India only)

Request Example

json
{
 "status": 200,
 "memberId": "16001",
 "mchOrderNo": "20220721144249483",
 "platOrderNo": "3KITxA1dEXhZ2IRXvwck",
 "orderStatus": "SUCCESS",
 "amount": 10000,
 "fee": 100,
 "timeEnd": 1658387041,
 "sign": "VJ0pQTRvHI7Tlc8TVodYOlDZzyxcDIJumD5pit+/eFcGYInT9ynePuyGXAqnoqrxeEvNbtN++DYd5J2oG16CIQU8qX9XFMj4o+DNPuUzNdaF06HhlkUxwPTTeSWCDOuw2XPtMRY0u8T/KA2PbzrX2lr4I6siICZaDHeocjO9PI0=",
 "msg": "success"
}

Transafe Developer Documentation