Токенизация кредитных карт PayPal в Magento

Вы видели выше, как легко определить новые методы оплаты через XML, и если бы наши новые методы были действительно автономными, они были бы готовы к работе с минимальным вмешательством в основной код. Однако, полагаясь на существующий код интеграции PayPal, они подвергаются многочисленным случаям констант классов, напрямую ссылающихся на методы оплаты, операторам дел, определяющих, как должна быть получена информация конфигурации, и даже жестко заданной логике, для которой страны используют метод оплаты. опоры.

Ниже приведены некоторые фрагменты нашего собственного переписывания вездесущего класса PayPal Config, демонстрирующие несколько мест, где мы были вынуждены добавить наши новые способы оплаты:

 <payment>
    <paypal_direct_customerstored>
        <model>cls_paypal/paypal_stored_customerstored_direct</model>
        ...
        <title>Saved Credit Card</title>
        ...
    </paypal_direct_customerstored>        
    <verisign_customerstored>
        <model>cls_paypal/paypal_stored_customerstored_payflowpro</model>
        ...
        <title>Saved Credit Card</title>
        ...
    </verisign_customerstored>
    <payflow_link_customerstored>
        <model>cls_paypal/paypal_stored_customerstored_payflowlink</model>
        ...
        <title>Saved Credit Card</title>
        ...
    </payflow_link_customerstored>
    <payflow_advanced_customerstored>
        <model>cls_paypal/paypal_stored_customerstored_payflowadvanced</model>
        ...
        <title>Saved Credit Card</title>
        ...
    </payflow_advanced_customerstored>
    ...
</payment>

В конце я не могу с уверенностью сказать, что я мог бы спроектировать такую ​​сложную интеграцию более гибким способом. Однако, это может упасть, однако, конечный результат жестко закодированных элементов, подобных этим, повышает вероятность того, что для поддержки будущих выпусков Magento потребуется незначительный повторный набор инструментов.

Нет проблем с API

Будучи в основном интеграцией с веб-сервисом, это расширение опирается на вызовы API для своей основной функциональности. В этой области, однако, наша задача стала чрезвычайно легкой благодаря тому, что мы просто усиливали существующую интеграцию. Ядро Magento уже определило классы для выдачи соответствующих запросов, и на самом деле нам не нужно было вообще определять низкоуровневый код для создания вызовов API.

Наше расширение было связано с двумя API-интерфейсами PayPal — имя-значение-пара (NVP) — прямым API и API шлюза PayFlow. Класс Magento Mage_Paypal_Model_Api_Nvp определяет логику для первого, в то время как последний обрабатывается непосредственно в классе метода оплаты PayFlow Pro и его потомках. Очень краткий снимок некоторых классов прямого API:

 class CLS_Paypal_Model_Paypal_Stored_Customerstored_Payflowpro extends CLS_Paypal_Model_Paypal_Payflowpro
{
    //...

    protected $_commonPayflowMethod;

    public function __construct()
    {
        parent::__construct();

        // Initialize common method
        $this->_commonPayflowMethod = Mage::getModel(
            'cls_paypal/paypal_stored_customerstored_payflow',
            array(
                'caller_method' => $this,
                //... various other params
            )
        );
    }

    //...

    public function authorize(Varien_Object $payment, $amount)
    {
        return $this->_commonPayflowMethod->authorize($payment, $amount);
    }

    public function capture(Varien_Object $payment, $amount)
    {
        return $this->_commonPayflowMethod->capture($payment, $amount);
    }
    
    //...
}

Наша главная забота касалась так называемых ссылочных транзакций, поскольку это ключевая функция токенизации API PayPal, которая заставляет работать нашу версию «сохраненных кредитных карт». Как оказалось, нам повезло, по крайней мере, с прямым API, потому что ссылочные транзакции были обязательным компонентом функции, которую уже поддерживала базовая интеграция: соглашения о выставлении счетов.

class CLS_Paypal_Model_Paypal_Config extends Mage_Paypal_Model_Config
{
//...

//...
}class Mage_Paypal_Model_Api_Nvp extends Mage_Paypal_Model_Api_Abstract
{
/**
* Paypal methods definition
*/
const DO_DIRECT_PAYMENT = 'DoDirectPayment';
const DO_CAPTURE = 'DoCapture';
const DO_AUTHORIZATION = 'DoAuthorization';
//... (other constants for API method names)

return $this;
}
}

 callDoReferenceTransaction

Мы ожидали больше работы для решений на основе PayFlow, но даже здесь все оставалось довольно просто. На самом деле API PayFlow не ожидает явного имени метода среди параметров запроса. class CLS_Paypal_Model_Paypal_Stored_Customerstored_Direct extends CLS_Paypal_Model_Paypal_Direct
{
//...

}ORIGID

Получив и установив соответствующий токен, мы занялись бизнесом. Главный класс был не намного дольше, чем этот:

 class CLS_Paypal_Model_Paypal_Stored_Customerstored_Payflow extends CLS_Paypal_Model_Paypal_Stored_Payflow
{

    //...

    protected function _placeOrder(Mage_Sales_Model_Order_Payment $payment, $amount, $transactionType = self::TRXTYPE_AUTH_ONLY)
    {
        // Get Reference ID
        $paymentStoredCardId = $this->_commonMethod->getInfoInstance()->getData('stored_card_id');
        $referenceId = null;

        if ($paymentStoredCardId) {
            $storedCardModel = Mage::getModel('cls_paypal/customerstored')->load($paymentStoredCardId);
            if ($storedCardModel->getId()) {
                $referenceId = $storedCardModel->getData('transaction_id');
            }
        }

        //...

        // Prepare and run 'Reference Transaction' request
        $request = $this->_buildBasicRequest($payment);
        $request->setTrxtype($transactionType);
        $request->setAmt(round($amount, 2));
        $request->setOrigid($referenceId);

        $response = $this->_postRequest($request);
        $this->_processErrors($response);

        //...
        
        return $this;
    }

}

Фактически, у нас было больше работы по сопоставлению API для нашего метода оплаты PayFlow Pro (не описанного в этой статье), чем для любого из наших сохраненных функций кредитной карты.

Дорога впереди

В настоящее время наиболее явным ограничением расширения токенизации кредитных карт PayPal являются его строгие требования совместимости. Я рад сообщить, что мы уже на пути к расширению совместимости с предыдущими версиями Magento в ближайшем будущем. (Следите за обновлениями на нашем блоге , если хотите).

Есть также множество других функций, которые мы хотели бы видеть добавленными в будущем. Например, поддержка постоянных платежных профилей Magento была бы естественной для сохраненных кредитных карт. Мы будем уделять пристальное внимание наиболее востребованным функциям, поскольку планируем будущее расширение.

Разработка нашего первого расширения для Magento Connect стала серьезным опытом для Classy Llama и чрезвычайно позитивным. Мы рады видеть, что функции токенизации PayPal могут предоставить продавцам Magento.