Request Body Parameters

application/json

Common Request Parameters

bizContent

• merchantTransactionIdString(64)Required

  The original transaction serial number of the merchant's website
• merchantCaptureIdString(64)Required

  The pre-authorization capture serial number of the merchant's website, globally unique
• amountString(14)Required

  Transaction amount, retaining two decimal places, for example 10.12. For some transaction currencies like JPY and KRW, where the smallest unit is the yuan, it also requires two decimal places to be submitted, for example 29.00
• currencyString(3)Required

  Transaction currency, a three-letter ISO 4217 code. For specific supported currencies, see the attached transaction currency list
• notificationUrlString(255)Optional

  A custom address set by the merchant for notifying the transaction result. Once this parameter is filled, PingPongCheckout will asynchronously push the transaction result to this address via POST.
  URL recommendation: use a complete URL with a publicly reachable domain name. Standard web ports are recommended (HTTPS defaults to 443 and HTTP defaults to 80). Ensure the URL can reliably receive PingPongCheckout asynchronous notifications.

请求报文示例

{
  "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

Common Response Parameters

bizContent

• transactionIdString(64)Required

  Original transaction serial number of PingPong
• merchantTransactionIdString(64)Required

  Original transaction serial number on the merchant's website
• merchantCaptureIdString(64)Required

  Merchant website pre-authorization capture serial number, globally unique
• currencyString(3)Required

  Transaction currency
• amountString(14)Required

  Transaction amount
• captureTimeString(32)Required

  Capture initiation time, timestamp
• captureEndingTimeString(32)Optional

  Time when capture reaches final state, timestamp
• statusString(32)Required

  1. SUCCESS - Success
  2. FAILED - Failure
  3. PROCESSING - In progress

请求报文示例

{
  "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"
}

Previous pageS2S Order and Payment

Next pagePre-Authorization Void