异步通知参数说明
对于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'