сбербанк эквайринг api php
Сбербанк эквайринг api php
Laravel Sberbank Acquiring
Пакет предоставляет вашему приложению функциональность для работы с платежами с использованием эквайринга от Сбербанка. Возможности:
Перед использованием рекомендуется ознакомиться с документацией, предоставляемой Сбербанком.
Добавьте пакет в зависимости:
Опубликуйте файл настроек:
Для хранения истории платежей и операций создаётся несколько таблиц:
Связь базового платежа и платежей в разных платежных системах организована на уровне ORM через полиморфную связь.
Пакет содержит два класса-клиента для работы с эквайрингом:
ApiClient и Client добавлены в Service Container и могут быть использованы в Dependency Injection. Резолвинг классов:
На данный момент поддерживаются следующие операции эквайринга:
| Операция | Документация Сбербанка |
|---|---|
| Регистрация заказа | Ссылка |
| Регистрация заказа с предавторизацией | Ссылка |
| Запрос завершения оплаты заказа | Ссылка |
| Запрос отмены оплаты заказа | Ссылка |
| Запрос возврата средств оплаты заказа | Ссылка |
| Получение статуса заказа | Ссылка |
| Запрос оплаты через Apple Pay | Ссылка |
| Запрос оплаты через Samsung Pay | Ссылка |
| Запрос оплаты через Google Pay | Ссылка |
| Запрос сведений о кассовом чеке | Ссылка |
| Запрос деактивации связки | Ссылка |
| Запрос активации связки | Ссылка |
| Запрос списка всех связок клиента | Ссылка |
| Запрос списка связок определённой банковской карты | Ссылка |
| Запрос изменения срока действия связки | Ссылка |
Если во втором аргументе не указаны параметры returnUrl и failUrl, то они берутся из файла настроек.
Регистрация заказа с предавторизацией
Если во втором аргументе не указаны параметры returnUrl и failUrl, то они берутся из файла настроек.
Запрос завершения оплаты заказа
Обязательные аргументы: id модели платежа (AcquiringPayment), сумма.
Запрос отмены оплаты заказа
Запрос возврата средств оплаты заказа
Обязательные аргументы: id модели платежа (AcquiringPayment), сумма.
Получение статуса заказа
Запрос оплаты через Apple Pay
Запрос оплаты через Samsung Pay
Запрос оплаты через Google Pay
Обязательные аргументы: paymentToken, полученный от системы Google Pay, сумма. Подробнее здесь.
Запрос сведений о кассовом чеке
Запрос активации связки
Запрос деактивации связки
Запрос списка всех связок клиента
Запрос списка связок определённой банковской карты
Запрос изменения срока действия связки
Запрос проверки вовлечённости карты в 3DS
Для аутентификации при обращении к платёжному шлюзу можно использовать следующие данные, полученные при регистрации:
файл конфигурации предоставляет параметры для задания данных аутентификации:
Обновление статусов платежей
Некоторые операции не позволяют определить новый статус платежа. Для обновления статусов реализована artisan-команда, вызывающая операцию getOrderStatusExtended для всех платежей с заданным статусом.
Рекомендуется добавить команду в шедулер (app/Console/Kernel.php):
На данный момент реализовано одно событие:
| Событие | Описание | Параметр |
|---|---|---|
| UpdateStatusCommandHasFailed | Во время обновления статусов платежей возникли ошибки | Массив исключений |
Пакет выбрасывает исключения, в случае возникновения ошибок.
| Исключение | Причина |
|---|---|
| HttpClientException | В ответ на запрос сервер вернул код, отличный от 200 |
| NetworkException | Не удалось выполнить запрос |
| JsonException | Не удалось декодировать JSON ответ сервера |
| ResponseProcessingException | Не удалось сохранить ответ сервера |
| ConfigException | Ошибка файла конфигурации |
| ModelNotFoundException | Не удалось найти модель (платеж) |
| \InvalidArgumentException | Некорректные параметры запроса |
| \Throwable | При сохранении модели возникла ошибка |
Если этот проект оказался для вас полезным, вы можете поддержать его развитие здесь.
The MIT License (MIT). Please see License File for more information.
About
Laravel пакет для работы с платежами с использованием эквайринга от Сбербанка
Подключение метода оплаты Сбербанк-Эквайринг
В данной статье рассмотрим:
Сбербанк – крупнейший в России банк-эквайер, с многолетним опытом работы на рынке эквайринговых услуг, собственный процессинговым центром, и командой высококвалифицированных специалистов. Банк предоставляет услуги эквайринга на высоком уровне, их отличает минимальная стоимость. При этом исключается возможность утечки конфиденциальной информации.
В настоящий момент сервис Сбербанк предлагает решение касательно 54-ФЗ для интернет-магазинов, осуществляя отправку фискальных данных из интернет-магазина в облачные кассы.
Для этого необходимо:
1) Обратиться к своему клиентскому менеджеру или в службу поддержки на support@ecom.sberbank.ru
2) В личном кабинете АТОЛ Онлайн можно взять кассу в аренду, приобрести фискальный накопитель, дистанционно оформить соответствующие договоры и получить сервис по регистрации ККТ/ФН в ФНС.
Рассмотрим как подключить и настроить интернет-эквайринг от Сбербанка в интернет-магазине на платформе ADVANTSHOP.
Первое, что необходимо сделать, это отправить заявку на подключение в Сбербанк эквайринг, заключить договор и зарегистрироваться. Перейдите на сайт https://www.sberbank.ru/help/business/sbbol/100074 и нажмите на кнопку «Начать принимать оплату» (рис.1)
Рисунок 1.
Откроется окно, где требуется ввести данные и отправить заявку на подключение (рис.2).
Рисунок 2.
После чего с Вами связываются, Вы заключаете договор, обговариваете условия сотрудничества и предоставляются доступ в личный кабинет.
Данные для настройки и проведения платежа сбербанк высылает вам в документации с настройками.
способы оплаты и нажмите на кнопку “Добавить способ оплаты”» src=»https://www.advantshop.net/help/pages/files/80/sberbank-acquiring/sberbank-acquiring-30.jpg» style=»border: 1px solid gray;» />
Рисунок 3.
Далее нажмите «Добавить способ оплаты». Во всплывающем окне, введите название и выберите из выпадающего списка модуль «Сбербанк-Эквайринг» (рис.4)
Рисунок 4.
Поставьте активность метода оплаты, и заполните поля настроек (рис.5)
Рисунок 5.
Все данные для заполнения полей Сбербанк высылает Вам на почту:
Сначала будут высланы тестовые данные, после проведения тестовых настроек и тестового платежа, сбербанк вышлет боевые настройки.
После проделанных шагов, проведите тестовый платеж.
Поставьте галочку в строке «Тестовый режим», проверьте оплату на товаре ценой в 1-5 рублей, используя тестовую карту, которую предоставляет Сбербанк (указана в документации).
Если оплата проходит корректно, свяжитесь со Сбербанком; служба поддержки Сбербанка сообщит Вам «боевые» настройки (логин, пароль, имя мерчанта), которые Вам нужно будет указать в настройках метода на стороне магазина (вместо тестовых настроек).
После этого отключите галочку «Тестовый режим».
Далее необходимо написать на почту support@ecom.sberbank.ru просьбу о том, чтобы для вашего мерчанта на стороне Сбербанка прописали уведомления в случае успешного платежа или ошибки.
Эти URL указаны в настройках метода оплаты «Сбербанк» на стороне магазина:
Если у вас кириллический домен, то в настройках магазина (пункт меню «Настройки->Общие настройки», поле «URL Магазина») и при регистрации в сбербанке, укажите домен в punycode, для конвертации домена можете использовать любой сервис, например: https://www.punycoder.com/.
Также обратите внимание, в магазине обязательно должны прописаны ваши реквизиты, номер телефона, описание метода оплаты сбербанк. И сбербанк эквайринг не заключит договор, если продаете товары 18+.
Готово. Мы рассмотрели подключение платежного модуля Сбербанк-Эквайринг. Ниже рассмотрим типовые ошибки и пути их решения.
Типовые ошибки и их решение:
Решение: Вам необходимо указать корректные настройки метода оплаты в полях «Логин», «Пароль» и «Имя мерчанта». Пожалуйста, убедитесь, что вы корректно сменили временный пароль, присланный вам Сбербанком изначально.
Производить смену временных паролей на стороне Сбербанка необходимо как для логина вида login-api, так и для логина вида login-operator.
Решение: для проведения тестового платежа необходимо использовать тестовую карту Сбербанка. Данные тестовой карты указаны в технической документации Сбербанка.
Сбербанк эквайринг api php
В разработке:
GEM sberbank-acquiring предоставляет функциональность для взаимодействия с API эквайринга банка Сбербанк. Он использует RESTful API эквайринга Сбербанка.
Перед тем, как приступить к использованию этого гема, автор настоятельно рекомендует (хотя бы бегло) ознакомиться с официальной документацией к JSON API эквайринга Сбербанка, а так же Wiki, кому интересно
Клиент может выполнять следующие вызовы к API:
| Название метода | Путь API |
|---|---|
| deposit | /payment/rest/deposit.do |
| get_order_status_extended | /payment/rest/getOrderStatusExtended.do |
| payment | /payment/rest/payment.do |
| payment_sber_pay | /payment/rest/paymentSberPay.do |
| refund | /payment/rest/refund.do |
| register | /payment/rest/register.do |
| register_pre_auth | /payment/rest/registerPreAuth.do |
| reverse | /payment/rest/reverse.do |
| verify_enrollment | /payment/rest/verifyEnrollment.do |
сначала приведет параметры к следующему виду:
a затем превратит их в параметры запроса: amount=1000&orderNumber=order%231&returnUrl=https%3A%2F%2Fexample.com%2Fsberbank%2Fsuccess&jsonParams=%7B%22userEmail%22%3A%22test%40example.com%22%7D
Создание заказа на 10 рублей
Проверка состояния заказа
Запрос состояния заказа с результатом на английском языке:
Проверка контрольной суммы callback-уведомлений
API эквайринга Сбербанка поддерживает два вида callback-уведомлений: без контрольной суммы и с контрольной суммой. В случае обработки уведомления с контрольной суммой, алгоритм проверки включает в себя выполнение запроса ‘getOrderStatusExtended’ к API эквайринга для проверки действительного статуса платежа. В остальных случаях требуется проверка параметра checksum с использованием симметричной или асимметричной криптографии.
Bug reports and pull requests are welcome on GitHub at https://github.com/panasyuk/sberbank-acquiring.
The gem is available as open source under the terms of the MIT License.
Подключение эквайринга от Сбербанка для сайта
Для того, чтобы прием платежей с вашего сайта был быстрым, безопасным и удобным существует система эквайринга от Сбербанка.
Т.е. ваши клиенты заказывая товар, или услугу через ваш сайт, смогут произвести расчет по картам МИР, Visa, MasterCard через платежный шлюз Сбербанка не отходя от своего компьютера. А вы в свою очередь сможете получить оплату на свой счет в Сбербанке.
На данный момент я имею возможность подключить эквайринг на все сайты созданные мною на системе WordPress. В том числе можно прикрутить эквайринг к Woocommerce.
Если Вам требуется подключение на другой CMS (WordPress, Zen Cart, Drupal, InstantCMS, Jimdo, Joomla, Tilda, Wix, Tiu.ru, TYPO3, uCoz, uDiscuz! Twilight CMS, UMI.CMS, VamShop, 1С-Битрикс, WebAsyst Shop-Script, Alto CMS, AVE.cms, ABO.CMS, CMS Made Simple, NetCat, AdVantShop.NET, UralCMS, Amiro.CMS, Atilekt.CMS, concrete5, Danneo, LiveStreet, DataLife Engine, diafan.CMS, DJEM, Elstrana CMS Hosting, Fast-Sales, HostCMS, ImageCMS, InSales, Melbis Shop, OsCommerce, MODX Revolution, Parallels SiteBuilder, RBC Contents, S.Builder, ShopCMS, Simpla, SiteEdit, StoreLand, MaxSite CMS, MODX Evolution, Nethouse, NGCMS, okis.ru, OpenCart, Canape CMS, CMS Ruen, CMS Sitebill, cs.cart, PHPShop Free, PrestaShop, Setup.ru, Textpattern), то обращайтесь будем работать, уверен, что всё получится.
Для тех, кому интересно, как происходит вся процедура подключения эквайринга делюсь информацией ниже.
Итак, в любом случае для начала работы с эквайрингом от Сбербанка на вашем сайте потребуется заключение договора с ПАО «Сбербанк». После чего закрепленный за вами менеджер банка создаст мерчант (личный кабинет), и тестовую панель администрирования.
Далее Сбербанком отправляются следуюущие данные:
Вход в тестовую панель управления https://3dsec.sberbank.ru/mportal-uat/index.html
API: мерчант-api
Оператор: мерчант-operator
Пароль на оба логина: простой пароль
В данном случае мерчант — это уникальное название клиента (логин) латинскими буквами.
После того, как от банка получены эти данные я буду производить настройки на сайте, вносить необходимый для работы код в php файлы.
После настройки необходимо будет проверить, как работает система, при этом оплату проводить можно с тестовых карт
Также нужно будет проверить, как отображается статистика заказов в вашем личном кабинете эквайринга.
После того, как я проверю ваш сайт на исправность приема платежей в тестовом режиме необходимо будет перевести всю систему в «боевой режим».
Для этого необходимо будет Отправить Сбербанку ссылку на страницу оплаты с описанием процесса оплаты (допустим на страницу оплаты после оформления заказа).
А также ссылку с контактной информацией клиента, где должны присутствовать примерно следующие данные:
После получения этих данных нужно будет зайти на https://securepayments.sberbank.ru/mportal/ и придумать новый сложный пароль для оператора мерчант-operator.
Затем выйти из панели администрирования, и еще раз зайти на https://securepayments.sberbank.ru/mportal/ и придумать новый сложный пароль для api мерчант-api.
В обоих случаях использовать сначала одноразовый пароль предоставленный Сбербанком.
В php-файлах сайта, которые отвечают за процесс оплаты поменять ссылку https://3dsec.sberbank.ru на https://securepayments.sberbank.ru
В случае с моей системой выглядит это примерно так:
define(‘USERNAME’, ‘мерчант-api’);
define(‘PASSWORD’, ‘сложный пароль api’);
define(‘GATEWAY_URL’, ‘https://securepayments.sberbank.ru/payment/rest/’);
define(‘RETURN_URL’, ‘https://сайт.ру/cart/spasibo.php’);
После смены данных в php файлах на хостинге нужно произвести пробную оплату в «боевом режиме».
Также на сайте необходимо будет подключить уведомления об оплате, т.е. после того, как деньги будут поступать на ваш счет, то вы немедленно узнаете об этом в сообщении по e-mail, и сможете отпустить вашему покупателю товар.
Для того, чтобы подключить уведомления по e-mail нужно написать письмо в поддержку Сбербанка support@ecom.sberbank.ru с просьбой прописать в настройках e-mail, на который будут приходить уведомления об оплате.
В целом я постарался описать весь процесс подключения эквайринга для вашего сайта, если требуется помощь то с радостью помогу.
Интернет-эквайринг от Сбербанка
Интернет-эквайринг от Сбербанка — это один из способов принимать платежи на сайте и получать деньги на счет компании в банке.
Подключение происходит в несколько этапов.
ВАЖНО: В заявке на подключение необходимо сразу добавить следующий комментарий: «Просьба подключить уведомления обратного вызова с контрольной суммой с помощью симметричной криптографии на адрес https://secure.vigbo.com/sberbank/notification.php».
1. Отправьте заявку на подключение на сайте Банка.
2. Сотрудники Сбербанка отправят вам письмо с документами, требуемыми для подключения, данные для доступа в личный кабинет Банка и данные для настройки сайта в тестовом режиме.
3. Зайдите в систему управления вашим сайтом, раздел Магазин > Продажи > Методы оплаты и добавьте добавьте метод оплаты Через Сбербанк.
4. Введите необходимые настройки для интеграции:
Логин с суффиксом -operator и пароль к нему вам нужно использовать для входа и работы в личном кабинете Сбербанка.
5. Протестируйте оплату на вашем сайте в тестовом режиме. Для тестирования используйте данные карт, предоставленные сотрудниками Сбербанка. Если данные не были предоставлены, вы можете их просмотреть на сайте Сбербанка.
6. Приведите ваш сайт в соответствие с требованиями Банка. Если какие-то из требований не будут выполнены, сайт не пройдет проверку.
8. Вам нужно заменить все тестовые учётные данные на новые и снять отметку Тестовый режим в системе управления сайтом.
ВАЖНО: Убедитесь, что вариант оплаты через Сбербанк виден на вашем сайте при заказе товара. Протестируйте данный метод оплаты в боевом режиме и убедитесь в правильности платежей.