后续操作
使用 Direct Payment 集成方法时,新订单的付款流程从初始交易开始,最常见的是 PAY 或 AUTHORIZE 交易。 如需可用初始交易的完整列表,请参阅交易。
初始交易定义了订单的所有重要信息:
- 订单本身的详细信息(如 ID、金额和货币)。
- 用于付款的付款方式。
- 付款人的付款详细信息。
如果您使用 PAY 交易,付款人收到了订购的商品并且满意,表明订单完成,无需执行其他操作。 但是,在很多情况下可能需要后续交易来处理订单的剩余生命周期。
后续场景
以下场景是您需要为现有订单发送后续交易的情况的示例:
- 如果您使用 VERIFY 交易作为初始交易来验证付款人的账户详细信息,您需要使用 PAY 或 AUTHORIZE 交易进行跟进来定义正确的订单金额和发起资金转移。
- 如果您使用 AUTHORIZE 交易作为初始交易,当您准备好发货或提供服务,想要进行资金交换时,您需要使用 CAPTURE 交易来跟进。 如果您发货或提供服务的能力出现延迟,您可能还需要使用 UPDATE AUTHORIZATION 交易来让授权保持有效,直到您准备好过账。
- 如果订单因任何原因被取消,您同时也需要使用 VOID 交易通过网关立即取消订单。 如果付款详细信息已被发送给银行,您需要使用 REFUND 交易,如果付款人对购买的商品不满意,想要退货,也需要使用此交易。 在极少数情况下会由于收单行需要进一步授权而导致交易失败,这时,您可以使用 REFERRAL 交易,同时提供其他必要的详细信息来重试付款操作。 RETRIEVE TRANSACTION 和 RETRIEVE ORDER API 操作还可以被视为后续 API 操作,但它们仅用于检索现有订单的详细信息,不会影响订单生命周期。 有关所有可用 API 操作的列表,请参阅操作。 有关所有可用交易的列表,请参阅交易。
链接到初始交易
与同一个订单相关的所有交易必须关联起来,以便各个支付系统(如 Mastercard Gateway 和银行)能够将它们识别为属于同一个订单。 通过在与订单相关的每笔交易中使用相同的 order ID 来完成关联。 order ID 作为请求 URL 中的路径参数提供。
后续交易中的共享数据
将同一个订单内的不同交易链接在一起意味着您只需提供一次有关该订单的特定数据。 网关存储订单的详细信息,并可以在处理任何后续交易时根据需要使用它们。
在任何后续交易中,您只需提供特定于该交易的数据。 例如:
- 在 CAPTURE 交易中,您至少需要提供当时在运送的商品的金额和货币,可以是全部或部分订单金额。 如果您提供其他数据,例如,航空公司数据或 1 级/2 级数据,您还需要提交其他数据。 有关更多信息,请参阅补充数据部分。
- 在 REFUND 交易中,您需要提供您在发送的退款的金额和货币,可以是全部或部分订单金额。
- 在 VOID 交易中,您需要提供要取消的确切交易的交易 ID。
- 在 REFERRAL 交易中,您需要提供让发卡机构可以批准之前失败的交易的授权代码。
在您成功完成初始交易并提供付款人的卡详细信息后,您无法在 CAPTURE 或 REFUND 交易中再次提供卡详细信息。 如果您这样做,网关将拒绝该请求。