5.4 快捷支付申请接口

参数

参数名称

取值

可空

最大长度

备注

cusid

商户号

平台分配的商户号

否

15

appid

应用ID

平台分配的APPID

否

8

version

版本号

接口版本号

可

2

默认填12

randomstr

随机字符串

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

否

32

用于签名

orderid

商户订单号

否

32

agreeid

协议编号

否

32

签约返回

amount

订单金额

否

20

单位分

currency

币种

否

8

暂只支持CNY

subject

订单内容

订单的展示标题

否

100

validtime

有效时间

订单有效时间

是

-

最大1440分钟

trxreserve

交易备注

用于用户订单个性化信息

交易完成通知会带上本字段

是

160

notifyurl

交易结果通知地址

接收交易结果通知回调地址，通知url必须为直接可访问的url，不能携带参数。

否

256

asinfo

分账信息

格式:

cusid:type:amount;cusid:type:amount…

其中

cusid:接收分账的通联商户号

type分账类型（01：按金额 02：按比率）

如果分账类型为02，则分账比率为0.5表示50%。如果分账类型为01，则分账金额以元为单位表示

是

1024

开通此业务需开通分账配置

terminfo

终端信息

终端信息的json字符串

详见终端字段说明

是

-

mktinfo

营销信息

List<MktUseInfo>的json字符串

是

-

signtype

签名方式

枚举值：

RSA

RSA2

SM2

否

8

sign

签名

否

--

详见收银宝签名规范

参数

参数名称

取值

可空

最大长度

备注

opeid

营销活动发起方id

否

32

基础营销分配，一般等于orgid或者cusid

mkt_appid

营销平台appid

是

8

营销平台的appid，一般与交易appid一致，

远端模式必填

userid

营销平台用户编号

是

32

营销平台用户编号

out_userid

商户用户编号

是

32

商户平台用户编号，远端模式必填

dcinfo_list

交易立减核销信息

Array[DcInfo]

否

-

参数

参数名称

取值

可空

最大长度

备注

actid

营销活动id

在基础营销平台创建的营销活动id

否

32

remark

备注

预留

可

128

字段ID

字段名称

取值

可空

最大长度

备注

retcode

返回码

SUCCESS-请求成功

FAIL-请求失败

SYSTEMERR-系统处理异常，请发起查询

PARAMERR-参数错误

SIGNAUTHERR-签名失败

否

16

此字段是通信标识，非交易结果

retmsg

返回码说明

可

100

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

orderid

商户订单号

否

32

trxstatus

交易状态

交易的状态,

0000:交易成功,交易流程完成

其余详看说明

否

4

详见3.1

errmsg

错误原因

失败的原因说明

是

100

trxid

交易单号

平台的交易流水号

否

20

交易成功返回

chnltrxid

渠道平台交易单号

是

50

交易成功返回

fintime

交易完成时间

yyyyMMddHHmmss

是

14

交易成功返回

thpinfo

交易透传信息

是

-

支付确认时需原样带上本字段信息

sign

签名

否

32