что такое алгоритм расчета хеша робокасса

Оплата заказов на сайте через Робокассу

В данной статье описан процесс оплаты заказа на сайте с помощью Робокассы. Перед тем, как преступить работе над скриптами оплаты, необходимо заполнить анкету, создать магазин и ознакомиться с документацией.

Настройка магазина в Робокассе

Для корректной работы скриптов потребуется сделать настройки в разделе «Мои магазины» – «Настройки» – вкладка «​Технические настройки».

В форме нужно заполнить следующие поля:

Настройки сайта

На сайте заказы будут хранится в таблице `orders` c полями:

Формирование ссылки на оплату

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

Для упращениния отладки платежей, нужно включить тестовый режим, добавив в URL параметр IsTest=1 (не нужно будет вводить реквизиты карт).

Скрипт оформления заказа:

Перейдя по сформированной ссылки, откроется форма оплаты на робокассе:

Обработка платежа

После того, как пользователь успешно оплатил заказ, он будет перенаправлен на «Success Url» с добавлением GET-параметров с данными платежа:

В PHP-скрипте нужно сверить SignatureValue и обновить статус заказа в базе данных.

Скрипт pay_success.php

Т.к. пользователь может не вернутся обратно на сайт, Робакасса отправляет дополнительный запрос на «Result Url» с ожиданием ответа, пример такого запроса:

Скрипт pay_result.php

В случаи отмены операции, пользователь перенаправляется на «Fail Url»:

Скрипт pay_error.php

Источник

Робокасса

ПОДКЛЮЧЕНИЕ РОБОКАССЫ

Поддерживаемые валюты: RUB.

Подключить Робокассу могут: Юр.лица, ИП, Физ.лица.

Для проведения платежей через Робокассу не обязательно покупать или арендовать онлайн-кассу. Все чеки могут формироваться кассами Робокассы, отправляться вашим клиентам, а также в налоговую в строгом соответствии с 54-ФЗ.

2. На шаге создания магазина указывайте адрес сайта через https:// и без www:

Через httpS, чтобы не было случайной ошибки с указанием технических адресов. Если в дальнейшем технический адрес указать через обычный протокол http, а не через https, интеграция не будет работать;

3. Укажите правильные технические настройки магазина. Они отличаются от примера на странице Робокассы:

Заметка: после подключения интеграции будут созданы две страницы. Страница успешного и неудачного платежа. Эти страницы, как и любые другие, можно редактировать.

Параметры проведения тестовых платежей:

4. На шаге подключения онлайн кассы можно выбрать любой вариант, кроме «Самостоятельное»:

Укажите идентификатор магазина;

Пароль 1 и Пароль 2 от параметров для тестовых платежей;

Включите параметр «Тестовые платежы»;

6. Откройте в редакторе ту страницу, с которой будет выполняться переход к оплате и настройте переход к оплате:

Если хотите сделать «Заказ в один клик»:

1) Добавьте виджет «Блок», установив роль «Карточка товара» и поместите в этот виджет ещё один виджет «Текст»;

2) Для первого виджета «Текст» установите роль «Название товара»;

4) Поместите в карточку товара форму и в настройках действий формы выберите «Переход к оплате».

Тяжело понять? Читайте здесь подробное описание.

Если хотите настроить переход к оплате из корзины:

2) В настройках формы, что в корзине, выберите действие «Переход к оплате»:

3) Опубликуйте страницу, чтобы применить внесенные изменения и провести тестовый платеж.

8. Если тестовый платеж прошел успешно:

Замените в настройках интеграции Пароль 1 и Пароль 2 на боевые;

Отключите параметр «Тестовый платежы»;

Cохраните настройки интеграции;

Теперь можно проверить работу боевых (реальных) платежей на опубликованной странице:

Источник

Как обмануть Робокассу

Если точнее, как обмануть сердобольных физических лиц, берущих комиссию за покупку на себя. Возможно, заголовок слишком громкий, возможно это и не статья вовсе (особенно учитывая, что я никогда не писал статей ранее), а какой-то очерк больного мозга, которому пора наконец выспаться, а не допиливать этот интернет-магазин. И тем не менее, во время интеграции Робокассы в интернет-магазин, была замечена интересная особенность, которая позволяет сэкономить на покупке за счет тех, кто пытается взять обязательства по комиссии в пользу Робокассы на свой счет, и я хотел бы вам об этом поведать.

Суть вопроса

Думаю, многие из вас знакомы с таким платёжным сервисом, как «Робокасса». Сервис этот, как водится, работает с двумя типами клиентов: физическими лицами, да юридическими. Рядовой пользователь, покупая нечто в нашем интернет-магазине, ожидает, что ему предъявят счет на сумму, указанную на ценнике. Очевиден тот факт, что требовать от пользователя покрыть еще и комиссию — это прямая дорога вникуда. Вот тут-то и встает вопрос, как переложить обязанность платить робокассе её долю на сам интернет-магазин.

Казалось бы, что может быть проще? Наверняка, такая настройка есть в личном кабинете на сайте платежки. Не тут-то было. Вернее, она есть. Но только в том случае, если вы — юридическое лицо.

В моей ситуации, человек, которому этот магазин создаётся, является лицом физическим. Администрация робокассы предусмотрительно поместила вопрос о комиссии в сайдбар личного кабинета. Видимо, как наиболее актуальный. Дабы не быть голословным:

Собственно, любая хитрая смена одного из значений, входящего в строку SignatureValue не даст транзакции совершиться. К слову, Вы, как разработчик можете добавлять свои параметры вида shp*, которые «переживут» платеж и будут отправлены вашему серверу назад. Эти параметры также приплюсовываются к подписи транзакции.
Теперь вернемся к теме статьи.

Решение вопроса

Решение, предлагаемое работниками Робокассы, настораживает сразу же. Выглядит оно так:

Для этих целей создан специальный XML-интерфейс:

Метод расчёта суммы к получению магазином — CalcOutSumm

Описание метода: Позволяет расчитать сумму к получению, исходя из текущих курсов ROBOKASSA, по сумме, которую заплатит пользователь.

Параметры метода: MerchantLogin — идентификатор магазина (строка), IncCurrLabel — метка валюты (строка), для которой нужно произвести расчёт суммы. Если оставить его пустым, то расчёт будет произведен для всех доступных валют, IncSum — сумма, которую должен заплатить пользователь.

Т.е. нам предлагается высчитывать сумму так, чтобы с учетом комиссии она равнялась цене товара. Магазин писался на рельсах, а потому весь дополнительный парсинг отнял бы несколько строчек. И тем не менее, даже при всём нашем желании

Где зарыта собака?

Проблемы начинаются сразу же, как только мы хотим воспользоваться этим «интерфейсом». Допустим, мы захотели подсчитать сумму для всех способов оплаты. Как гласит руководство:

IncCurrLabel — метка валюты (строка), для которой нужно произвести расчёт суммы. Если оставить его пустым, то расчёт будет произведен для всех доступных валют

Первая мысль: «Возможно я дурак и что-то не так делаю. Может, опускать параметр нужно не так?». Но нет, исходя из той же документации (пример для другой функции, лишь демонстрирую отсутствие значения):

Пробуем опустить параметр вовсе:

Беда. Но мы не сдаёмся. Что можно сделать в такой ситуации? Точно! Допустим, мы будем брать идентификатор способа оплаты из коллекции, считать для него сумму оплаты отдельно и запихивать в форму на нашем сайте, после чего менять outSum и пересчитывать подпись при выборе пользователем другого способа.

Хорошо, что я не кинулся реализовывать это.

Немного грубого проектирования показало, что на деле всё будет не так уж и радужно. О чём это я? Давайте посмотрим внимательнее на интерфейс инициализации оплаты.

sIncCurrLabel
— предлагаемая валюта платежа. Пользователь может изменить ее в процессе оплаты.

Ничего пока не насторожило? Давайте вдумаемся. Робокасса предлагает нам считать сумму самим, опираясь на выбранный пользователем интерфейс оплаты. Этот самый интерфейс IncCurrLabel в подпись не входит. Это логично, т.к. пользователь имеет право выбрать другой способ на сайте кассы. Тем не менее, комиссия для каждого способа высчитывается своя. Более того, высчитывать её предлагается нам, на стороне нашего сервера. Мы получаем outSum от того самого интерфейса, запихиваем в нашу форму, считаем подпись и отправляем на оплату.

Суть всей статьи

Ещё раз.
Робокасса предлагает нам вычитать из нашего дохода сумму комиссии, основываясь на том, какой способ оплаты хочет пользователь. При этом, этот самый способ оплаты она дает менять тогда, когда мы контроля над процессом платежа уже не имеем. Что происходит дальше?

А дальше все просто. Пользователь выбирает на нашем сайте способ с самой большой комиссией. На моей памяти — банковская карта. Мы, как добрые дяди, вычитаем порядка 300 рублей из цены нашего товара, дабы снять ношу комиссии с покупателя. Он же, попав на сайт Робокассы, просто выбирает оплату через какой-нибудь Яндекс или Вебмани с мизерной комиссией. Комиссия по новому способу высчитается на сайте робокассы опираясь на отправленный нами «скидочный» вариант цены. Всё.

И всё-таки, загвоздка получается в том, что с момента попадания на сайт платежки если пользователь оплатит заказ — нам вернется «успех» по платежу. И никого не волнует, что мы потеряли деньги на этом, по сути. Такая вот нехитрая схема.

Что всё-таки можно сделать?

Выход номер раз

Зверский

Мы можем хранить сумму, нашего товара и способ платежа, указанный пользователем в тех самых shp* параметрах. Эти параметры защищены от изменения, а значит, мы получим их в целости и сохранности. Получив их назад, мы пересчитываем сумму снова и смотрим, сколько мы получили и сколько должны были. Если получили меньше — значит, нас обманули и мы можем как-то воздействовать на пользователя.

Проблема здесь лишь в том, что типичный покупатель может по чистой случайности, даже если мы напишем, что менять способ в самой кассе нельзя, поступить по своему. Вернуть деньги в полном объеме мы ему уже не сможем, если он подтвердит такую транзакцию. Так что и выходом это назвать сложно.

Выход номер два

Единственный

Регистрироваться в кассе как юридическое лицо. Собственно, в моем случае заказчик решил поступить именно так. В таком случае вам становится доступен один единственный переключатель, который решает эту проблему раз и навсегда.

Источник

Kак подключить ROBOKASSA?

На Платформе вы можете настроить удобный приём платежей на страницах с помощью сервиса https://robokassa.com/. Данная возможность доступна только для тарифов Бизнес и Бизнес+.

1. Регистрация на сервисе Робокасса

❗ Важно: На данный момент регистрация на сервисе доступна только для ИП и юридических лиц.

Шаг 1. Заходим на главную страницу Робокассы и нажимаем на кнопку
«Подключиться к Robokassa»

Шаг 2. Переходим к регистрации. Заполняем следующие поля:

Где вы ведете бизнес: Выбираем Россия или Казахстан.

Зарегистрировать как: Выбираем один из вариантов: юридическое лицо; ИП;

ID клиента: Указываем общий логин для всех сотрудников компании. Желательно указать название компании на латинице.

Email администратора: Указываем адрес электронной почты. На почту придет пароль для входа в личный кабинет администратора.

Далее нажимаем на кнопку «Зарегистрироваться» и переходим к дальнейшим настройкам.

Подробнее о настройках со стороны Робокассы можно прочитать в их инструкции: https://docs.robokassa.ru/

Шаг 3. После заполнения профиля в Робокассе, переходим к добавлению своего интернет-магазина. Для этого нажимаем на кнопку «Мои магазины» и на «Добавить новый»

Шаг 4. Для регистрации магазина, заполняем следующие поля:

1.Наименование магазина: Это название будут видеть ваши клиенты, при переходе к оплате.

3.URL главной страницы вашего сайта: Указываем адрес главной страницы вашего сайта в полном формате, например, так:

4.Способ вывода средств: Нажмите на кнопку «Добавить» и укажите банковскую карту или электронный кошелек для вывода средств.

5.Ответственное лицо: Укажите сотрудника, который будет отвечать за взаимодействие с Робокассой. Можете указать одного из сотрудников, или себя. Нажмите на кнопку «Добавить» если нет вариантов для выбора.

6.Тех. поддержка: Укажите сотрудника, который будет отвечать за взаимодействие с покупателями по вопросам прохождения платежей. Администратор (Вы) будет указан как значение по умолчанию.

7.Каталог магазинов, в котором можно будет найти ваш магазин: Выбираем из списка сферу деятельности вашей компании.

Шаг 5. Переходим к техническим настройкам – это будет основой для дальнейшей интеграции. Заполняем следующие поля:

1. Идентификатор магазина: Это поле заполнится автоматически. В него вставится идентификатор магазина, который мы указывали в прошлом шаге.

3. Пароль #1: Нужно указать или сгенерировать пароль. Обязательно сохраните его, чтобы не потерять.
Пароль #2: Также нужно указать или сгенерировать и сохранить.

4. Result Url: Здесь указываем ссылку на вашу главную страницу. Это поле будет заполняться автоматически, нам нужно его немного изменить.

Добавляем /gw/robo/ok после адреса страницы, чтобы в итоге получилось так:

5. Метод отсылки данных по Result Url: Выбираем значение POST

7. Метод отсылки данных по Success Url: Выбираем значение GET

8. Fail Url: Здесь указываем ссылку на главную или на специально созданную страницу. Если оплата не прошла, пользователь будет перенаправлен на неё.

9. Метод отсылки данных по Fail Url: Выбираем значение GET

Шаг 6. Параметры проведения тестовых платежей не трогаем. Нажимаем на кнопку «Сохранить»

Шаг 7. Прокручиваем страницу выше и нажимаем на кнопку «Запрос на активацию»

Наиболее подробное описание регистрации от начала и до конца (все, что мы разобрали выше) можно найти в инструкции от Робокассы.

2. Настройка интеграции

Шаг 1. Выберите нужный проект, в котором хотите создать интеграцию:

Шаг 2. Перейдите в раздел «Интеграции», нажмите на кнопку «Добавить интеграцию»

И при добавлении интеграции выберите «Робокасса»

Шаг 3. После добавления интеграции с Робокассой, перейдем к настройкам интеграции. По порядку заполните поля:

1. Название: В этом поле укажите название интеграции. Название будете видеть только вы, и так будет удобнее отличать интеграции, если их будет несколько. Данное поле не обязательное.

2. Идентификатор магазина: Указываем идентификатор, который мы создали при регистрации в Робокассе.

3. Пароль #1: Указываем пароль #1 который мы создали или сгенерировали при регистрации в Робокассе.

4. Пароль #2: Также указываем пароль #2 который мы создали или сгенерировали.

5. Нажимаем на кнопку «Добавить»

После добавления интеграции, не выходя с ее настроек, у нас появится еще 2 поля:

«Заплатить комиссию ROBOKASSA за покупателя (только для физических лиц)»
Данная настройка позволяет платить комиссию ROBOKASSA за покупателя, если вам это необходимо.

Также, с июля 2017 года предприниматели обязуются вместо обычных кассовых аппаратов установить онлайн-кассы, которые передают информацию о каждой покупке напрямую в налоговые органы.
Подробнее об онлайн-кассах.

Шаг 4. Заходим в настройки страницы, на которой будем подключать оплату.

В разделе «Настройки магазина» выбираем созданную интеграцию с Робокассой и нажимаем на кнопку «Сохранить»

3. Подключаем Робокассу на страницу

Есть 2 способа настроить переход к оплате, после того как клиент отправит форму заявки.
Способ 1: Настроить оплату внутри корзины. Клиент сможет добавить в корзину несколько товаров и выбрать количество каждой позиции товара. Сумма заказа суммируется, и после отправки заявки, клиент сможет оплатить все добавленные в корзину товары.
Способ 2: Настроить оплату внутри конкретной карточки товара. Клиент сможет отправить заявку и оплатить конкретную позицию товара, без добавления ее в корзину. Этот способ подойдет лучше всего, если вы продаете не физические товары, а, например, услугу, у которой есть несколько разных вариаций и цен.

Вы можете комбинировать оба способа, чтобы дать клиенту выбор. Т.е. разместить кнопку для добавления товара в корзину и еще одну кнопку для быстрого заказа выбранного товара.

3.1 Заказ и оплата через корзину

Шаг 1. Открываем корзину (нажав на кнопку корзины) и форму заявки, которая находится внутри корзины.

Шаг 2. Выполняем следующие действия:

Заходим в настройки формы (иконка гаечного ключа)

Переходим в раздел «Форма»

Нажимаем на поле «Действие после отправки формы» чтобы выбрать нужный вариант действия

Выбираем вариант «Переход к оплате» или «Сообщение + Переход к оплате»

3.2 Заказ и оплата в карточке товара

Шаг 2. Нажмите на кнопку, чтобы открылось окно с формой.
Шаг 3. Выполняем настройки перехода к оплате:

Заходим в настройки формы (иконка гаечного ключа)

Переходим в раздел «Форма»

Нажимаем на поле «Действие после отправки формы» и выбираем вариант «Переход к оплате» или «Сообщение + Переход к оплате»

В старых формах (они всегда обведены оранжевым), после выбора «Переход к оплате» или «Сообщение + Переход к оплате», внизу появляются поля «Назначение платежа» и «Сумма». На данный момент эти поля уже не учитываются, и их можно не менять.

Стоимость товара при переходе к оплате, будет определяться только с виджета «Цена товара» в карточке товара.

Если у вас не добавлен такой виджет, возможно, вы еще не настроили саму карточку товара.
«Как добавить карточку товара?»

💡Также вы можете разместить форму напрямую в карточке товара, чтобы посетитель мог заполнить ее сразу, не открывая модального окна, как мы делали это выше.
На скриншоте ниже мы добавили в карточку виджет новой формы с более гибкими настройками.

💡Если вы хотите использовать новые формы именно во всплывающем модальном окне, то сумма из карточки самостоятельно заполняться не будет. Для настройки выполняем следующие действия:

1. Добавляем на страницу виджет «Кнопка с окном»

2. Нажимаем на кнопку и добавляем в открывшееся окно карточку товара, внутри которой обязательно устанавливаем виджеты «Цена товара» и «Название товара».
Что такое виджеты «Цена товара» и «Название товара» и откуда их взять можно узнать в нашей статье: «Как добавить карточку товара?»

Внутрь нашей карточки устанавливаем так же виджет самой формы:

❗Обратите внимание, что форма тоже должна быть внутри карточки товара, как цена и название товара.

4. Если вы не хотите, чтобы цену товара было видно в модальном окне, то зайдите в настройки стилей виджета «Цена товара» (иконка капельки), в раздел «Параметры» и укажите в поле «Класс виджета» значение:

Цена товара будет фиксироваться при переходе к оплате, но не будет отображаться в модальном окне. Обратите внимание, что виджет будет скрываться только на странице, если зайти на нее по ссылке, а в редакторе его будет видно.
При таких настройках, виджет новой формы будет корректно работать в модальном окне.

4. Как узнать, оплатил ли клиент заказ?

Уведомление об оплате приходят от Робокассы на почту, которая была указана в настройках Робокассы на момент регистрации.

Помимо уведомлений, вы можете проверять оплаченные заявки в личном кабинете, в разделе «Заявки». Статус успешно оплаченной заявки меняется с «Новый» на «Оплачен»

Готово!🎉 Мы настроили интеграцию с платежным сервисом «Robokassa».

Источник