预下单接口
功能概述
上传互联互通付款扫码支付交易的商户码信息，对付款扫码的订单进行支付。
接口地址
https://webox-api.5upay.com/webox/connectPay/create
| 参数名称 |
参数中文名称 |
类型& 长度 |
参数说明 |
是否必填 |
| merchantId |
商户编号 |
varchar(9) |
钱包用户的商户编号，商户在首信易系统的唯一 id，可在商户后台查看 |
M |
| walletId |
钱包 ID |
varchar(19) |
用户钱包在我司的唯一编号 |
M |
| merchantQR |
商户码 |
varchar(512) |
商户码信息 |
M |
| notifyUrl |
通知地址 |
varchar(200) |
订单终态后首信易支付会向该地址发送通知，该地址可以带参数，“https://www.5upay.com/callback.action?test=test 注意：如不填notifyUrl 的参数值您的服务器将得不到订单终态的通知。 |
O |
| hmac |
参数签名 |
varchar(500) |
商户生成的参数签名结果，获取hmac的方法请参考请求加密流程 |
M |
参数示例
<![CDATA[
{
"merchantId": "890000595",
"requestId": "202002251582614048062",
"walletId ":"1233345",
"notifyUrl": "https://qa-sdk.5upay.com/webox/Notify",
"hmac": null
}
]]>
同步返回参数列表
| 参数名称 |
参数中文名称 |
参数说明 |
| status |
响应状态 |
SUCCESS 响应正常 |
| FAIL 响应异常 |
| merchantId |
商户编号 |
同请求参数 |
| walletId |
钱包 ID |
同请求参数 |
| merchantQR |
商户码 |
同请求参数 |
| serialNumber |
交易流水号 |
首信易支付系统订单流水号 |
| barCodeType |
条码类型 |
DC 动态码 |
| SC 静态码 |
| 当为静态码时需要调“支付确认接口”上送支付金额 |
| token |
票据 |
通过此参数调起移动端 SDK（仅可使用一次） |
| errorMessage |
订单错误信息 |
只有订单状态出现异常时返回此参数 |
| amount |
订单金额 |
当条码类型为“动态码”时，返回该参数，订单金额，单位：分，1元=100分。 |
| productDetails |
商品信息 |
JSON[数组]，详见商品信息表 |
| merchantInfo |
收单商户信息 |
JSON，详见收单商户信息表 |
| createDateTime |
创建时间 |
格式：yyyy-MM-dd HH:mm:ss |
| hmac |
参数签名 |
商户生成的参数签名结果，获取hmac的方法请参考请求加密流程 |
productDetails 商品信息
| 参数名称 |
参数中文名称 |
参数说明 |
| productName |
商品名称 |
商品名称 |
| quantity |
商品数量 |
商品数量 |
| amount |
商品单价 |
单位：分，1元=100分 |
merchantInfo 收单商户信息
| 参数名称 |
参数中文名称 |
参数说明 |
| shortName |
收单商户简称 |
收单商户简称 |
| platformName |
平台简称 |
平台简称 |
参数示例
<![CDATA[
{
"status":"SUCCESS",
"orderStatus":"INIT",
"merchantId":"890000595",
"requestId":"202002251582614048062",
"serialNumber":"201911042372723735545584806014976",
"token":"20191022221481371367938298683392",
"walletId":"11111111"
"createDateTime":"2019-10-22 18:43:36",
"hmac":"NJ6mmeVuilTlmWC2ps8vFkxJPqyehltp3h92LPutr0PuE+vdt32o7AOqHFozN7I8
3KI5y+CoQy1XE8w3d+xEmClPMwhviIZYRcDUoq4IFI7LjHGtUHpISwDx4/21mjTMyDc6q
ISC+6PBBW6iqbGTcv0XZTGRxULhtkxrJ4qk/FlHGwP/5mwKyqOapWHS1nbufHkf5fhR8
BviurnNQHPwhIUXJpbieJGRS+aDvw/zIfG49MhHKESbttHhgGaZmResmxyWUlrDCrYY8
xYnBKhn7Z/ohR2IRz7U8yO8oRQbSj6FU5GOMknFXhbDSIR/FK05TnioDuc5mNTk0Vvs
oSsmmg==",
}
]]>
异步返回参数列表
| 参数名称 |
参数中文名称 |
参数说明 |
| merchantId |
商户编号 |
同请求参数 |
| walletId |
钱包 ID |
同请求参数 |
| serialNumber |
交易流水号 |
首信易支付系统订单流水号 |
| orderStatus |
订单状态 |
SUCCESS 支付成功 |
| FAILED 失败 |
| CANCEL取消 |
| barCodeType |
条码类型 |
DC 动态码 |
| SC 静态码 |
| 当为静态码时需要调“支付确认接口”上送支付金额 |
| errorMessage |
订单错误信息 |
只有订单状态失败时返回此参数 |
| amount |
订单金额 |
当条码类型为“动态码”时，返回该参数，订单金额，单位：分，1元=100分 |
| productDetails |
商品信息 |
JSON[数组]，详见商品信息表 |
| merchantInfo |
收单商户信息 |
JSON，详见收单商户信息表 |
| createDateTime |
创建时间 |
密码确认下单时间， 格式：yyyy-MM-dd HH:mm:ss |
| completeDateTime |
完成时间 |
密码确认完成时间， 格式：yyyy-MM-dd HH:mm:ss |
| hmac |
参数签名 |
商户生成的参数签名结果，获取hmac的方法请参考请求加密流程 |
productDetails 商品信息
| 参数名称 |
参数中文名称 |
参数说明 |
| productName |
商品名称 |
商品名称 |
| quantity |
商品数量 |
商品数量 |
| amount |
商品单价 |
单位：分，1元=100分 |
merchantInfo 收单商户信息
| 参数名称 |
参数中文名称 |
参数说明 |
| shortName |
收单商户简称 |
收单商户简称 |
| platformName |
平台简称 |
平台简称 |
参数示例
<![CDATA[
{
"orderStatus":"SUCCESS",
"merchantId":"890000595",
"requestId":"1571654460635",
"serialNumber":"12345678",
"walletId":"11111111"
"createDateTime":"2019-10-21 18:41:17",
"completeDateTime":"2019-10-21 18:51:17",
"hmac":"IpsfuWXscJCvcSCMtHbDZIqpFwG+TcvD3tLVbuZGflIbBv7DDigsYARc2h7b6oR
Oec/9DKb41CqYWw2E7IegMj+OmDRUZOF6pXgNE8l7sAW+68UKJ4xKOFRCyqmw4H
HZaxh7An5Ml/IYI1pfUYyAVSfaQGdnef4CTdkq+JJfBTjB2BED6CE0sCBEtWE7eT/bOYE
+Ha1wlVhpbBxRG8/301QK5WtVh8l5whsdqDw+WqqEw5DMoxpBopZfrF8oxqNA/6/Fzb/
ZApUG4rwzRfFXBQaGQHZVe+JFTuOoXfDhPrdqT5Qhm6i2OZindeHx2Q0YoCxMNKu9f
YIupX1Vw53Stg=="
}
]]>