申请退款
Request Body Parameters
application/json公共请求参数
bizContent
customerObject按条件选subOrderListArray可选merchantTransactionIdString(64)必填商户网站订单号merchantRefundIdString(64)必填商户的退款交易流水号，全局唯一。amountString(14)必填退款交易金额，最小单位查询 附件交易币种表currencyString(3)必填交易币种，ISO 4217 三位币种，具体支持币种见 附件交易币种表accountNumberString（32）按条件选退款账户号，特殊支付方式必传，具体见特殊支付方式退款说明channelCodeString(32)按条件选银行code，特殊支付方式退款必传，具体见特殊支付方式退款说明phoneString(20)按条件选手机号，特殊支付方式退款必传，具体见特殊支付方式退款说明identificationIdString(32)按条件选证件号，特殊支付方式退款必传，具体见特殊支付方式退款说明emailString(32)按条件选邮箱，特殊支付方式退款必传，具体见特殊支付方式退款说明notificationUrlString(255)可选由商户自定义本次交易结果通知的地址，一旦填写该参数，PingPongCheckout 将通过 POST 方式异步推送交易结果到该地址。
地址建议：请填写基于公网域名的完整 URL，推荐使用标准 Web 端口（HTTPS 默认 443，HTTP 默认 80），并确保该地址可稳定接收 PingPongCheckout 的异步通知。remarkString(32)按条件选商户扩展字段
Request Body Example
{
"accId": "2023042011040310224447",
"bizContent": {
"amount": 100,
"currency": "USD",
"merchantTransactionId": "PMT-2S7RR3K4LQ1715047351210",
"notificationUrl": "https://test-acquirerpay.pingpongx.com/qa/result.html",
"merchantRefundId": "PMT-4DNTI3AWXR1715049316146"
},
"clientId": "2023042011040310224",
"sign": "7F271F64F5ADDF225D76A8F3EADFD5E4F6E71716635D2F18DD51DB6D8CD50E78",
"signType": "SHA256",
"version": "1.0"
}Responses Body Parameters
application/json公共返回参数
bizContent
transactionIdString(64)必填PingPong 原交易流水号merchantTransactionIdString(64)必填商户网站的原交易流水号merchantRefundIdString(64)必填商户网站的退款交易流水号refundIdString(64)必填PingPong退款交易流水号currencyString(3)必填交易币种amountString(14)必填交易金额refundTimeString(32)必填退款发起时间，时间戳refundEndingTimeString(32)可选退款到达终态时间，时间戳statusString(32)必填- SUCCESS-成功
- FAILED-失败
- PROCESSING-进行中
remarkString(32)按条件选商户拓展字段
Request Body Example
{
"accId": "2023042011040310224447",
"bizContent": {
"amount": "100.000000",
"refundTime": "1715049319280",
"transactionId": "2024050750046460",
"merchantTransactionId": "PMT-2S7RR3K4LQ1715047351210",
"currency": "USD",
"merchantRefundId": "PMT-4DNTI3AWXR1715049316146",
"refundId": "2024050750046461",
"status": "SUCCESS"
},
"clientId": "2023042011040310224",
"code": "000000",
"description": "Transaction succeeded",
"sign": "9475FF30D4DF1A3FD9696EBFBAC72729A7E6140D4E39490097C7F06BDD69020C",
"signType": "SHA256"
}