4.15统一主扫API


接口地址: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

详见安全规范


yinjr 2025年5月16日 16:49 收藏文档