Настройка оплаты по Системе Быстрых Платежей (СБП) через QR-код (на примере Газпромбанка)

Что позволяет протокол

1. Выплачивать деньги на карты, эмитированные банками РФ и зарубежными банками.
2. Выплачивать через Систему Быстрых Платежей (СБП).
3. Выплачивать деньги на QIWI кошельки клиентов — pay(1).
4. Проверять текущий статус транзакции перевода — status.
5. Проверять возможность проведения выплаты на QIWI Кошелек — check-deposit-possible.
6. Следить за балансом на агентском счете для выплат — ping.

Создание CSR-запроса на сертификат

Запрос на сертификат генерируется одновременно с закрытым ключом, например, с помощью утилиты OpenSSL:

Получение сертификата

Открытый ключ и запрос на сертификат необходимо передать менеджеру QIWI. Менеджер возвращает Контрагенту СА-сертификат и клиентский сертификат, сформированный в ответ на запрос.

Отправка запросов

Запросы к API должны отправляться по адресу:

Аутентификация по клиентскому сертификату

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

Аутентификация по цифровой подписи

Для аутентификации по цифровой подписи Контрагент должен создать пару RSA-ключей, например, с помощью утилиты OpenSSL. Размер ключа должен быть 2048 бит, ключ должен быть закодирован в BASE64.

Выплаты на qiwi кошельки

1. Пользователь передает вам сумму пополнения и номер QIWI кошелька, который нужно пополнить.
2. Вы отправляете запрос в Top-Up API QIWI Кошелька на проверку возможности проведения платежа.
3. Вы отправляете запрос в Top-Up API QIWI Кошелька на пополнение указанного кошелька.
4. Вы проверяете текущий статус платежа. Платеж должен принять финальный статус.
5. При успешном финальном статусе платежа средства автоматически перечисляются на баланс указанного кошелька с вашего агентского счета.
6. При неуспешном финальном статусе платежа вы возвращаете средства пользователю.

Выплаты на банковские карты

1. Пользователь передает вам сумму пополнения и номер карты, которую нужно пополнить.
2. Вы отправляете запрос выплаты на карту банка РФ или запрос выплаты на карту зарубежного банка в Top-Up API QIWI Кошелька для выплаты средств на указанную карту.
3. Вы проверяете текущий статус платежа. Платеж должен принять финальный статус.
4. При успешном финальном статусе платежа средства автоматически перечисляются на указанную банковскую карту с вашего агентского счета.
5. При неуспешном финальном статусе платежа вы возвращаете средства пользователю.

Запрос баланса контрагента

Данный запрос возвращает текущий баланс по агентскому договору в сервисе QIWI Кошелек.

Или денежные переводы вчера, позавчера и сегодня.

Если вы ученый, квантовый физик, и не можете в двух словах объяснить пятилетнему ребенку, чем вы занимаетесь, —  вы шарлатан.” (С) Ричард Фейнман

Рассказывать про Систему быстрых платежей, которую мы сделали – неблагодарный труд. Для обывателя эта штука простая, как шариковая ручка, и поэтому трудно понять – ну что здесь нового и необычного? Вот нажал ты две кнопки и деньги уже на счете – и что? Это же самоочевидно.

Кстати, шариковая ручка, которую я взял для примера – это прорыв? Ведь Гоголь как-то писал до её появления, и неплохо. Но что делать, если хорошая мысль пришла в голову внезапно, искать чернила и перо? Нет, можно просто достать ручку и блокнот из кармана и записать тут же. Просто? Очень, даже говорить не о чем. Изменение поведения? Да, и сильное.

Я уже 12 лет работаю в индустрии денежных переводов и успел застать смену нескольких эпох. Сейчас я работаю в Системе быстрых платежей, и приходится рассказывать про СБП школьным друзьям, бывшим коллегам и даже продавцам шаурмы, поэтому на тысячный раз я взял и записал свои рассказы и решил их опубликовать. Тут будет рассказ, как транзакции стали такими повседневными и незаметными, что про них никто не вспоминает.

Как сегодня? mobile only

Основная предпосылка нового поведения – у каждого есть смартфон и смартфон используется как инструмент по умолчанию для любой бытовой операции.

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

– упс, а я наличку дома забыл. Дайте взаймы, я завтра сниму и отдам!

– давайте я заплачу за всех, а вы мне скинетесь? 

– у меня только тысяча, есть сдача? 

– и мне!

Маленький, но ежедневный кейс. Как его решать? С наличкой не всегда удобно; а использовать полноценный денежный перевод и в голову не придет – получатель-то напротив тебя сидит, не идти же в банк для отправки ему денег ради ста рублей! Вот если бы можно было отправить деньги так же легко, как оплатить мобильный! Достал телефон и пока кофе пьешь – вжух!

И в мобильных приложениях банков стали появляться переводы, сначала – в пределах своего банка; затем – в дружественные банки, с которыми удалось интегрироваться. Кейс изменился:

– У тебя какой банк, “АА”?

– Нет, “ББ”. А твой АА умеет в ББ переводить?

– Посмотрим… не вижу такого. Вроде нет. А твой банк может в мой запрос кинуть?

– Что, запрос???

– Ну ок. А карточки в другом банке нет?

– Да это нормальный банк!

– Понял. Тогда по номеру карточки?

– Вот еще, номер карты светить….. Ну хорошо, погоди, сейчас достану ….. 2200 **** **** ****. Вбил?

– Ага, перевожу. Ого, комиссия. Отправил. Жди, скоро переведется. Хотя тут про сроки ничего не сказано.

Все это очень удобно работало, когда вы оба – клиенты одного банка; а если нет – все заканчивается шелестом купюр. И близок локоть, да не укусишь.  

Какие кейсы переводов хотелось бы видеть в своем мобильном? Перевод микросуммы человеку, который рядом. С минимальными транзакционными расходами (комиссия, время, количество нажатий). И хорошо бы не афишировать номер карточки. 

1. Скинуться другу, оплатившему общий счет. 

2. Собрать деньги на подарок коллеге. 

3. Вернуть долг, пока не забыл.

4. Пополнить общий семейный бюджет. 

5. Срочно подкинуть ребенку денег на обед. 

6. Перевести полученную зарплату в другой банк.

Как создать ключи

• Сгенерировать закрытый ключ. Выполните команду:

openssl genrsa -out private.key 2048

Далее введите пароль и подтвердите:

Enter pass phrase for private.key:

В папке выполнения команды будет создан файл с приватным ключом: private.key.

• Получить открытый ключ, соответствующий закрытому, командой:

openssl rsa -in private.key -pubout -out public.key

• Контрагент должен передать открытый ключ в QIWI, а закрытый ключ использовать для подписи запросов.

Коды ошибок обработки запроса

API возвращает код ошибки обработки запроса в теге <result-code>. Ошибки с кодом > 0 возвращаются, если сервер не смог обработать запрос (в ответе отсутствуют запрашиваемые данные).

Коды ошибок обработки платежа

API возвращает информационный код ошибки обработки платежа в атрибуте result-code тега <payment>.

Настройка оплаты по системе быстрых платежей (сбп) через qr-код (на примере газпромбанка)

Ответ без ошибок обработки

Если запрос обработан корректно, то в ответе возвращаются сведения о платеже в теге <payment>.

Параметры ответа:

Ответ без ошибок обработки запроса

Если запрос обработан корректно, то в ответе возвращаются сведения о платеже в теге <payment>.

Параметры ответа:

Ответ с ошибками обработки

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

Параметры ответа:

Ответ с ошибками обработки запроса

Если сервер не смог обработать запрос на пополнение баланса учетной записи Клиента в системе QIWI Wallet, API возвращает ответ с кодом произошедшей ошибки. В этом случае информация о транзакции отсутствует в ответе, поэтому вы должны перейти к запросам статуса, не отклоняя платеж на своей стороне.

Параметры ответа:

Параметры запроса

Внутри тега payment поля с тегом extra могут располагаться в любом порядке

Перевод, как это делалось раньше

Сегодня речь пойдет только о переводах от человека к человеку, Consumer-to-Consumer, C2C. 

Кто и как этим пользовался? 

Основной сценарий – cash-to-cash, внес наличные – выдали наличные. Родители отправляли деньги уехавшим студентам; уехавшие на заработки – зарплаты домой семьям; иногда даже коммерсанты рассчитывались за товары.

Отдельный кейс – перевод самому себе: человек едет в другой город и боится везти с собой в поезде наличные.

 Как это выглядело для клиента?

1. Выбираешь систему денежных переводов – да, их несколько, только в России было штук пять популярных. Нужно выбрать, где комиссия меньше. Нужно понять, в какой системе пункты отправки и выдачи удобно расположены (или даже так: что в городах отправки и выдачи они вообще есть).

2. Приходишь в отделение банка, заполняешь бланк – ФИО и телефон отправителя и получателя; страна назначения, город и, возможно, пункт выдачи. Предъявляешь паспорт. Расписываешься на заявлении.

3. Отдаешь кассиру деньги и комиссию сверху – получаешь квитанцию и контрольный код. 

4. Говоришь код получателю (хорошо, если банк тебе его в СМС отправил, можно просто переслать). 

5. Получатель идет в пункт выдачи (тут же или через день-два), предъявляет паспорт, называет код.

6. Кассир распечатывает заявление на выдачу, и после получения подписи выдает наличные. 

Дочитали? Еще недавно это было нормой. 

Что видим? Высокие транзакционные расходы – время и поход в отделение; заполнение бумажек; нужно звонить получателю и уточнять детали. Если раз в месяц отправить зарплату домой – это переносимо, а вот для кейса, когда коллеге перекинуть триста рублей – и в голову не придет.

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

Варианты: 

Первые два варианта ограничивается суммой 15.000 рублей, так как отправитель не идентифицирован. 

Шагнем лет на пять вперед в мир «пластика» – карта теперь есть у каждого, даже у ретроградов есть зарплатная карточка.  

Появляется сценарий card-to-card – межбанковский перевод по номеру карты. А что, так можно было? Уже не нужно заполнять анкету и приходить в банк самому, нужно только использовать интернет-банкинг и знать номер карты получателя.

Ну и что бы платежная система у отправителя и получателя совпадали бы. Такие переводы процессятся самой Международной платежной системой (VISA, MasterCard и др.). И еще один бенефит – не нужно знать, какой у получателя банк. МПС сама направит куда нужно.

Неудобств уже меньше, но они пока остались: номер карты не вечен, карты меняют, значит, нужно говорить номер карты каждый раз. Как вывод – его нужно “засветить”. Ну и вообще его нужно знать, то есть достать из бумажника, то есть носить с собой. И, конечно же, приходилось платить комиссию за такой перевод, поэтому часть отправителей на этом этапе отказывалась от перевода – что-то дорого, поищу лучше наличные.

Еще был вариант для принципиальных (он и сейчас есть) – перевод со счета на счет по реквизитам. Нужно знать БИК банка и номер счета получателя в нем. Такой перевод может идти пару дней, и тоже комиссия, так как у такого перевода высокая себестоимость для банков.

Пополнение баланса qiwi кошелька

Запрос используется для перевода средств с агентского счета на счет клиента в системе QIWI Wallet. Перед выполнением запроса необходимо проверить возможность проведения платежа.

Вы должны указывать тип средств, которые получены Контрагентом от клиента – наличные или безналичные средства, в параметре запроса extra name=”income_wire_transfer”.

Если клиент с указанным номером кошелька не существует в системе QIWI Wallet и проведение платежа возможно, то клиент будет создан в момент регистрации платежа.

После успешного выполнения запроса платеж начинает жизненный цикл в системе QIWI Wallet. Каждому этапу жизненного цикла соответствует свой статус платежа. Если в ответе на запрос выплаты получен нефинальный статус платежа, то для проверки успешного прохождения платежа вы должны периодически (но не чаще одного раза в 10 минут) выполнять запрос проверки статуса платежа до получения успешного или неуспешного финального статуса платежа. Коды финальных статусов указаны в списке возвращаемых API статусов платежа.

Последнее обновление: 2022-11-01

Операция используется для выплаты средств на банковские карты платежных систем. Выплата средств в системе QIWI Wallet представляет собой списание средств с авансового депозита агента и зачисление на банковские карты международных платежных систем «Visa International», «MasterCard International Incorporated», платежной системы «Мир», эмитированные кредитными организациями РФ. Платежная система определяется по номеру карты.

После выполнения запроса платеж начинает свой жизненный цикл в системе QIWI Wallet. Каждому этапу жизненного цикла соответствует свой статус платежа. Если в ответе на запрос выплаты получен нефинальный статус платежа, то для проверки успешного прохождения платежа вы должны периодически (но не чаще одного раза в 10 минут) выполнять запрос проверки статуса платежа до получения успешного или неуспешного финального статуса платежа. Коды финальных статусов указаны в списке возвращаемых API статусов платежа.

Последнее обновление: 2020-07-10

API возвращает статус платежа в атрибуте status тега <payment>.

Финальный статус означает, что жизненный цикл платежа в сервисе QIWI Wallet завершен и его статус больше не изменится.

API возвращает статусы из следующих диапазонов:

Последнее обновление: 2020-07-14

API выплат на карты и QIWI Кошельки предназначено для платежных агентов КИВИ Банк (АО), позволяет зачислять деньги на банковские карты клиентов, выпущенные платежными системами VISA, MasterCard, МИР, а также на кошельки пользователей (балансы учетных записей клиентов в системе QIWI Wallet).

Последнее обновление: 2020-10-08

Операция используется для выплаты средств на банковские карты, выпущенные зарубежными банками. Выплата средств в системе QIWI Wallet представляет собой списание средств с авансового депозита агента и зачисление на банковские карты международных платежных систем «Visa International», «MasterCard International Incorporated», эмитированные зарубежными кредитными организациями. Платежная система определяется по номеру карты.

После выполнения запроса платеж начинает свой жизненный цикл в системе QIWI Wallet. Каждому этапу жизненного цикла соответствует свой статус платежа. Если в ответе на запрос выплаты получен нефинальный статус платежа, то для проверки успешного прохождения платежа вы должны периодически (но не чаще одного раза в 10 минут) выполнять запрос проверки статуса платежа до получения успешного или неуспешного финального статуса платежа. Коды финальных статусов указаны в списке возвращаемых API статусов платежа.

Проверка возможности проведения платежа

Данным запросом вы должны проверить, возможно ли проведение платежа для пополнения учетной записи клиента в системе QIWI Wallet.

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

Проверка регистрации клиента

Данным запросом вы можете до проведения платежа проверить, зарегистрирована ли учетная запись Клиента в системе QIWI Wallet.

Проверка существования учетной записи Клиента не является обязательной для регистрации платежа. При успешной регистрации платежа отсутствующая в системе QIWI Wallet учетная запись Клиента создаётся автоматически.

Проверка статуса платежа

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

Проведение платежа считается завершенным, когда он достигает финального статуса. Значения статусов с указанием признака финальности приведены в разделе Статусы платежей.

Для проверки успешного прохождения платежа, вы должны периодически выполнять данный запрос до получения успешного или неуспешного финального статуса. Запрос позволяет получить текущий статус платежа.

Сбп плати qr (от сбербанка) для 1с (обычные и управляемые формы)

Формат xml-данных

Формат взаимодействия

Взаимодействие происходит посредством пересылки запросов и ответов на них системы QIWI Wallet. Запросы и ответы – XML-документы в кодировке UTF-8.

Формат запроса

Справка по формату значений тегов и атрибутов XML.