VOID
约 699 字大约 2 分钟
2025-03-07
对于支持单独Capture(捕获)的支付方式(如国际信用卡支付),支付过程分为两个步骤完成:
- Authorization:验证购物者的支付细节与发行方,并预留资金。
- CAPTURE:将预留的资金从购物者转移到您的账户。
Void:如果您Authorization 成功,但不想操作CAPTURE,可以发起void操作。 void通常指取消一笔已经授权但尚未捕获的支付。此操作会释放之前预留的资金,确保资金不会从购物者的账户中扣除。这与退款不同,退款是针对已经捕获的资金进行的。 void是支付领域中常见的一种"修改"操作,它直接影响到已授权或已捕获的支付的状态。
发起VOID
对于AUTH_SUCCESS状态的订单可以通过调用VOID-预授权撤销API发起VOID操作,为了接收VOID的异步通知请设置notificationUrl。报文内容详见预授权撤销异步通知
提示
当您的交易无法确认是否已经CAPTURE的情况,您可以调用单笔交易查询
处理VOID操作的状态
调用VOID-预授权撤销API后,在同步响应中您可能会收到status可选值:
SUCCESS-成功FAILED-失败PROCESSING-进行中
为了处理PROCESSING的情况,您需要在调用VOID-预授权撤销API时,正确设置notificationUrl,以便于正确收到预授权撤销异步通知
提示
当您收不到异步通知或者无法确认状态的情况,您可以调用预授权撤销查询
多次VOID
CAPTURE-预授权权确认 API 根据merchantVoidId幂等,您可以安全的多次调用。
提示
目前暂不支持部分VOID,VOID的总金额必须等于交易金额
- 当
merchantVoidId相同时候,重新调用VOID-预授权撤销 API,您将会获取到查询结果。 - 当您调用VOID-预授权撤销 API失败需要重试时候,您需要更新
merchantVoidId重新发起请求。
