# Выполните настройки подключения, которые производятся через главную страницу веб-интерфейса администратора Carbon Billing 5 / Платежные системы.
Сначала необходимо включить платежную систему и указать секретный логин, выданный Робокассой:
!2020-08-25_18-26.png|border=1!
После включения платежной системы нужно также указать секретные пароли, также выданные Робокассой:
!2020-08-25_18-26_1.png|border=1!
URL скрипта для для веб-робокассы будет выглядеть примерно так:
\\
\\
{code}
http://ip_сервера:1444/webrobokassa.php
{code}
URL скрипта для платежных терминалов будет выглядеть примерно так:
\\
\\
{code}
http://ip_сервера:1444/robokassa.php
{code}
\\
\\
# Для корректного поступления платежей от системы Robokassa необходимо разрешить доступ к биллингу от платежного сервера. Перейдите в раздел [Платежные Системы - Настройки сети|CarbonBilling:Настройка сети для платежных систем] и добавьте адреса.
h2. Сервер Robokassa
В личном кабинете на сайте робокассы также нужно добавить параметры для взаимодействия с сервером Carbon Billing. В поле "Result URL" нужно выбрать метод отсылки данных GET, а в качестве адреса для взаимодействия указать обработчик запросов на сервере:
*Для webrobokassa:* [http://ip\_|http://ip_/]*сервера:номер_порта/webrobokassa.php*
*Для robokassa через терминалы: *[http://ip\_|http://ip_/]*сервера:номер_порта/robokassa.php*
{color:#ff0000}{*}Примечание: номер_порта по умолчанию 1444.*{color}
{color:#ff0000}{*}В биллинге, на странице http://<Billing IP>:8081/settings/asr_fiscal/network/ надо указать адреса (через пробел) с которых будут отправляться запросы в обработчик.*{color}
{code}
tcpdump -nnvi any tcp port 1444
{code}
!Без имени.jpg|border=1!
{color:#000000}В полях "Success URL" и "Fail URL" нужно указать адрес:{color} [http://ip\-|http://ip-/]{color:#000000}{*}сервера/cabinet/welcome{*}{color}
*Пароль 1, 2* - те же, что указываете в консольном меню на сервере.
*Примечание:* основное требование стабильной работы платежей робокассы - ip-адреса, логины, id_пользователей и номера_контрактов не должны повторятся в базе Carbon Billing. Другими словами, каждый пользователь должен однозначно идентифицироваться системой по любому из указанных полей.
h2. Отображение в личном кабинете Wordpress
Добавить на страницу оплаты шорткод для _ROBOKASSA_ [CarbonBilling:Отображение платежных систем в личном кабинете абонента]
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.
Сначала необходимо включить платежную систему и указать секретный логин, выданный Робокассой:
!2020-08-25_18-26.png|border=1!
После включения платежной системы нужно также указать секретные пароли, также выданные Робокассой:
!2020-08-25_18-26_1.png|border=1!
URL скрипта для для веб-робокассы будет выглядеть примерно так:
\\
\\
{code}
http://ip_сервера:1444/webrobokassa.php
{code}
URL скрипта для платежных терминалов будет выглядеть примерно так:
\\
\\
{code}
http://ip_сервера:1444/robokassa.php
{code}
\\
\\
# Для корректного поступления платежей от системы Robokassa необходимо разрешить доступ к биллингу от платежного сервера. Перейдите в раздел [Платежные Системы - Настройки сети|CarbonBilling:Настройка сети для платежных систем] и добавьте адреса.
h2. Сервер Robokassa
В личном кабинете на сайте робокассы также нужно добавить параметры для взаимодействия с сервером Carbon Billing. В поле "Result URL" нужно выбрать метод отсылки данных GET, а в качестве адреса для взаимодействия указать обработчик запросов на сервере:
*Для webrobokassa:* [http://ip\_|http://ip_/]*сервера:номер_порта/webrobokassa.php*
*Для robokassa через терминалы: *[http://ip\_|http://ip_/]*сервера:номер_порта/robokassa.php*
{color:#ff0000}{*}Примечание: номер_порта по умолчанию 1444.*{color}
{color:#ff0000}{*}В биллинге, на странице http://<Billing IP>:8081/settings/asr_fiscal/network/ надо указать адреса (через пробел) с которых будут отправляться запросы в обработчик.*{color}
{code}
tcpdump -nnvi any tcp port 1444
{code}
!Без имени.jpg|border=1!
{color:#000000}В полях "Success URL" и "Fail URL" нужно указать адрес:{color} [http://ip\-|http://ip-/]{color:#000000}{*}сервера/cabinet/welcome{*}{color}
*Пароль 1, 2* - те же, что указываете в консольном меню на сервере.
*Примечание:* основное требование стабильной работы платежей робокассы - ip-адреса, логины, id_пользователей и номера_контрактов не должны повторятся в базе Carbon Billing. Другими словами, каждый пользователь должен однозначно идентифицироваться системой по любому из указанных полей.
h2. Отображение в личном кабинете Wordpress
Добавить на страницу оплаты шорткод для _ROBOKASSA_ [CarbonBilling:Отображение платежных систем в личном кабинете абонента]
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.