Page tree
Skip to end of metadata
Go to start of metadata

Параметры необходимые для инициализации платежа:

Имя параметраВерсия APIЗначениеПримеры/примечания
key1.0ключ (идентификатор сервиса), присваиваемый системой при «создании кнопки» в личном кабинете“b5/uqup/i/ueWBrRyp9V0n97zyHty5YtV5u/NW27nlk=
cost1.0, 2.0сумма в рублях, которую клиент должен заплатить100 (если сумма передаётся с копейками, то использовать разделитель "точка", напр. 100.65)
name1.0, 2.0Описание оплачиваемого товара/услуги. Отображается на странице оплаты.Не более 128 символов. Пример: Заказ №212
email1.0, 2.0электронная почта клиента
поле обязательно для рекуррентных платежей, для остальных вариантов оплаты необходимость ввода регулируется в настройках сервиса
test@test.com
phone_number1.0, 2.0телефонный номер плательщика
необходимость обязательного ввода регулируется в настройках сервиса и параметрами платежного канала
74951234567
order_id1.0, 2.0Цифровое поле, обязательно
Номер заказа в системе партнера, должен быть уникальным. Дважды заказ с одинаковым order_id оплатить не удастся. Если нет необходимости определять каждый заказ, то значение order_id нужно сделать равным 0. Максимальная длина 64 символа.
Для рекуррентных платежей длина >=6 символов

100001 

Допускается использование латиницы. Кириллица не поддерживается (будет получена ошибка при создание транзакции).

 "Уже существует заказ с order_id XXXXX. Старый номер XXXXXXXXX"

Существует механизм проверки номера заказа (order_id) на уникальность. Это не ошибка. Предупреждение, которое вы видите в таких случаях - результат этой проверки.
Ссылка или кнопка - это генератор. Каждый переход по ней - это попытка создать новую транзакцию с тем номером, который ссылка в данный момент передаёт. Передача одинакового номера заказа из админки магазина (CMS) приводит к тому же результату.

Пример ссылки, содержащей номер заказа:
https://partner.rficb.ru/alba/input/?name=Rent_hall&cost=15200&key=Agl%2FskVOgsU6ZizcKvXjIlWhNJPyYri9x0J%2BY9ex6C0%3D&default_email=&order_id=192032

Пример алгоритма получения предупреждения:

  1. Первый клик создал транзакцию 3950000001 с номером заказа 192032. Оплата не состоялась, плательщик закрыл браузер.
  2. Через некоторое время плательщик нажал на эту ссылку снова. Банковский шлюз попытался создать транзакцию 3950000002 с номером заказа 192032.
  3. Предупреждение. Существование двух разных транзакций с одинаковым номером невозможно!

Если вы хотите избежать такого поведения, передавайте новый номер заказа на каждый клик по кнопке из корзины или ссылке. Если вы продолжаете получать предупреждение "Уже существует заказ с order_id XXXXX. Старый номер XXXXXXXXX", значит ваш магазин по каждому клику присылает одно и то же. Вы можете убедиться в существовании транзакции с указанным в предупреждении "старым" номером, проверив раздел "Отчёты".

comment1.0, 2.0Комментарий платежа. Вы можете передавать через него любую свою информацию. Информация переданная в данном параметре не отображается на странице оплаты и может использоваться для внутренних нужд магазина.Текстовое поле, не более 512 символов
invoice_data1.0, 2.0Данные в формате json для фискального чека (см. API для АТОЛ)htmlspecialchars JSON
custom_fields1.0, 2.0Опциональный параметр. Предназначен для передачи дополнительной информации в различные каналы оплатыurlencoded словарь JSON
check*2.0Подпись версии 2.0 – электронная подпись запроса. См. приложение №1

Обязательна передача параметра version=’2.0’ и service_id.

Параметр key в данном случае не требуется.

service_id2.0Идентификатор сервиса, обязательно для версии 2.0121233
version2.0Строка. Обязательно для установки версии API, отличного от 1.0. Если не задано используется версия API 1.0.2.0

check*

(устаревшее)

1.0MD5 хеш от параметров: key + cost + name + email + order_id + comment + payment_type + secret_key

*

Принудительная проверка подписи активируется администратором РФИ в настройках сервиса магазина.


Для рекуррентных операций необходимо передавать дополнительные поля, см описание работы рекуррентных платежей.

  • No labels