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