预授权请款
Request Body Parameters
application/json公共请求参数
bizContent
subOrderListArray可选merchantTransactionIdString(64)必填商户网站的原交易流水号merchantCaptureIdString(64)必填商户网站预授权请款流水号,全局唯一amountString(14)必填交易金额,小数点后保留两位,例如 10.12,部分交易币种如 JPY、KRW 其最小单位为元,也要求上送两位小数,例如 29.00currencyString(3)必填交易币种,ISO 4217 三位币种,具体支持币种见附件交易币种表notificationUrlString(255)可选由商户自定义本次交易结果通知的地址,一旦填写该参数,PingPongCheckout 将通过 POST 方式异步推送交易结果到该地址。
地址建议:请填写基于公网域名的完整 URL,推荐使用标准 Web 端口(HTTPS 默认 443,HTTP 默认 80),并确保该地址可稳定接收 PingPongCheckout 的异步通知。
Request Body Example
{
"accId": "2023042011040310224447",
"bizContent": {
"merchantCaptureId": "PMT-2S7RR3K4LQ1715047351210",
"merchantTransactionId": "PMT-2S7RR3K4LQ1715047351210",
"amount": "100",
"currency": "USD",
"notificationUrl": "https://test-acquirerpay.pingpongx.com/qa/notify"
},
"clientId": "2023042011040310224",
"sign": "4DCA0F0F91CDBB45DC0D40350CF428215C76CA29B282AEBBAA76CC09751E0ED1",
"signType": "SHA256",
"version": "1.0"
}Responses Body Parameters
application/json公共返回参数
bizContent
transactionIdString(64)必填PingPong原交易流水号merchantTransactionIdString(64)必填商户网站的原交易流水号merchantCaptureIdString(64)必填商户网站预授权请款流水号,全局唯一currencyString(3)必填交易币种amountString(14)必填交易金额captureTimeString(32)必填capture发起时间,时间戳captureEndingTimeString(32)可选capture到达终态时间,时间戳statusString(32)必填- SUCCESS-成功
- FAILED-失败
- PROCESSING-进行中
Request Body Example
{
"accId": "2023042011040310224447",
"bizContent": {
"amount": "100.000000",
"merchantCaptureId": "PMT-2S7RR3K4LQ1715047351210",
"captureTime": "1715047466000",
"transactionId": "2024050750046460",
"captureEndingTime": "1715047468242",
"merchantTransactionId": "PMT-2S7RR3K4LQ1715047351210",
"currency": "USD",
"status": "SUCCESS"
},
"clientId": "2023042011040310224",
"code": "000000",
"description": "Transaction succeeded",
"sign": "5033C47D3A1CF3E19A4B0EE0E566CE723D67E8BA236B828829BDE586CA999D2A",
"signType": "SHA256"
}