Skip to main content

Asynchronous Notification


  • The server returns after receiving the payment notification from the payment provider.

Info

notify_url needs to be provided when placing an order.

NameTypeDescriptionRequirement
paytypeString(6)Payment type
Alipay, WeChat
user_confirm_keyStringUser Key, provided by eftPay
transaction_idString(64)Payment provider's single number
out_trade_noString(28)Merchant order number
subjectString(256)Transaction information
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
payment_typeString(20)Wallet type
scene_typeStringPayment scene
tidString(20)Merchant terminal number
fee_typeString(5)Currency type
rateString(10)Transaction exchange rate, configuration return
eftpay_trade_noString(28)eftPay order number
openidStringOpenid obtained from public account
WeChat PUBLIC scene return
sub_openidStringOpenid obtained from mini program
WeChat APPLETS scene return
timeStringTime, format: yyyyMMddHHmmss
signString(64)Signature

The following parameters must be returned after receiving the transaction asynchronous notification

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

{
    "paytype": "WeChat",
    "user_confirm_key": "12345678",
    "transaction_id": "2019082422001386450540290447",
    "out_trade_no": "2019082402191600000000000000",
    "subject": "测试通知",
    "total_fee": "0.02",
    "currency": "HKD",
    "trade_status": "TRADE_SUCCESS",
    "sign": "d37d17a7243b2ae49a865275531a9a7c42f80623e673d0ccf5a79ef62bf14913",
    "time": "20190824022030",
    "gmt_payment": "2019-09-24 02:20:29",
    "payment_type": "WECHATCN",
    "scene_type": "H5",
    "fee_type": "HKD",
    "eftpay_trade_no": "08520005269190824021901723"
}

{
    "time": "20230609110646",
    "sign": "2c418bfb1085b0cabbf2f5c6de71db0694a5a78b7271b05ca6d5a8b70227ebb2",
    "return_code": "success"
}