API Explanation

Request Type

POST

Request URI

/api/v1/pay/unionpay/inapp-secure-pay

Request

Parameter Type Required Description Remark
amount String Yes Transaction Amount cent is the unit, “100” means a dollar
callbackURL String Yes Callback URL After the payment is completed, the system sends a notification to this URL (Maximum length 255 English characters)
remark String No Remark (Maximum length 128 English characters)

Request Example:

{
  "amount": "1000",
  "callbackURL": "https://your.callback.url",
  "remark": ""
}

Response

Parameter Type Description Remark
paymentId String Payment ID
encoding String
merchantId String Merchant ID
tn String UnionPay Payment Parameters Use for UnionPay APP payment
amount String Transaction Amount cent is the unit, “100” means a dollar

Response Example:

{
  "status": "SUCCESS",
  "result": {
    "paymentId": "1677703284112112",
    "encoding": "UTF-8",
    "merchantId": "ON00000185",
    "tn": "441834876151254735000",
    "amount": "1000"
  }
}

Payment Result

After the OTT Pay API server obtains the payment result from the payment channel, it will immediately send the payment result to the specified callbackURL. Of course, the merchant system can also actively query through Payment Status Query API.