---
url: >-
https://acquirer-api-docs-v4-en.pingpongx.com/notes/zh/onlinePayment/auth/index.md
description: >-
PingPongCheckout API
用于处理在线支付中的预授权和捕获流程。适用于需要分阶段处理付款的场景，如商品定制或预定服务。关键步骤包括授权、预授权撤销、预授权撤销查询、预授权请款及预授权请款查询。主要功能通过设置参数如captureDelayHours实现，确保资金在正确时间点从顾客账户
---
## 接口调用说明
接口调用流程：
1. **授权**：预授权交易第一步需要调用 授权请求 创建一笔预授权订单（需要将接口中 captureDelayHours 的值设为 -1）
2. **预授权撤销**：商户调用预授权撤销可以对预授权订单进行撤销处理。如果一个预授权交易被撤销，那么原本预留的资金将被释放回卡主的账户。此操作通常在订单被取消或更改时发生。
3. **预授权撤销查询**：商户调用预授权撤销查询确认预授权交易是否已成功被撤销。商家可以使用此查询来确定预留的资金是否已经被释放回卡主的账户。
4. **预授权请款**：商户调用预授权请款，将触发实际的资金转移，将之前预留的金额从卡主账户转移到商家账户。如果交易未请款，则预先授权的资金将释放回卡主账户。
5. **预授权请款查询**：商家可以调用预授权请款查询 确认是否扣款成功，查看预留的资金是否仍然存在，或该预授权交易是否已被撤销。
信用卡交易的处理过程中，"Auth Capture"（授权和捕获）是非常常见的一个流程，尤其在线上交易中。这个过程可以分为两个主要阶段：授权（Authorization）和捕获（Capture）。下面是对这两个阶段的简单解释：
## 业务流程
### 授权（Authorization）
当顾客使用信用卡在线购物并提交订单时，商家首先会向顾客的信用卡发出授权请求（需要将接口中 captureDelayHours 的值设为 -1）。
### 捕获（Capture）
在商品发货或服务提供完毕后，商家需要向银行发送一个预授权请款请求来完成这笔交易。预授权请款请求是告诉银行可以从顾客的账户中扣除之前授权冻结的金额了。银行收到预授权请款请求后，会正式从顾客的账户中扣款，并将这些资金转移到商家的账户中。这标志着整个支付过程的完成。
### 示例
假设你在一家网上书店订购了一本书，价格为$30。
1. 在你提交订单时，书店会向你的信用卡发行银行请求$30的授权。
2. 如果你的信用卡通过验证并且账户中有足够的额度，银行会预留这$30并给出授权码。
3. 当书店发货时，他们会执行捕获操作，实际上从你的账户中扣除这$30并开始资金转移过程。
通常情况下，授权和捕获是同步进行的。然而，在某些案例中，商家可能需要在不同的时间点执行这两个步骤。比如说，当一个产品需要定制或者预定时，商家可能会在客户下单时获取授权，然后在产品真正准备好并且发货时再执行捕获。
另外，需要注意的是，每一个授权都有一个有效期，在有效期内商家必须执行捕获操作，超过有效期未执行的话，授权将会过期，届时，即使商家执行捕获也无法完成交易。有效期的长短通常由发卡银行决定，大部分银行设定的有效期是7天。