异步通知与同步返回

服务端接收支付提供方支付通知之后返回。
异步通知需要提供接口 URL 给我们配置到后台，或者预下单时上传参数 notify_url；同步返回须要预下单时上传参数 return_url。
注意: OCT，FDMS，JETCOHK 目前无异步通知只有同步通知，NUVEI，线上银联只通知一次，请主动调用查询获取订单状态。
异步通知商家接口和同步返回商家页面的请求参数，其中异步通知商家接口的 Content-Type 为 application/json，而同步返回商家页面的 Content-Type 为 x-www-form-urlencode，POST 提交方式返回给商户进行接收处理。
接收异步通知后，须返回响应参数，告知已成功接收处理通知。如果是同步返回时，商户无须返回。

相关信息

需要下单时提供 notify_url / return_url

名称	类型	描述
notify_type	String(30)	通知类型固定：`trade_status_sync`
user_confirm_key	String	用户Key，由 eftPay 提供
trade_no	String(64)	支付提供方单号
transaction_id	String(64)	支付提供方单号
out_trade_no	String(28)	商户订单号
eft_trade_no	String(28)	依付得订单号
eftpay_trade_no	String(28)	依付得订单号
total_fee	String(8)	金额
currency	String(5)	货币类型
trade_status	String(32)	交易状态，见附录2
gmt_payment	String	交易时间，格式：`yyyy-MM-dd HH:mm:ss`
wallet	String(20)	钱包类型
tid	String(20)	商户终端号
trade_type	String(10)	交易类型 `SALE`
card_scheme	String(8)	卡类型，Mpgs/AE/NUVEI 交易配置返回。如：`VISA`/`MASTERCARD`
card_number	String(8)	卡号，Mpgs/AE/NUVEI 交易配置返回
time	String	时间，格式：`yyyyMMddHHmmss`
sign	String(64)	签名

名称	类型	描述
return_status	String(3)	返回状态码，代表。注：此参数不可作为交易状态是否成功的判断其他状态码见附录3
return_char	String(100)	返回说明，可能会变化，不能作条件判断
return_status 大于 00 时返回
time	String	时间，格式：`yyyyMMddHHmmss` `return_status` >= `00` 时返回
sign	String(64)	签名 `return_status` >= `00` 时返回

收到交易异步通知后须返回以下参数

名称	类型	描述
return_code	String(10)	返回码 success/false
time	String	时间，格式：`yyyyMMddHHmmss`
sign	String(64)	签名

{
    "notify_type": "trade_status_sync",
    "user_confirm_key": "12345678",
    "trade_no": "2019082422001386450540290447",
    "out_trade_no": "20190824021916",
    "eft_trade_no": "08520005269190824021901723",
    "total_fee": "0.02",
    "currency": "HKD",
    "trade_status": "TRADE_SUCCESS",
    "sign": "d37d17a7243b2ae49a865275531a9a7c42f80623e673d0ccf5a79ef62bf14913",
    "time": "20190824022030",
    "gmt_payment": "2019-09-24 02:20:29",
    "wallet": "ALIPAYCN",
    "trade_type": "SALE"
}

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

异步通知与同步返回

#

#

#

#

#

#