本頁還沒有繁體中文版本,下面是简体中文內容。
对接文档
这里是本平台给商户的接口说明。一共两套接口:
- 代付接口 std1:提代付、查代付、查余额,代付有结果时回调您。新接入的商户用这一套。见 代付接口 std1。
- 代收接口 compat1(老协议):下单、查单、查余额,付款成功时回调您。原来已经按老协议接好的商户用这一套,只换地址、不改代码。见 代收接口 compat1。
本平台的地址
| 项目 | 值 |
|---|---|
| 接口地址(网关) | https://api.xx2system.xyz |
| 回调来源 IP | 47.242.183.76 |
| 商户后台 | https://merchant.xx2system.xyz |
| 本文档 | https://document.xx2system.xyz |
| 新开商户号的样子 | MCH58001 |
| 本平台币种 | CNY |
- 请求都发到上表的「接口地址」,路径见各接口。http、https 都收,建议用 https。
- 我们给您发回调时,从上表的「回调来源 IP」发出。您那边对回调来源设了 IP 白名单的,把它们加进去。
接入前要准备的
- 商户号:开户后运营告诉您。新开的商户号形如
MCH58001;从老系统迁来的商户,商户号不变。 - API私钥:一户一把,代付接口 std1 和代收接口 compat1 共用,在 商户后台 的「商户管理 › 安全中心」里看。新开的商户是一串 64 位十六进制文本;从老系统迁来的商户沿用原来的商户私钥。私钥只放在您的服务器上,不要写进网页或手机应用。
- IP 白名单:把调接口的服务器出口 IP 报给运营。代付接口的名单是空的时候,所有代付请求都会被拒。
- 回调地址:要能从公网访问;收到回调、处理好之后回
success。
通用约定
- 金额一律是整数,按货币最小单位:两位小数的货币
10000表示 100.00。 - 时间:代付接口 std1 是
yyyy-MM-dd HH:mm:ss,北京时间(UTC+8);老协议的reqTime是yyyyMMddHHmmss,paySuccTime是毫秒数。 - 字符集:UTF-8。
- 签名:两套接口签法不同,见 签名。
- 拿不准结果时先查单,不要换单号重下。