Skip to main content

Asynchronous notification


Return after the server receives the payment notification from the payment provider.

Info

notify_url needs to be provided when placing an order

NameTypeDescriptionRequirement
notify_typeString(30)Notification type
Fixed:trade_status_sync
trade_typeString(10)Transaction type
SALE
user_confirm_keyStringUser Key, provided by eftPay
trade_noString(64)Payment provider order number
transaction_idString(64)Payment provider order number
out_trade_noString(28)Merchant order number
eft_trade_noString(28)eftPay order number
eftpay_trade_noString(28)eftPay order number
total_feeString(8)Amount
currencyString(5)Currency type
trade_statusString(32)Transaction status, see Appendix 2
gmt_paymentStringTransaction time, format:yyyy-MM-dd HH:mm:ss
walletString(20)Wallet type
tidString(20)Merchant terminal number
rateString(10)Transaction exchange rate, configuration return
timeStringTime, format:yyyyMMddHHmmss
signString(64)Signature

The following parameters must be returned after receiving the transaction notification

NameTypeDescriptionRequirement
return_codeString(10)Return code
success/false
timeStringTime, format:yyyyMMddHHmmss
signString(64)Signature

{
    "currency": "HKD",
    "eft_trade_no": "20005269520084311t5rutcv1734",
    "eftpay_trade_no": "20005269520084311t5rutcv1734",
    "gmt_payment": "2019-09-24 02:20:29",
    "notify_type": "trade_status_sync",
    "out_trade_no": "rrn_1686280005975",
    "sign": "9fdff8df93645e4b24919543f46c6b1219f80e7f47341d0c04834ee303903449",
    "time": "20230609110645",
    "total_fee": "1",
    "trade_no": "2019082422001386450540290447",
    "trade_status": "TRADE_SUCCESS",
    "user_confirm_key": "S0003469",
    "wallet": "ALIPAYCN",
    "transaction_id": "2020012022001386451433772415",
    "trade_type": "SALE"
}

{
    "time": "20230609110645",
    "sign": "8e80d3a03a8cf23e1427648fdf160431188740fbc371090c702c5a00bb6f347b",
    "return_code": "success"
}