Skip to main content

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

NameTypeDescriptionRequirement
notify_typeString(30)Notification type
Fixed:trade_status_sync
trade_typeString(10)Transaction type
REFUND
user_confirm_keyStringUser Key, provided by eftPay
transaction_idString(64)Payment provider's order number
out_trade_noString(28)Merchant order number
currencyString(5)Currency type
total_feeString(8)Total order amount
trade_statusString(32)Trade status, see Appendix 2
gmt_paymentStringTransaction time, format:yyyy-MM-dd HH:mm:ss
payment_typeString(8)Wallet type
tidString(20)Merchant terminal number
fee_typeString(5)Currency type
rateString(10)Transaction exchange rate, returned by configuration
eftpay_trade_noString(28)eftPay order number
refund_trade_noString(28)eftPay refund number, returned by configuration
return_amountString(8)Refund amount
refund_noString(28)Refund order number
scene_typeStringPayment scenario
paytypeString(6)Payment type
timeStringTime, format:yyyyMMddHHmmss
signString(64)Signature

The following parameters must be returned after receiving the transaction notice

NameTypeDescriptionRequirement
return_codeString(10)Return code
success/false
timeStringTime, format:yyyyMMddHHmmss
signString(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"
}