3.8统一支付

参数

参数名称

取值

可空

最大长度

备注

appid

应用ID

平台分配的APPID

否

20

orgid

机构ID

实际交易的机构ID

是

11

服务商appid调用时必填

cusid

商户号

实际交易的店铺ID

否

11

version

版本号

接口版本号

可

2

默认填11

trxamt

交易金额

单位为分

否

15

reqsn

商户交易单号

商户的交易订单号

否

64

保证商户平台唯一

paytype

交易方式

详见附录交易方式

否

3

randomstr

随机字符串

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

否

32

body

订单标题

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

是

100

最大100个字节(注：utf8下，一个中文字符是3个字节)

remark

备注

备注信息

是

160

最大160个字节(80个中文字符)
禁止出现+，空格，/，?，%，#，&，=这几类特殊符号

validtime

有效时间

订单有效时间，以分为单位，不填默认为5分钟

是

4

最大1440分钟

acct

支付平台用户标识

JS支付时使用
微信支付-用户的微信openid
支付宝支付-用户user_id
微信小程序-用户小程序的openid
云闪付JS-用户userId

是

32

notify_url

交易结果通知地址

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

是

256

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

limit_pay

支付限制

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

是

32

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

sub_appid

微信子appid

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

是

32

只对微信支付有效

goods_tag

订单优惠标识

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

是

32

只对微信支付有效
W01交易方式不支持

benefitdetail

优惠信息

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

-

微信单品优惠
W01交易方式不支持
支付宝智慧门店
支付宝单品优惠

chnlstoreid

渠道门店编号

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

是

例如：
对于支付宝支付，支付宝门店编号
对于微信支付，微信门店编号
W01交易方式不支持

subbranch

门店号

是

4

 通联系统门店号

extendparams

拓展参数

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

是

参考5.9拓展参数附录说明

cusip

终端ip

用户下单和调起支付的终端ip地址

是

16

payType=U02云闪付JS支付不为空

front_url

支付完成跳转

必须为https协议地址，且不允许带参数

是

128

只支持payType=U02云闪付JS支付
payType=W02微信JS支付

idno

证件号

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

是

32

暂只支持支付宝支付,微信支付(微信支付的刷卡支付除外)

truename

付款人真实姓名

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

是

32

暂只支持支付宝支付,微信支付(微信支付的刷卡支付除外)

asinfo

分账信息

上送分账信息，json字符串

是

1024

参照附录4.7asinfo字段说明

fqnum

分期

3  花呗分期3期
6  花呗分期6期
12  花呗分期12期
3-cc 支付宝信用卡分期3期
6-cc 支付宝信用卡分期6期
12-cc 支付宝信用卡分期12期

是

8

暂只支持支付宝花呗分期,支付宝信用卡分期
仅支持A01/A02

signtype

签名方式

是

8

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

unpid

银联pid

仅支持代理商/服务商角色调用

sign

签名

详见安全规范

否

32

terminfo

终端信息

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

是

200

paytype=A04,W04,U04时，terminfo字段必填

operatorid

收银员号

是

20

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分账/收款确认”接口完成分账或收款入账。

W01|A01|S01

W02|A02|U02

A03|S03

W06

动态码CSB支付

JSAPI支付

支付宝APP支付

微信小程序支付

acct

M

M

notify_url

M

M

M

M

sub_appid

M

M

idno

仅实名支付需要

truename

asinfo

仅分账支付需要

字段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

randomstr

随机字符串

随机生成的字符串

否

32

trxstatus

交易状态

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

否

4

详见交易返回码说明

fintime

交易完成时间

yyyyMMddHHmmss

是

14

对于微信刷卡支付有效

errmsg

错误原因

失败的原因说明

是

100

payinfo

支付串

扫码支付则返回二维码串，js支付则返回json字符串
QQ钱包及云闪付的JS支付返回支付的链接,商户只需跳转到此链接即可完成支付
支付宝App支付返回支付信息串；

聚合支付返回支付链接，跳转到此链接进行支付；

小程序聚合支付返回json串，商户小程序跳转至appid小程序的paypath进行支付

是

不限

sign

签名

否

32

详见安全规范

mchtdiscountamount

商户优惠汇总金额

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

否

14

单位：分

bankdiscountamount

银行补贴汇总金额

银行活动银行分摊金额

否

14

单位：分

参数

参数名称

取值

appid

应用ID

平台分配的应用ID

cusid

商户号

平台分配的商户号

cusorderid

商户订单号

交易上送的订单号(reqsn)

trxcode

交易类型

见附录：交易类型说明

trxid

通联交易流水号

通联系统内唯一

trxamt

交易金额

分为单位

trxdate

交易请求日期

yyyyMMdd

paytime

交易完成时间

yyyyMMddHHmmss

trxstatus

交易状态

见附录：交易状态说明

trxreserved

交易备注

返回商品号(goodsid)

sign

签名信息

详见接口规则：安全规范

参数

参数名称

取值

appid

应用ID

平台分配的应用ID

cusid

商户号

平台分配的商户号

reqsn

商户订单号

交易上送的订单号(reqsn)

trxid

通联交易流水号

通联系统内唯一

trxamt

交易金额

分为单位

remark

交易备注

randomstr

随机串

sign

签名信息

详见安全规范