Refund Asynchronous Notification
The server returns after receiving the refund notice from the payment provider.
If no notification receiving address is passed in when applying for a refund, no notification request is initiated.
Currently, only WeChat is supported.
Info
Provide notify_url
when a refund is needed
Name | Type | Description | Requirement |
---|---|---|---|
notify_type | String(30) | Notification type Fixed: trade_status_sync | |
trade_type | String(10) | Transaction typeREFUND | |
user_confirm_key | String | User Key, provided by eftPay | |
transaction_id | String(64) | Payment provider's order number | |
out_trade_no | String(28) | Merchant order number | |
currency | String(5) | Currency type | |
total_fee | String(8) | Total order amount | |
trade_status | String(32) | Trade status, see Appendix 2 | |
gmt_payment | String | Transaction time, format:yyyy-MM-dd HH:mm:ss | |
payment_type | String(8) | Wallet type | |
tid | String(20) | Merchant terminal number | |
fee_type | String(5) | Currency type | |
rate | String(10) | Transaction exchange rate, returned by configuration | |
eftpay_trade_no | String(28) | eftPay order number | |
refund_trade_no | String(28) | eftPay refund number, returned by configuration | |
return_amount | String(8) | Refund amount | |
refund_no | String(28) | Refund order number | |
scene_type | String | Payment scenario | |
paytype | String(6) | Payment type | |
time | String | Time, format:yyyyMMddHHmmss | |
sign | String(64) | Signature |
The following parameters must be returned after receiving the transaction notice
Name | Type | Description | Requirement |
---|---|---|---|
return_code | String(10) | Return code success/false | |
time | String | Time, format:yyyyMMddHHmmss | |
sign | String(64) | Signature |
{
"notify_type": "trade_status_sync",
"trade_type": "REFUND",
"user_confirm_key": "12345678",
"transaction_id": "4200000994202001206533192063",
"out_trade_no": "20200120103448",
"total_fee": "0.02",
"currency": "HKD",
"trade_status": "TRADE_CLOSED",
"sign": "13a0a514971ded891920554346b5c83362f58dd7580554f3ef66f9859fbfe916",
"time": "20200120110948",
"gmt_payment": "2020-01-20 10:35:34",
"payment_type": "WECHATCN",
"tid": "tid0001",
"fee_type": "WeChat",
"rate": "0.88",
"eftpay_trade_no": "18520012345190801101200777",
"refund_trade_no": "R_20200120103526_0",
"return_amount": "0.02",
"refund_no": "R_20200120103526_0",
"scene_type": "H5",
"paytype": "WeChat"
}
{
"time": "20230609110646",
"sign": "2c418bfb1085b0cabbf2f5c6de71db0694a5a78b7271b05ca6d5a8b70227ebb2",
"return_code": "success"
}