Request Body Parameters

application/json

Common Request Parameters

bizContent

• requestTimeString(13)Required

  Merchant-side request time. Timestamp, in milliseconds
• refundIdString(64)Required

  PingPong refund serial number, at least one of refundId and merchantRefundId must be sent
• merchantRefundIdString(64)Required

  Merchant website refund serial number, at least one of refundId and merchantRefundId must be sent
• merchantTransactionIdString(64)Required

  Original merchant website transaction serial number

请求报文示例

{
  "accId": "2018092520455210043243",
  "bizContent": {
    "requestTime": "1748599812954",
    "merchantRefundId": "RFD-G1DYGNCEQ61748599729106",
    "merchantTransactionId": "PMT-SNV279OONV1748599488191"
  },
  "clientId": "2018092520455210043",
  "sign": "BFEE0B5AABC7644CE2C80CF19C2A634DBCC6336590722755CA7890AFBB2C024B",
  "signType": "SHA256",
  "version": "1.0"
}

Responses Body Parameters

application/json

Common Response Parameters

bizContent

• amountString(12)Required

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

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

  Refund initiation time, timestamp
• statusString(32)Required

  Transaction status: Status Idempotency
• PROCESSING-In progress
• SUCCESS-Success
• FAILED-Failed

resultCodeString(6)Optional

Status result code

resultDescriptionString(500)Optional

Status result description

refundEndingTimeString(13)Optional

Time when the refund reaches the final state, timestamp

remarkString(255)Optional

Merchant extension field, can be used to specify specific parameters, will be returned as is in the response body

响应报文示例

{
  "accId": "2018092520455210043243",
  "clientId": "2018092520455210043",
  "signType": "MD5",
  "sign": "b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v2w3x4y5z6a1",
  "code": "000000",
  "description": "Success",
  "bizContent": {
    "amount": "50.00",
    "currency": "EUR",
    "refundTime": "1748599729106",
    "status": "SUCCESS",
    "resultCode": "000000",
    "resultDescription": "Refund successful",
    "refundEndingTime": "1748599829106",
    "remark": "Partial refund"
  }
}