测试地址:http://116.228.64.55:28082/yst-service-api/tx/handle
生产地址:https://ibsapi.allinpay.com/yst-service-api/tx/handle
接口代码(transCode):2094
接口功能说明:
1.新增【储值卡订单核销】接口,用于储值卡订单核销,新增支持多收款人及分账功能;调用本接口,将平台应用储值卡资金核销到收款方 ;
2.储值卡订单核销不支持调用【订单关闭】接口,进行订单关闭;
3.针对交易成功的储值卡核销订单,可调用【退款申请】接口进行退款,支持全额退款、部分退款;
4.储值卡订单核销成功/失败都会发送异步通知;
5.该接口适用场景需向业管申请,目前行业版产品:“融易充”面向共享行业的“四轮充电/二轮充电”场景已开放使用。
业务请求参数
字段 | 字段类型 | 字段长度 | 必填 | 字段名称 | 说明 |
---|---|---|---|---|---|
reqTraceNum |
String |
50 |
是 |
商户订单号 |
|
receiverList |
JSONArray |
|
是 |
收款人列表 |
储值卡核销收款人列表 |
respUrl |
String |
256 |
是 |
后台通知地址 |
|
remark |
String |
100 |
否 |
备注 |
|
extendParams |
String |
200 |
否 |
扩展参数 |
业务响应参数
字段 | 字段类型 | 字段长度 | 必填 | 字段名称 | 说明 |
---|---|---|---|---|---|
result |
String |
1 |
否 |
订单状态 |
|
reqTraceNum |
String |
50 |
是 |
商户订单号 |
|
respTraceNum |
String |
40 |
是 |
通联订单号 |
|
extendParams |
String |
200 |
否 |
扩展参数 |
|
respCode |
String |
5 |
是 |
业务返回码 |
|
respMsg |
String |
200 |
是 |
业务返回说明 |
|
储值卡核销收款人列表
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
signNum |
String |
是 |
商户会员编号-收款方 |
|
amount |
Long |
是 |
核销金额 |
单位:分 |
couponAmount |
Long |
否 |
平台抽佣金额 |
平台抽佣金额,单位:分; 内扣,如金额=100,平台抽佣金额=2,实际到账金额为98 |
sepDetail |
JSONArray |
否 |
储值卡核销分账人列表 |
内扣。 支持分账到会员账户。 |
储值卡核销分账人列表
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
signNum |
String |
是 |
商户会员编号-分账收款人 |
商户系统用户标识,商户系统中唯一编号。 |
amount |
Long |
是 |
分账金额 |
金额,单位:分 |
remark |
String |
否 |
备注 |
备注,最长50个字符 |