API Explanation

Request Type

POST

Request URI

/api/v1/pay/alipay/inapp-pay

Request

Parameter	Type	Required	Description	Remark
userId	String	Yes	Alipay users ID
amount	String	Yes	Transaction Amount	cent is the unit, “100” means a dollar
callbackURL	String	Yes	Callback URL	Send notifications to this URL when an order is complete (Maximum length 255 English characters)
returnUrl	String	Yes	After the payment succeeds, Alipay redirects to this returnUrl
saleNumber	String	No
remark	String	No	Remark	Maximum length with 128 English characters

Request Example：

{
  "userId": "2088222545687337",
  "amount": "1000",
  "callbackURL": "https://your.callback.url",
  "returnUrl": "https://your.return.url",
  "saleNumber": "01",
  "remark": "this is remark"
}

Response

Parameter	Type	Description
payInfo	String	Alipay redirect link. Merchants can use this link as a deep link to open the Alipay app
amount	String	Transaction Amount
paymentId	String	Payment Id

Response Example：

{
    "status": "SUCCESS",
    "result": {
        "payInfo": "alipayconnect://platformapi/acwallet/alipayconnectcode?code=golcashier1954bb35-0cc7-4463-90d1-dc17a236451dsandbox&golSandbox=true&pspName=ALIPAY_CN",
        "amount": "10.00",
        "paymentId": "1677689674209894"
    }
}

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.