Documentation

Documentation

  • API Банка 131
  • Languages iconРусский
    • English

›Прием платежей

Документация

  • Возможности API
  • С чего начать

Работа с API

  • Формат работы
  • Библиотеки
  • Тестирование
  • История изменений

Массовые выплаты

  • Возможности
  • Как всё работает
  • Сценарии выплат
  • Возвраты выплат
  • Самозанятые

    • Выплаты самозанятым
    • Фискализация без выплаты

    Способы получения выплат

    • На российскую банковскую карту
    • На счет в российском банке
    • В кошелек QIWI
    • В кошелек ЮMoney (Яндекс.Деньги)
    • В налоговую
    • Через СБП по номеру телефона

    Выплаты по шагам

    • Выплата на карту с виджетом
    • Выплата с расчетного счета
    • Выплата с номинального счета
    • Выплата в иностранной валюте
    • Выплата одним запросом
    • Выплата на карту с PCI DSS
    • Выплата самозанятому с фискализацией

Прием платежей

  • Возможности
  • Процесс платежа
  • Платеж банковской картой
  • Платежи с холдированием
  • Возвраты
  • Рекуррентные платежи
  • Платежи через СБП по QR-коду
  • Платеж кошельком QIWI
  • Сплит-платежи

    • Варианты и возможности
    • Сплит-платежи без доработок
    • Сплит-платежи по API

    Платежи по шагам

    • Оплата через платежную форму
    • Оплата с PCI DSS
    • Платеж одним запросом

Виджеты

  • Виджет для токенизации карты
  • Виджет платежной формы
  • Виджет для привязки самозанятого

Проверка паспорта

  • Возможности
  • Взаимодействие
  • Методы

    • Проверка паспорта
    • Статус проверки
  • Ответы и ошибки

Самозанятые

  • Общая информация
  • Привязка
  • Проверка привязки
  • Проверка данных
  • Оповещения из ФНС
  • Начисления и бонусы

Акты и реестры

  • Реестр выплат
  • Реестр платежей
  • Акт

Справочник API

  • Объекты
  • Методы
  • Вебхуки
  • Коды ошибок

Платежи через СБП по QR-коду

Вы можете принимать платежи через Систему быстрых платежей (СБП) по QR-коду. Для этого вам надо предварительно пройти регистрацию в Банке 131 с тем, чтобы:

  • получить идентификатор юридического лица в СБП;
  • зарегистрировать расчетный счет вашего юридического лица в СБП.

После успешной регистрации вам нужно разместить на странице оплаты ссылку на оплату через СБП по QR-коду.

Cценарий получения платежа через СБП по QR-коду

  1. Создайте платежную сессию session/create.
  2. Отправьте запрос на проведение платежа с помощью метода session/start/payment.
  3. Дождитесь вебхука action_required от Банка 131.
  4. Покажите пользователю QR-код для оплаты.
  5. Дождитесь от Банка 131 вебхука payment_finished с результатом проведения платежа. Статус succeeded сообщает вам, что платеж успешно проведен.

Пример запроса на создание платежной сессии

curl -X POST \
  https://demo.bank131.ru/api/v1/session/create \
  -H 'Content-Type: application/json' \
  -H 'X-PARTNER-PROJECT: your_project_name' \
  -H 'X-PARTNER-SIGN: 721af394d5a7aefd0e91f5390abc4d7e20fb2b5784b091fef621f3c61b7abb4b' \
  -d '{
    "payment_details": {
        "type": "faster_payment_system"
    },
    "amount_details": {
        "amount": 5000,
        "currency": "rub"
    },
    "customer": {
        "reference": "lucky"
    }
}

Пример успешного ответа

{
    "status": "ok",
    "session": {
        "id": "ps_2986",
        "status": "in_progress",
        "created_at": "2021-04-27T16:15:00.354384Z",
        "updated_at": "2021-04-27T16:15:00.402138Z",
        "acquiring_payments": [
            {
                "id": "pm_5000",
                "status": "in_progress",
                "created_at": "2021-04-27T16:15:00.405618Z",
                "customer": {
                    "reference": "lucky"
                },
                "payment_details": {
                    "type": "faster_payment_system"
                },
                "amount_details": {
                    "amount": 5000,
                    "currency": "rub"
                },
                "amounts": {
                    "gross": {
                        "amount": 5000,
                        "currency": "rub"
                    }
                }
            }
        ]
    }
}

Пример вебхука action_required с QR-кодом

{
    "status": "ok",
    "session": {
        "id": "ps_2986",
        "status": "in_progress",
        "created_at": "2021-04-27T16:15:00.354384Z",
        "updated_at": "2021-04-27T16:15:00.491522Z",
        "acquiring_payments": [
            {
                "id": "pm_5000",
                "status": "pending",
                "created_at": "2021-04-27T16:15:00.405618Z",
                "customer": {
                    "reference": "lucky"
                },
                "payment_details": {
                    "type": "faster_payment_system"
                },
                "amount_details": {
                    "amount": 5000,
                    "currency": "RUB"
                },
                "amounts": {
                    "net": {
                        "amount": 5000,
                        "currency": "RUB"
                    },
                    "gross": {
                        "amount": 5000,
                        "currency": "RUB"
                    }
                },
                "customer_interaction": {
                    "type": "inform",
                    "inform": {
                        "qr": {
                            "content": "https://qr.nspk.ru/AD10004AO4DQJ54B9Q0PLEGTD7V5UEQT?type=01&bank=100000000153&sum=5000&cur=RUB&crc=CEAB",
                            "img": "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"
                        }
                    }
                }
            }
        ]
    }
}

Возврат платежей через СБП

Сценарий возврата платежей через СБП ничем не отличается от стандартного.

← Рекуррентные платежиПлатеж кошельком QIWI →
  • Cценарий получения платежа через СБП по QR-коду
  • Возврат платежей через СБП
Documentation
Документация
Массовые выплатыПрием платежейСправочник APIЮридические документы
Сценарии по шагам
Выплата на карту с токеномВыплата на карту с PCI DSSВыплата самозанятомуОплата через платежную форму
Напишите нам
Предложения и идеи — partners@131.ruПресса — press@131.ru
© 2022 Банк 131