2.2分账服务

交易分账

接口地址：
生产：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	详见安全规范

交易分账回退

接口地址：

生产：https://vsp.allinpay.com/apiweb/trxshare/revoke

测试：https://syb-test.allinpay.com/apiweb/trxshare/revoke

使用场景：

用于交易分账接口的分账交易进行回退，可多次回退，回退总金额不能超过分账金额。

一次分账回退产生两笔交易，分账入金商户（即分账发起的商户）产生一笔入金交易，分账出金方产生一笔出金交易

如果入金方需要对账的，请上送payerreqsn(出金商户流水)

请求参数：

参数	参数名称	取值	可空	最大长度	备注
orgid	机构号	通联分配的机构号例如代理商号，集团商户号	否	15
appid	应用ID	对接的APPID	否	8
cusid	商户号	出金商户号	否	15
version	版本号	接口版本号	可	2	默认填12
randomstr	随机字符串	随机生成的字符串	否	32
signtype	签名方式		是	8	RSA RSA2 SM2
sign	签名		否	32	详见安全规范
payertrxid	出金交易单号	分账成功的出金方通联交易单号	否	20
reqsn	回退流水号	商户平台的分账回退流水号两个自然日内唯一	否	32
payerreqsn	出金方回退流水号	出金方商户的分账回退流水用于对账，可空	是	32	回退的出金方即原分账交易的入金方
trxamt	回退金额	单位：分	否	15
remark	备注	业务备注	否	100	最大50个文字

响应参数：

字段ID	字段名称	取值	可空	最大长度	备注
retcode	返回码	SUCCESS/FAIL	否	8	此字段是通信标识，非最终结果
retmsg	返回码说明		是	100
以下信息只有当retcode为SUCCESS时有返回
cusid	商户号	平台分配的商户号	否	15
appid	应用ID	平台分配的APPID	否	8
rktrxid	回退交易单号	通联平台的入金方回退交易流水号	否	20
payertrxid	回退出金交易单号	通联平台的出金方回退交易流水号	否	18	回退的出金方即原分账交易的入金方
reqsn	回退流水号	商户的回退流水号	否	32
trxstatus	交易状态	交易的状态, 0000-交易成功 2000，2008-需查询 3开头错误码-交易失败，详情查看错误信息	否	4	详见附录
errmsg	错误原因	失败的原因说明	是	100
trxcode	交易类型	交易类型	否	8	见附录
fintime	交易完成时间	yyyyMMddHHmmss	是	14
randomstr	随机字符串	随机生成的字符串	否	32
sign	签名		否	32	详见安全规范

分账交易查询

接口地址：

生产：https://vsp.allinpay.com/apiweb/trxshare/query

测试：https://syb-test.allinpay.com/apiweb/trxshare/query

使用场景：

查询分账交易结果

请求参数：

参数	参数名称	取值	可空	最大长度	备注
orgid	机构号	通联分配的机构号例如代理商号，集团商户号	否	15
appid	应用ID	对接的APPID	否	8
cusid	商户号	出金商户号	否	15
version	版本号	接口版本号	可	2	默认填12
randomstr	随机字符串	随机生成的字符串	否	32
signtype	签名方式		是	8	RSA RSA2 SM2
payertrxid	出金交易单号	分账成功的出金方通联交易单号	是	20	reqsn和payertrxi必填其一建议:商户如果同时拥有trxid和reqsn,优先使用trxid
reqsn	分账流水号	商户平台的分账流水号	是	32
sign	签名		否	32	详见安全规范

响应参数：

字段ID	字段名称	取值	可空	最大长度	备注
retcode	返回码	SUCCESS/FAIL	否	8	此字段是通信标识，非最终结果
retmsg	返回码说明		是	100
以下信息只有当retcode为SUCCESS时有返回
cusid	商户号	平台分配的商户号	否	15
appid	应用ID	平台分配的APPID	否	8
payertrxid	出金交易单号	分账成功的出金方通联交易单号	否	20
reqsn	商户交易单号	商户的交易订单号	否	32
trxamt	分账金额	单位为分	否	16
trxstatus	交易状态	交易的状态, 0000-交易成功 2000，2008-需查询 3开头错误码-交易失败，详情查看错误信息	否	4	详见附录
errmsg	错误原因	失败的原因说明	是	100
payeecusid	入金商户号		否	15
trxcode	交易类型	交易类型	否	8	见附录
fintime	交易完成时间	yyyyMMddHHmmss	是	14
randomstr	随机字符串	随机生成的字符串	否	32
sign	签名		否	32	详见安全规范

分账回退交易查询

接口地址：

生产：https://vsp.allinpay.com/apiweb/trxshare/revokequery

测试：https://syb-test.allinpay.com/apiweb/trxshare/revokequery

使用场景：

查询分账回退交易结果

请求参数：

参数	参数名称	取值	可空	最大长度	备注
orgid	机构号	通联分配的机构号例如代理商号，集团商户号	否	15
appid	应用ID	对接的APPID	否	8
cusid	商户号	入金商户号	否	15
version	版本号	接口版本号	可	2	默认填12
randomstr	随机字符串	随机生成的字符串	否	32
signtype	签名方式		是	8	RSA RSA2 SM2
rktrxid	分账回退交易单号	通联分账回退交易单号	是	20	reqsn和trxid必填其一建议:商户如果同时拥有trxid和reqsn,优先使用trxid
reqsn	分账回退流水号	商户平台的分账回退流水号	是	32
sign	签名		否	32	详见安全规范

响应参数：

字段ID	字段名称	取值	可空	最大长度	备注
retcode	返回码	SUCCESS/FAIL	否	8	此字段是通信标识，非最终结果
retmsg	返回码说明		是	100
以下信息只有当retcode为SUCCESS时有返回
cusid	商户号	平台分配的商户号	否	15
appid	应用ID	平台分配的APPID	否	8
rktrxid	回退交易单号	通联平台的入金方回退交易流水号	否	20
reqsn	分账回退流水号	商户平台的分账回退流水号	否	32
trxamt	回退金额	单位为分	否	16
trxstatus	交易状态	交易的状态, 0000-交易成功 2000，2008-需查询 3开头错误码-交易失败，详情查看错误信息	否	4	详见附录
errmsg	错误原因	失败的原因说明	是	100
payercusid	出金商户号		否	15
trxcode	交易类型	交易类型	否	8	见附录
fintime	交易完成时间	yyyyMMddHHmmss	是	14
randomstr	随机字符串	随机生成的字符串	否	32
sign	签名		否	32	详见安全规范

2.2分账服务

目录

交易分账

交易分账回退

分账交易查询

分账回退交易查询