4.2.1业务订单扣款


接口地址:https://vsp.allinpay.com/apiweb/zhimacredit/pay
测试地址:https://test.allinpaygd.com/apiweb/zhimacredit/pay
使用场景:
业务单完成后调用此接口进行扣款

请求参数:

参数 参数名称 取值 可空 最大长度 备注
cusid 商户号 平台分配的商户号 15  
appid 应用ID 平台分配的APPID 8  
version 版本号 接口版本号 2 默认填12
randomstr 随机字符串 商户自行生成的随机字符串 32  
trxamt 交易金额 单位为分 15  
reqsn 商户交易单号 商户的交易订单号 32 保证商户平台唯一
body 订单标题

订单商品名称

为空则以商户名作为商品名称

100

最大100个字节

(50个中文字符)

remark 备注 备注信息 160  
asinfo 分账信息

格式:

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

其中

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

type分账类型(01:按金额 02:按比率)

如果分账类型为02,则分账比率为0.5表示50%

如果分账类型为01,则分账金额以元为单位表示

1024 开通此业务需开通分账配置
extendparams 扩展参数

Extendparams实体的json字符串,注意是String

同时上送业务trade_component_order_id(即orderid)

tc_installment_order_id(即installment_order_id)

agreement_no

-

 

 

signtype 签名方式   8

RSA

RSA2

SM2

terminfo 终端信息

终端信息的json字符串

详见附录5.5终端字段说明

200  
validtime 有效时间 以分为单位,不填默认30天     最大30天
sign 签名 详见安全规范 32  

extendparams样例:

{"tc_installment_order_id":"2024070301502301900008830002118326","agreement_no":"20245425175068923888","trade_component_order_id":"2024070301502300000008830032212281"}

响应参数:

字段ID 字段名称 取值 可空 最大长度 备注
retcode 返回码 SUCCESS/FAIL 8

此字段是通信标识

非交易结果

交易是否成功需要查看trxstatus来判断

retmsg 返回码说明   100  
以下信息只有当retcode为SUCCESS时有返回
cusid 商户号 平台分配的商户号 15  
appid 应用ID 平台分配的APPID 8  
trxid 交易单号 收银宝平台的交易流水号 20  
chnltrxid 渠道平台交易单号 例如微信,支付宝平台的交易单号 50  
reqsn 商户交易单号 商户的交易订单号 32  
trxstatus 交易状态

交易的状态,对于刷卡支付,

该状态表示实际的支付结果

其他为下单状态

4 详见附录
errmsg 错误原因 失败的原因说明 100  
acct 支付平台用户标识

支付宝支付-用户user_id

32 如果为空,则默认填000000
chnltrxid 支付渠道交易单号 如支付宝,微信平台的交易单号 50  
trxcode 交易类型 交易类型 8 见附录
fintime 交易完成时间 yyyyMMddHHmmss 14  
cmid 渠道子商户号   32

支付宝

chnlid 渠道商号   32  
chnlextendparams 渠道扩展字段

一般用于渠道的活动参数填写

填写规则详看附录

-  
randomstr 随机字符串 随机生成的字符串 32  
sign 签名   32  

yinjr 2024年10月25日 09:06 收藏文档