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