测试地址:https://ibstest.allinpay.com/yst/yst-service-api/tx/handle
生产地址:https://ibsapi.allinpay.com/yst-service-api/tx/handle
接口代码(transCode):2087
功能说明:
针对资金管理模式为交易处理、银行托管和账后结算的应用,支持发起扫码预消费交易及扫码预消费完成交易。
针对成功的扫码预消费交易进行预消费完成,剩余金额会自动发起回退,回退至消费者原账户。
- 支持全部完成和部分完成
- 支持一笔扫码预消费订单发起多次预消费完成申请:
- 控制同一笔扫码预消费完成的完成订单金额≤原预消费订单金额。(当且仅当上一笔预消费完成后,才允许进行下一笔预消费完成)
- 累计支付金额≤原订单支付金额,累计营销金额≤原订单营销金额
业务请求参数
字段 |
字段类型 |
必填 |
字段长度 |
字段名称 |
说明 |
reqTraceNum |
String |
是 |
32 |
商户订单号 |
本次扫码预消费完成交易的请求单号 |
orderAmount |
Long |
是 |
16 |
完成订单金额 |
单位:分 需要确认完成的订单金额 完成订单金额=完成支付金额 |
payAmount |
Long |
否 |
20 |
完成支付金额 |
单位:分 渠道实际确认完成的支付金额 |
orgReqTraceNum |
String |
否 |
32 |
原预消费商户订单号 |
原扫码预消费的商户订单号+日期、通联订单号,二选一上送 |
oriTransDate |
String |
否 |
|
原预消费日期 |
|
orgRespTraceNum |
String |
否 |
|
原预消费通联订单号 |
|
autoBack |
String |
否 |
1 |
是否回退标志 |
0:不自动发起回退 1:自动发起回退 不填:默认为1 |
业务响应参数
字段 |
字段类型 |
必填 |
字段长度 |
字段名称 |
说明 |
reqTraceNum |
String |
是 |
32 |
商户订单号 |
|
respTraceNum |
String |
是 |
32 |
通联订单号 |
|
result |
String |
否 |
|
订单状态 |
枚举值: 0:进行中 1:交易成功 2:交易失败 |
respCode |
String |
是 |
|
业务返回码 |
00000:代表成功 66666、66667:处理中,即当前的请求已受理,需要继续调用关联的确认类接口,或通过发起订单查询、等待异步通知,来获取处理状态。 其他返回码:均代表失败 |
respMsg |
String |
是 |
|
业务返回说明 |