POST

📍How to choose a site? See API Endpoint Guide

Request Body Parameters

application/json

Common Request Parameters

bizContent

• requestIdString(64)Required

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

  Merchant-side request time. Timestamp, to the millisecond
• transactionIdString(64)Required

  PingPong transaction ID, at least one of this or merchantTransactionId must be provided
• merchantTransactionIdString(64)Required

  Merchant website transaction ID, at least one of this or transactionId must be provided

请求报文示例

{
  "accId": "2018092520455210043243",
  "bizContent": {
    "requestId": "REQ-E5RE2UOSN71748594003057",
    "requestTime": "1748594003057",
    "transactionId": "OS202505300010000201"
  },
  "clientId": "2018092520455210043",
  "sign": "D861DA5DDA33FF09B2935C3473A177B74545B450F34334626D979AB266C75BAB",
  "signType": "SHA256",
  "version": "1.0"
}

Responses Body Parameters

application/json

Common Response Parameters

bizContent

• cardTransinfoObjectOptional

  Card payment information

  • acqBankNameStringOptional

    Name of the acquiring bank for POS card transactions
  • acqTermnialIdStringOptional

    Terminal number of the acquiring bank for POS card transactions
  • acqMerchantIdStringOptional

    Merchant number of the acquiring bank for POS card transactions
  • acqRRNStringOptional

    RRN (Retrieval Reference Number) of the acquiring bank for POS card transactions
  • acqStanStringOptional

    Terminal transaction number of the acquiring bank for POS card transactions
  • acqRspCodeStringOptional

    Response code of the acquiring bank for POS card transactions
  • acqRspMessageStringOptional

    Explanation of the response code of the acquiring bank for POS card transactions
  • acqBatchNumberStringOptional

    Batch number of the acquiring bank for POS card transactions
  • acqInvoiceNumberStringOptional

    Invoice Number of the acquiring bank for POS card transactions
  • desensitizedCardNoStringOptional

    Card number for POS card transactions, display with the first six and last four digits visible, others masked
  • issuerBankNameStringOptional

    Issuing bank name of the card used in POS card transactions
  • cardHolderNameStringOptional

    Cardholder name of the card used in POS card transactions
  • cardTypeStringOptional

    Card type, enum values:

    • DEBIT - Debit card
    • CREDIT - Credit card
    • CHARGE CARD - Charge card
  • issuerBankCountryStringOptional

    Issuing bank country, ISO A2 code (ISO 3166-1 alpha-2 standard), defaults to countries supported by PingPong, see Country Codes
  • cardBrandStringOptional

    Card brand, enum values:

    • VISA
    • Mastercard
    • American Express
    • JCB
    • Discover
    • CHINA UNION PAY
• transactionIdString(64)Required

  PingPong transaction number
• merchantTransactionIdString(64)Required

  Merchant website's transaction number
• currencyString(3)Required

  Transaction currency, ISO 4217 three-letter code, see the supported currencies in the appendix Transaction Currencies
• amountString(12)Required

  Transaction amount, the precision depends on the currency, please check the appendix Transaction Currencies
• transactionTimeString(13)Required

  Time when the transaction was initiated, timestamp
• statusString(32)Required

  Transaction status: Idempotent Status

  • INIT - Initial state
  • IPROCESSING - In progress
  • SUCCESS - Success
  • FAILED - Failed
  • AUTH_SUCCESS - Pre-authorization success
  • CANCEL - Pre-authorization canceled
  • CLOSED - Order closed
• transactionEndingTimeString(13)Optional

  Time when the transaction reached its final state, timestamp
• remarkString(255)Optional

  Merchant extended fields, can be used to specify certain parameters, will be returned as is in the response body
• resultCodeString(6)Optional

  Status result code
• resultDescriptionString(500)Optional

  Description of the status result

响应报文示例

{
  "accId": "2018092520455210043243",
  "bizContent": {
    "amount": "121.23",
    "remark": "payment test",
    "transactionTime": "1748591388000",
    "transactionId": "OS202505300010000201",
    "merchantTransactionId": "PMT-15ZSIRMPKT1748591387687",
    "currency": "MYR",
    "status": "PROCESSING",
    "cardTransinfo": {
      "acqBankName": "Bank of America",
      "cardBrand": "VISA",
      "cardHolderName": "John Doe",
      "cardType": "CREDIT",
      "issuerBankCountry": "US"
    }
  },
  "clientId": "2018092520455210043",
  "code": "001000",
  "description": "Successful request"
}

Previous pageRefund Application

Next pageRefund Query