生产地址:https://vsp.allinpay.com/apiweb/unionc2b/frontorder
测试地址:https://syb-test.allinpay.com/apiweb/unionc2b/frontorder
使用场景:
C2B订单支付前端模式,商户调用接口下单后,跳转到下单返回的url完成支付
请求参数:
|
参数 |
参数名称 |
取值 |
可空 |
最大长度 |
备注 |
|
orgid |
机构号 |
平台分配的集团号/代理商号 |
是 |
15 |
|
|
cusid |
商户号 |
平台分配的商户号 |
否 |
15 |
|
|
appid |
应用ID |
平台分配的APPID |
否 |
8 |
|
|
version |
版本号 |
接口版本号 |
可 |
2 |
默认填12 |
|
trxamt |
交易金额 |
单位为分 |
否 |
15 |
|
|
reqsn |
商户交易单号 |
商户的交易订单号 |
否 |
32 |
保证商户平台唯一 |
|
body |
订单标题 |
订单商品名称,为空则以商户名作为商品名称 |
否 |
100 |
最大100个字节(50个中文字符) |
|
remark |
业务备注信息 |
在交易结果通知接口原样带回 |
是 |
160 |
最大300个字节(150个中文字符) |
|
validtime |
有效时间 |
订单有效时间,以分为单位 |
否 |
8 |
最大1440 |
|
acctno |
付款帐号 |
SM4加密传输 |
是 |
128 |
指定卡号支付必填 |
|
acctname |
付款户名 |
SM4加密传输 |
是 |
128 |
指定卡号支付必填 |
|
idtype |
证件类型 |
|
是 |
1 |
|
|
idno |
证件号 |
SM4加密传输 |
是 |
128 |
|
|
mobile |
手机号码 |
SM4加密传输 |
是 |
128 |
|
|
apptype |
应用类型 |
01 商户 APP 02 商户微信小程序 08 商户微信公众号 |
否 |
2 |
|
|
appname |
应用名称, |
如果应用类型是01,则填APP的包名,必填 |
是 |
100 |
|
|
apppath |
回调应用路径 |
如果应用类型是01,则填应用的scheme,必填 |
是 |
100 |
|
|
notify_url |
交易结果通知地址 |
接收异步通知回调地址,通知url必须为直接可访问的url,不能携带参数。 |
是 |
256 |
|
|
randomstr |
随机字符串 |
商户自行生成的随机字符串 |
否 |
32 |
|
|
signtype |
签名方式 |
|
是 |
8 |
RSA RSA2 SM2 |
|
sign |
签名 |
详见安全规范 |
否 |
32 |
|
响应参数:
|
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
|
retcode |
返回码 |
SUCCESS/FAIL
|
否 |
8 |
此字段是通信标识,非交易结果,交易是否成功需要查看trxstatus来判断 |
|
retmsg |
返回码说明 |
|
是 |
100 |
|
|
以下信息只有当retcode为SUCCESS时有返回 |
|||||
|
cusid |
商户号 |
平台分配的商户号 |
否 |
15 |
|
|
appid |
应用ID |
平台分配的APPID |
否 |
8 |
|
|
trxid |
交易单号 |
收银宝平台的交易流水号 |
否 |
20 |
|
|
reqsn |
商户交易单号 |
商户的交易订单号 |
否 |
32 |
|
|
randomstr |
随机字符串 |
随机生成的字符串 |
否 |
32 |
|
|
trxstatus |
交易状态 |
2000-下单成功,请查询交易 2008-交易异常,请查询 3开头-交易失败,具体查看errmsg |
否 |
4 |
|
|
payinfo |
|
|
|
|
|
|
errmsg |
错误原因 |
失败的原因说明 |
是 |
100 |
|
|
sign |
签名 |
|
否 |
32 |
详见安全规范 |