Request Body Parameters

application/json

公共请求参数

bizContent

• merchantTransactionIdString(64)必填

  商户网站的原交易流水号
• notificationUrlString(255)必填

  异步通知地址。
  地址建议：请填写基于公网域名的完整 URL，推荐使用标准 Web 端口（HTTPS 默认 443，HTTP 默认 80），并确保该地址可稳定接收 PingPongCheckout 的异步通知。
• merchantVoidIdString(64)必填

  商户网站预授权撤销流水号，全局唯一
• amountString(14)必填

  交易金额，小数点后保留两位，如 10.12，部分交 易币种如 JPY、KRW 其最小单位为元，也要求上送两位小数，如 29.00
• currencyString(3)必填

  交易币种，ISO 4217 三位币种，具体支持币种⻅附件交易币种表

请求报文示例

{
  "accId": "2023042011040310224447",
  "bizContent": {
    "merchantVoidId": "PMT-RM319TQYEJ1715049483296",
    "merchantTransactionId": "PMT-RM319TQYEJ1715049483296",
    "amount": "100",
    "currency": "USD",
    "notificationUrl": "https://test-acquirerpay.pingpongx.com/qa/notify"
  },
  "clientId": "2023042011040310224",
  "sign": "334BB275659C85577A889EDCE1693972BA1744B24F8C12A8A5E37EE557B66DD0",
  "signType": "SHA256",
  "version": "1.0"
}

Responses Body Parameters

application/json

公共返回参数

bizContent

• transactionIdString(64)必填

  PingPong原交易流水号
• merchantTransactionIdString(64)必填

  商户网站的原交易流水号
• merchantVoidIdString(64)必填

  商户网站的void交易流水号
• descriptionString必填

  结果描述
• currencyString(3)必填

  交易币种
• amountString(14)必填

  交易金额
• voidTimeString(32)必填

  void发起时间，时间戳
• voidEndingTimeString(32)可选

  void到达终态时间，时间戳
• statusString(32)必填

  状态

  1. SUCCESS-成功
  2. FAILED-失败
  3. PROCESSING-进行中

请求报文示例

{
  "accId": "2023042011040310224447",
  "bizContent": {
    "amount": "100.000000",
    "merchantVoidId": "PMT-RM319TQYEJ1715049483296",
    "transactionId": "2024050750046462",
    "voidEndingTime": "1715049613278",
    "voidTime": "1715049612000",
    "merchantTransactionId": "PMT-RM319TQYEJ1715049483296",
    "currency": "USD",
    "status": "SUCCESS"
  },
  "clientId": "2023042011040310224",
  "code": "000000",
  "description": "Transaction succeeded",
  "sign": "0474235D375F8A81E9FD17E278ED3F11039F8462F64650A1F0D613FADAE5B04F",
  "signType": "SHA256"
}

上一页预授权请款

下一页申请退款