接口地址:https://vsp.allinpay.com/apiweb/unitorder/nativepay
测试地址:https://syb-test.allinpay.com/apiweb/unitorder/nativepay
使用场景:
调用接口下单成功后,生成含订单信息的收款码,展示给顾客,顾客扫码进行付款.支持微信,支付宝,银联规范app的扫码
1.用户在绝度超时时间内扫码可进行支付,超过超时时间则提示收款码已失效。
2.接口返回的是含订单信息的二维码,在用户未扫码之前(开始支付)平台并未生成订单,此时交易查询返回交易不存在(trxstatus=1001),查询到该状态码,说明用户尚未扫码付款。
3.同一个订单号多次调用接口,如果历史订单尚未超时,金额一致,则新旧二维码都可以扫。超时时间以第一次下单的为准,如果付款当前时间超过了第一次下单超时时间,新旧码都无法支付。如果需要刷新超时时间,请更换订单号或等待原订单超时
如果需要刷新超时时间,请更换订单号或等待原订单超时
请求参数:
参数 |
参数名称 |
取值 |
可空 |
最大长度 |
备注 |
cusid |
商户号 |
平台分配的商户号 |
否 |
15 |
|
appid |
应用ID |
平台分配的APPID |
否 |
8 |
|
version |
版本号 |
接口版本号 |
可 |
2 |
默认填12 |
randomstr |
随机字符串 |
商户自行生成的随机字符串 |
否 |
32 |
|
trxamt |
交易金额 |
单位为分 |
否 |
15 |
|
reqsn |
商户交易单号 |
商户的交易订单号
|
否 |
32 |
保证商户平台唯一 |
body |
订单标题 |
订单商品名称,为空则以商户名作为商品名称 |
是 |
100 |
最大100个字节(50个中文字符) |
remark |
备注 |
备注信息 |
是 |
160 |
|
expiretime |
订单超时时间 |
格式:yyyyMMddHHmmss
|
否 |
14 |
|
subbranch |
门店号 |
|
是 |
4 |
|
limit_pay |
支付限制 |
no_credit--指定不能使用信用卡支付 |
是 |
32 |
暂时只对微信支付和支付宝,支付宝支付有效,仅支持no_credit |
idno |
证件号 |
实名交易必填.填了此字段就会验证证件号和姓名 |
是 |
32 |
暂只支持支付宝 |
truename |
付款人真实姓名 |
实名交易必填.填了此字段就会验证证件号和姓名 |
是 |
32 |
暂只支持支付宝 |
asinfo |
分账信息 |
格式: cusid:type:amount;cusid:type:amount… 其中 cusid:接收分账的通联商户号 type分账类型(01:按金额 02:按比率) 如果分账类型为02,则分账比率为0.5表示50%。如果分账类型为01,则分账金额以元为单位表示 |
是 |
1024 |
开通此业务需开通分账配置 |
goods_tag |
商品标志 |
订单优惠标记,用于区分订单是否可以享受优惠,字段内容在微信后台配置券时进行设置,说明详见代金券或立减优惠 |
是 |
32 |
暂只对微信有效 |
benefitdetail |
优惠信息 |
填写格式详见附录3.5 注意是String |
是 |
- |
微信单品优惠 支付宝智慧门店 |
chnlstoreid |
渠道门店编号 |
商户在支付渠道端的门店编号 |
是 |
|
例如 对于支付宝支付,支付宝门店编号 对于微信支付,微信门店编号
|
fqnum |
花呗分期 |
3-花呗分期3ss期 6-花呗分期6期 12-花呗分期12期 |
是 |
4 |
|
extendparams |
扩展参数 |
Extendparams实体的json字符串,注意是String 一般用于渠道的活动参数填写 详看附录 |
是 |
- |
|
signtype |
签名方式 |
|
是 |
SM2/RSA | |
sign |
签名 |
详见安全规范 |
否 |
32 |
|
响应参数:
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
retcode |
返回码 |
SUCCESS/FAIL
|
否 |
8 |
此字段是通信标识,非交易结果,交易是否成功需要查看trxstatus来判断 |
retmsg |
返回码说明 |
|
是 |
100 |
|
以下信息只有当retcode为SUCCESS时有返回 |
|||||
cusid |
商户号 |
平台分配的商户号 |
否 |
15 |
|
appid |
应用ID |
平台分配的APPID |
否 |
8 |
|
reqsn |
商户交易单号 |
商户的交易订单号 |
否 |
32 |
|
trxstatus |
交易状态 |
交易的状态, 对于刷卡支付,该状态表示实际的支付结果,其他为下单状态 |
否 |
4 |
详见附录 |
errmsg |
错误原因 |
失败的原因说明 |
是 |
100 |
|
payinfo |
支付串 |
扫码支付则返回二维码串,js支付则返回json字符串 App支付返回json串 手Q的JS支付返回支付的链接,商户只需跳转到此链接即可完成支付 |
是 |
不限 |
|
randomstr |
随机字符串 |
随机生成的字符串 |
否 |
32 |
|
sign |
签名 |
|
否 |
32 |
详见安全规范 |