数据同步
预创建订单
客户在商户平台登录后，在点击支付时，商户平台将支付信息以及发票信息传输到荣e通平台，然后荣e通平台验证成功后向商户返回跳转连接地址，商户平台根据地址跳转到荣e通页面，该页面同时展示出客户提交的订单信息，包括纳订单金额、订单编号、收款人。收款人开户行、收款人账号等相关信息。
请求地址
| 环境 | 请求地址 |
| 正式环境 | https://api.cargonpay.com/api/apiJoinPay/orderSubmit |
请求参数
| 索引 | ID | 名称 | 类型及长度 | 必须 | 说明 | |
| 1 | accessKey | 请求唯一标识 | varchar(36) | 是 | 荣e通平台为商户分配 | |
| 2 | nonce | 随机号 | varchar(36) | 是 | ||
| 3 | timestamp | 时间戳 | varchar(20) | 是 | Unix时间戳，保留到毫秒 | |
| 4 | sign | 签名 | varchar(32) | 是 | ||
| 5 | returnUrl | 支付提交完成后返回页面 | varchar(200) | 是 | ||
| 6 | notifyUrl | 支付结果通知地址 | varchar(200) | 是 | ||
| 7 | detail | 付款信息 | object | 是 | ||
| 8 | merchantOrderNo | 商户订单号 | varchar(36) | 是 | ||
| 9 | currency | 发票币别 | varchar(10) | 是 | USD、CNY | |
| 10 | paymentAmount | 订单金额 | decimal(18,2) | 是 | ||
| 11 | shipName | 船名 | varchar(50) | 否 | ||
| 12 | voyage | 航次 | varchar(100) | 否 | ||
| 13 | billNo | 提单号 | varchar(200) | 否 | ||
| 14 | shipDate | 开船日 | varchar(20) | 否 | 例:yyyy-MM-dd | |
| 15 | billFile | 提单影像 | varchar | 否 | Base64字符串(PDF) | |
| 16 | pdfFile | 发票文件 | array | 是 | ||
| 17 | invoiceNo | 发票号码 | varchar(10) | 是 | 币别为USD时必填，为CNY时选填 | |
| 18 | invoiceType | 发票类型 | varchar(10) | 是 | 币别为USD时必填，为CNY时选填电票：PDF纸票：JPG | |
| 19 | invoiceAmount | 发票金额 | decimal(18,2) | 是 | ||
| 20 | invoiceFile | 发票文件 | varchar | 是 | 币别为USD时必填，为CNY时选填发票文件Base64String | |
| 21 | bankAccount | 收款账户 | varchar(30) | 否 | 空默认使用收款默认账号 |
响应参数
| 索引 | ID | 名称 | 长度 | 必须 | 说明 |
| 1 | code | 返回状态码 | varchar(10) | 是 | |
| 2 | message | 返回消息 | varchar(200) | 是 | |
| 3 | data | object | 是 | ||
| 4 | url | 支付跳转页面 | nvarhcar(200) | 是 | |
| 5 | tradeNo | 交易号 | varchar(36) | 是 | |
| 6 | merchantOderNo | 商户订单号 | varchar(36) | 是 |
请求示例
JSON格式
- {
- "timestamp": "1725797231000",
- "nonce": "1725797231052",
- "accessKey": "F0D16DD2EFF945C4B73A4B37F99C2696",
- "sign": "AB15D04C25F6B63317F2C166B58EED61",
- "returnUrl": "http://www.xxx.com/xx",
- "notifyUrl": "http://www.xxx.com/xxx",
- "detail": {
- "merchantOrderNo": "7123847812",
- "currency": "USD",
- "paymentAmount": 10780,
- "shipName": "测试",
- "voyage": "测试",
- "billNo": "871283718",
- "shipDate": "2021-06-23",
- "billFile": "base64string",
- "pdfFile": [
- {
- "invoiceNo": "81237123",
- "bankAccount": "32423423423423",
- "invoiceType": "PDF",
- "invoiceAmount": 10780,
- "invoiceFile": "base64string"
- }
- ]
- }
- }
复制代码
响应示例
JSON格式
- {
- "code": "000000",
- "message": "请求成功",
- "data": {
- "url": "https://www.x.com/pxxxx?orderCodes=[B@803a333",
- "tradeNo": "ADV21071211053249592",
- "merchantOrderNo": "7123847812"
- }
- }
复制代码
返回码说明
| 索引 | id | 名称 |
| 1 | 000000 | 提交成功 |
| 2 | 100001 | 参数无效，【参数名】不正确 |
| 3 | 100002 | 请求时间超出有效时间 |
| 4 | 100003 | 商户accessKey不存在，请联系荣e通客服 |
| 5 | 100004 | 商户accessKey已停用 |
| 6 | 100005 | 验证签名失败 |
| 7 | 100006 | 请求重复，请重新发起(nonce重复) |
| 8 | 200001 | 订单总金额与发票总金额不一致 |
| 9 | 200005 | 商户未设置默认的收款账号 |
| 10 | 999999 | 系统错误，请联系技术人员 |
| 11 | 200006 | 未查询到收款账号信息 |
| 12 | 200007 | 收款账号币别与订单币别不一致 |
- 请求地址
- 请求参数
- 响应参数
- 请求示例
- 响应示例
- 返回码说明
