Request Body Parameters

application/json

Common Request Parameters

bizContent

• merchantRefundIdString(64)Required

  Merchant refund order number, unique identifier, used to prevent duplicate refunds
• merchantTransactionIdString(64)Required

  Original payment order number, must be a successfully paid order
• amountString(12)Required

  Refund amount, precision depends on currency, see Transaction Currencies
• currencyString(3)Required

  Refund currency, must match original payment order currency, ISO 4217 three-letter currency code
• remarkString(255)Optional

  Refund remark, will be returned as is in the response
• cashierDeviceIdString(64)Required

  Unique ID of the cash register device

请求报文示例

{
  "accId": "PPX_ACC_202312001",
  "clientId": "PPX_MCH_20230001",
  "signType": "SHA256",
  "sign": "BAEA4D56D885D6BD449BFFA2D9F117ECEDA662C85197A19050CA0C18CC64B871",
  "version": "1.0",
  "event": "REFUND",
  "requestTime": "1683531500000",
  "bizContent": {
    "merchantRefundId": "MCH_REFUND_20231212001",
    "merchantTransactionId": "MCH_ORDER_20231212001",
    "amount": "100.00",
    "currency": "USD",
    "remark": "客户退货",
    "cashierDeviceId": "CASHIER_001"
  }
}

Responses Body Parameters

application/json

Common Response Parameters

bizContent

• requestIdString(64)Required

  Unique request number
• transactionRefundIdString(64)Optional

  PingPong refund ID

响应报文示例

{
  "accId": "PPX_ACC_202312001",
  "clientId": "PPX_MCH_20230001",
  "signType": "SHA256",
  "sign": "BAEA4D56D885D6BD449BFFA2D9F117ECEDA662C85197A19050CA0C18CC64B871",
  "event": "REFUND_ACCEPTANCE",
  "code": "0",
  "description": "退款受理成功",
  "requestTime": "1683531501000",
  "bizContent": {
    "requestId": "SAAS_REQ_20231212001",
    "transactionRefundId": "PPX_REFUND_202312120001"
  }
}

Previous pageQuery API

Next pageRefund Query