Request Body Parameters

application/json

Common Request Parameters

bizContent

• merchantTransactionIdString(64)Required

  Original transaction ID from the merchant's website
• notificationUrlString(255)Required

  Asynchronous notification address.
  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.
• merchantVoidIdString(64)Required

  Merchant's pre-authorization void transaction ID, globally unique
• amountString(14)Required

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

  Transaction currency, ISO 4217 three-letter code. For specific supported currencies, see the attached Transaction Currencies table

请求报文示例

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

Common Response Parameters

bizContent

• transactionIdString(64)Required

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

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

  Void transaction serial number of the merchant's website
• descriptionStringRequired

  Result description
• currencyString(3)Required

  Transaction currency
• amountString(14)Required

  Transaction amount
• voidTimeString(32)Required

  Void initiation time, timestamp
• voidEndingTimeString(32)Optional

  Void final state arrival time, timestamp
• statusString(32)Required

  Status

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

请求报文示例

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

Previous pagePre-Authorization Capture

Next pageRefund Application