异步通知参数说明

对于API支付产生的交易,EPAY会根据API 中传入的异步通知地址 notifyUrl,通过 POST 请求的形式将支付结果作为参数通知到您的系统。

回调订单状态

Code Merchant status Description
5 Cancel 订单取消
6 Fail 订单失败
7 Success 订单成功
8 Close 订单关闭
20 No refund of handling fee 订单失败且不退手续费(提现业务)

回调说明

数据格式: 当前版本使用x-www-form-urlencoded格式回调

回调时您需要返回 “success”,EPAY接收到这个信息时则停止回调,默认针对订单号回调重试16次(10s 30s 1m 2m 3m 4m 5m 6m 7m 8m 9m 10m 20m 30m 1h 2h)。

如果出现问题可以联系EPAY回调推送状态也可以由您主动查询订单状态数据。

name type required desc example
epayAccount string YES 您的账号 test2020@epay.com
merchantOrderNo string YES 您的订单号 211151436637284296077312
epayOrderNo string YES EPAY订单号 210911037
pinCode string NO 取款码,现金才有 11021
amount string YES 订单金额 11.00
paymentAmount string YES 付款金额 11.00
receiveAmount string YES 收款金额 70.65
settlementCurrency string YES 结算币种 USD
paymentCurrency string YES 付款币种 USD
receiveCurrency string YES 收款币种 CNY
fee string YES 手续费 5.11
rate string YES 汇率 0.155701
status string YES 订单状态 7
accountNo string NO 电子货币收款账号 addd11245
payerAccount string NO 交易对方epay账号 payer@epay.com
remark string NO 备注 dd
extendFields string NO 扩展字段 {\"test\":\"test\"}
timestamp string YES yyyy-MM-dd HH:mm:ss 完成时间 2022-11-03 07:30:02
version string YES 版本号 V2.0.0
code string YES 返回码 1
message string NO 提示 success
sign string YES 签名

回调示例

   curl --location --request POST 'http://{{ notify_url}}' \
   --header 'Content-Type: application/x-www-form-urlencoded' \
   --data-urlencode 'epayAccount=test2020@epay.com' \
   --data-urlencode 'epayOrderNo=211151436637284296077312' \
   --data-urlencode 'merchantOrderNo=V1.0.0' \
   --data-urlencode 'pinCode=1245' \
   --data-urlencode 'bankAccount=sssswsa5451'
   --data-urlencode 'amount=11.00'
   --data-urlencode 'paymentAmount=11.00'
   --data-urlencode 'receiveAmount=70.65'
   --data-urlencode 'settlementCurrency=USD'
   --data-urlencode 'paymentCurrency=USD'
   --data-urlencode 'receiveCurrency=CNY'
   --data-urlencode 'fee=5.11'
   --data-urlencode 'rate=0.155701'
   --data-urlencode 'status=7'
   --data-urlencode 'timestamp=2109-11-03 07:30:02'
   --data-urlencode 'code=1'
   --data-urlencode 'message=success'
   --data-urlencode 'version=V2.0.0'
   --data-urlencode 'sign=29F424B1995A3163CF5428DAACD1F8FB59890878298C6845FF88DA05D03D4F68'

CurrentVersion

   curl --location --request POST 'http://{{ notify_url}}' \
   --header 'Content-Type: application/x-www-form-urlencoded' \
   --data-urlencode 'epayAccount=test2020@epay.com' \
   --data-urlencode 'epayOrderNo=211151436637284296077312' \
   --data-urlencode 'merchantOrderNo=V1.0.0' \
   --data-urlencode 'pinCode=1245' \
   --data-urlencode 'bankAccount=sssswsa5451'
   --data-urlencode 'amount=11.00'
   --data-urlencode 'paymentAmount=11.00'
   --data-urlencode 'receiveAmount=70.65'
   --data-urlencode 'settlementCurrency=USD'
   --data-urlencode 'paymentCurrency=USD'
   --data-urlencode 'receiveCurrency=CNY'
   --data-urlencode 'fee=5.11'
   --data-urlencode 'rate=0.155701'
   --data-urlencode 'status=7'
   --data-urlencode 'timestamp=2109-11-03 07:30:02'
   --data-urlencode 'code=1'
   --data-urlencode 'message=success'
   --data-urlencode 'version=V2.0.0'
   --data-urlencode 'sign=29F424B1995A3163CF5428DAACD1F8FB59890878298C6845FF88DA05D03D4F68'

results matching ""

    No results matching ""