Magento 支付流程

Question

我正在致力于为 Magento 实现一个新的支付模块，并希望了解这个逻辑背后的核心概念。我知道我必须从 Mage_Payment_Model_Method_Abstract 或其任何子类进行扩展，但我的问题是何时使用以及如何在我的模型中使用捕获和授权方法。 例如，如果我将整个过程分成如下步骤：

1. 用户来到购物车并选择某种付款方式，即网关。
2. 系统拦截请求，收集所有提交的数据并将用户发送到网关 URL。
3. 用户在网关站点下订单（或取消订单），网关站点将有关订单的信息发送到我的商店。
4. 我的商店使用收到的数据对订单进行更多修改，并保存状态为已完成或已取消的订单。

在这些步骤中，我必须在哪里使用授权和捕获方法？如果有人能向我解释授权和捕获的含义，我将不胜感激？

Answer 1

这是我一直以来理解这些概念的方式，以及在 Magento 中实现支付模块所需了解的内容。您的具体“这种情况发生在哪里”的答案在下面以粗体显示，尽管它并不像您希望的那么简单。

在互联网出现之前，实体信用卡交易分为两个阶段。

在销售时，当商家拿着消费者的信用卡进行购买时，他们会将其滑过销售点设备，该设备会呼叫信用卡的中央办公室并询问“这张卡是否已获得该网络的授权，以及该特定消费者的可用信用额度是否足够大以允许进行此次购买”。

如果购买被接受（而不是被拒绝），则该费用被称为“授权”。消费者将拿起他们的产品，销售点系统/收银机将注意到交易已获得授权。然后，在一天结束时或一周结束时，按照其他预定的定期时间表，或者当所有者决定停止饮酒时，商家将检查所有授权收据并发送另一张授权交易中获取资金。获取资金就是将钱存入商家的账户。

这仍然是大多数网关使用的模型，也是 Magento Inc. 选择为其支付模块实施的域模型。

事情应该运行的方式是，当消费者在 Magento 等系统中到达最终结账步骤时，Magento 会向网关的 API 发出授权请求。如果交易成功，订单将被系统接受，并存储来自授权请求的唯一 ID。接下来，当消费者的货物发货时，店主使用 Magento 管理员创建发票。此发票的创建会发出捕获请求（使用从授权请求返回的商店 ID）。 这是在 Magento 中发出这些方法调用的地方。

然而，事情变得棘手，因为每个支付网关对这些概念的解释都略有不同，并且每个商家对“在我们发货之前不要捕获”责任的解释也不同。除了上述场景之外，支付模块还有一个称为“支付操作”的系统配置值。可以将其设置为“仅授权”，这将实现上述流程。它还可以设置为授权和捕获，这将在下订单时授权并捕获付款。它甚至变得更令人困惑，因为尽管该方法称为 Authorize 和 Capture，但当前版本的 Magento 仅在设置为这种模式时才会发出捕获请求（至少对于 Authorize.net 而言），而 Authorize.net在一天的大部分时间里，内部会将捕获请求置于已授权但未捕获的状态。 Magento 如何处理订单、付款和发票是代码库中随版本变化很大的一个领域。

因此，Magento 支付模块系统背后的想法是保护您免受 Cluster F 的影响——即编程支付网关逻辑。在您的 authorize 方法中，您实现对支付网关的授权 API 的调用（或执行您此时想要发生的任何检查和逻辑）。该方法传递一个支付对象和一个金额。如果您让您请求/执行您的逻辑并确定它因任何原因无效，您将抛出一个异常，

Mage::throwException('...');

这告诉 Magento 授权失败，并且它将采取相应的行动（显示错误消息等）。否则，您可以在 Payment 对象上设置数据成员并发出 a

return $this;

数据成员是您稍后在捕获付款时需要的内容。这将我们带到支付模块的 capture 方法。此方法还会发送支付对象和金额。在这种方法中，您发出捕获请求。付款对象将具有 cc_trans_id 数据成员

$payment->getCcTransId()

，该成员允许您针对网关发出捕获。这是您负责在 authorize 中保存的数据成员之一。同样，如果您的代码确定捕获失败，则会抛出异常。否则，您返回$this。

Authorize.net 支付模块有很好的示例说明如何完成此操作。

app/code/core/Mage/Paygate/Model/Authorizenet.php

例如，考虑 capture 方法的这一部分。

public function capture(Varien_Object $payment, $amount)
{
    if ($payment->getCcTransId()) {
        $payment->setAnetTransType(self::REQUEST_TYPE_PRIOR_AUTH_CAPTURE);
    } else {
        $payment->setAnetTransType(self::REQUEST_TYPE_AUTH_CAPTURE);
    }   
    
    $payment->setAmount($amount);
    $request= $this->_buildRequest($payment);
    $result = $this->_postRequest($request);
    //...
    

这里，capture 方法正在检查付款是否具有 cc_trans_id。根据结果​​，它将 anet_trans_type 设置为以下任一值：

self::REQUEST_TYPE_PRIOR_AUTH_CAPTURE
self::REQUEST_TYPE_AUTH_CAPTURE

然后，API 请求对象使用该值发送 API 调用以进行以下任一操作：

1. 捕获预授权交易
2. 立即捕获