- 接入指南(接入前请浏览以下内容)
1、参数中红色为必填参数,黄色为条件选填参数;
2、token参数在head中,登录控制台在商户管理中查看;
3、merchatCode、APPID登录控制台在应用管理中查看;
3、找管理员设置通知地址,此通知地址主要用于Ethoca退款通知;交易通知通过交易参数中的notify参数进行;
4、目前所有的交易US、CA大部分会走no 3ds,其他国家均为全3D交易,特殊MCC的NO 3D交易会单独通知;
支持的卡种
Visa | Visa |
MasterCard | MasterCard |
卡支持的交易币种
美元 | USD |
欧元 | EUR |
英鎊 | GBP |
日元 | JPY |
澳元 | AUD |
加拿大元 | CAD |
新加坡元 | SGD |
请求地址
环境 | 请求方式 | 地址 |
测试环境 | POST | http://212.64.29.191:9001/gateway |
生产环境 | POST | https://gateway.risingsunpay.com/gateway |
Test Card
4111111111111111 | no 3d |
5200000000001096 | 3d |
4000000000001000 | 3d 2.1 无摩擦 |
5200000000002235 | 3d 2.2 无摩擦 |
4000000000002503 | 3d 2.2 挑战Visa |
5200000000001096 | 3d 2.1 挑战MasterCard |
错误码
200 | SUCCESS |
201 | PENDING |
100 | FAIL |
101 | CANCEL |
102 | TIMEOUT |
300 | PARAMTER_ERROR |
500 | HIGH_RTISK(基于风控和验卡的结果为高风险,您可以自行处置后续) |
800 | BANK_ERROR |
309 | SYSTEM_ERROR |
交易状态(status)
INIT, PENDING, REDIRECT(中间态)
SUCCESS, FAIL, TIMEOUT(终态)
获取设备信息代码示例
httpAcceptBrowserValue: navigator.userAgent,
httpAcceptContent: document.querySelector(‘meta[http-equiv=”Content-Type”]’)?.getAttribute(‘content’) || “text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7”,
browserJavaEnabled: navigator.javaEnabled() ? “true” : “false”,
browserJavascriptEnabled: “true”, // JavaScript is enabled if this script runs
browserUserAgent: navigator.userAgent,
language: navigator.language || navigator.userLanguage,
screenColorDepth: screen.colorDepth.toString(),
screenHeight: screen.height.toString(),
screenWidth: screen.width.toString(),
timezone: new Date().getTimezoneOffset() / 60
Request
Response
Request
Response
Request
Response
POST
Request
URL: /query?orderId=20240712111048
POST
Request
orderId(交易Response的orderId字段)
Response
URL: /trackNumber?orderId=20240816160001&postCode=SF1454829088889&postCompany=SFSY
POST
Request
orderId(交易Response的orderId字段)
postCode(物流单号)
postCompany(物流公司,请参考附录17Track物流公司代码)
Response http 200表示处理成功