Robokassa

Версия 7 oleg
на ноя 10, 2014 17:23.
<< Изменения с 6 по 7
по сравнению с
Текущая Технический писатель
на мар 31, 2021 16:35.
Ключ
Эта строка удалена.
Это слово было удалено. Это слово было добавлено.
Эта строка добавлена.

Изменения (31)

просмотр истории страницы
Выполните настройки подключения, которые производятся&nbsp;через главную страницу&nbsp;веб-интерфейса администратора Carbon Billing 5 / Платежные системы. !плат5.JPG|border=1!
После включения платежной системы нужно также указать секретные логин и пароли.
{toc}

URL скрипта для&nbsp;для веб-робокассы&nbsp;будет выглядеть примерно так:
h2. Настройка в биллинге

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

{code}
http://1.2.3.4:1444/webrobokassa.php
{code}
URL скрипта для платежных терминалов будет выглядеть примерно так:
Включите платежную систему, укажите секретный логин, секретный пароль 1 и секретный пароль 2.

{code}
http://1.2.3.4:1444/robokassa.php
{code}
{info}Секретные данные указываются в личном кабинете Робокассы (описано дальше){info}

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

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

*Для webrobokassa:*&nbsp;[http://ip\_|http://ip_/]*сервера:номер_порта/webrobokassa.php*
Перейдите в раздел [Платежные Системы - Настройки сети|CarbonBilling:Настройка сети для платежных систем] и добавьте IP-адреса платёжной системы.

*Для robokassa через терминалы:&nbsp;*[http://ip\_|http://ip_/]*сервера:номер_порта/robokassa.php*
h3. Отображение в личном кабинете Wordpress

{color:#ff0000}{*}Примечание: номер_порта по умолчанию 1444.*{color}
По статье [CarbonBilling:Отображение платежных систем в личном кабинете абонента], добавьте на страницу оплаты шорткод для Robokassa.

{color:#ff0000}{*}В биллинге, на странице&nbsp;http://<Billing IP>:8081/settings/asr_fiscal/network/ надо указакать адреса (через пробел) с которых будут отправляться запросы в обработчик.*{color}
h3. Убедитесь что абоненты будут платить по верному идентификатору

{color:#000000}В полях&nbsp;"Success URL" и "Fail URL" нужно указать адрес:{color}&nbsp;[http://ip\-|http://ip-/]{color:#000000}{*}сервера/cabinet/userinfo{*}{color} !плат6.JPG|border=1!
*Пароль 1, 2*&nbsp; - те же, что указываете в консольном меню на сервере.
Основное требование стабильной работы платежей Робокассы - IP-адреса, логины, IP пользователей и номера договоров не должны повторятся в базе Carbon Billing.
Другими словами, каждый пользователь должен однозначно идентифицироваться системой по любому из указанных полей.

*Result URL, Success&nbsp;URL, Fail&nbsp;URL*&nbsp;\- укажите адрес кабинета вашего локального сайта.&nbsp;
Например, если у одного абонента номер договора "BILL00005", а другого такой же логин [учетной записи|CarbonBilling:Учетная запись. Создание и изменение.], скорей всего будут проблемы с зачислением платежей.

*Примечание:*&nbsp;основное требование стабильной работы платежей робокассы - ip-адреса, логины, id_пользователей и номера_контрактов не должны повторятся в базе Carbon Billing. Другими словами, каждый пользователь должен однозначно идентифицироваться системой по любому из указанных полей.
h2. Настройка в личном кабинете Робокассы

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


* 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*" - те же, что указываете в настройках биллинга

{info}Используется *HTTP*!{info}
{note}Примечание: номер порта по умолчанию 1444{note}

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

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

...
_Для проверки оплаты через сервис робокассы нужно сформировать правильный URL._
1. Для этого нужно в личном кабинете пользователя, на вкладке оплата ввести сумму для оплаты через робокассу и нажать "оплатить".
После этого получим URL запроса вида [https://merchant.roboxchange.com/Index.aspx?MrchLogin=&OutSum=100&InvId=2457135&Desc=Contract%20number%200000012&SignatureValue=365c90e732ae61c980ef7e1951a028fd&nbsp];который отправляется на сервер платежной системы.

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

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

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

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

...

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



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

В CarbonBilling 5 поддерживается отправка данных по платежу в ОФД для&nbsp;клиентов Robokassa, выбравших [Облачное|http://fiscal.robokassa.ru/#decision_block]&nbsp;решение,&nbsp;[Кассовое|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*&nbsp;--- предоплата 100%. Полная предварительная оплата до момента передачи предмета расчёта;
* *prepayment*&nbsp;--- предоплата. Частичная предварительная оплата до момента передачи предмета расчёта;
* *advance&nbsp;*--- аванс;
* *full_payment*&nbsp;--- полный расчёт. Полная оплата, в том числе с учетом аванса (предварительной оплаты) в момент передачи предмета расчёта;
* *partial_payment*&nbsp;--- частичный расчёт и кредит. Частичная оплата предмета расчёта в момент его передачи с последующей оплатой в кредит;
* *credit*&nbsp;---&nbsp;передача в кредит. Передача предмета расчёта без его оплаты в момент его передачи с последующей оплатой в кредит;
* *credit_payment*&nbsp;--- оплата кредита. Оплата предмета расчёта после его передачи с оплатой в кредит (оплата кредита).

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

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

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

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

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

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

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

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

Допустимые значения:
* «*none*» -- без НДС;
* «*vat0*» -- НДС по ставке 0%;
* «*vat10*» -- НДС чека по ставке 10%;
* «*vat110*» -- НДС чека по расчетной ставке 10/110;
* «*vat20*»&nbsp;-- НДС чека по ставке 20%;&nbsp;
* «*vat120*»&nbsp;-- НДС чека по расчетной ставке 20/120.&nbsp;