Payment Callback
1.Overview
Uses callBackUrl to send the payment result to the merchant when the payment processing reaches a final state of success or failure. Merchants promote merchant-side transactions based on the payment result.
Note: If the merchant response is { "transResult": "SUCCESS" } , the callback notification will stop. If not,the callback notification will be performed every 5 minute,After 3 retries, the callback notification will be stopped.
2.Request Info
Method: post
Path: The callBackUrl parameter when the Payment
2.1 Request Header
Key | Value |
---|---|
Content-Type | application/json |
2.2 Request Data
Name | Description | Type |
---|---|---|
appId | Unique identifier assigned to a third-party application platform | string |
payMethod | Payment method: 1.NewPay; 4.MasterCard; | int |
orderAmt | Payment amount | string |
currency | Payment currency, LAK/USD | string |
newpayOrderNo | Newpay order number | string |
orderNo | Order number | string |
subject | Commodity title | string |
transStatus | Payment result: 0-success; 1-failure | int |
transInfo | The reason for failure | string |
settlementStatus | Settlement status: 1-no settlement; 2-have already settled | int |
timestamp | Callback execution time | string |
extra | Third party order supplementary fields | string |
sign | Data signature | string |
3. Example Data
3.1 Request (Request Merchant)
{
"orderNo":"202209067002502223",
"subject":"1",
"transInfo":"Transaction Success",
"sign":"RUgPFHojyrvmGpIGxzdzHG6BlxDn9Ei...",
"orderAmt":"123.00",
"newpayOrderNo":"202209210000006950",
"settlementStatus":1,
"payMethod":1,
"extra":"",
"appId":6,
"currency":"LAK",
"transStatus":0,
"timestamp":1663738614280
}
3.2 Response(Merchant's response)
{
"transResult": "SUCCESS"
}