退款通知

• Endpoint: POST /RefundResultNotifyUrl
• Tags: 收单

Parameters

Field	In	Type	Required	Constraints	Description
Content-Type	header	string	Yes
sign	header	string	Yes		签名信息请参考技术文档

Parameter Examples

• Content-Type: "application/json"
• sign: "FPFVT3o227JrFRbqu19boZCpVVTF9KznxyRawUmxpfXilHV/0yK46haPhAjNu1hPUMy7Vw/ILXhfzffNm4Fj0apWknlTY9OJxnSoQxS9BTFtc61tn5yV1q69x/kkBl82/qwg+XTJ4fOzy7Mar3VaC1E2PlDA6RkkKBUyNE6RYgsdB+Su7an4+4HVTNAnoe74WyvBgxTLMNg28igBTdqxaO3w/UBY6ObVp7vkqkQGdL1Y+HgmMYaAVwrM3+ALWGId0sJ+YqTY4WJ+0xCRGhaSnybiIjZsQEYyID68WNUfuavDLDsEhaMm/HfQvf5p0R1Ltovp3wwJnEbQcjY458iX5A=="

Request Body

Content-Type: application/json

Field	Type	Required	Constraints	Description	Enum
code	string	Yes	maxLength: 32	返回码，’APPLY_SUCCESS’代表成功
msg	string	Yes	maxLength: 256	响应描述，’Success.’
keyVersion	string	Yes	maxLength: 8	密钥版本。当前值为：1
appId	string	No	maxLength: 64	商户app id
merchantNo	string	Yes	maxLength: 15	商户Id
notifyTime	string	Yes	maxLength: 32	请求时间，符合rfc3339规范，格式：yyyy-MM-dd’T’HH:mm:ss.SSSXXX
notifyType	string	Yes	maxLength: 16	通知类型 REFUND	REFUND
data	object	Yes
data.outRefundNo	string	Yes	maxLength: 64	商户退款单号
data.refundTradeNo	string	Yes	maxLength: 64	PayerMax退款流水号
data.outTradeNo	string	Yes	maxLength: 64	原商户订单号
data.refundAmount	number	Yes		退款金额，金额的单位为元。
data.refundCurrency	string	Yes	maxLength: 3	退款币种
data.status	string	Yes	maxLength: 32	退款单状态: REFUND_SUCCESS，REFUND_FAILED	REFUND_SUCCESS, REFUND_FAILED
data.refundFinishTime	string	Yes		退款完成时间，utc+0时区。

Example

{
  "code": "APPLY_SUCCESS",
  "msg": "Success.",
  "keyVersion": "1",
  "appId": "3b242b56a8b64274bcc37dac281120e3",
  "merchantNo": "020213827212251",
  "notifyTime": "2022-01-17T09:33:54.540+00:00",
  "notifyType": "REFUND",
  "data": {
    "outRefundNo": "R1642411016202",
    "refundTradeNo": "20220117091657TI790000055087",
    "outTradeNo": "P1642410680681",
    "refundAmount": 10000,
    "refundCurrency": "IDR",
    "refundFinishTime": "2023-10-20T03:28:23.092Z",
    "status": "REFUND_SUCCESS"
  }
}

Responses

200

错误码

分类	结果码	结果描述
PAYMENT_FAILED	Provider failed to process.	支付失败
REFUND_INSUFFICIENT_BALANCE	Insufficient Txn currency in the to be Settled Account.	余额不足无法退款

Field	Type	Required	Constraints	Description	Enum
code	string	Yes		返回码，’ SUCCESS’代表成功
msg	string	Yes		返回描述，’Success.’

Response Example

{
  "code": "SUCCESS",
  "msg": "Success"
}

Enum Reference

notifyType

• REFUND

data.status

• REFUND_SUCCESS
• REFUND_FAILED