Request Body Parameters

application/json

Common Request Parameters

bizContent

• requestTimeString(13)Required

  Merchant-side request time. Timestamp, in milliseconds
• deviceSnString(64)Optional

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

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

  Original merchant order serial number, unique identifier of the order, can be used for subsequent order queries and reconciliation
• merchantRefundIdString(64)Required

  Merchant refund order serial number, unique identifier of the order
• amountString(12)Required

  Refund amount, the precision digits are related to the currency, please check the appendix Transaction Currency
• currencyString(3)Required

  Refund currency, ISO 4217 three-letter currency code, see appendix Transaction Currency for specific supported currencies
• cashierDeviceIdString(64)Required

  Unique ID of the cashier device serial number

请求报文示例

{
  "accId": "2018092520455210043243",
  "bizContent": {
    "requestTime": "1748597280752",
    "merchantTransactionId": "PMT-15ZSIRMPKT1748591387687",
    "merchantRefundId": "REF-15ZSIRMPKT1748591800000",
    "deviceSn": "NEC300067041",
    "deviceModel": "N950S",
    "amount": "121.23",
    "currency": "MYR",
    "cashierDeviceId": "111"
  },
  "clientId": "2018092520455210043",
  "sign": "6D214AE3A1926127C3240D4F7604130362B2007EB3D81C67C43CB7C9D9D97F4A",
  "signType": "SHA256",
  "version": "1.0"
}

Responses Body Parameters

application/json

Common Response Parameters

bizContent

• transactionRefundIdString(64)Required

  PingPong refund serial number
• merchantRefundIdString(64)Required

  Transaction serial number on the merchant website
• statusString(32)Required

  Transaction status:

  1. ACCEPT_SUCCESS-Acceptance successful
  2. FAILED-Failed
  3. PROCESSING-In progress

响应报文示例

{
  "accId": "2018092520455210043243",
  "bizContent": {
    "merchantRefundId": "REF-15ZSIRMPKT1748591800000",
    "transactionRefundId": "OS202505300010000211",
    "status": "PROCESSING"
  },
  "clientId": "2018092520455210043",
  "code": "002000",
  "description": "Transaction processing"
}

Previous pagePayment API

Next pageTransaction Query