Request Body Parameters

application/json

Common Request Parameters

bizContent

• merchantRefundIdString(64)Conditional

  Merchant refund ID, required if transactionRefundId is not provided
• transactionRefundIdString(64)Conditional

  PingPong refund ID, required if merchantRefundId is not provided

请求报文示例

{
  "accId": "PPX_ACC_202312001",
  "clientId": "PPX_MCH_20230001",
  "signType": "SHA256",
  "sign": "9F86D081884C7D659A2FEAA0C55AD015A3BF4F1B2B0B822CD15D6C15B0F00A08",
  "version": "1.0",
  "event": "REFUND_QUERY",
  "requestTime": "1683532500000",
  "bizContent": {
    "merchantRefundId": "MCH_REFUND_20231212001"
  }
}

Responses Body Parameters

application/json

Common Response Parameters

bizContent

• cardTransinfoObjectOptional
• requestIdString(64)Required

  Unique request ID
• merchantTransactionIdString(64)Required

  Merchant transaction ID
• merchantRefundIdString(64)Required

  Merchant refund ID
• transactionRefundIdString(64)Required

  PingPong refund ID
• amountString(12)Required

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

  Refund currency, ISO 4217 three-letter currency code, see Transaction Currencies
• transactionTimeString(13)Required

  Transaction initiation time, timestamp (milliseconds)
• statusString(32)Required

  Refund status:

  • PROCESSING - Processing
  • SUCCESS - Success
  • FAILED - Failed

响应报文示例

{
  "accId": "PPX_ACC_202312001",
  "clientId": "PPX_MCH_20230001",
  "signType": "SHA256",
  "sign": "9F86D081884C7D659A2FEAA0C55AD015A3BF4F1B2B0B822CD15D6C15B0F00A08",
  "version": "1.0",
  "event": "REFUND_QUERY_RESULT",
  "code": "0",
  "description": "查询受理成功",
  "requestTime": "1683532501000",
  "bizContent": {
    "requestId": "REQ_202312120001",
    "merchantTransactionId": "MCH_ORDER_20231212001",
    "merchantRefundId": "MCH_REFUND_20231212001",
    "transactionRefundId": "PPX_REFUND_202312120001",
    "amount": "50.00",
    "currency": "USD",
    "transactionTime": "1683531500000",
    "status": "SUCCESS",
    "cardTransinfo": {
      "acqBankName": "Bank of America",
      "acqTermnialId": "TERM001",
      "acqMerchantId": "MCHNT001",
      "acqRRN": "RRN001",
      "acqStan": "STAN001",
      "acqRspCode": "00",
      "acqRspMessage": "Approved",
      "acqBatchNumber": "BATCH001",
      "acqInvoiceNumber": "INV001",
      "desensitizedCardNo": "123456******1234",
      "issuerBankName": "Bank of America",
      "cardHolderName": "John Doe"
    }
  }
}

Previous pageRefund API

Next pageTransaction Cancel