... {toc}
h2. Настройка в биллинге
h3. Включите платёжную систему и укажите данные доступа к API платёжной системы
Включите платежную систему, укажите секретный логин, секретный пароль 1 и секретный пароль 2.
{info}Секретные данные указываются в личном кабинете Robokassa (описано дальше){info}
!Robokassa, основные параметры.png|border=0,width=600!
h3. Разрешите платёжной системе доступ к Result URL в биллинге
Перейдите в раздел [Платежные Системы - Настройки сети|CarbonBilling:Настройка сети для платежных систем] и добавьте IP-адреса платёжной системы.
h3. Отображение в личном кабинете Wordpress
По статье [CarbonBilling:Отображение платежных систем в личном кабинете абонента], добавьте на страницу оплаты шорткод для Robokassa.
h3. Убедитесь что абоненты будут платить по верному идентификатору
Основное требование стабильной работы платежей Robokassa - IP-адреса, логины, IP пользователей и номера договоров не должны повторятся в базе Carbon Billing.
Другими словами, каждый пользователь должен однозначно идентифицироваться системой по любому из указанных полей.
Например, если у одного абонента номер договора "BILL00005", а другого такой же логин [учетной записи|CarbonBilling:Учетная запись. Создание и изменение.], скорей всего будут проблемы с зачислением платежей.
h2. Настройка в личном кабинете Robokassa
В личном кабинете на сайте Robokassa также нужно добавить параметры для взаимодействия с сервером Carbon Billing. В поле "Result URL" нужно выбрать метод отсылки данных GET, а в качестве адреса для взаимодействия указать обработчик запросов на сервере:
* Result URL для *web-robokassa*:
{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*" - те же, что указываете в настройках биллинга
{info}Используется *HTTP*\!{info}
{note}Примечание: номер порта по умолчанию 1444{note}
!Без имени.jpg|border=1,width=650!
h2. Проверка работы Robokassa
*Использовать тестовый сервер можно только в том случае если ваш мерчант еще не активирован. Если же вы уже провели активацию своего мерчанта, то тестовый сервер будет недоступен.*
Проверить корректность настроек сервера можно на тестовой странице сервиса Robokassa [http://robokassa.ru/ru/DocTest/Ru/Interface.aspx|http://robokassa.ru/ru/DocTest/Ru/Interface.aspx]
Приведенные рекомендации и примеры касаются только интерфейса оплаты и не относятся к XML интерфейсам.
*Инициализация оплаты*
_Для проверки оплаты через сервис Robokassa нужно сформировать правильный URL._
1. Для этого нужно в личном кабинете пользователя, на вкладке оплата ввести сумму для оплаты через Robokassa и нажать "оплатить".
После этого получим 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-error.png|border=1!
* Внимание:*{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. Вы попадете на форму тестов Robokassa где можно проконтроллировать обмен запросами между сервером Carbon Billing и Robokassa и сразу отладить возникающие ошибки.
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*» -- патентная СН.
*Налоговая ставка в ККТ*
Это поле устанавливает налоговую ставку в ККТ. Определяется для каждого вида товара по отдельности, но за все единицы конкретного товара вместе.
|
