测试地址:https://ibstest.allinpay.com/yst/yst-service-api/tx/handle
生产地址:https://ibsapi.allinpay.com/yst-service-api/tx/handle
接口代码(transCode):4014
说明:
- 本接口仅支持账后结算模式的应用查询,查询消费交易的剩余可分账金额。
- 剩余可分账金额=订单结算金额(含营销)-订单已确认金额+确认资金已退款金额-营销退款金额-渠道退款金额+原消费交易为日结情况下的退款手续费。
- 针对支付及退款交易直接对接收银宝的应用:
当天发生退款的情况,需应用方自行计算可分账金额:
(1)实际的可分账金额=本接口的响应的“剩余可分账金额”-当日的退款交易+退款的日结手续费。
(2)或在退款交易的D+1 系统对账后,再查询本接口。
业务请求参数
|
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
|
orgRespTraceNum |
String |
40 |
否 |
通联订单号 |
1.“通联订单号”与“商户订单号+订单创建日期”,必传其中一种 2.使用“商户订单号”查询时,必须传“订单创建日期”。 3. 消费交易从收银宝发起的场景,“商户订单号”字段传收银宝的交易号 |
|
orgReqTraceNum |
String |
50 |
否 |
商户订单号 |
|
|
orgTransDate |
String |
8 |
否 |
订单创建日期 格式:yyyyMMdd |
业务响应参数
|
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
|
respCode |
String |
5 |
是 |
业务返回码 |
|
|
respMsg |
String |
200 |
否 |
业务返回说明 |
|
|
ableSepAmount |
Long |
20 |
是 |
剩余可分账金额 |
字段的计算规则见接口说明 |
|
orderAmount |
Long |
20 |
是 |
订单金额 |
消费订单的订单金额 |
|
settAmount |
Long |
20 |
是 |
结算金额 |
消费订单的结算金额 存在营销补贴的情况,则结算金额=营销金额+消费订单的渠道结算金额 |
|
confirmedAmount |
Long |
20 |
是 |
订单已确认金额 |
即【批量分账】/【批量多次分账】的订单金额,从在途转为可用的金额 |
|
confirmedRefundAmount |
Long |
20 |
是 |
确认资金已退款金额 |
|
|
cnlRefundAmount |
Long |
20 |
是 |
渠道退款金额 |
消费交易的渠道退款订单金额 |
|
promotionRefundAmount |
Long |
20 |
是 |
营销退款金额 |
|