API по генерации QR кодов для оплаты

Документация к универсальному API для генерации QR кодов для оплаты на счёт юридического лица или ИП

Как получить QR через api

Чтобы получить QR код для любого юр.лица или ИП необходимо направить запрос GET или POST по url
https://sbqr.ru/OVO/api_png_QR_v2.php

При этом указать ряд обязательных параметров

Параметр Описание Комментарий
token Токен для доступа к api. Можно получить обратившись по почте analiticexpertpay@gmail.com
PayeeINN ИНН юр.лица или ИП
Name Наименование юр.лица или ИП
BIC БИК банка
PersonalAcc Расчётный счёт
lastName ФИО плательщика Придёт в платёжном поручение в поле «Назначение платежа», по этому значению будет понятно, кто оплатил.
Purpose Назначение
Sum Сумма рублей
sumKop Сумма копеек Можно не указывать, если копейки не используются
format Формат выходного файла Возможные значение png и svg.

Если не указывать, то по-умолчанию png.

Пример запроса.

https://sbqr.ru/OVO/api_png_QR_v2.php?token=2719d3ad1c0c2&PayeeINN=212907189988&Name=ИП Ефремов Александр Геннадьевич&BIC=049706609&PersonalAcc=40802810675000008271&lastName=Иванов Иван Иванович&Purpose=за товар или услуги&Sum=220

Можно вставить в строку адреса браузера

Результат

Пример QR код для оплаты через api

Подключить api можно оставив заказ на почту analiticexpertpay@gmail.com. Стоимость согласно тарифам

Примечание: для тестирования API можно использовать такие средства как postman

Postman получение QR код для оплаты через api

Если что то заполнили не так

Если часть обязательных атрибутов указана не правильно, то возможны следующие ответы от api

Изображение QR кода при этом не будет сформировано, пока не исправите ошибку.

Код ответа Сообщение об ошибке Как исправить
403 Закончился срок действия токена Продлить токен, написав на адрес analiticexpertpay@gmail.com
404 Токен не найден. Исправить токен или если Вы новый клиент, то запросить его по почте analiticexpertpay@gmail.com
400 Ошибочный ИНН Укажите параметр PayeeINN
400 Ошибочный расчётный счёт Укажите параметр PersonalAcc
400 Заполните корректно наименование получателя (организацию или ИП) Укажите параметр Name

Как вставить в сайт

Чтобы вставить это api в сайт или CMS, можно воспользоваться следующим подходом

Пример на HTML

<img src="https://sbqr.ru/OVO/api_png_QR_v2.php?token=2719d3ad1c0c2&PayeeINN=212907189988&Name=ИП Ефремов Александр Геннадьевич&BIC=049706609&PersonalAcc=40802810675000008271&lastName=Иванов Иван Иванович&Purpose=за товар или услуги&Sum=220" />

, где значение параметров должно определяться ранее в CMS вашего сайта.

Примечание: при передачи параметров в которых есть пробел (название организации или ФИО) неоходимо значение предварительно закодировать через url_encode() в api на php. Он кодирует символы пробелов. Чтобы значение не разрывалось.

Пример на PHP

<?php
###### выше может быть код вашей целевой страницы вашего сайта ###### 
$data['token'] = '2719d3ad1c0c2'; # ключ доступа
$data['PayeeINN'] = '212907189988'; # ИНН юр.лица
$data['Name'] = 'ИП Ефремов Александр Геннадьевич'; 
$data['BIC'] = '049706609';
$data['PersonalAcc'] = '40802810675000008271';  
$data['lastName'] = 'Иванов'; # плательщик 
        $data['Purpose'] = 'Оплата заказа № 1 с сайта';  # назначение
        $data['Sum'] = 200; # в рублях
        # 1 Формирование url запроса к API
        $url='https://sbqr.ru/OVO/api_png_QR_v2.php'
        . '?token=' . $data['token']
        . '&PayeeINN=' . $data['PayeeINN']
        . '&Name=' . $data['Name'] 
        . '&BIC=' . $data['BIC']
        . '&PersonalAcc=' . $data['PersonalAcc']  
        . '&lastName=' . $data['lastName'] 
        . '&Purpose=' . $data['Purpose'] . '&Sum' . $data['Sum'];
        # 2 Вывод полученного изображение в документ
        echo '<img src="' . $url . '" />';      
###### ниже может быть код вашей целевой страницы вашего сайта ######        

  
?>

Пример на python

###### выше может быть код вашей целевой страницы вашего сайта ###### 
data = dict()
data['token'] = '2719d3ad1c0c2'; # ключ доступа
data['PayeeINN'] = '7707089101'; # ИНН юр.лица
data['Name'] = 'ИП Ефремов Александр Геннадьевич'; 
data['BIC'] = '049706609'
data['PersonalAcc'] = '40802810675000008271'
data['lastName'] = 'Иванов'; # плательщик
data['Purpose'] = 'госпошлина за паспорт нового образца';  # назначение
data['Sum'] = 5000; # в рублях
# 1 Формирование url запроса к API
url=('https://sbqr.ru/OVO/api_png_QR_v2.php' 
     + '?token=' + data['token']
     + '&PayeeINN=' + data['PayeeINN']
     + '&Name=' + data['Name']
     + '&BIC=' + data['BIC']
     + '&PersonalAcc=' + data['PersonalAcc']
     + '&lastName=' + data['lastName']
     + '&Purpose=' + data['Purpose']
     + '&Sum=' + str(data['Sum']));
# 2 Вывод полученного изображение в документ
print('<img src="' + url + '" />'); 
      
###### ниже может быть код вашей целевой страницы вашего сайта ######        
  

Использование в Google таблицах

Данный api можно использовать в google таблицах для получения изображения QR кода для оплаты. Для этого в целевую ячейку вставить формулу, которая обратиться к api сервиса и получит изображение  https://sbqr.ru/OVO/api_png_QR_v2.php

Пример полученного QR кода в google таблицах.
Получение QR в google таблицах через api

Если у Вас стоит задача с помощью api генерировать или создавать платёжные QR коды, то Вы можете заказать их по почте analiticexpertpay@gmail.com. Стоимость работы api см. в тарифах

Есть вопросы — оставляете комментарии ниже.

Добавить комментарий

Ваш адрес email не будет опубликован.