3.1统一扫码

字段ID

字段名称

取值

可空

最大长度

备注

appid

应用ID

平台分配的APPID

否

20

orgid

机构ID

实际交易的机构ID

是

11

服务商appid调用时必填

cusid

商户号

实际交易的店铺ID

否

11

version

版本号

接口版本号

是

2

默认填11

randomstr

随机字符串

商户自行生成的随机字符串

否

32

trxamt

交易金额

单位为分

否

15

reqsn

商户交易单号

商户的交易订单号

否

64

保证商户平台唯一

body

订单标题

订单商品名称，为空则以商户名作为商品名称

是

100

最大100个字节(50个中文字符)

remark

备注

备注信息

是

160

禁止出现+，空格，/，?，%，#，&，=这几类特殊符号

authcode

支付授权码

如微信,支付宝,银联的付款二维码

否

32

limit_pay

支付限制

no_credit--指定不能使用信用卡支付

是

32

暂时只对微信支付和支付宝,支付宝支付有效,仅支持no_credit

goods_tag

订单优惠标记

订单优惠标记，用于区分订单是否可以享受优惠，字段内容在微信后台配置券时进行设置，说明详见代金券或立减优惠

是

32

 只对微信支付有效

benefitdetail

优惠信息

Benefitdetail的json字符串,注意是String
填写格式详见附录5.8

是

-

微信单品优惠
支付宝智慧门店
银联云闪付单品优惠

sub_appid

微信子appid

微信小程序/微信公众号/APP的appid

是

32

只对微信支付有效

chnlstoreid

渠道门店编号

商户在支付渠道端的门店编号

例如
对于支付宝支付，支付宝门店编号
对于微信支付，微信门店编号

subbranch

门店号

是

4

收银宝门店号

idno

证件号

实名交易必填.填了此字段就会验证证件号和姓名

是

32

暂只支持支付宝

extendparams

拓展参数

json字符串，注意是String
一般用于渠道的活动参数填写

是

参考4.5拓展参数附录说明

truename

付款人真实姓名

实名交易必填.填了此字段就会验证证件号和姓名

是

32

暂只支持支付宝

asinfo

分账信息

上送分账信息，json字符串

是

1024

参照附录4.7asinfo字段说明

fqnum

花呗分期

6-花呗分期6期
12-花呗分期12期

是

4

暂只支持支付宝花呗分期

notify_url

交易结果通知地址

接收交易结果的通知回调地址，通知url必须为直接可访问的url，不能携带参数。
https只支持默认端口

是

256

若使用https,需使用默认443端口

signtype

签名方式

是

8

支持MD5、RSA、SM2，不填默认MD5

sign

签名

详见安全规范

否

32

terminfo

终端信息

终端信息的json字符串
详见附录4.6终端字段说明

否

200

membertype

会员账户类型

是

2

1-手机号

2-会员卡号

3-Openid

4-会员动态码

5-外部会员ID

6-内部会员ID

memberid

会员账户

是

180

inaccountflag

入金账户标识

0-余额户

1-储值卡专用户

是

2

不送默认0

splitflag

分账标识

否

2

1-自动分账，默认1

2-不分账

3-延时分账/收款

若上送2时，忽略接口上送的asinfo；若上送3，则必须调用“3.21分账/收款确认”接口完成分账或收款入账。

字段ID

字段名称

取值

可空

最大长度

备注

retcode

返回码

SUCCESS/FAIL

否

8

此字段是通信标识，非交易结果，交易是否成功需要查看trxstatus来判断

retmsg

返回码说明

是

100

以下信息只有当retcode为SUCCESS时有返回

cusid

商户号

实际交易的店铺ID

否

11

appid

应用ID

平台分配的APPID

否

20

orgid

机构ID

实际交易的机构ID

否

11

trxid

交易单号

收银宝平台的交易流水号

是

20

chnltrxid

渠道平台交易单号

例如微信,支付宝平台的交易单号

是

50

reqsn

商户交易单号

商户的交易订单号

否

64

trxstatus

交易状态

交易的状态,对于刷卡支付，该状态表示实际的支付结果，其他为下单状态

否

4

详见交易返回码说明

acct

支付平台用户标识

 微信支付-用户的微信openid
支付宝支付-用户user_id

是

32

如果为空,则默认填000000

trxcode

交易类型

交易类型

否

8

见交易类型

fintime

交易完成时间

yyyyMMddHHmmss

是

14

errmsg

错误原因

失败的原因说明

是

100

randomstr

随机字符串

随机生成的字符串

否

32

initamt

原交易金额

是

15

与请求字段trxamt值一致，单位：分

trxamt

实际交易金额

是

15

用于区分优惠活动的金额，单位：分

fee

手续费

是

15

单位：分

cmid

渠道子商户号

是

32

限微信/支付宝交易响应

chnlid

渠道号

是

32

限微信交易响应

chnldata

渠道信息

目前返回云闪付/微信/支付宝的活动参数

是

-

限交易参与活动

accttype

借贷标识

是

2

00-借记卡
02-信用卡
99-其他（花呗/余额等）

sign

签名

否

32

详见安全规范

balanceamount

余额抵扣金额

是

20

单位：分

score

积分抵扣数量

是

11

scoreamount

积分抵扣金额

是

20

单位：分

bankscore

银行积分抵扣数量

是

11

bankscoreamount

银行积分抵扣金额

是

20

单位：分

givescore

返积分数

是

11

givecouponnum

返券张数

是

11

mchtdiscountamount

商户优惠汇总金额

商户积分、余额、卡券优惠抵扣金额，银行活动商户分摊金额

否

14

单位：分

bankdiscountamount

银行补贴汇总金额

银行活动银行分摊金额

否

14

单位：分

consumecouponlist

数字营销系统用券列表，ArrayList

promotionid

活动编号

是

11

couponno

券号

是

32

coupontype

券类型

是

2

couponname

券名称

是

50

consumeamount

抵扣金额

是

20

单位：分

banksubsidyamount

银行补贴金额

是

20

单位：分