Refund Asynchronous Notification
The server returns after receiving the refund notification from the payment provider.
If no notification receiving address is provided when applying for a refund, no notification request will be initiated.
Info
notify_url needs to be provided when requesting a refund.
| 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 order number | |
| trade_no | String(64) | Payment provider order number | |
| out_trade_no | String(28) | Merchant order number | |
| total_fee | String(8) | Order total amount | |
| currency | String(5) | Currency type | |
| trade_status | String(32) | Transaction status, see Appendix 2 | |
| gmt_payment | String | Transaction time, format: yyyy-MM-dd HH:mm:ss | |
| wallet | String(20) | Wallet type | |
| tid | String(20) | Merchant terminal number | |
| eft_trade_no | String(28) | eftPay order number | |
| eftpay_trade_no | String(28) | eftPay order number | |
| return_amount | String(8) | Refund amount | |
| refund_no | String(28) | Refund number | |
| rejectReason | String(28) | Octopus refund failure reason, only returned by Octopus | |
| time | String | Time, format: yyyyMMddHHmmss | |
| sign | String(64) | Signature |
The following parameters must be returned upon receiving the transaction notification.
| Name | Type | Description | Requirement |
|---|---|---|---|
| return_code | String(10) | Return code success/false | |
| time | String | Time, format: yyyyMMddHHmmss | |
| sign | String(64) | Signature |
{
"currency": "HKD",
"eft_trade_no": "18520003650610023041t5ruq5va732",
"eftpay_trade_no": "18520003650610023041t5ruq5va732",
"gmt_payment": "2020-01-20 10:35:34",
"notify_type": "trade_status_sync",
"out_trade_no": "20200120103448",
"refund_no": "R_20200120103526_0",
"return_amount": "0.02",
"time": "20200120110948",
"total_fee": "0.02",
"trade_no": "4200000994202001206533192063",
"trade_status": "TRADE_CLOSED",
"trade_type": "REFUND",
"transaction_id": "4200000994202001206533192063",
"user_confirm_key": "61002304",
"wallet": "WECHATCN",
"sign": "13a0a514971ded891920554346b5c83362f58dd7580554f3ef66f9859fbfe916"
}
{
"time": "20230609110646",
"sign": "2c418bfb1085b0cabbf2f5c6de71db0694a5a78b7271b05ca6d5a8b70227ebb2",
"return_code": "success"
}