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