交易分账
接口地址:
生产:https://vsp.allinpay.com/apiweb/trxshare/share
测试:https://syb-test.allinpay.com/apiweb/trxshare/share
使用场景:
用于交易完成后根据交易单号,按照商户与通联之间的分账协议,将收款资金按接口上送比例转到指向商户,分账商户需配置分账授权关系
一次分账产生两笔交易,分账出金商户(即分账发起的商户)产生一笔出金交易,分账入金方(分账接收的商户)产生一笔入金交易
如果入金方需要对账的,请上送payeereqsn(入金商户流水)
请求参数:
参数 |
参数名称 |
取值 |
可空 |
最大长度 |
备注 |
---|---|---|---|---|---|
orgid |
机构号 |
通联分配的机构号 例如代理商号,集团商户号 |
可 |
15 |
|
appid |
应用ID |
对接的APPID |
否 |
8 |
|
cusid |
商户号 |
出金商户号 |
否 |
15 |
|
version |
版本号 |
接口版本号 |
可 |
2 |
默认填12 |
randomstr |
随机字符串 |
随机生成的字符串 |
否 |
32 |
|
signtype |
签名方式 |
|
是 |
8 |
RSA RSA2 SM2
|
sign |
签名 |
|
否 |
32 |
详见安全规范 |
oldtrxid |
交易单号 |
待分账的交易的通联交易单号 |
否 |
20 |
|
reqsn |
分账流水号 |
商户平台的分账流水号 两个自然日内唯一 |
否 |
32 |
|
payeecusid |
入金商户号 |
|
否 |
15 |
|
payeereqsn |
入金商户流水号 |
入金商户的分账入账流水 用于对账,可空 |
是 |
32 |
|
trxamt |
分账金额 |
单位:分 |
否 |
15 |
|
remark |
分账备注 |
业务备注 |
否 |
100 |
最大50个文字 |
响应参数:
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
---|---|---|---|---|---|
retcode |
返回码 |
SUCCESS/FAIL
|
否 |
8 |
此字段是通信标识,非最终结果 |
retmsg |
返回码说明 |
|
是 |
100 |
|
以下信息只有当retcode为SUCCESS时有返回 |
|||||
cusid |
商户号 |
平台分配的商户号 |
否 |
15 |
|
appid |
应用ID |
平台分配的APPID |
否 |
8 |
|
payertrxid |
出金交易单号 |
分账成功的出金方通联交易单号 |
否 |
20 |
|
payeetrxid |
入金商户入金交易单号 |
|
否 |
18 |
|
reqsn |
分账流水号 |
商户的分账流水号 |
否 |
32 |
|
trxstatus |
交易状态 |
交易的状态, 0000-交易成功 2000,2008-需查询 3开头错误码-交易失败,详情查看错误信息 |
否 |
4 |
见附录 |
errmsg |
错误原因 |
失败的原因说明 |
是 |
100 |
|
trxcode |
交易类型 |
交易类型 |
否 |
8 |
见附录 |
fintime |
交易完成时间 |
yyyyMMddHHmmss |
是 |
14 |
|
randomstr |
随机字符串 |
随机生成的字符串 |
否 |
32 |
|
sign |
签名 |
|
否 |
32 |
详见安全规范 |