Перейти к содержанию

Уведомления о ЕРИП платежах

Для информирования вашей IT-системы об изменениях статуса платежного требования и об осуществленной оплате bePaid использует механизм уведомлений на адрес, указанный в notification_url запроса.

Уведомления - это POST-запросы с вашими авторизационными данными и содержащие JSON-сообщения с данными платёжного требования.

Проверяйте авторизационные данные, чтобы убедиться, что запрос пришел от bePaid.

Уведомления приходят в случае изменения статуса операции на pending, expired, failed или successful.

Параметры сообщения

Параметр Тип Описание
transaction object
status string Статус платежа.
message string Сообщение системы
type string payment
amount integer Сумма платежа в копейках.
currency string Валюта BYN
description string Описание заказа.
uid string uid транзакции.
id string id транзакции.
order_id string Значение order_id из платежного запроса.
tracking_id string Значение tracking_id или order_id из платежного запроса.
expired_at string Дата, до которой действует платёж. Данный параметр отсутствует, если у платежа нет срока действия. Смотрите описание формата в expired_at запроса на оплату.
paid_at string Дата, когда был оплачен платёж. Данный параметр отсутствует, если платеж еще не оплачен. Смотрите описание формата в expired_at запроса на оплату.
created_at string Время создания платёжного требования.
language string Значение параметра language из запроса или en по умолчанию.
test boolean true, если платежный запрос является тестовым. Иначе, false.
payment_method_type string erip
additional_data object Секция, содержащая дополнительную информацию о платеже.
notifications array Типы уведомлений, отправляемых клиентам при создании платежных требований.
receipt_text array Массив строк текста, который будет добавлен в письмо клиенту.
billing_address object Секция информации о покупателе.
first_name string Имя покупателя.
middle_name string Отчество покупателя.
last_name string Фамилия покупателя.
country string Страна покупателя.
city string Город покупателя.
zip string Почтовый индекс или zip-код покупателя.
address string Адрес покупателя.
phone string Телефонный номер покупателя.
customer object Секция информации о покупателе.
ip string IP адрес покупателя.
email string Электронная почта покупателя.
payment object Секция оплаты
ref_id string Идентификационный номер транзакции в ЕРИП.
message string Сообщение ЕРИП.
status string Статус операции в ЕРИП.
gateway_id string Идентификатор внутреннего платежного шлюза.
erip object Данные о ЕРИП платеже.
request_id integer Номер запроса в ЕРИП.
service_no integer Код услуги ЕРИП, присвоенный bePaid.
account_number string Номер заказа/услуги/договора, для оплаты через ЕРИП.
transaction_id integer Номер операции в ЕРИП.
instruction array Массив строк информации, которая описывает путь в дереве ЕРИП для нахождения платежного поручения.
service_info array Массив строк информации, которая будет показана плательщику перед подтверждением оплаты через ЕРИП и описывающая за что происходит оплата.
receipt array Массив строк информации, которая будет отображена на чеке-подтверждении оплаты через ЕРИП.
agent_code integer Код платежного агента, принявшего платеж.
agent_name string Имя платежного агента, принявшего платеж.
service_no_erip integer Код услуги, присвоенный ЕРИП.
qr_code_raw string Закодированные в base64 данные для генерации QR-кода.
qr_code string Закодированная в base64 PNG картинка QR-кода. Для отображения QR-кода на сайте нужно вставить значение qr_code в img HTML тэг: <img src="здесь значение qr_code">.
Пример уведомления
{
  "transaction":{
    "status":"pending",
    "message":"Требование на оплату счёта создано.",
    "type":"payment",
    "id":"8759cf84-e56d-44b7-a8ae-62640f6402c4",
    "uid":"8759cf84-e56d-44b7-a8ae-62640f6402c4",
    "order_id":"100000003495",
    "amount":22000,
    "currency":"BYR",
    "description":"Оплата заказа #123",
    "tracking_id":"AB8923",
    "created_at":"2015-12-07T14:21:24.420Z",
    "expired_at":"2016-12-07T14:21:240Z",
    "paid_at":"2016-12-07T14:40:120Z",
    "test":true,
    "payment_method_type":"erip",
    "billing_address":{
        "first_name":"Иван",
        "middle_name": "Иванович",
        "last_name":"Петров",
        "country":"BY",
        "city":"Минск",
        "address":"ул. Независимости, 1",
        "zip":"220000",
        "phone":"+375172000000"
    },
    "customer":{
        "email":"ivanpetrov@example.com",
        "ip":"127.0.0.7"
    },
    "payment":{
        "ref_id":null,
        "message":null,
        "status":"pending",
        "gateway_id":1
    },
    "erip":{
        "request_id":"00000001",
        "service_no":99999999,
        "account_number":"123",
        "transaction_id":"0000001",
        "service_info":["Оплата заказа 123"],
        "instruction": ["'Расчёт' ЕРИП-> Интернет-магазины/сервисы-> B -> bePaid.by"],
        "receipt":["Спасибо за оплату заказа 123"]
    }
  }
}