POST

📍How to choose a site? See API Endpoint Guide

Request Body Parameters

application/json

Common Request Parameters

bizContent

• subOrderListArrayOptional

  List of sub-order information

  • subMerchantIdString(64)Required

    Sub-merchant number on the merchant platform
  • subMerchantTransactionIdString(64)Required

    Sub-merchant order number, a unique identifier for the sub-order
  • amountString(12)Required

    Sub-order amount
  • currencyString(3)Required

    Currency of the sub-order amount, which must be consistent with the original transaction amount currency
• 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.

Request Body Example

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

Request Body Example

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