Просмотр Исходного

{toc}

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

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

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

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

!Robokassa, основные параметры.png|border=0,width=600!

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

Перейдите в раздел [Платежные Системы - Настройки сети|CarbonBilling:Настройка сети для платежных систем] и добавьте IP-адреса платёжной системы.

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

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

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

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

Например, если у одного абонента номер договора "BILL00005", а другого такой же логин [учетной записи|CarbonBilling:Учетная запись. Создание и изменение.], скорей всего будут проблемы с зачислением платежей.

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

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


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

{warning}Примечание: номер_порта по умолчанию 1444{warning}

!Без имени.jpg|border=1,width=650!

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

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

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

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

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

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

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

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

{color:#333333}Нужно получить правильный адрес следующим образом: {color}
* В личном кабинете абонента перед инициализацией оплаты нужно в браузере вызвать _Инструменты разработчика._ В большинстве современных браузеров они вызываются клавишей *{_}F12._*
* После этого введите сумму платежа и нажмите "_Оплатить_"
* Вы будете перенаправлены на страницу оплаты с ошибкой откуда вы сможете получить необходимый URL
!robokassa_url.png|border=1!
{color:#ff0000}{*}Внимание:*{color} в браузере 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 и робокассой и сразу отладить возникающие ошибки.



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

В CarbonBilling 5 поддерживается отправка данных по платежу в ОФД для клиентов Robokassa, выбравших [Облачное|http://fiscal.robokassa.ru/#decision_block] решение, [Кассовое|https://fiscal.robokassa.ru/#decision_block] решение или [решение Робочеки.|https://fiscal.robokassa.ru/?_ga=2.82812181.2070953949.1526290936-380379276.1423060977]
!2020-08-25_18-32.png|border=1!
*Признак способа расчёта*
Возможные значения параметра:
* *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.