Подключение платежного шлюза СберБанк. Как реализовать подключение?

Question

[unobruno]

Появилась задача - подключить платежный шлюз Сбербанка на интернет-магазине. Расскажите основные принципы подключения? Где что сверстать? Как работать с https://3dsec.sberbank.ru/payment/merchants/****/p... Нюансы форм и т.д.

Answer 1

[voronkovich]

Недавно столкнулся с той же проблемой. Почему-то Сбербанк не делает библиотек для работы со своим API, как все нормальные платежные шлюзы. Да и API у них - совершенно безумное. Документации в открытом доступе нет, какие-то пдфки в письме прислали. В итоге, сделал небольшую библиотеку на PHP https://github.com/voronkovich/sberbank-acquiring-... Надеюсь пригодится кому-нибудь еще.

Comments

[x404]

Спасибо!
Будем тестить.

[voronkovich]

Сергей Сыса тестируйте :) Найдете ошибки - делайте пулл-реквест, буду очень признателен!

[neudachniyproger]

voronkovich: Да ты вообще гении Реально красиво написано Только подсказал бы как подключить там по моему с namespace что то не так Или я опять рукожоплю)) с похмелья

[voronkovich]

neudachniyproger: Возможно, ты забыл указать ключ для использования тестовой среды Сбербанка. Вот самый простой рабочий пример:

<?php

use Voronkovich\SberbankAcquiring\Client;

$client = new Client([
'userName' => 'YourUserName',
'password' => 'YourPassword',
'apiUri' => Client::API_URI_TEST,
]);

[Rinaax]

voronkovich: Здравствуйте) а вы бы не смогли объяснить куда и какие файлы надо подключать? Я просто понять ничего не могу.

[voronkovich]

Rinaax: Не могу :) У библиотеки есть документация. Что еще можно добавить сверх этого? Если вы не знакомы с PHP - я не смогу ничем помочь.
Вообще говоря, возможно вам нужен плагин для используемого вами движка, а не эта библиотека. Смотрите здесь https://3dsec.sberbank.ru/demopayment/docsite/inde...

[ail88]

voronkovich: Добрый день. Используем вашу библиотеку, спасибо за ее написание. Вы случайно не сталкивались с изменениями в 54-ФЗ? Который теперь требует от электронной коммерции отправку пользователю чека и автоматическую отправку отчетов ФНС, сбербанк со вместо с АТОЛ, предлагают решение, но это требует внесение корректировок в формировании запроса. Конкретнее, теперь требуется отправка корзины вместе с запросом. Подробнее здесь:
https://developer.sberbank.ru/acquiring-api-basket

Может Вы сталкивались с этим, и как то дорабатывали библиотеку?

[voronkovich]

ail88: Нет, не дорабатывал, т.к. доработка не требуется. Для передачи корзины, нужно просто использовать параметр orderBundle.

$result = $client->registerOrder($orderId, $orderAmount, $returnUrl, [
    'orderBundle' => [
        'cartItems' => [],
    ]
]);

[ail88]

voronkovich: Спасибо большое за ответ. Библиотеку Вашу не трогали, но есть проблемка. Атол требует для формирования чека e-mail или телефон клиента, но при его передачи вылезает ошибка:



Основной код формирования запроса

При этом, если не посылаем в запросе e-mail или телефон, то запрос доходит до сбербанка, но уже там личном кабинете атол показывает ошибку, что не указан телефон или почта клиента.

[ail88]

На всякий случай прикрепляю вашу библиотеку.

[voronkovich]

ail88: "Системная ошибка" - это ответ Сбербанка (согласен, он абсолютно бессмысленный). Расшифровки есть тут.
Я полагаю, это проблема на стороне Сбербанка, т.к. библиотека не изменяет переданные ей данные.
Могу порекомендовать сделать запрос вручную из командной строки или браузера, чтобы убедится что запрос также завершается неудачей.
Или создайте HttpClient вручную и укажите опцию \CURLOPT_VERBOSE => true. Подробнее см. здесь. Это позволит вам увидеть в командной строке, как выполняется запрос библиотекой.

[ail88]

voronkovich: Спасибо большое за ответ. Сбербанк подтвердил, что это проблема на их стороне.

[Webdevvv]

ail88, у вас решилась проблема с отправкой корзины? Кажется у меня сейчас то же самое..

[ale3x]

Может быть кому-то пригодится. Не мог отправить данные корзины через REST; без корзины заказ регистрировался. На запрос регистрации заказа с корзиной выпадала ошибка "Системная ошибка", поддержка Сбербанка не могла точно ответить, почему так, и что ошибка означает.

В результате решение:
В документации написано, что для отправки корзины отправляется параметр:

'orderBundle' => [
    ....
    'cartItems' => [
        'items' => [
            [....],
            [....],
        ],
    ],
]

Так вот, содержимое orderBundle должно быть json-строкой, т.е. можно сделать так:

'orderBundle' => json_encode([
    'cartItems' => [
        'items' => $items,
    ],
]),

На решение этой проблемы и переписки с тех. поддержкой ушло недели две. Надеюсь, это сэкономит кому-нибудь время.

[voronkovich]

ale3x, Всё верно, это должна быть JSON-строка. Я добавил автоматическую конвертацию в JSON параметра orderBundle (https://github.com/voronkovich/sberbank-acquiring-... ). Обновитесь до версии 2.3

[toster1234]

Ребят помогите разобраться, с пхп знаком но уровень знаний пока ниже джуна чтоб реализовать это, можно рабочий пример какой то или сайт

[Lephin]

Если, кто зайдет сюда. Не получается вот в такой форме отправить параметры товара для 54-Ф3

[андрей громов]

voronkovich, как это сделать? я часто вижу как заполняют форму с указаной ценой, ввод полей для номера от карточки и потом после нажатия оплатить перебрасывает на код подтверждения, помоги я давно ищу этот вариант, как это нужно настроить, может у вас есть код? я вообще ноль в этом, но пойму если хоть немного узнаю что и как. могу видео показать чтобы понять о чем я, может не так описал, вот скрин

[андрей громов]

[андрей громов]

voronkovich, Олег это минутное дело чтобы обьяснить

[voronkovich]

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

[андрей громов]

voronkovich, как тогда тот парень на ютубе это делает?

[voronkovich]

андрей громов, не знаю, я подобных вещей не делал.

Answer 2

[blindmen]

у них есть 2 метода WebService-ах и REST.
по поводу REST вкратце. отправляется запрос POST или GET вида https://3dsec.sberbank.ru/payment?юзер&пароль&номе... если запрос правильный, в ответ получаем ссылку на страницу оплаты.
если заключить с ними договор то они вышлют вам документацию где всё поверхностно написано (документация рассчитана на опытного вебмастера, хотя и junior с гуглом смогут разобраться). и дадут тестовый доступ и "менеджера".

Comments

[unobruno]

Спасибо за ответ, я уже решил проблему через REST и отправкой запроса через функцию curl в php. Кстати в их документации ничего не сказано про то, каким образом отправлять запрос.

[blindmen]

unobruno: не за что, я догадывался что за пару месяцев вы уже нашли решение, но решил таки написать, мало ли кому пригодиться, и по поводу "подробно расписано" вы правы я погорячился)

[Chernichko]

unobruno: можно ли где то посмотреть реализацию? Мне хочется застрелится. от того. что я не понимаю, как это сделать....

[unobruno]

Chernichko: dropmefiles.com/IuzYH

[Chernichko]

unobruno: спасибо) Подскажите, а подключен ли у вас сертификат SSL?

[Chernichko]

unobruno: Это я к тому. что я делала тоже самое, все равно не работает. В документации СБ ничего нет про то, что сертификат обязателен.

[unobruno]

Chernichko: точно не знаю, но на 99% уверен что нет

[Chernichko]

unobruno: Вы не сталкивались с тем. что возвращался пустой ответ? У меня получается так, что если прописываю данные в строке браузера, получаю нужное. Если Пытаюсь как то по другому. либо ошибка XMLHttpRequest cannot load. либо, как в данном случае, пустой ответ...

[unobruno]

Chernichko: к сожалению помочь ничем не могу, ушел от веб-дел давно. Но есть подозрения что на хостинге стоит старая версия php

[Chernichko]

unobruno: понятно. спасибо)))0

[Сергей Сергеев]

unobruno, Chernichko поделитесь пожалуйста примером реализации, срок хранения по ссылке истёк

Answer 3

[Олег]

Клиент для API сбера, как часть https://omnipay.thephpleague.com/
https://github.com/AndrewNovikof/omnipay-sberbank

Comments

[toster1234]

А можно подробней как это подключить?Я с пхп знаком но мой уровень пока даже до джуна не дотягивает чтоб разобратьсяв этом всем, можно хотя бы сайт пример где это все реализовано?

[Олег]

На странице либы есть все, как подключить, как провести оплату и тд.
https://github.com/AndrewNovikof/omnipay-sberbank

Сюда копировать код думаю лишним будет.

[TruSnowRider]

У либы есть небольшая проблема, она не соответствует терминам omnipay (в частности метод purchase работает по другому).
https://github.com/AndrewNovikof/omnipay-sberbank/...

Answer 4

[0x131315]

В процессе интеграции sbercredit. Аналогичные проблемы.
В документации запросы странного вида, такие не выдает ни http_build_query, ни key-value подстановка.
Плюс запросы GET, но с требованием POST-заголовка application/x-www-form-urlencoded)
Примеры POST-запросов в документации неадекватные, и завести их так и не удалось ни в каком виде.
Оказалось что API принимает только GET, и http_build_query вполне хватит.

Проблема была в документации: запросы составлялись по их документации, но... ничего не работало. И API не умеет говорить ничего, кроме system error)
Разобрал их API по кусочкам, оказалось что оно документации мало соответствует - многие необязательные поля на деле обязательны.

Сейчас следующий круг ада: API принимает запрос, отдает данные для перехода на шлюз, но... теперь шлюз отдает ошибки в web-интерфейсе)
Оказалось поле muasure было обязательным. При этом в документации в примерах запросов оно пустое, и API на пустое поле ошибок не выдает. Такие дела.

Comments

[Алексей Колесников]

Вам удалось разобраться с этим? Второй день мучаюсь, в ответ ничего кроме System error или отсутсвует параметр INSTALLMENT(хотя он присутсвует) получить не удалось

[0x131315]

Алексей Колесников, Удалось конечно. Но опыт был крайне неприятным.

[Алексей Колесников]

0x131315, не поделитесь работающим примером? Очень уж много времени занимает настройка эмпирическим методом )

[0x131315]

Алексей Колесников,

После всех экспериментов вылилось вот в такое

$request = [
            'language' => 'ru',
            'currency' => 643,
            'pageView' => 'MOBILE',
            'orderNumber' => 'order1',
            'amount' => 10 * 100,
            'returnUrl' => 'http://store.com/order/order1',
            'merchantLogin' => 'merchantId',
            'jsonParams' => json_encode(
                [
                    'email' => '[e-mail]',
                    'phone' => '[phone]',
                    'backToShopUrl' => 'http://store.com',
                    'backToShopName' => 'Назад в магазин',
                ]
            ),
            'orderBundle' => json_encode(
                [
                    'orderCreationDate' => '2021-03-14T12:59:00',
                    'customerDetails' => [
                        'email' => '[e-mail]',
                        'phone' => '[phone]',
                        'contact' => 'user',
                        'deliveryInfo' => [
                            'deliveryType' => 'delivery',
                            'country' => 'RU',
                            'city' => 'город',
                            'postAddress' => 'адрес',
                        ],
                    ],
                    'cartItems' => [
                        'items' => [
                            [
                                'positionId' => 1,
                                'name' => 'спички',
                                'quantity' => [
                                    'value' => 1,
                                    'measure' => 'шт.',
                                ],
                                'itemPrice' => 10 * 100,
                                'itemAmount' => 10 * 1 * 100,
                                'itemCode' => 'артикул',
                                'itemCurrency' => 643,
                            ],
                        ],
                    ],
                    'installments' => [
                        'productType' => 'INSTALLMENT',
                        'productID' => 10,
                    ],
                ]
            ),
            'userName' => 'login',
            'password' => 'password',
            'dummy' => 'true',
        ];
        $url = 'https://3dsec.sberbank.ru/sbercredit/register.do?' . http_build_query($request);
        $curl = curl_init();
        curl_setopt($curl, CURLOPT_URL, $url);
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'GET');
        curl_setopt($curl, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
        $response = curl_exec($curl);

Нужно подставить свои логин, пароль и мерчант для теста.
И 3dsec - это исключительно тестовый шлюз.

[Алексей Колесников]

0x131315, благодарю ) будем тестировать

[Александр Анкудинов]

Подскажите, пожалуйста, логин/пароль они должны выдать или сгенерировать где-то можно?

Саппорт отправляет на https://developer.sberbank.ru но по работе со платежами кроме QR платежи там ничего нет.

[0x131315]

Александр Анкудинов, обычно при заключении договора создают личный кабинет и логины/пароли для test/prod окружений. А без договора такое и смысла не имеет.
Документация здесь:
https://securepayments.sberbank.ru/wiki/doku.php/start
https://pokupay.ru/documents

Answer 5

[Александр Епихин]

Для того чтобы тестировать оплату необходимо использовать тестовые карточки. Если будете использовать реальную карту, то ничего происходить на странице оплаты не будет

Answer 6

[panasyuk]

Еще есть реализация для Ruby https://github.com/panasyuk/sberbank-acquiring