2.16【扫码预消费完成】


测试地址: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

 

业务返回说明

 

maxy2 2025年9月24日 15:29 收藏文档