概述
电子钱包代付，是指商家可以在EPAY提现规定的当地币种到用户的电子钱包账号。
支付流程
商家可以参考如下流程图，完成代付对接。
流程说明
- 用户访问您的页面发起交易请求。
- 您的后台服务调用createEwalletTransaction接口到EPAY网关后台服务创建交易。
- EPAY网关后台服务创建正式订单，开始处理：订单状态status=1
- EPAY网关后台服务调用第三方银行完成付款交易
- 第三方银行AcquireerBank回调结果发送到EPAY网关后台服务。
- EPAY网关后台服务处理订单结果，包括订单成功：订单状态status=7，订单失败：订单状态status=6。
- EPAY网关后台服务发送回调结果给您的后台服务，通知交易订单已完成。
- 您的后台服务可以选择调用queryTransaction接口进行信息确认。
- EPAY网关后台服务响应queryTransaction接口数据。
- 您的后台服务更新交易数据，完成订单状态。
- 您的后台服务通知用户订单完成状态。
创建订单
商家后台请求 createEwalletTransaction 的API接口，传入商家订单号、订单金额、币种及收款账号等参数（具体可查看如下入参说明），创建EPAY代付订单。
注意：此时订单状态为处理中（status=1），可通过查询交易接口 queryTransaction 查看订单详情。
示例代码
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\n\t\"sign\": \"\",\n\t\"param\": {\n\t\t\"epayAccount\": \"test2020@epay.com\",\n\t\t\"category\": \"EWALLET\",\n \"channelCode\":\"11\",\n\t\t\"notifyUrl\": \"http://localhost/paymentApi/channel/send.do\",\n\t\t\"merchantOrderNo\": \"0702001122\",\n\t\t\"amount\": \"0.01\",\n\t\t\"currency\": \"USD\",\n\t\t\"version\": \"V2.0.0\",\n\t\t\"receiverInfo\": {\n\t\t\t\"accountNo\": \"41111810111111111111\",\n\t\t\t\"remark\": \"remark\"\n\t\t}\n\t}\n}");
Request request = new Request.Builder()
.url("http://29597375fx.epaydev.xyz/capi/openapi/payoutApi/createEwalletTransaction")
.method("POST", body)
.addHeader("Content-Type", "application/json")
.build();
Response response = client.newCall(request).execute();
java
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\n\t\"sign\": \"\",\n\t\"param\": {\n\t\t\"epayAccount\": \"test2020@epay.com\",\n\t\t\"category\": \"EWALLET\",\n \"channelCode\":\"11\",\n\t\t\"notifyUrl\": \"http://localhost/paymentApi/channel/send.do\",\n\t\t\"merchantOrderNo\": \"0702001122\",\n\t\t\"amount\": \"0.01\",\n\t\t\"currency\": \"USD\",\n\t\t\"version\": \"V2.0.0\",\n\t\t\"receiverInfo\": {\n\t\t\t\"accountNo\": \"41111810111111111111\",\n\t\t\t\"remark\": \"remark\"\n\t\t}\n\t}\n}");
Request request = new Request.Builder()
.url("http://29597375fx.epaydev.xyz/capi/openapi/payoutApi/createEwalletTransaction")
.method("POST", body)
.addHeader("Content-Type", "application/json")
.build();
Response response = client.newCall(request).execute();
python
import requests
import json
url = "http://29597375fx.epaydev.xyz/capi/openapi/payoutApi/createEwalletTransaction"
payload = json.dumps({
"sign": "",
"param": {
"epayAccount": "test2020@epay.com",
"category": "EWALLET",
"channelCode": "11",
"notifyUrl": "http://localhost/paymentApi/channel/send.do",
"merchantOrderNo": "0702001122",
"amount": "0.01",
"currency": "USD",
"version": "V2.0.0",
"receiverInfo": {
"accountNo": "41111810111111111111",
"remark": "remark"
}
}
})
headers = {
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
go
package main
import (
"fmt"
"strings"
"net/http"
"io/ioutil"
)
func main() {
url := "http://29597375fx.epaydev.xyz/capi/openapi/payoutApi/createEwalletTransaction"
method := "POST"
payload := strings.NewReader(`{
"sign": "",
"param": {
"epayAccount": "test2020@epay.com",
"category": "EWALLET",
"channelCode":"11",
"notifyUrl": "http://localhost/paymentApi/channel/send.do",
"merchantOrderNo": "0702001122",
"amount": "0.01",
"currency": "USD",
"version": "V2.0.0",
"receiverInfo": {
"accountNo": "41111810111111111111",
"remark": "remark"
}
}
}`)
client := &http.Client {
}
req, err := http.NewRequest(method, url, payload)
if err != nil {
fmt.Println(err)
return
}
req.Header.Add("Content-Type", "application/json")
res, err := client.Do(req)
if err != nil {
fmt.Println(err)
return
}
defer res.Body.Close()
body, err := ioutil.ReadAll(res.Body)
if err != nil {
fmt.Println(err)
return
}
fmt.Println(string(body))
}
shell
printf '{
"sign": "",
"param": {
"epayAccount": "test2020@epay.com",
"category": "EWALLET",
"channelCode":"11",
"notifyUrl": "http://localhost/paymentApi/channel/send.do",
"merchantOrderNo": "0702001122",
"amount": "0.01",
"currency": "USD",
"version": "V2.0.0",
"receiverInfo": {
"accountNo": "41111810111111111111",
"remark": "remark"
}
}
}'| http --follow --timeout 3600 POST 'http://29597375fx.epaydev.xyz/capi/openapi/payoutApi/createEwalletTransaction' \
Content-Type:'application/json'
入参说明
| 参数名称 | 参数说明 |
|---|---|
| epayAccount | 商家开通的EPAY账号 |
| merchantOrderNo | 商家订单号 |
| version | 版本号，当前版本号为V2.0.0，兼容版本V1.0.0 |
| category | 类型：EWALLET |
| notifyUrl | 回调地址，用于接收EPAY后台通知的订单结果：成功或失败 |
| amount | 订单金额 |
| currency | 币种，如：USD |
| channelCode | 渠道编号，如 11：Perfect Money, 12：Advcash, 16：Payeer, 18：FasaPay |
| extendFields | 商户扩展字段，要求JSON格式 |
| receiverInfo | 付款信息，要求固定JSON格式，如： {"accountNo":"41111810111111111111", // 银行卡号 "remark":"付款说明" // 备注} |
以上为业务参数说明，参数封装结构及sign签名请查看 开发指引>接入指南>接口规则>接口规范 和 开发指引>接口签名 。
查询交易
商家可调用 queryTransaction（交易查询接口），通过商家订单号查询对应订单支付情况。
示例代码
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\n \"param\": {\n \"epayAccount\": \"test2020@epay.com\",\n \"version\": \"V2.0.0\",\n \"merchantOrderNo\": \"20210708220\"\n },\n \"sign\": \"\"\n}");
Request request = new Request.Builder()
.url("http://29597375fx.epaydev.xyz/capi/openapi/payoutApi/queryTransaction")
.method("POST", body)
.addHeader("Content-Type", "application/json")
.build();
Response response = client.newCall(request).execute();
java
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\n \"param\": {\n \"epayAccount\": \"test2020@epay.com\",\n \"version\": \"V2.0.0\",\n \"merchantOrderNo\": \"20210708220\"\n },\n \"sign\": \"\"\n}");
Request request = new Request.Builder()
.url("http://29597375fx.epaydev.xyz/capi/openapi/payoutApi/queryTransaction")
.method("POST", body)
.addHeader("Content-Type", "application/json")
.build();
Response response = client.newCall(request).execute();
python
import requests
import json
url = "http://29597375fx.epaydev.xyz/capi/openapi/payoutApi/queryTransaction"
payload = json.dumps({
"param": {
"epayAccount": "test2020@epay.com",
"version": "V2.0.0",
"merchantOrderNo": "20210708220"
},
"sign": ""
})
headers = {
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
go
package main
import (
"fmt"
"strings"
"net/http"
"io/ioutil"
)
func main() {
url := "http://29597375fx.epaydev.xyz/capi/openapi/payoutApi/queryTransaction"
method := "POST"
payload := strings.NewReader(`{
"param": {
"epayAccount": "test2020@epay.com",
"version": "V2.0.0",
"merchantOrderNo": "20210708220"
},
"sign": ""
}`)
client := &http.Client {
}
req, err := http.NewRequest(method, url, payload)
if err != nil {
fmt.Println(err)
return
}
req.Header.Add("Content-Type", "application/json")
res, err := client.Do(req)
if err != nil {
fmt.Println(err)
return
}
defer res.Body.Close()
body, err := ioutil.ReadAll(res.Body)
if err != nil {
fmt.Println(err)
return
}
fmt.Println(string(body))
}
shell
printf '{
"param": {
"epayAccount": "test2020@epay.com",
"version": "V2.0.0",
"merchantOrderNo": "20210708220"
},
"sign": ""
}'| http --follow --timeout 3600 POST 'http://29597375fx.epaydev.xyz/capi/openapi/payoutApi/queryTransaction' \
Content-Type:'application/json'
入参说明
| 参数名称 | 参数说明 |
|---|---|
| epayAccount | 商家开通的EPAY账号 |
| merchantOrderNo | 商家订单号 |
| version | 版本号，当前版本号为V2.0.0，兼容版本V1.0.0 |
以上为业务参数说明，参数封装结构及sign签名请查看 开发指引>接入指南>接口规则>接口规范 和 开发指引>接口签名 。
异步通知
EPAY通过POST 请求的方式（也可以通过创建订单时传入的successUrlMethod或者failUrlMethod字段来设置回调的请求方式）将支付结果作为参数通知到notifyUrl（创建订单时设置的地址），商家收到异步通知后可以对sign签名值做安全性校验，判断消息来源是EPAY后再对自身业务做逻辑处理。具体sign签名方法请查看 开发指引>接口签名。
异步通知示例，请查看 开发指引>异步通知>回调示例
订单状态图
API列表
| API名称 | API描述 | 操作 |
|---|---|---|
| createEwalletTransaction | 创建订单 | 查看文档 |
| queryTransaction | 查询交易 | 查看文档 |