Request Body Parameters

application/json

Common Request Parameters

bizContent

• subOrderListArrayOptional
• merchantTransactionIdString(64)Required

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

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

  Transaction amount, retain two decimal places, for example 10.12, for some transaction currencies such as JPY, KRW where the smallest unit is the yuan, also require two decimal places to be sent, for example 29.00
• currencyString(3)Required

  Transaction currency, ISO 4217 three-letter code, see the attached list of supported transaction currencies for details
• 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

  PingPong original transaction serial number
• merchantTransactionIdString(64)Required

  Merchant website's original transaction serial number
• merchantCaptureIdString(64)Required

  Merchant website's 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

  Capture final state arrival time, 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 pagePlace Order and Pay

Next pagePre-Authorization Void