4.4. Callback

1. Payment Callback

1.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.

1.2. Request Info

• Method: post

• Path: The callBackUrl parameter when the Payment

1.2.1 Request Header

Key	Value
Content-Type	application/json

1.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

1.3. Example Data

1.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
}

1.3.2 Response（Merchant's response）

{
    "transResult": "SUCCESS"
}

2. Refund Callback

2.1. Overview

Uses callBackUrl to send the refund result to the merchant when the refund processing reaches a final state of success or failure. Merchants promote merchant-side transactions based on the refund 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.2. Request Info

• Method: post

• Path: The callBackUrl parameter when the Refund

2.2.1 Request Header

Key	Value
Content-Type	application/json

2.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
refundOrderAmt	Payment amount	string
currency	Payment currency, LAK/USD	string
newpayOrderNo	Newpay order number	string
newpayRefundOrderNo	Newpay refund order number	string
orderNo	Order number	string
refundOrderNo	Order number	string
tranStatus	Payment result: 1-success; 0-failure	int
transInfo	The reason for failure	string
timestamp	Callback execution time	string
sign	Data signature	string

2.3. Example Data

2.3.1 Request (Request Merchant)

{
    "orderNo":"202209067002502223",
    "refundOrderNo":"202209067002502232",
    "transInfo":"Transaction Success",
    "transStatus":0,
    "sign":"RUgPFHojyrvmGpIGxzdzHG6BlxDn9Ei...",
    "refundOrderAmt":"123.00",
    "newpayOrderNo":"202209210000006950",
    "newpayRefundOrderNo":"202209210000006950",
    "payMethod":1,
    "appId":6,
    "currency":"LAK",
    "transStatus":0,
    "timestamp":1663738614280
}

2.3.2 Response（Merchant's response）

{
    "transResult": "SUCCESS"
}