Robokassa

Skip to end of metadata
Go to start of metadata

Настройка в биллинге

Включите платёжную систему и укажите данные доступа к API платёжной системы

Включите платежную систему, укажите секретный логин, секретный пароль 1 и секретный пароль 2.

Секретные данные указываются в личном кабинете Робокассы (описано дальше)

Разрешите платёжной системе доступ к Result URL в биллинге

Перейдите в раздел Платежные Системы - Настройки сети и добавьте IP-адреса платёжной системы.

Отображение в личном кабинете Wordpress

По статье Отображение платежных систем в личном кабинете абонента, добавьте на страницу оплаты шорткод для Robokassa.

Убедитесь что абоненты будут платить по верному идентификатору

Основное требование стабильной работы платежей Робокассы - IP-адреса, логины, IP пользователей и номера договоров не должны повторятся в базе Carbon Billing.
Другими словами, каждый пользователь должен однозначно идентифицироваться системой по любому из указанных полей.

Например, если у одного абонента номер договора "BILL00005", а другого такой же логин учетной записи, скорей всего будут проблемы с зачислением платежей.

Настройка в личном кабинете Робокассы

В личном кабинете на сайте робокассы также нужно добавить параметры для взаимодействия с сервером Carbon Billing. В поле "Result URL" нужно выбрать метод отсылки данных GET, а в качестве адреса для взаимодействия указать обработчик запросов на сервере:

  • Result URL для веб-робокассы:
    http://ip_сервера:1444/webrobokassa.php
    
  • Result URL для платежных терминалов:
    http://ip_сервера:1444/robokassa.php
    
  • В полях "Success URL" и "Fail URL" нужно указать адрес:
    http://169.254.0.80/cabinet/welcome
  • Задайте "Пароль 1" и "Пароль 2" - те же, что указываете в настройках биллинга
Используется HTTP!
Примечание: номер порта по умолчанию 1444

Проверка работы Robokassa

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

Проверить корректность настроек сервера можно на тестовой странице сервиса робокассы http://robokassa.ru/ru/DocTest/Ru/Interface.aspx

Приведенные рекомендации и примеры касаются только интерфейса оплаты и не относятся к XML интерфейсам.

Инициализация оплаты

Для проверки оплаты через сервис робокассы нужно сформировать правильный URL.
1. Для этого нужно в личном кабинете пользователя, на вкладке оплата ввести сумму для оплаты через робокассу и нажать "оплатить".

После этого получим URL запроса вида https://merchant.roboxchange.com/Index.aspx?MrchLogin=login&OutSum=100&InvId=2457135&Desc=Contract%20number%200000012&SignatureValue=365c90e732ae61c980ef7e1951a028fd который отправляется на сервер платежной системы.

Но сейчас большинство браузеров в адресной строке возвращают результирующий URL вида https://merchant.roboxchange.com/Merchant/Error/Common/478bd9e2-dc51-447c-b687-dc78e8057449. Не модифицируйте этот адрес!

Нужно получить правильный адрес следующим образом: 

  • В личном кабинете абонента перед инициализацией оплаты нужно в браузере вызвать Инструменты разработчика. В большинстве современных браузеров они вызываются клавишей F12.
  • После этого введите сумму платежа и нажмите "Оплатить"
  • Вы будете перенаправлены на страницу оплаты с ошибкой откуда вы сможете получить необходимый URL

    Внимание: в браузере Chrome есть проблемы с копированием URL из окна инструментов. В примере использовался Firefox

2. Модифицировать полученный URL - заменить https://merchant.roboxchange.com/;на http://test.robokassa.ru/;

В итоге у вас должен получиться URL вида http://test.robokassa.ru/Index.aspx?MrchLogin=&OutSum=100&InvId=2457135&Desc=Contract%20number%200000012&SignatureValue=365c90e732ae61c980ef7e1951a028fd, который нужно вставить в адресную строку браузера и перейти по ней.

3. Вы попадете на форму тестов робокассы где можно проконтроллировать обмен запросами между сервером Carbon Billing и робокассой и сразу отладить возникающие ошибки.

Фискализация для клиентов Robokassa

В CarbonBilling 5 поддерживается отправка данных по платежу в ОФД для клиентов Robokassa, выбравших Облачное решение, Кассовое решение или решение Робочеки.

Признак способа расчёта
Возможные значения параметра:

  • full_prepayment --- предоплата 100%. Полная предварительная оплата до момента передачи предмета расчёта;
  • prepayment --- предоплата. Частичная предварительная оплата до момента передачи предмета расчёта;
  • advance --- аванс;
  • full_payment --- полный расчёт. Полная оплата, в том числе с учетом аванса (предварительной оплаты) в момент передачи предмета расчёта;
  • partial_payment --- частичный расчёт и кредит. Частичная оплата предмета расчёта в момент его передачи с последующей оплатой в кредит;
  • credit --- передача в кредит. Передача предмета расчёта без его оплаты в момент его передачи с последующей оплатой в кредит;
  • credit_payment --- оплата кредита. Оплата предмета расчёта после его передачи с оплатой в кредит (оплата кредита).

Этот параметр необязательный. Если этот параметр не передан клиентом, то в чеке будет указано значение параметра по умолчанию из Личного кабинета, если же параметр передан клиентом, то именно эти значения параметра будут переданы в АТОЛ.

Признак предмета расчёта
Возможные значения параметра:

  • commodity --- товар. О реализуемом товаре, за исключением подакцизного товара (наименование и иные сведения, описывающие товар);
  • excise --- подакцизный товар. О реализуемом подакцизном товаре (наименование и иные сведения, описывающие товар);
  • job --- работа. О выполняемой работе (наименование и иные сведения, описывающие работу);
  • service --- услуга. Об оказываемой услуге (наименование и иные сведения, описывающие услугу);
  • gambling_bet --- ставка азартной игры. О приеме ставок при осуществлении деятельности по проведению азартных игр;
  • gambling_prize --- выигрыш азартной игры. О выплате денежных средств в виде выигрыша при осуществлении деятельности по проведению азартных игр;
  • lottery --- лотерейный билет. О приеме денежных средств при реализации лотерейных билетов, электронных лотерейных билетов, приеме лотерейных ставок при осуществлении деятельности по проведению лотерей;
  • lottery_prize --- выигрыш лотереи. О выплате денежных средств в виде выигрыша при осуществлении деятельности по проведению лотерей;
  • intellectual_activity --- предоставление результатов интеллектуальной деятельности. О предоставлении прав на использование результатов интеллектуальной деятельности или средств индивидуализации;
  • payment --- платеж. Об авансе, задатке, предоплате, кредите, взносе в счет оплаты, пени, штрафе, вознаграждении, бонусе и ином аналогичном предмете расчета;
  • agent_commission --- агентское вознаграждение. О вознаграждении пользователя, являющегося платежным агентом (субагентом), банковским платежным агентом (субагентом), комиссионером, поверенным или иным агентом;
  • composite --- составной предмет расчета. О предмете расчета, состоящем из предметов, каждому из которых может быть присвоено значение выше перечисленных признаков;
  • another --- иной предмет расчета. О предмете расчета, не относящемуся к выше перечисленным предметам расчета; 
  • property_right -- имущественное право;
  • non-operating_gain -- внереализационный доход; 
  • insurance_premium -- страховые взносы; 
  • sales_tax -- торговый сбор;
  • resort_fee -- курортный сбор.

Этот параметр необязательный. Если этот параметр не передан клиентом, то в чеке будет указано значение параметра из Личного кабинета, если же параметр передан клиентом, то именно это значение параметра будут переданы в АТОЛ.

Система налогообложения

Необязательное поле, если у организации имеется только один тип налогообложения.

Перечисление со значениями:

  • «osn» – общая СН;
  • «usn_income» – упрощенная СН (доходы);
  • «usn_income_outcome» – упрощенная СН (доходы минус расходы);
  • «envd» – единый налог на вмененный доход;
  • «esn» – единый сельскохозяйственный налог;
  • «patent» – патентная СН.

Налоговая ставка в ККТ

Это поле устанавливает налоговую ставку в ККТ. Определяется для каждого вида товара по отдельности, но за все единицы конкретного товара вместе.

Допустимые значения:

  • «none» – без НДС;
  • «vat0» – НДС по ставке 0%;
  • «vat10» – НДС чека по ставке 10%;
  • «vat110» – НДС чека по расчетной ставке 10/110;
  • «vat20» -- НДС чека по ставке 20%; 
  • «vat120» -- НДС чека по расчетной ставке 20/120. 
Введите метки, чтобы добавить к этой странице:
Please wait 
Ищите метку? просто начните печатать.