订单
订单用于链接与您和付款人之间的一个销售实例相关的所有交易。 它用来代表传统的纸质“订单”概念,即您向客户出售一单商品。 因此,此类订单包含所有典型订单数据,如所购买商品的单项商品、购买人以及购买方式、送货地址,最为重要的是支付金额。
订单中的交易
一个订单可以包含一个或多个交易。 有些订单只有一个交易,即付款交易,也称为购买交易,在此交易中商品全额付款并立即发货。
其他订单有两个主要交易,一个是授权交易,检查付款人的银行账户是否有足够的资金并预留资金,然后是过账交易,将资金从付款人的账户转移到您的账户。 当您无法保证商品能否在付款人请求时派送的情况下,通常使用授权或过账模型。 有时,您可能需要退还部分或全部订单款项,或者分几次交付商品。 所有这些资金流动都代表一个订单的交易,订单是将这些交易链接在一起形成一个销售实例的实体。
以下示例描述了与常见卡交易流相关的订单状态生命周期:
- 如果您在卡付款中使用 3DS 支付验证 (3DS),首先使用各个身份验证操作来确认付款人的真实身份。 身份验证成功后,订单状态为
AUTHENTICATED
。 - 使用付款人向您授权对其进行扣费的
AUTHORIZE
交易。 发卡机构确认授权成功后,订单状态变为AUTHORIZED
。 - 当您准备好运送订单时,您将发送发起资金转移流程的
CAPTURE
交易。 如果您分多次发货,可以根据需要执行多个部分过账。 已过账全部授权金额时,订单状态将变为 CAPTURED。 如果您已经执行了部分过账,订单中还有未付授权金额,订单状态将变为PARTIALLY_CAPTURED
。 - 如果付款人退回产品,您可以根据需要进行一次全额退款或一次或多次部分退款。 订单状态将变为 REFUNDED 或 PARTIALLY_REFUNDED,具体取决于可退回的过账金额。
注意: 如果您不使用 3DS,可以直接进入下一步。
根据付款方式不同,非卡付款流可能略有不同。 具体流记录在该付款方式的集成指南中。
当您使用 <<paymentGateway>> 处理订单时,您可以在初始交易中提供有关订单的所有信息。 例如,账单、送货、付款和全部金额等详细信息。
在与同一订单相关的后续交易中,您不需要重复一般订单数据,只需引用原始订单即可。 例如,在退款交易中,您只需提供订单 ID 和您想要退款的金额,网关将使用初始交易来收集银行转账所需的所有详细信息。
如果订单的初始交易失败,您可以为同一订单提交另一个交易,而无需创建新的订单 ID。 这在付款人想要使用不同的付款详细信息重试失败的交易的场景中很有用。 例如,其他信用卡或备用付款方式。