Request Body Parameters

application/json

Common Request Parameters

bizContent

• customerObjectOptional
• goodsArrayOptional
• requestIdString(64)Required

  Unique request number, globally unique
• requestTimeString(13)Required

  Merchant-side request time. Timestamp, in milliseconds
• captureDelayHoursintConditional

  • 0 indicates immediate capture
  • -1 indicates manual capture, after successfully calling the order creation API, you also need to call the pre-authorization capture, not supported for local payments
• deviceSnString(64)Required

  Device serial number, used to specify the target POS machine for payment
• deviceModelString(64)Required

  Device model, used to specify the target POS machine for payment
• merchantTransactionIdString(64)Required

  Order number on the merchant's website, a unique identifier for the order, can be used for subsequent order inquiries and reconciliation
• amountString(12)Required

  Transaction amount, the precision depends on the currency, please refer to the appendix Transaction Currencies
• currencyString(3)Required

  Transaction currency, ISO 4217 three-letter code, specific supported currencies see appendix Transaction Currencies
• cashierDeviceIdStringRequired

  Unique ID of the cash register device
• shopperIpString(128)Required

  User IP address for placing an order, supports IPv4 format
• paymentMethodString(64)Required

  Specified payment method, optional values:

  • Card Purchase - Card swipe payment
  • QR-POSScan - B scan C payment
  • QR Payment - C scan B payment
  • Octopus - Octopus card payment (Hong Kong)
• timeExpireString(10)Required

  Order expiration time. 1 minute to 3 days (if less than 1 minute, it defaults to 1 minute; if more than 3 days, it defaults to 3 days). If not provided, it defaults to 3 days. Timestamp format, unit: seconds, example value: 1683530496
• tradeCountryString(2)Required

  Used to specify the transaction country ISO A2 code (ISO 3166-1 alpha-2 standard), defaults to countries supported by PingPong, two-letter codes see appendix Country Codes
• notificationUrlString(255)Optional

  Custom notification URL for this transaction result by the merchant.
  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.
• remarkString(255）Optional

  Merchant extended fields, can be used to specify certain parameters, will be returned as is in the response body

请求报文示例

{
  "accId": "2018092520455210043243",
  "bizContent": {
    "requestId": "REQ-15ZSIRMPKT1748591387687",
    "requestTime": "1748591387687",
    "timeExpire": "1748591687",
    "captureDelayHours": "0",
    "deviceSn": "NEC300067041",
    "deviceModel": "N950S",
    "amount": "121.23",
    "currency": "MYR",
    "paymentMethod": "QR Payment",
    "cashierDeviceId": "111",
    "shopperIp": "47.98.1.1",
    "merchantTransactionId": "PMT-15ZSIRMPKT1748591387687",
    "tradeCountry": "MY",
    "notificationUrl": "https://test-acquirerpay.pingpongx.com/qa/result.html",
    "remark": "payment test"
  },
  "clientId": "2018092520455210043",
  "sign": "C578137C7009700927502B1EAFB425893980832DDFC02434AD957FD364D9DE9D",
  "signType": "SHA256",
  "version": "1.0"
}

Responses Body Parameters

application/json

Common Response Parameters

bizContent

• transactionIdString(64)Required

  PingPong transaction number
• merchantTransactionIdString(64)Required

  Merchant website transaction number
• qrCodeStringOptional

  QR code encoding. Used for QR code payment scenarios, this code can be converted into a QR code image for display
• qrUrlStringOptional

  QR code address. Used for QR code payment scenarios, to display the QR code
• qrCodeExpiredString(10)Optional

  QR code expiration time, in timestamp format, unit: seconds
• remarkString(255)Optional

  Merchant extended field

响应报文示例

{
  "accId": "2018092520455210043243",
  "bizContent": {
    "qrCodeExpired": "1748591687",
    "qrCode": "00020201021226580014A000000615000101065016640226100101570045614O01BDLA00015204539953034585406121.235802MY5925PINGPONG PAYMENT MALAYSIA6002MY62630120OS2025053001100002010311O01BDLA00010620OS20250530011000020182648305FDCB588DA5B1EDC5588660398CF3D8D3036F54F99A8B1710D4B04DBE5B066304FB33",
    "merchantTransactionId": "PMT-15ZSIRMPKT1748591387687",
    "remark": "payment test",
    "transactionId": "OS202505300010000201"
  },
  "clientId": "2018092520455210043",
  "code": "002000",
  "description": "Transaction processing"
}

Next pageRefund Application