Дополнение для оплаты

Способ оплаты — последний шаг оформления: покупатель выбирает, как платить, и нажимает кнопку подтверждения. Каждый способ — дополнение вида payment. Частей у него больше, чем у доставки: он не только появляется в списке, но и показывает кнопку и завершает заказ.

Файлы

extension/acme_hello/
├── admin/
│   ├── controller/payment/acme_pay.php       страница настроек
│   ├── language/en-gb/payment/acme_pay.php
│   └── view/template/payment/acme_pay.twig
└── catalog/
    ├── model/payment/acme_pay.php            доступен ли способ
    ├── controller/payment/acme_pay.php       кнопка и подтверждение
    ├── language/ru-ru/payment/acme_pay.php
    └── view/template/payment/acme_pay.twig

Страница настроек строится как у модуля; код настроек — payment_acme_pay. Поля: payment_acme_pay_status, payment_acme_pay_sort_order и payment_acme_pay_order_status_id — статус, который получает оплаченный заказ.

Модель

// extension/acme_hello/catalog/model/payment/acme_pay.php
namespace Opencart\Catalog\Model\Extension\AcmeHello\Payment;
 
class AcmePay extends \Opencart\System\Engine\Model
{
    public function getMethods(array $address = []): array
    {
        $this->load->language('extension/acme_hello/payment/acme_pay');
 
        $option['acme_pay'] = [
            'code' => 'acme_pay.acme_pay',
            'name' => $this->language->get('heading_title'),
        ];
 
        return [
            'code' => 'acme_pay',
            'name' => $this->language->get('heading_title'),
            'option' => $option,
            'sort_order' => (int) $this->config->get('payment_acme_pay_sort_order'),
        ];
    }
}

Метод возвращает способ оплаты с одним вариантом; пустой массив скрывает способ. Это формат выпусков 4.0.2 и новее. В 4.0.0 и 4.0.1 метод назывался getMethod() и возвращал плоский массив без вариантов. Сверьтесь с extension/opencart/catalog/model/payment/cod.php своей копии.

Кнопка

Когда покупатель выбирает способ, оформление вызывает index() контроллера витрины и вставляет возвращённый HTML:

// extension/acme_hello/catalog/controller/payment/acme_pay.php
namespace Opencart\Catalog\Controller\Extension\AcmeHello\Payment;
 
class AcmePay extends \Opencart\System\Engine\Controller
{
    public function index(): string
    {
        $this->load->language('extension/acme_hello/payment/acme_pay');
 
        $data['confirm'] = $this->url->link('extension/acme_hello/payment/acme_pay.confirm', 'language=' . $this->config->get('config_language'));
 
        return $this->load->view('extension/acme_hello/payment/acme_pay', $data);
    }
}

{# extension/acme_hello/catalog/view/template/payment/acme_pay.twig #}
<form action="{{ confirm }}" method="post" data-oc-toggle="ajax">
  <button type="submit" class="btn btn-primary">{{ button_confirm }}</button>
</form>

Подтверждение

public function confirm(): void
{
    $this->load->language('extension/acme_hello/payment/acme_pay');
 
    $json = [];
 
    if (!isset($this->session->data['order_id'])) {
        $json['error'] = $this->language->get('error_order');
    }
 
    if (!$json) {
        $this->load->model('checkout/order');
 
        $this->model_checkout_order->addHistory(
            (int) $this->session->data['order_id'],
            (int) $this->config->get('payment_acme_pay_order_status_id')
        );
 
        $json['redirect'] = $this->url->link('checkout/success', 'language=' . $this->config->get('config_language'), true);
    }
 
    $this->response->addHeader('Content-Type: application/json');
    $this->response->setOutput(json_encode($json));
}

Установите способ в Extensions → Extensions, вид Payments, и включите его. На странице index.php?route=checkout/checkout выберите его и нажмите кнопку — откроется страница успешного заказа, а заказ появится в Sales → Orders со статусом из настроек.

Способы из ядра в confirm() дополнительно проверяют, что в $this->session->data['payment_method'] сохранён именно этот способ. Вид этого значения различается между выпусками, поэтому проверку скопируйте из cod.php своей копии.

Настоящий платёжный шлюз

С банком или платёжной службой confirm() заказ не оформляет. Покупателя отправляют на страницу службы, а служба позже сама вызывает отдельный метод вашего контроллера — обратный вызов. Этот метод проверяет подпись запроса и только потом вызывает addHistory().

Частая ошибка

Заказ помечают оплаченным в момент, когда покупатель возвращается со страницы оплаты в магазин. Адрес возврата можно открыть вручную, ничего не заплатив. Помечайте заказ оплаченным только в обратном вызове от службы, проверив подпись и сумму.

Спасибо, что читаете!