ROBOKASSA. Описание интерфейсов

Общее описание сервиса

ROBOKASSA Моментальный старт продаж для малого бизнеса. Решение всех проблем с 54-ФЗ одной кнопкой. Быстрое подключение, легкая интеграция, более 30 способов оплат в рамках единого договора, в том числе Apple Pay, SamsungPay

Продукты:

INSTA - бесплатный инструмент для организации продаж в Инстаграме с созданием собственной полноценной онлайн-точки продаж. Бережный перенос контента по APi и создание онлайн-витрины, платежи, онлайн-касса и фискальные чеки уже включены в пакет.

ROBO.MARKET - моментальный старт продаж для малого бизнеса: бесплатный инструмент приема онлайн-платежей более чем 30 способами, онлайн-касса и фискальные чеки.

РОБОЧЕКИ - бесплатный инструмент приема онлайн-платежей с выдачей фискальных чеков в полном соответствии с 54-ФЗ

Основные шаги по созданию и активации магазина

Регистрация и активация в системе ROBOKASSA

Если решение о подключении принято, начните с Регистрации по любой форме юридического лица, в том числе ИП, ООО, ЗАО, ОАО. А также НКО, БАНК, ФГУП, РНКО и т.д. и т.п. (только резиденты РФ и Казахстана).

Инструкция по регистрации в PDF

Регистрация нового клиента

Создайте аккаунт в системе на главной странице нашего сайта по ссылке: «Подключить магазин». После перехода откроется  страница

Порядок заполнения полей Необходимо указать Страна Форма сотрудничества Идентификатор клиента Логин администратора E-Mail администратора

Пароль будет создан автоматически и выслан на E-Mail Администратора вместе с остальными регистрационными данными.

Авторизация и Заполнение основных регистрационных данных

Используя Идентификатор клиента и Логин, заданные Вами при регистрации, и высланный на E-Mail пароль, авторизуйтесь в Личном кабинете клиента.

После авторизации можно задать свой пароль для доступа в Личный кабинет (заменить автоматически сгенерированный), если у Вас есть такая необходимость. Это делается так:

• Меню
• Настройки
• Мой доступ
• Настройки доступа

Прочие регистрационные данные

Следующие шаги пока можно пропустить, и сразу перейти к созданию магазина.

Раздел Настройки

Рекомендуем Вам сразу заполнить Ваши данные и контактную информацию в разделе Настройки.

• Меню
• Настройки
• Мой доступ
• Контактная информация

 

Обязательные поля Обязательными для заполнения являются поля: Полное имя, ФИО ФИО (в родительном падеже) Должность Основной E-Mail Телефон Необязательные поля Остальные поля заполняются на Ваше усмотрение. Документ, подтверждающий право подписи Дополнительный E-Mail Skype Адрес Комментарий

Для юридического лица/Кредитной/Благотворительной/Религиозной организации

Заполните информацию о Вашей организации.

• Меню
• Настройки
• Данные юридического лица

Регистрационные данные Тип собственности ИНН КПП ОГРН/ОГРНИП Дата внесения записи о регистрации в ЕГРЮЛ/ЕГРИП Контакты организации Адреса Заполняются в соответствии с Вашими адресами

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

Юридический адрес Фактический адрес Почтовый адрес

Для бюджетной организации

Если Вы зарегистрированы как бюджетная организация, то укажите дополнительную информацию.

Обязательные параметры Лицевой счет КБК ОКТМО Контакты Данные Подписанта Данные для контактов

Для Индивидуального предпринимателя

Если Вы Индивидуальный предприниматель, то укажите дополнительную информацию.

• Меню
• Настройки
• Данные юридического лица

 

Обязательные параметры ФИО Дата рождения Место рождения Паспорт Свидетельство о государственной регистрации Если Ваше свидетельство оформлено по форме Р61003

Для юридического лица - нерезидента

Заполните информацию о Вашей организации.

Обязательные параметры для нерезидентов Полное наименование в латинской транскрипции Регистрационный номер Код налогоплательщика Контакты организации Юридический адрес в стране регистрации Данные подписанта Необязательные параметры Полное наименование на русском языке Код иностранной организации При наличии представительства в РФ ИНН Контакты представительства Юридический адрес подразделения на территории РФ Фактический адрес подразделения на территории РФ

Для физического лица

Укажите свой электронный кошелёк QIWI, или карту Visa и MasterCard российского банка.

Способы вывода средств В разделе: «Настройки» – «Способы вывода средств» указываются возможные способы вывода для Ваших средств и их реквизиты.

Выберите новый способ из списка или создайте новый  нажатием кнопки «Добавить способ вывода средств».

• Меню
• Настройки
• Способы вывода средств

Заполните необходимые данные. Например, если выбран банковский счет:

Выберите тип счёта Наименование БИК Корр. счёт Расч. счёт

Создание магазина

Создать первый магазин можно либо на Главной странице Вашего Личного кабинета клиента либо в разделе «Мои магазины» нажатием кнопки «Добавить новый». В дальнейшем, магазины можно создавать только в разделе «Мои магазины».  На открывшейся странице необходимо заполнить все поля, в соответствии с их назначением и требованиями.

• Меню
• Управление
• Мои магазины

 

Технические настройки

Вы можете быстро перейти к настройкам конкретного магазина из общего списка, который виден как на главной странице, так и в разделе Мои магазины, с помощью кнопки «Настройки магазина», представленной в виде иконки (см. картинку).

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

• Меню
• Управление
• Мои магазины

Активация

После выполнения всех вышеописанных действий и настройки скрипта ROBOKASSA на Вашем сайте Вы можете направить нам запрос на Активацию Магазина для приёма платежей. Данный запрос отправляется из Настроек Вашего магазина (раздел Мои магазины – магазин который необходимо активировать), по кнопке «Запрос на активацию»:

• Меню
• Управление
• Мои магазины 

Но если Вами не заполнены какие-то важные разделы, информация из которых будет использоваться в работе, то в настройках магазина будет присутствовать напоминание об этом, а кнопка «Запрос на активацию»  не будет отображаться.

При наличии такого напоминания необходимо проверить корректность заполнения данных Юридического лица и раздела Технические настройки.

Деактивировать магазин можно только по запросу в Службу Поддержки ROBOKASSA.

Готовое решение для оплаты на сайте

Robokassa предоставляет возможность поставить на свой сайт кнопку/ссылку для оплаты товара через Robokassa. Кнопка может быть как с фиксированной суммой (опция "Оплатить"), так и с произвольной суммой.

 

Инструкция по выставлению счетов в PDF

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

 

Скопируйте код и вставьте его на свой сайт.

При клике на кнопку "Оплатить" плательщик будет перенаправлен на платежную страницу Robokassa.

 

Виджеты и модули оплаты

Итак, Вы зарегистрировались, теперь необходимо выполнить важный шаг – установить скрипт ROBOKASSA на Вашем сайте и настроить его работу. 

Здесь Вы можете ознакомиться с готовыми модулями под различные CMS и торговые платформы. 

Все наши официальные модули также доступны для скачивания на платформе GitHub.

Официальные модули ROBOKASSA

Официальный модуль приема платежей Robokassa для Битрикс 24. Robokassa - оплата Битрикс24  

• Инструкция по установке и настройке 
• Регистрация в сервисе
• Видео инструкция
• Инструкция в PDF

 

Официальный модуль приема платежей Robokassa для InSales. Robokassa - оплата InSales

• Инструкция по установке и настройке
• Модуль Robokassa для InSales
• Видео инструкция
• Инструкция в PDF

 

Официальный модуль приема платежей Robokassa для WordPress. Robokassa - оплата WordPress

• Официальный модуль от Robokassa

 

Официальный модуль приема платежей Robokassa для WordPress WooCommerce Subscriptions с поддержкой периодических (рекуррентных) платежей. Robokassa - оплата WordPress WooCommerce Subscriptions

• Официальный модуль от Robokassa
• Репозиторий GitHub

Официальный модуль приема платежей Robokassa для OpenCart. Robokassa - оплата OpenCart

• Официальный модуль от Robokassa

Официальный модуль приема платежей Robokassa для Drupal 8 Commerce 2.x. Robokassa - оплата Drupal

• Официальный модуль от Robokassa(GitHub)
• Ссылка на модуль на Drupal.org

Официальный модуль приема платежей Robokassa для Joomla VirtueMart - оплата VirtueMart

• Официальный модуль от Robokassa

 

Официальный модуль приема платежей Robokassa для 1С-Битрикс. Robokassa - оплата 1С-Битрикс

• Официальный модуль от Robokassa

 

Официальный модуль приема платежей Robokassa для сервиса WIX. Robokassa - оплата WIX 

• Инструкция по установке и настройке
• Видео инструкция

 

 

Официальный модуль приема платежей Robokassa для СRM Мой Склад. Robokassa - оплата Мой Склад

• Инструкция по настройке
• Видео инструкция

 

 

Официальный модуль приема платежей Robokassa для RetailCRM - оплата RetailCRM

• Инструкция по установке и настройке

 

Официальный модуль приема платежей Robokassa для MODX Revolution Minishop2.
Robokassa - оплата MODX Revolution Minishop2

• Ссылка на модуль в GitHub

AMO CRM

Официальный модуль приема платежей Robokassa для AMO CRM. Robokassa - оплата AMO CRM

• Инструкция по установке и настройке
• Видео инструкция
• Инструкция в PDF

• Инструкция по настройке SalesBot

Виджеты и модули оплаты сторонних разработчиков

Модуль приема платежей Robokassa для Ecwid. Robokassa - оплата Ecwid

• Инструкция по установке и настройке
• Инструкция в PDF. Как продавать в соц.сетях

 

Модуль приема платежей Robokassa для 1С-Битрикс. Robokassa - оплата 1С-Битрикс

• Инструкция по установке и настройке
  

 

Встроенный модуль приема платежей Robokassa Битрикс24 - не требует платного тарифа.

• Инструкция по настройке
• Инструкция по настройке Робочеков
  
  

Модуль приема пожертвований для благотворительных организаций с поддержкой периодических (рекуррентных) платежей Онлайн Лейка.

• Страница сервиса
• Инструкция по настройке
• Модуль на сайте wordpress
• Модуль в GitHub
  
  

Модуль приема платежей Robokassa для HOST CMS. Robokassa - оплата HOST CMS

• Инструкция по установке и настройке
• Модуль ROBOKASSA для HOST CMS

 

Модуль приема платежей Robokassa для DIAFAN CMS. Robokassa - оплата DIAFAN CMS

• Инструкция по установке и настройке

 

Модуль приема платежей Robokassa для ADVANTSHOP. Robokassa - оплата ADVANTSHOP

• Инструкция по установке и настройке

 

Модуль приема платежей Robokassa для OpenCart. Robokassa - оплата OpenCart
Модули сторонних разработчиков

• Модуль Robokassa OpenCart версии 2
• Модуль ROBOKASSA для OpenCart
• Модуль Shoputils.Robokassa

 

Модуль приема платежей Robokassa для Tilda Publishing. Robokassa - оплата Tilda Publishing

• Инструкция по установке и настройке
• Видео инструкция
• Инструкция в PDF

 

Модуль приема платежей Robokassa для PHPShop CMS. Robokassa - оплата PHPShop CMS

• Инструкция по установке и настройке
• Модуль ROBOKASSA для PHPShop CMS

 

Модуль приема платежей Robokassa для cs.cart. Robokassa - оплата cs.cart

• Инструкция по установке и настройке

 

Модуль приема платежей Robokassa для PERFECT CMS. Robokassa - оплата PERFECT CMS

• Интегрирован в саму CMS 
  
  

Модуль приема платежей Robokassa для АвтоВебОфис. Robokassa - оплата АвтоВебОфис

• Подробно о возможностях платформы АвтоВебОфис
• Пошаговая инструкция по подключению системы ROBOKASSA к Вашему сайту

 

Модуль приема платежей Robokassa для RetailCRM от retailcrm.services. Robokassa - оплата RetailCRM

• Инструкция по установке и настройке

 

Модуль приема платежей Robokassa для платформа для инфобизнеса Emdesell. Robokassa - оплата Emdesell

• Инструкция по установке и настройке
• Модуль ROBOKASSA для Emdesell

 

Модуль приема платежей Robokassa для LPGenerator. Robokassa - оплата LPGenerator

• Инструкция по подключению системы ROBOKASSA к сайту на платформе LPGenerator

 

Модуль приема платежей Robokassa для X-CART. Robokassa - оплата X-CART

• Инструкция по настройке ROBOKASSA для X-CART 4

 

Модуль приема платежей Robokassa для orderino. Robokassa - оплата orderino

• Описание, инструкция по установке и настройке

 

Модуль приема платежей Robokassa для FLEXCORE. Robokassa - оплата FLEXCORE

• Описание, инструкция по установке и настройке
  
  

Модуль приема платежей Robokassa для lanbilling2. Robokassa - оплата lanbilling2

• Инструкция по установке и настройке

 

Модуль приема платежей Robokassa для Cranbee Store. Robokassa - оплата Cranbee Store

• Инструкция по установке и настройке

 

Модуль приема платежей Robokassa для UMI.CMS. Robokassa - оплата UMI.CMS

• Инструкция по установке и настройке

 

Модуль приема платежей Robokassa для READY-SCRIPT. Robokassa - оплата READY-SCRIPT

• Инструкция по установке и настройке

 

Модуль приема платежей Robokassa для Shop-Script. Robokassa - оплата Shop-Script

• Инструкция по установке и настройке

 

Модуль приема платежей Robokassa для Amiro CMS. Robokassa - оплата Amiro CMS

• Инструкция по подключению
• Инструкция по настройке

 

Модуль приема платежей Robokassa для GET-COURSE. Robokassa - оплата GET-COURSE

• Как настроить интеграцию с Робокассой
• Как сделать интернет-витрину для соответствия требованиям Робокассы

 

Модуль приема платежей Robokassa для flexbe. Robokassa - оплата flexbe

• Инструкция по установке и настройке

 

Модуль приема платежей Robokassa для TO BIZ.NET. Robokassa - оплата TO BIZ.NET

• Инструкция по установке и настройке

 

Модуль приема платежей Robokassa для E-AutoPay.com. Robokassa - оплата E-AutoPay.com

• Инструкция по установке и настройке

 

Модуль приема платежей Robokassa для Appthemes

• инструкция по установке и настройке для системы wordpress с компонентами appthemes

 

Модуль приема платежей Robokassa для PricePlan. Robokassa - оплата PricePlan

• Ссылка на инструкцию по интеграции

 

Модуль приема платежей Robokassa для FastSales. Robokassa - оплата FastSales

• Описание процесса интеграции содержится в Руководстве пользователя, в разделе «5.3.7 Robokassa»

 

Модуль приема платежей Robokassa для simpla. Robokassa - оплата simpla

• Описание процесса установки

• Модуль для интеграции с Робокассой

 

Модуль приема платежей Robokassa для Bazium. Robokassa - оплата Bazium

• Инструкция по установке и настройке

 

Модуль приема платежей Robokassa для Гидра. Robokassa - оплата Гидра

• Инструкция по установке и настройке
• Пример настройки

 

Модуль приема платежей Robokassa для NNOVO. Robokassa - оплата NNOVO

• Инструкция по установке и настройке

 

 

Модуль приема платежей Robokassa для PrestaShop.  Robokassa - оплата PrestaShop

• Страница разработчика модуля

 

Модуль приема платежей Robokassa для Vigbo. Robokassa - оплата Vigbo

• Инструкция для подключения

 

Модуль приема платежей Robokassa для Eshoper. Robokassa - оплата Eshoper

• Инструкция по установке и настройке

 

Модуль приема платежей Robokassa для BNOVO. Облачная система управления отелем, хостелом, апартаментами

• Инструкция по установке и настройке

 

Модуль приема платежей Robokassa для Osclass. Osclass – бесплатный скрипт доски объявлений

• Инструкция по установке и настройке

 

База знаний Платформы LP

• Инструкция по установке и настройке

 

Модуль приема платежей Robokassa для LP MOTOR. Robokassa - оплата LP MOTOR

• Инструкция по установке и настройке

 

Модуль приема платежей Robokassa для MOGUTA CMS. Robokassa - оплата MOGUTA CMS

• Инструкция по установке и настройке

 

Модуль приема платежей Robokassa для UKIT. Robokassa – UKIT

• Инструкция по установке и настройке

 

Модуль приема платежей Robokassa для Megagroup CMS S3

• Инструкция по установке и настройке

 

Модуль приема платежей Robokassa для Sellios

• Инструкция по установке и настройке

 

Модуль приема платежей Robokassa для 5CMS

• Инструкция по установке и настройке

 

Модуль приема платежей Robokassa для CMS Invision Community

• Инструкция по установке и настройке

 

Модуль приема платежей Robokassa для FormDesigner.ru

• Инструкция по установке и настройке

 

Модуль приема платежей Robokassa для Creatium. Robokassa - оплата Creatium

• Инструкция по установке и настройке

 

Модуль приема платежей Robokassa для AINOX.
Robokassa с поддержкой рекуррентных платежей - оплата AINOX

• Ссылка на страницу сервиса
• Демо
• Инструкция по настройке
• Рекуррентные платежи для GetCourse

 

Модуль приема платежей Robokassa для Bizon 365. Robokassa - оплата Bizon 365

• Страница сервиса
• Инструкция по настройке

 

 

Модуль приема платежей Robokassa для Taplink. Robokassa - оплата Taplink

• Страница сервиса
• Инструкция по настройке

 

Модуль приема платежей Robokassa для Shopify. Robokassa - оплата Shopify

• Инструкция по установке и настройке

 

Модуль приема платежей Robokassa для Webasyst. Robokassa - оплата Webasyst

• Инструкция по установке и настройке

 

Модуль приема платежей Robokassa для NetCat. Robokassa - оплата NetCat

• Инструкция по установке и настройке

 

Модуль приема платежей Robokassa для WordPress от разработчика Mofsy. Robokassa - оплата WordPress Mofsy

• Модуль от Mofsy
• Премиум дополнение

 

Модуль приема платежей Robokassa для Платформа OpenMall. Robokassa - оплата Платформа OpenMall

• Инструкция по установке и настройке

 

Модуль приема платежей Robokassa для Zaptrade. Robokassa - оплата Zaptrade

• Инструкция по установке и настройке
• Страница сервиса

 

Модуль приема пожертвований через Robokassa Приход.ру. Robokassa – прием пожертвований

• Инструкция по установке и настройке

 

Модуль для приема платежей Robokassa для сервиса для автоматизации инфобизнеса с поддержкой периодических (рекуррентных) платежей

• Инструкция по установке и настройке

 

Модуль приема платежей Robokassa для КИОСК. Robokassa - оплата КИОСК

• Инструкция по установке и настройке
• Сайт системы

 

Модуль приема платежей Robokassa для CRM Автошкола Контроль. Robokassa - оплата Автошкола Контроль

• Инструкция по установке и настройке
• Ссылка на сервис

 

Модуль приема платежей Robokassa для Salebot. Robokassa - оплата Salebot

• Инструкция по установке и настройке
• Сайт конструктора ботов

 

Модуль приема платежей Robokassa для Pruffme. Robokassa - оплата Pruffme 

• Инструкция по установке и настройке
• Видеоинструкция
• Сайт сервиса

 

Модуль приема платежей Robokassa для FLORA. Robokassa - оплата FLORA

• Инструкция по установке и настройке
• Сайт сервиса

 

Модуль приема платежей Robokassa для VamShop. Robokassa - оплата VamShop

• Инструкция по установке и настройке

 

Модуль приема платежей Robokassa для САЙТРОССИЯ. Robokassa - оплата САЙТРОССИЯ

• Инструкция по установке и настройке

 

Модуль приема платежей Robokassa для платформы для онлайн-школ фитнеса InSkill. Robokassa - оплата InSkill

• Сайт сервиса 
• Инструкция по установке и настройке

 

Модуль приема платежей Robokassa для сервиса Botobot. Robokassa - оплата Botobot

• Инструкция по установке и настройке
• Сайт сервиса

 

Модуль приема платежей Robokassa для Satom. Robokassa - оплата Satom

• Инструкция по установке и настройке

 

Интеграция сервиса учета Финолог с Робокассой. Прием платежей и импорт транзакций из Робокассы в Финолог.

• Инструкция по установке и настройке

 

Модуль приема платежей Robokassa для онлайн видео платформы Boomstream. Robokassa - оплата Boomstream

• Инструкция по настройке интеграции

 

Модуль приема платежей Robokassa для stepFORM.io

• Инструкция по настройке интеграции

 

Модуль приема платежей Robokassa для системы автоматизации доставки еды и цветов FoodSoul. Robokassa - оплата FoodSoul

• Инструкция по установке и настройке

 

Модуль приема платежей Robokassa для платформы комплексной автоматизации работы отдела продаж LEELOO.AI. Robokassa - оплата LEELOO.AI

• Страница сервиса
• Инструкция по настройке

 

Модуль приема платежей Robokassa для CMS Smart Engine. Robokassa - оплата CMS Smart Engine

• Инструкция по установке и настройке
  
  

 Модуль приема платежей Robokassa для BotHelp. Robokassa - оплата BotHelp

• Страница сервиса
• Инструкция по установке и настройке

 

Модуль приема платежей Robokassa для генератора ботов BotMother. Robokassa - оплата BotMother

• Инструкция по установке и настройке
  
  

Модуль приема платежей Robokassa для OKAYCMS. Robokassa - оплата OKAYCMS

• Страница сервиса
• Инструкция по установке и настройке

 

Модуль приема платежей Robokassa для платформы онлайн-обучения СORE. Robokassa - оплата CORE

• Страница сервиса
• Инструкция по установке и настройке

 

 

Модуль приема платежей Robokassa для Setup.Ru. Robokassa - оплата Setup.Ru

• Инструкция по настройке интеграции

 

Модуль приема платежей Robokassa для Ucoz. Robokassa - оплата Ucoz

• Инструкция по настройке интеграции

• Онлайн-урок по настройке

 

Модуль приема платежей Robokassa для StoreLand. Robokassa - оплата StoreLand

• Инструкция по настройке интеграции

 

Модуль приема платежей Robokassa для TextBack. Robokassa - оплата TextBack

• Инструкция по установке и настройке
  
  

Модуль приема платежей Robokassa для ПланФакт. Robokassa - оплата ПланФакт

• Инструкция по установке и настройке

Модуль приема платежей Robokassa для системы для управления школой Big Ben
CRM. Robokassa - оплата Big Ben CRM

• Сайт сервиса

• Инструкция по установке и настройке
  
  

Модуль приема платежей Robokassa для VirtualityCMS. Robokassa - оплата
VirtualityCMS

• Инструкция по установке и настройке
  

Модуль приема платежей Robokassa для WinWinBot. Robokassa - оплата WinWinBot

• Инструкция по установке и настройке

Модуль приема платежей Robokassa для АвтоОфис - платформа для онлайн-школ.
Robokassa - оплата АвтоОфис

• Инструкция по установке и настройке

Модуль приема платежей Robokassa для конструктора чат-ботов LEADTEX.
Robokassa - оплата LEADTEX

• Регистрация в сервисе

• Инструкция по установке и настройке

Демонстрационные магазины

Оплата заданной суммы

На странице сайта продавца размещается код, формирующий кнопку для перехода на оплату через ROBOKASSA. При нажатии на эту кнопку покупатель будет перенаправлен на сайт ROBOKASSA для совершения платежа на указанную продавцом сумму.

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

Корзина покупок
	Кол-во (шт.)	Цена (руб.)	Сумма (руб.)
Техническая документация по ROBOKASSA	1	6,00	6,00
Техническая документация по Robo.market	1	5,00	5,00
			11,00

 

Ознакомиться с примерами кода, описанием используемых параметров и их значений, Вы можете здесь. 

Выбрать готовый модуль под свою CMS или торговую платформу, Вы можете здесь. 

Оплата произвольной суммы

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

Пример подобной формы с возможностью ввода суммы находится ниже. Будьте внимательны, если Вы введете данные вашего платежного средства, то сможете провести настоящую операцию оплаты в адрес нашего демонстрационного магазина:

 

Ознакомиться с примерами кода, описанием используемых параметров и их значений, Вы можете здесь.

Выбрать готовый модуль под свою CMS или торговую платформу, Вы можете здесь.

Оплата с помощью iFrame

В случае, если нужно предоставить покупателям возможность проводить оплату непосредственно на сайте магазина, можно использовать iFrame (дизайн кнопки задаётся магазином):

Оплатить

Ознакомиться с примерами кода, описанием используемых параметров и их значений, Вы можете здесь.

Интерфейс оплаты

Код кассы с одной кнопкой «Оплатить»

Интерфейс ROBOKASSA, предлагающий перейти к оплате, нажав одну кнопку. 

Предварительно магазин должен сохранить у себя передаваемую информацию (номер счёта, сумма, дата формирования и дополнительные параметры, если они используются). Адрес для отправки запроса на проведение оплаты: https://auth.robokassa.ru/Merchant/PaymentForm/FormMS.js

Результатом является изображенная на иллюстрации форма:

Варианты кнопок Вы можете увидеть здесь.

Параметры запроса: MerchantLogin, OutSum, InvId, Description и SignatureValue.

База для расчёта контрольной суммы: MerchantLogin:OutSum:InvId:Пароль#1 

где: Пароль#1  – это тот самый пароль, который Вы указали в Технических настройках.

Если Вы хотите передавать нам пользовательские параметры, например: Shp_login=Vasya и Shp_oplata=1, то база для расчёта контрольной суммы должна выглядеть так:

MerchantLogin:OutSum:InvId:Пароль#1:Shp_login=Vasya:Shp_oplata=1

 Пример кода (PHP), для установки на сайте, с использованием только обязательных параметров:

<?
  $mrh_login = "demo";
  $mrh_pass1 = "password_1";
  $inv_id = 0;
  $inv_desc = "Техническая документация по ROBOKASSA";
  $out_summ = "8.96";
  $crc = md5("$mrh_login:$out_summ:$inv_id:$mrh_pass1");
  print "<html><script language=JavaScript ".
      "src='https://auth.robokassa.ru/Merchant/PaymentForm/FormMS.js?".
      "MerchantLogin=$mrh_login&OutSum=$out_summ&InvoiceID=$inv_id".
      "&Description=$inv_desc&SignatureValue=$crc'></script></html>";
?>

Подробное описание всех использованных параметров и их значений можно посмотреть здесь. Обратите внимание, что приведённый пример предполагает, что в Технических настройках магазина выбран алгоритм расчёта хэша MD5.

Покупатель отправляется для оплаты в платёжный интерфейс ROBOKASSA, выбирает способ оплаты и совершает платёж. После чего средства перечисляются на Ваш баланс в системе ROBOKASSA, а на зарегистрированные Вами  ResultURL мы пришлём уведомление об оплате.

Оплата произвольной суммы

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

На странице оплаты сайта продавца размещается код, выполняющий запрос на сайт ROBOKASSA. ROBOKASSA возвращает в качестве ответа на запрос html код формы:

Примеры кода для сайта:

<?
  $mrh_login = "demo";
  $mrh_pass1 = "password_1";
  $inv_id = 0;
  $inv_desc = "Техническая документация по ROBOKASSA";
  $def_sum = "10";
  $crc = md5("$mrh_login::$inv_id:$mrh_pass1");
  print "<html><script language=JavaScript ".
      "src='https://auth.robokassa.ru/Merchant/PaymentForm/FormFLS.js?".
      "MerchantLogin=$mrh_login&DefaultSum=$def_sum&InvoiceID=$inv_id".
      "&Description=$inv_desc&SignatureValue=$crc'></script></html>"; 

?>

Приведённый пример предполагает, что в Технических настройках магазина выбран алгоритм расчёта хэша MD5.

Параметр OutSum в этом варианте не участвует. Вместо него используется: DefaultSum — сумма, отображаемая (предлагаемая для оплаты) в форме по умолчанию. В отличие от OutSum, DefaultSum не участвует в  расчёте контрольной суммы SignatureValue.

База для расчёта контрольной суммы SignatureValue, будет выглядеть так:"$mrh_login::$inv_id:$mrh_Пароль#1".

Обратите внимание, что вместо параметра OutSum пустое место.

Подробное описание всех использованных параметров и их значений можно посмотреть здесь.

Пример кода с использованием всех параметров

Пример кода на PHP, для установки на сайте. 

<?php
// регистрационная информация (Идентификатор магазина, пароль #1)
// registration info (Merchant ID, password #1)
$mrh_login = "demo";
$mrh_pass1 = "Password_1";

// номер заказа
// number of order
$inv_id = 12345;

// описание заказа
// order description
$inv_desc = "Техническая документация по ROBOKASSA";

// сумма заказа
// sum of order
$out_summ = "8.96";

// тип товара
// code of goods
$shp_item = 1;

// предлагаемая валюта платежа
// default payment e-currency
$in_curr = "BANKOCEAN2R";

// язык
// language
$culture = "ru";

// кодировка
// encoding
$encoding = "utf-8"; 

// Адрес электронной почты покупателя
// E-mail
$Email = "[email protected]";

// Срок действия счёта
// Expiration Date
$ExpirationDate = "2029-01-16T12:00";

// Валюта счёта
// OutSum Currency
$OutSumCurrency = "USD";

// формирование подписи
// generate signature
$crc  = md5("$mrh_login:$out_summ:$inv_id:$OutSumCurrency:$mrh_pass1:Shp_item=$shp_item");

// форма оплаты товара
// payment form
  print
   "<html>".
   "<form action='https://auth.robokassa.ru/Merchant/Index.aspx' method=POST>".
   "<input type=hidden name=MerchantLogin value=$mrh_login>".
   "<input type=hidden name=OutSum value=$out_summ>".
   "<input type=hidden name=InvId value=$inv_id>".
   "<input type=hidden name=Description value='$inv_desc'>".
   "<input type=hidden name=SignatureValue value=$crc>".
   "<input type=hidden name=Shp_item value='$shp_item'>".
   "<input type=hidden name=IncCurrLabel value=$in_curr>".
   "<input type=hidden name=Culture value=$culture>".
   "<input type=hidden name=Email value=$Email>".
   "<input type=hidden name=ExpirationDate value=$ExpirationDate>".
   "<input type=hidden name=OutSumCurrency value=$OutSumCurrency>".
   "<input type=submit value='Оплатить'>".
   "</form></html>";
?>

Подробное описание всех использованных параметров и их значений можно посмотреть здесь. Обратите внимание, что приведённый пример предполагает, что в Технических настройках магазина выбран алгоритм расчёта хэша MD5.

Варианты кнопок и форм

Вы можете выбрать размер и внешний вид кнопки оплаты или формы ввода суммы. Ниже приведены возможные варианты кнопок и форм, а также URL-ы, которые нужно использовать для получения соответствующей кнопки/формы.

Варианты кнопки оплаты

https://auth.robokassa.ru/Merchant/PaymentForm/FormM.js

 

https://auth.robokassa.ru/Merchant/PaymentForm/FormMS.js

 

https://auth.robokassa.ru/Merchant/PaymentForm/FormS.js

 

https://auth.robokassa.ru/Merchant/PaymentForm/FormSS.js

https://auth.robokassa.ru/Merchant/PaymentForm/FormL.js

https://auth.robokassa.ru/Merchant/PaymentForm/FormV.js

 

 

 

Варианты формы со вводом суммы

https://auth.robokassa.ru/Merchant/PaymentForm/FormFL.js

https://auth.robokassa.ru/Merchant/PaymentForm/FormFLS.js

iFrame

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

Во все наши официальные модули уже интегрирована поддержка iFrame. 

Дизайн кнопки оплаты может быть задан интернет-магазином. Использование данной функции предполагает небольшую настройку программного кода на стороне интернет магазина.

Важное уточнение! При работе через iFrame перенаправление покупателя на Success URL после совершения оплаты или на Fail URL при отказе от оплаты не происходит поскольку покупатель не уходит с сайта продавца, а всё время остаётся на нём. Уведомление магазину на Result URL в случае успешной оплаты отправляется как и всегда.

Для непосредственного запуска iFrame, в страницу оплаты необходимо вставить скрипт:

<script type="text/javascript" src="https://auth.robokassa.ru/Merchant/bundle/robokassa_iframe.js"></script>

ВАЖНО! Разместить данный скрипт необходимо рядом с кнопкой оплаты (обычно это основной массив сайта в тэге <body>).

Для старта оплаты необходимо вызвать метод Robokassa.StartPayment(paymentParameters).
Вызов метода можно разместить, например, в элементарном onClick - обработчике нажатия на кнопку "Оплатить".

Формируем запрос из привычных параметров.

Пример кнопки:

<script type="text/javascript" src="https://auth.robokassa.ru/Merchant/bundle/robokassa_iframe.js"></script>
<input type="submit" value="Оплатить" onclick="Robokassa.StartPayment({
			MerchantLogin: 'demo',
			OutSum: '11.00',
			Description: 'Оплата заказа в Тестовом магазине ROBOKASSA',
			shp_Item: '1',
			Culture: 'ru', 
			Encoding: 'utf-8',
			SignatureValue: '3925b771e47d405cbcbb492daa936824'})">

Рекомендации для разработчиков приложений под iOS

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

Подробнее про него можно прочитать здесь.

Important
Starting in iOS 8.0 and OS X 10.10, use WKWebView to add web content to your app. Do not use UIWebView or WebView.

Если же, Вы планируете разработку с компонентом UIWebView, то работоспособность нашей платёжной формы в вашем мобильном приложении мы гарантировать не можем. 

Оповещение об оплате на ResultURL

ResultURL предназначен для получения Вашим сайтом оповещения об успешном платеже в автоматическом режиме.

В случае успешного проведения оплаты ROBOKASSA делает запрос на ResultURL (см. раздел Технические настройки) с указанием параметров OutSum, InvId и SignatureValue.

Данные всегда передаются в кодировке UTF-8.

ВНИМАНИЕ! В случае, если вы используете фильтрацию входящих запросов, не забудьте прописать IP-адреса Робокассы в white-лист вашего сервера
185.59.216.0/24 (185.59.216.1 - 185.59.216.254)

Описание параметров OutSum InvId EMail Fee SignatureValue

Ваш скрипт, находящийся по ResultURL, обязан проверить равенство полученной контрольной суммы и контрольной суммы, рассчитанной Вашим скриптом по параметрам, полученным от ROBOKASSA, а не по локальным данным магазина.

Если контрольные суммы совпали, то Ваш скрипт должен ответить ROBOKASSA, чтобы мы поняли, что Ваш скрипт работает правильно и повторное уведомление с нашей стороны не требуется. Результат должен содержать  текст OK и параметр InvId. Например, для номера счёта 5 должен быть возвращён вот такой ответ: OK5.

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

Если в настройках в качестве метода отсылки данных был выбран E-Mail, то в случае успешного проведения оплаты ROBOKASSA  отправит Вам письмо на электронный адрес, указанный в поле ResultURL, со всеми выше перечисленными параметрами.

Получена оплата:

Цена: OutSum
inv_id: InvId
Метод оплаты: PaymentMethod
[Пользовательские параметры]

С уважением,
Проект ROBOKASSA

Переадресация пользователя при успешной оплате на SuccessURL

В случае успешного исполнения платежа Покупатель сможет перейти по адресу, указанному Вами в Технических настройках, там же Вы указали метод (GET или POST).

Переход пользователя по данному адресу с корректными параметрами (правильной Контрольной суммой) означает, что оплата Вашего заказа успешно выполнена.

Однако для дополнительной защиты желательно, чтобы факт оплаты проверялся скриптом, исполняемым при переходе на ResultURL, или путем запроса XML-интерфейса получения состояния оплаты счета, и только при реальном наличии счета с номером InvId в БД магазина.

На самом деле, переход пользователя по ссылке SuccessURL – это формальность, которая нужна только для того, чтобы пользователь вернулся обратно к Вам и получил информацию о том, что он сделал всё правильно, и его заказ ждёт его там-то и там-то. Проводить подтверждение оплаты у себя по базе и все остальные действия, связанные с выдачей покупки, Вам нужно при получении уведомления на ResultURL, потому что именно на него ROBOKASSA передаёт подтверждающие данные об оплате в автоматическом режиме (т. е. в любом случае и без участия пользователя).

Параметры, передающиеся при переходе OutSum InvId SignatureValue Culture Пользовательские параметры

Переадресация пользователя при отказе от оплаты на FailURL

В случае отказа от исполнения платежа Покупатель перенаправляется по данному адресу.

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

Параметры, передающиеся при отказе от оплаты OutSum InvId Culture

Переход пользователя по данному адресу, строго говоря, не означает окончательного отказа Покупателя от оплаты, нажав кнопку «Back» в браузере он может вернуться на страницы ROBOKASSA. Поэтому в случае блокировки товара на складе под заказ, для его разблокирования желательно проверять факт отказа от платежа запросом запроса XML-интерфейса получения состояния оплаты счета, используя в запросе номер счета InvId имеющийся в БД магазина (Продавца).

Типовые ошибки интерфейса оплаты Код ошибки: 23 Код ошибки: 25 Код ошибки: 26 Код ошибки: 29 Код ошибки: 30 Код ошибки: 31 Код ошибки: 33 Код ошибки: 34 Код ошибки: 35 Код ошибки: 40 Код ошибки: 41 Код ошибки: 42 Код ошибки: 60 Коды ошибок: 20, 21, 22, 24, 27, 28, 32, 36, 37, 43, 500

Описание параметров скрипта (модуля) ROBOKASSA

В данном разделе описаны все параметры используемые в скриптах ROBOKASSA. 

По этим ссылкам Вы можете скачать архивы с примерами реализации скрипта, на нескольких языках программирования:

• Php
• Asp
• Perl

Описание переменных, параметров и значений

Рассмотрим, какие параметры и переменные используются в скриптах и какие значения для них могут быть использованы. А также, что из всего этого нужно и для чего.

Обязательные параметры

Без них ничего работать не будет!

MerchantLogin OutSum Description SignatureValue Необязательные параметры Вы можете пропустить этот раздел

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

IncCurrLabel InvId Culture Encoding Email ExpirationDate OutSumCurrency UserIp

Дополнительные пользовательские параметры

Они также относятся к необязательным параметрам, но несут совершенно другую смысловую нагрузку. Это такие параметры, которые ROBOKASSA никак не обрабатывает, но всегда возвращает магазину в ответных вызовах.

Если:

• Вы собираетесь создавать магазин, в котором предусмотрено большое количество товаров, разделов и типов товара.
• Ваш сайт будет предоставлять разнообразные услуги, не похожие друг на друга.
• На одном сайте работают несколько ресурсов.
• И самое распространённое — Вам требуется использовать дополнительную идентификацию Ваших клиентов, например, знать его ID или Логин у Вас на сайте.

То при старте операции оплаты Вы можете передавать всю эту информацию.

При завершении операции оплаты, мы будем возвращать Вам эти дополнительные параметры. Формироваться они должны следующим образом:

Всегда начинаться с: Shp_; SHP_; shp_ 
Выглядеть они могут так: Shp_1=1;Shp_1=2 —  или так: Shp_oplata=1;Shp_oplata=2 — или вот так: Shp_login=Vasya; Shp_name=Вася.

Например: MerchantLogin:OutSum:InvId:Пароль#1:Shp_id=126:Shp_login=Vasya

При получении уведомлений от ROBOKASSA, Вы (Ваши скрипты) сможете использовать их по своему усмотрению. Например, принять решение куда перенаправить покупателя на Вашем сайте.

Очень важно, чтобы все параметры были отсортированы в алфавитном порядке.

Например: 

Shp_login=Vasya:Shp_name=Вася :Shp_oplata=1 (l – n – o)

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

В сумме строка может содержать до 2048 знаков.

Каждый из этих параметров ОБЯЗАТЕЛЬНО должен быть включён в подсчёт контрольной суммы (SignatureValue). Как при старте операции, так и при её завершении. Все параметры  должны быть обязательно отсортированы в алфавитном порядке.

Периодические платежи

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

Важно! Данная услуга доступна только по предварительному согласованию. Для её подключения создайте запрос через свой Личный кабинет.

На первом этапе пользователь производит обычный платеж по выставленному счету, но помимо всех остальных параметров необходимо передать еще один специальный параметр Recurring, указывающий, что в дальнейшем платеж будет периодически повторяться. После успешной оплаты такого счета с помощью банковской карты, магазин получает возможность периодически повторять платеж уже без участия пользователя. Для этого магазин делает запросы на специальный URL (https://auth.robokassa.ru/Merchant/Recurring), передавая обычные параметры и указывая номер счета, оплаченного на первом этапе.

 

ГОТОВЫЙ ПЛАТЕЖНЫЙ МОДУЛЬ ОТ НАШИХ ПАРТНЕРОВ
Воспользуйтесь готовым решением от нашего партнера «AINOX.RU» — это облачный платежный модуль для Robokassa с поддержкой рекуррентных платежей. С помощью Ainox вы можете запустить платежи по подписке за 15 минут, без программиста и даже без сайта.

Зарегистрируйтесь по этой ссылке и получите 30 дней пробного периода бесплатную поддержку и помощь в настройке «под ключ».

Параметры Recurring PreviousInvoiceID

<form method = "POST"  action = "https://auth.robokassa.ru/Merchant/Recurring">
    <input type = hidden name = MerchantLogin value = demo>
    <input type = hidden name = InvoiceID value = 156>
    <input type = hidden name = PreviousInvoiceID value = 154>
    <input type = hidden name = Description value = 'Оплата подписки'>
    <input type = hidden name = SignatureValue value = 9ada9c4f842cdc1163e5e97d0461a1de>
    <input type = hidden name = OutSum value = 100>
    <input type = submit value = 'Pay'>    
</form>

Сплитование (разделение) платежей

Если в работе вашего магазина(ов) имеется необходимость распределять поступающие платежи между несколькими вашими магазинами или магазинами партнёров, то необходимо сделать Сплитование (разделение) платежа. 

Важно! Данная услуга доступна только по предварительному согласованию. Для её подключения создайте запрос через свой Личный кабинет.

В случае проведения платежа, который должен быть распределён между несколькими магазинами к стандартному запросу на проведение платежа добавляется параметр – Split

В этом параметре передается информация о магазинах, участвующих в платеже, и распределении суммы платежа по ним. 

Информация о магазинах передается в виде списка через запятую:

Split=информация_о_мастер_магазине,информация_о_магазине_2,информация_о_магазине_3…

По каждому магазину передается три параметра:

• идентификатор магазина (обязательный параметр);
• сумма, зачисляемая магазину (обязательный параметр);
• номер счета (необязательный параметр).

Формат передачи информации по магазину:

идентификатор_магазина:сумма:номер_счета

Каждый Сплит платёж проводится от имени одного магазина - это магазин называется Мастер.
Информация об этом магазине обязательно должна присутствовать в параметрах сплитования, и находится на первом месте при их перечислении. 

Параметры Идентификатор магазина Сумма Номер счета

Примеры передачи данных

1. С передачей номера счёта:

 

Split=master:225.50:12345,shop2:20.00:321,shop3:10.34:456

• Идентификатор мастер магазина: master, сумма мастер магазина: 225.50, номер счета мастер магазина: 12345;
• Идентификатор магазина 2: shop2, сумма: 20.00, номер счета: 321;
• Идентификатор магазина 3: shop3, сумма: 10.34, номер счета: 456.

2. Без передачи номера счёта:

 

Split=master:225.50:12345,shop2:20.00:,shop3:10.34:

• Идентификатор мастер магазина: master, сумма мастер магазина: 225.50, номер счета мастер магазина: 12345;
• Идентификатор магазина 2: shop2, сумма: 20.00, номер счета не указан;
• Идентификатор магазина 3: shop3, сумма: 10.34, номер счета не указан.

 

Пример использования параметра Split в запросе:

<?php
// регистрационная информация (Идентификатор магазина, пароль #1)
// registration info (Merchant ID, password #1)
$mrh_login = "demo";
$mrh_pass1 = "Password_1";

// номер заказа
// number of order
$inv_id = 12345;

// описание заказа
// order description
$inv_desc = "Пример сплитования в ROBOKASSA";

// сумма заказа
// sum of order
$out_summ = "255.84";

// информация о сплите
// information about split
$Split = "demo:225.50:12345,shop2:20.00:321,shop3:10.34:456";

// формирование подписи
// generate signature
$crc  = md5("$mrh_login:$out_summ:$inv_id:$OutSumCurrency:$mrh_pass1:Shp_item=$shp_item");

// форма оплаты товара
// payment form
  print
   "<html>".
   "<form action='https://auth.robokassa.ru/Merchant/Index.aspx' method=POST>".
   "<input type=hidden name=MerchantLogin value=$mrh_login>".
   "<input type=hidden name=OutSum value=$out_summ>".
   "<input type=hidden name=InvId value=$inv_id>".
   "<input type=hidden name=Description value='$inv_desc'>".
   "<input type=hidden name=SignatureValue value=$crc>".
   "<input type=hidden name=Split value=$Split>".
   "<input type=submit value='Оплатить'>".
   "</form></html>";
?>

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

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

Передача фискальных данных при использовании официальных виджетов и модулей оплаты:

Вам необходимо выполнить простые настройки модуля на стороне сайта. Это встроенная функция, после ее настройки вся необходимая информация для чека будет передаваться из карточек товара вашего интернет-магазина (актуально для официальных модулей для Битрикс24, InSales, WordPress WooCommerce, OpenCart, Joomla, VirtueMart, 1С-Битрикс).

WIX: товарная номенклатура передаётся по умолчанию, без каких-либо дополнительных настроек.

Amo CRM: необходимо выполнить настройку модуля во вкладке "Настройки платежа" и включить фискализацию чеков, после чего наименования товаров и услуг будут передаваться в чек из счёта, который будет создан в новой сделке.

МойСклад: необходимо выполнить настройку модуля во вкладке "Платежи" и включить фискализацию чеков. После этого наименования товаров и услуг будут передавать в чек из счёта, который будет создан во вкладке "Счета покупателям".

 

Передача номенклатуры при использовании виджетов и модулей оплаты сторонних разработчиков:

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

Передача номенклатуры в рамках «самописного» сайта:

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

Обращаем Ваше внимание, что для решений Робочеки и Облачное в чеке не может быть более ста товарных позиций.

Receipt

{
  "sno": "osn",
  "items": [
    {
      "name": "Название товара 1",
      "quantity": 1,
      "sum": 100,
      "payment_method": "full_payment",
      "payment_object": "commodity",
      "tax": "vat10"
    },
    {
      "name": "Название товара 2",
      "quantity": 3,
      "sum": 450,
      "payment_method": "full_prepayment",
      "payment_object": "excise",
      "tax": "vat120",
      "nomenclature_code": "04620034587217"
    }
  ]
}

Параметр включается в контрольную подпись запроса (после номера счета магазина и после UserIp (Ip конечного пользователя)). Например: MerchantLogin:OutSum:InvId:Receipt:Пароль#1.

Внимание! Поле sum содержит полную стоимость за все единицы данного товара вместе, учитывая (если есть) скидки, бонусы и специальные/премиальные цены на отдельные единицы товара (например, третий товар за половину стоимости или за пять единиц товара скидка 12%).

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

Описание параметров sno items name sum quantity payment_method payment_object tax nomenclature_code Пример кода на PHP

<?php
// your registration data
$mrh_login = "test";      // your login here
$mrh_pass1 = "securepass1";   // merchant pass1 here

// order properties
$inv_id = 5;        // shop's invoice number
// (unique for shop's lifetime)
$inv_desc = "desc";   // invoice desc
$out_summ = "550";   // invoice summ

// receipt (JSON array -> urlencode)
$receipt = "%7B%22sno%22%3A%22osn%22%2C%22items%22%3A%5B%7B%22name%22%3A%22%D0%9D%D0%B0%D0%B7%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5+%D1%82%D0%BE%D0%B2%D0%B0%D1%80%D0%B0+1%22%2C%22quantity%22%3A1%2C%22sum%22%3A100%2C%22payment_method%22%3A%22full_payment%22%2C%22payment_object%22%3A%22commodity%22%2C%22tax%22%3A%22vat10%22%7D%2C%7B%22name%22%3A%22%D0%9D%D0%B0%D0%B7%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5+%D1%82%D0%BE%D0%B2%D0%B0%D1%80%D0%B0+2%22%2C%22quantity%22%3A3%2C%22sum%22%3A450%2C%22payment_method%22%3A%22full_prepayment%22%2C%22payment_object%22%3A%22excise%22%2C%22tax%22%3A%22vat120%22%2C%22nomenclature_code%22%3A%2204620034587217%22%7D%5D%7D";
$receipt_urlencode = urlencode($receipt);

// build CRC value
$crc = md5("$mrh_login:$out_summ:$inv_id:$receipt:$mrh_pass1");

// build URL
$url = "https://auth.robokassa.ru/Merchant/Index.aspx?MerchantLogin=$mrh_login&" .
    "OutSum=$out_summ&InvId=$inv_id&Description=$inv_desc&Receipt=$receipt_urlencode&SignatureValue=$crc";

// print URL if you need
echo "<a href='$url'>Payment link</a>";

Проверка чека

Для того, чтобы проверить и скачать фискальный чек, вам необходимо зайти на сайт https://check.ofd.ru/ или воспользоваться формой ниже и ввести 3 параметра чека:

ФН - фискальный накопитель
ФД - фискальный документ
ФП (ФПД) - фискальный признак

Эти параметры вы сможете увидеть в чеке из раздела "Операции и возвраты" вашего личного кабинета.
После чего кликнуть на "найти чек".

Правила для успешного формирования чека

• В чеке есть хотя бы одна позиция;

• Во всех позициях указано наименование. Строка наименования не должна содержать спецсимволов и символов других языков, кроме русского и английского;

  • Пример ошибки с символами других языков:

    • Название позиции: «дiтячий одяг»

• Входная строка наименования товара длиной не более 128 символов, более длинные строки будут обрезаны;

• Цена и сумма позиции не отрицательная;

• Общая сумма всех позиций больше нуля;

• Сумма каждой позиции должна передаваться в рублях за все количество данного товара с учетом всех возможных скидок, бонусов и специальных цен;

• Сумма всех позиций в чеке должна быть равна сумме операции;

• Все телефоны в личном кабинете должны указываться в формате «+Ц», где Ц – последовательность цифр. Максимум 18 цифр, без скобок и дефисов;

  • Правильно заполненный номер: +79008007060

  • Пр. ошибок:

    • Указано 2 номера в одной строке: +79008007060+79008007060

    • Наличие дефиса или скобок: +7(900)800-70-60

    • Телефон начинается с формата отличного от «+7»: 89008007060

• Наименование организации не должно содержать спецсимволов и символов других языков, кроме русского и английского;

  • Пример ошибки со спецсимволами:

    • Некорректный тип кавычек в названии организации: "ООО “Робокасса”"

  • Пример ошибки с символами других языков:

    • Название организации: "ООО Робоћћ"

 

 

Формирование второго чека

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

Для этого мы реализовали возможность сформировать второй кассовый чек, с признаком способа расчёта «полный расчёт».

По закону, при проведении операций с методом оплаты «аванс», «предоплата» и «предоплата 100%» необходимо формировать второй чек. Вы можете сделать это в Личном кабинете Robokassa (раздел «Операции и возвраты»). Конструктор итогового чека в личном кабинете выглядит следующим образом:





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

ВАЖНО:

1. Сервис актуален только для магазинов/партнеров, принимающих платежи и осуществляющих фискализацию через ROBOKASSA. 
2. Сервис бесплатный (но можно выбить максимум 2 чека по одной операции).
3. В параметре «operation» передается значение «sell», другие варианты игнорируются.

 

Для формирования второго чека необходимо сформировать запрос в формате Json. 

Пример запроса:

{
  "merchantId": "robokassa_sell",
  "id": "14",
  "originId": "13",
  "operation": "sell",
  "sno": "osn",
  "url": "https://www.robokassa.ru/",
  "total": 100,
  "items": [
    {
      "name": "нечто",
      "quantity": 1,
      "sum": 100,
      "tax": "none",
      "payment_method": "full_payment",
      "payment_object": "commodity",
      "nomenclature_code": "RU-123456-ABC1234567"
    }
  ],
  "client": {
    "email": "[email protected]",
    "phone": "71234567890"
  },
  "payments": [
    {
      "type": 2,
      "sum": 100
    }
  ],
  "vats": [
    {
      "type": "none",
      "sum": 0
    }
  ]
}

Описание параметров

Основные параметры запроса соответствуют параметрам первого фискального чека.

Помимо этого необходимо добавить дополнительные обязательные параметры:

MerchantID ID OriginId Operation URL Total Payment_method Client Payments Vats

Последовательность формирования запроса в BASE64URL для второго чека

 Внимание! Все запросы отправляются только в кодировке UTF8

•  Берем запрос целиком и при помощи кодировщика base64 кодируем в следующее:

eyJtZXJjaGFudElkIjoicm9ib2thc3NhX3NlbGwiLCJpZCI6IjE0IizigJxvcmlnaW5JZOKAnTrigJ0xM+KAnSwib3BlcmF0aW9uIjoic2VsbF9yZWZ1bmQiLCJzbm8iOiJvc24iLCJpdGVtcyI6W3sibmFtZSI6ItC90LXRh9GC0L4iLCJxdWFudGl0eSI6MSwic3VtIjoxMDAsInZhdCI6Im5vbmUiLCJwYXltZW50X21ldGhvZCI6ImZ1bGxfcHJlcGF5bWVudCIsInBheW1lbnRfb2JqZWN04oCdOiJzZXJ2aWNlIn1dLCJwYXltZW50cyI6W3sidHlwZSI6MSwic3VtIjoxMTAwfV0sInZhdHMiOlt7InR5cGUiOiJub25lIiwic3VtIjowfV19

и стираем на конце все знаки =, если имеются.

• Создаем SIGNATURE: для этого берем созданный запрос в base64 и приписываем к нему MerchantPass1 магазина (например, robokassatest):

eyJtZXJjaGFudElkIjoicm9ib2thc3NhX3NlbGwiLCJpZCI6IjE0IizigJxvcmlnaW5JZOKAnTrigJ0xM+KAnSwib3BlcmF0aW9uIjoic2VsbF9yZWZ1bmQiLCJzbm8iOiJvc24iLCJpdGVtcyI6W3sibmFtZSI6ItC90LXRh9GC0L4iLCJxdWFudGl0eSI6MSwic3VtIjoxMDAsInZhdCI6Im5vbmUiLCJwYXltZW50X21ldGhvZCI6ImZ1bGxfcHJlcGF5bWVudCIsInBheW1lbnRfb2JqZWN04oCdOiJzZXJ2aWNlIn1dLCJwYXltZW50cyI6W3sidHlwZSI6MSwic3VtIjoxMTAwfV0sInZhdHMiOlt7InR5cGUiOiJub25lIiwic3VtIjowfV19robokassatest

• Теперь из полученной конструкции необходимо создать hash в соответствии с тем, что выбрано у магазина в Технических настройках (md5 и тд):

90cc17555f40c44b7842ff7c83ae42fc 

• Чтобы собрать финальный запрос, который отправляется уже на URL для выбивания чека, необходимо сначала полученный md5 снова закодировать в base64:

OTBjYzE3NTU1ZjQwYzQ0Yjc4NDJmZjdjODNhZTQyZmM=

и стираем на конце все знаки =, если имеются.

• Для завершения сборки запроса к URL, на котором выбивается чек, берем изначальное тело запроса в base64, ставим точку и приписываем полученный чуть выше signature от md5 в base64:

eyJtZXJjaGFudElkIjoicm9ib2thc3NhX3NlbGwiLCJpZCI6IjE0IizigJxvcmlnaW5JZOKAnTrigJ0xM+KAnSwib3BlcmF0aW9uIjoic2VsbF9yZWZ1bmQiLCJzbm8iOiJvc24iLCJpdGVtcyI6W3sibmFtZSI6ItC90LXRh9GC0L4iLCJxdWFudGl0eSI6MSwic3VtIjoxMDAsInZhdCI6Im5vbmUiLCJwYXltZW50X21ldGhvZCI6ImZ1bGxfcHJlcGF5bWVudCIsInBheW1lbnRfb2JqZWN04oCdOiJzZXJ2aWNlIn1dLCJwYXltZW50cyI6W3sidHlwZSI6MSwic3VtIjoxMTAwfV0sInZhdHMiOlt7InR5cGUiOiJub25lIiwic3VtIjowfV19.OTBjYzE3NTU1ZjQwYzQ0Yjc4NDJmZjdjODNhZTQyZmM

• Отправить этот запрос

Отправка должна быть методом POST на URL: https://ws.roboxchange.com/RoboFiscal/Receipt/Attach

Если в результате кодирования в base64 присутствуют символы «+» или «/», то необходимо произвести замену «+» на «-» и «/» на «_», прежде чем использовать полученный результат.

Ответ на запрос создания чека

{
    "ResultCode": "0",
    "ResultDescription": "ok",
    "OpKey": "A6739663-BA55-4FA1-8D5D-621FE863DB53-v4OKjovkFY"
}

ResultСode ResultDescription OpKey

Получение статуса чека

Для того чтобы узнать результат формирования фискального чека, необходимо создать запрос вида:

{
  "merchantId": "robokassa_state",
  "id": "34"
}

Внимание! Все запросы отправляются только в кодировке UTF8

Параметры запроса MerchantId Id Signature

• Собираем из этого запроса base64:

eyJtZXJjaGFudElkIjoicm9ib2thc3NhX3N0YXRlIiwib3BrZXkiOiJENUMyNUEyRi0zOTAzLTQ4MjAtODcyRC01OTU3QjFFNjM4NTYtdmVOdTVTbzJNeSJ9

и стираем на конце все знаки =, если имеются.

• Формируем Signature также с MerchantPass1 (robokassatest):

eyJtZXJjaGFudElkIjoicm9ib2thc3NhX3N0YXRlIiwib3BrZXkiOiJENUMyNUEyRi0zOTAzLTQ4MjAtODcyRC01OTU3QjFFNjM4NTYtdmVOdTVTbzJNeSJ9robokassatest

и кодируем это все в md5:

03f9aeb13a8ead94c12b7440e0ee0c26

Теперь этот md5 снова в base64:

MDNmOWFlYjEzYThlYWQ5NGMxMmI3NDQwZTBlZTBjMjY=

и стираем на конце все знаки =, если имеются.

• Формируем полноценный запрос на статус чека из первоначального тела запроса в base64 и конечной signature также в base64, разделяя их снова точкой:

eyJtZXJjaGFudElkIjoicm9ib2thc3NhX3N0YXRlIiwib3BrZXkiOiJENUMyNUEyRi0zOTAzLTQ4MjAtODcyRC01OTU3QjFFNjM4NTYtdmVOdTVTbzJNeSJ9.MDNmOWFlYjEzYThlYWQ5NGMxMmI3NDQwZTBlZTBjMjY

• Отправляется это все вновь методом POST, но только уже на URL:

https://ws.roboxchange.com/RoboFiscal/Receipt/Status

• Если все правильно сформировали, то должны получить ответ вида (первый блок данных, это первый чек, второй блок - второй чек):

{
    "Code": "0",
    "Description": "ok",
    "Statuses": [
        {
            "Id": null,
            "Code": "2",
            "Description": "Done",
            "FnNumber": "9289540300624259",
            "FiscalDocumentNumber": "178744",
            "FiscalDocumentAttribute": "4279510152",
            "FiscalDate": null
        },
        {
            "Id": null,
            "Code": "2",
            "Description": "Done",
            "FnNumber": "9289420300621979",
            "FiscalDocumentNumber": "186589",
            "FiscalDocumentAttribute": "4237315093",
            "FiscalDate": null
        }
    ]
}

Описание возвращаемых параметров Code Description Фискальные данные

Сервис отправки SMS

Сервис SMS-сообщений поможет быстро и оперативно получать информацию о поступлении оплаты в Ваш магазин, а также передавать информацию для Ваших клиентов – сообщать о порядке прохождения и формирования заказа. После каждой покупки, совершённой в Вашем магазине, ROBOKASSA предоставляет возможность отправить 3 SMS-сообщения покупателю. 

Для подключения сервиса SMS-рассылок информирования  об оплате заказа в магазине следует:

• активировать магазин (подключение сервиса к еще неактивированному магазину невозможно);
• перейти в

• Меню
• Управление
• Дополнительные сервисы
• SMS-рассылки

 

• Выбрать магазин из выпадающего списка;
• В Технических настройках  данного магазина прописать номер телефона, на который Вы хотите получать  SMS-сообщения об оплате заказа. 

Для подключения сервиса SMS-рассылок  для информирования покупателей следует:

• активировать магазин (в неактивированном магазине сервис работать не будет);
• подключить на своей стороне сервис, осуществляющий отправку SMS-сообщений. Сервис расположен по адресу: https://services.robokassa.ru/SMS/. Сервис принимает запросы методом GET. Пример запроса можно посмотреть здесь.

К сервису отправки SMS  подключается каждый магазин по отдельности (если их несколько).Стоимость услуги можно посмотреть здесь ("Тарифы" - "Комиссии Компании за подключение и использование Функции «SMS-рассылка»").

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

Параметры запроса login phone message signature

Допустим, необходимо отправить SMS для магазина с логином demo_merchant на номер 79051234567 с текстом «All work fine!».

Пароль#1 находится в Личном кабинете клиента в Технических настройках данного магазина ( у клиента может быть несколько магазинов). Например, значение Пароль#1 будет Password1drowssaP.

Таким образом строка для подписи будет выглядеть как demo_merchant:79051234567:All work fine!:Password1drowssaP. Подпись MD5 такого запроса будет следующей: 6f0ed2dbb08da5a50124a3ee0581a7f6. Подпись SHA1 будет: 271f256595a8adc63438a3d75e14c20bc3fabe85.

Описание возвращаемых данных result count errorCode errorMessage

Запрос можно считать успешно исполненным если поле result = true и errorCode = 0.

Пример запроса методом HTTP GET

https://services.robokassa.ru/SMS/?login=demo_merchant&phone=79051234567&message=All%20work%20fine!&signature=6f0ed2dbb08da5a50124a3ee0581a7f6

Коды ошибок, специфичные для этого интерфейса

• 0 – запрос обработан успешно;
• 1 – отсутствует параметр запроса;
• 2 – указанный партнер не найден;
• 3 – партнер неактивен;
• 4 – отправка SMS-сообщений для данного партнера недоступна (партнер не активировал данную услугу в личном кабинете);
• 5 – в данный момент отправка SMS-сообщений указанным партнером невозможна;
• 6 – превышен лимит SMS-сообщений;
• 1000 – неверная подпись запроса;
• 9999 – внутренняя ошибка.

Уведомления

Уведомления предназначены для информирования владельца магазина о поступившей оплате за заказ. 

Для подключения Уведомлений перейдите в 

• МЕНЮ
• Настройки
• Мой доступ
• Уведомления

 

Подпишитесь на Уведомления в Telegram или браузере.

 и получайте мгновенное Уведомление об оплаченном заказе:

XML интерфейсы

Общая информация

XML интерфейсы предназначены для создания развёрнутого интерфейса ROBOKASSA, со всевозможными информационными блоками для клиентов Вашего магазина/сайта, а также для построения более глубокой системы взаимодействия Вашего магазина/сайта с ROBOKASSA.

Запросы к интерфейсам можно отправлять методом HTTP GET или HTTP POST, либо их можно использовать как методы XML web-сервиса:

• URL для запросов HTTP GET/POST:
  https://auth.robokassa.ru/Merchant/WebService/Service.asmx/<название метода>
• URL web-сервиса:
  https://auth.robokassa.ru/Merchant/WebService/Service.asmx
• WSDL-описание web-сервиса находится по адресу:
  https://auth.robokassa.ru/Merchant/WebService/Service.asmx?WSDL

Ответ на запрос, переданный методом HTTP GET/POST, возвращается в формате XML-документа. Документ имеет следующую структуру:

<?xml version="1.0" encoding="utf-8" ?>
<...>
  <Result>
    <Code>integer</Code>
    <Description>string</Description>
  </Result>
  <...>
    Запрошенные данные (возвращаются только в случае успешного выполнения запроса)
    Required data
  </...>
</...>

Элемент Result содержит информацию о результате выполнения запроса:

Информация о результате в элементе Result Code Description

Общие коды ошибок

Общие коды ошибок, которые могут возвращаться всеми запросами:

• 2 – информация о магазине с таким MerchantLogin не найдена или магазин не активирован;
• 1000 – внутренняя ошибка сервиса.

Интерфейс получения списка валют

Возвращает список валют, доступных для оплаты заказов указанного магазина/сайта.

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

Название метода URL для запросов HTTP GET/POST Параметры запроса MerchantLogin Language Пример запроса методом HTTP GET

Формат ответа для запросов HTTP GET/POST

<?xml version="1.0" encoding="utf-8" ?>
<CurrenciesList xmlns="http://auth.robokassa.ru/Merchant/WebService/">
  <Result>
    <Code>integer</Code> 
    <Description>string</Description>
  </Result>
  <Groups>
    <Group Code="string" Description="string">
      <Items>
        <Currency Label="string" Name="string" /> 
        ...
      </Items>
    </Group>
    ...
  </Groups>
</CurrenciesList>

Описание возвращаемых данных Groups Code Description Items Label Name Коды ошибок, специфичные для этого интерфейса

Нет.

Интерфейс получения списка доступных способов оплаты

Возвращает список способов оплаты, доступных для оплаты заказов указанного магазина/сайта. 
Используется для отображения доступных способов оплаты непосредственно на Вашем сайте, если Вы желаете дать больше информации своим клиентам. Основное отличие от Списка валют – здесь не показывается детальная информация по всем вариантам оплаты, здесь отображаются группы/методы оплаты.

Название метода URL для запросов HTTP GET/POST Параметры запроса MerchantLogin Language Пример запроса методом HTTP GET

Формат ответа для запросов HTTP GET/POST

<?xml version="1.0" encoding="utf-8" ?>
<PaymentMethodsList xmlns="http://auth.robokassa.ru/Merchant/WebService/">
  <Result>
    <Code>integer</Code>
    <Description>string</Description>
  </Result>
  <Methods>
    <Method Code="string" Description="string" />
    <Method Code="string" Description="string" />
    ...
  </Methods>
</PaymentMethodsList>

Описание возвращаемых данных Methods Code Description Коды ошибок, специфичные для этого интерфейса

Нет.

Интерфейс получения состояния оплаты счета

Возвращает детальную информацию о текущем состоянии и реквизитах оплаты. 
Необходимо помнить, что операция инициируется не в момент ухода пользователя на оплату, а позже – после подтверждения его платежных реквизитов, т.е. Вы вполне можете не находить операцию, которая по Вашему мнению уже должна начаться.

Название метода URL для запросов HTTP GET/POST Параметры запроса MerchantLogin InvoiceID Signature

Пример запроса методом HTTP GET

https://auth.robokassa.ru/Merchant/WebService/Service.asmx/OpState?MerchantLogin=demo&InvoiceID=1932809606&Signature=9e2bf657364d25acf5905b4ac4f50e39

Формат ответа для запросов HTTP GET/POST

<?xml version="1.0" encoding="utf-8" ?>
<OperationStateResponse xmlns="http://auth.robokassa.ru/Merchant/WebService/">
  <Result>
    <Code>integer</Code>
    <Description>string</Description>
  </Result>
  <State>
    <Code>integer</Code>
    <RequestDate>datetime</RequestDate>
    <StateDate>datetime</StateDate>
  </State>
  <Info>
    <IncCurrLabel>string</IncCurrLabel>
    <IncSum>decimal</IncSum>
    <IncAccount>string</IncAccount>
    <PaymentMethod>
      <Code>string</Code>
      <Description>string</Description>
    </PaymentMethod>
    <OutCurrLabel>string</OutCurrLabel>
    <OutSum>decimal</OutSum>
  </Info>
</OperationStateResponse>

Описание возвращаемых данных State Code RequestDate StateDate Info IncCurrLabel IncSum IncAccount PaymentMethod Code (способа оплаты) Description OutCurrLabel OutSum Коды ошибок, специфичные для этого интерфейса

• 1 – неверная цифровая подпись запроса;
• 3 – информация об операции с таким InvoiceID не найдена.
• 4 – найдено две операции с таким InvoiceID. Такая ошибка возникает когда есть тестовая оплата с тем же InvoiceID.

Формат данных типа дата/время

Дата/время передаются в формате, рекомендованном стандартом ISO 8601 (YYYY-MM-DDThh:mm:ss.fffffff;ZZZZZ), где:

• YYYY - год, 4 цифры;
• MM - месяц, 2 цифры;
• DD - день месяца, 2 цифры (от 01 до 31);
• T – латинский символ «T» в верхнем регистре;
• hh - часы, 2 цифры (24-часовой формат, от 00 до 23);
• mm - минуты, 2 цифры (от 00 до 59);
• ss - секунды, 2 цифры (от 00 до 59);
• fffffff – от 1 до 7 цифр дробной части секунд;
• ZZZZZ - описатель временной зоны, может принимать значения:
  • +hh:mm или -hh:mm – смещение относительно UTC (показывает, что указано локальное время, которое на данное число часов и минут опережает или отстает от UTC);
  • символ «Z» (должен быть в верхнем регистре), означает, что момент времени представлен в UTC зоне (эквивалентно +00:00 и -00:00).

Например: 2010-02-11T16:07:11.6973153+03:00

Виды магазинов

Простейший магазин без формирования уникального номера счета

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

• пользователь, выбрав способ оплаты и нажав кнопку "Оплатить", попадает на страницу ROBOKASSA, где производит оплату (на счёт магазина при этом поступают средства в Вашей валюте).
• по окончании процесса на e-mail адрес оператора магазина посылается сообщение о произведенной операции.  

В разделе Технические настройки необходимо заполнить поля:

• Алгоритм расчёта хэша – MD5 (значение по умолчанию).
• ResultURL – e-mail адрес оператора магазина, метод отправки данных – e-mail.
• SuccessURL  – адрес страницы, на которую отправится покупатель после оплаты, метод отправки данных не имеет значения (можно оставить главную страницу сайта, либо разместить по этому адресу страницу с текстом, говорящим клиенту, что его платёж успешно проведён).
• FailURL – адрес страницы, на которую направляется покупатель после неудачной оплаты, метод отправки данных не имеет значения (можно оставить главную страницу сайта, либо разместить по этому адресу страницу с текстом, говорящим клиенту, что его платёж не проведён).

Для такого магазина и скрипт необходим самый простой. В принципе необходим даже не скрипт, а ссылка для перехода на совершение оплаты.

Для работы Вам понадобится самый простой текстовый редактор, например - Блокнот.

Рассмотрим процедуру создания такой ссылки по шагам:

1. Воспользуемся шаблоном запроса для перехода на оплату:

   https://auth.robokassa.ru/Merchant/Index.aspx?MerchantLogin=[значение]&OutSum=[значение]&Description=[значение]&SignatureValue=[значение]

2. Заменим [значение] соответствующими данными, (подробнее можно почитать тут).

   Например, для исходных данных:

   • MerchantLogin = demo

     (идентификатор Вашего магазина из раздела Технические настройки)

   • OutSum = 11

     (cтоимость товара у Вас на сайте, рубли)

   • Description = Покупка в демо магазине

     (описание покупки)

   В результате получаем ссылку:

   https://auth.robokassa.ru/Merchant/Index.aspx?MerchantLogin=demo&OutSum=11&Description=Покупка в демо магазине&SignatureValue=[значение]

3. В полученной ссылке отсутствует только последнее значение – SignatureValue. Его необходимо вычислить.

   Строка данных, от которой его считают выглядит так:

   MerchantLogin:OutSum::Пароль #1

    – подставляем в неё соответствующие значения и получаем:

   demo:11::[Пароль #1]

   [Пароль #1] – это пароль, придуманный Вами при заполнении раздела Технические настройки.

   Обратите внимание,что обязательный параметр InvId присутствует в подсчете SignatureValue, хотя и с пустым значением.

4.  Для вычисления Контрольной суммы, SignatureValue, по алгоритму MD5 можно использовать один из on-line калькуляторов, например, 

   http://www.codenet.ru/services/md5/ или подобный.

5. Собираем готовую ссылку для размещения на Вашем сайте:

   https://auth.robokassa.ru/Merchant/Index.aspx?MerchantLogin=demo&OutSum=11&Description=Покупка в демо магазине&SignatureValue=2c113e992e2c985e43e348ff3c12f32b

   (По этой ссылке Вы можете совершить настоящий платёж на 11 рублей в нашем Демонстрационном магазине.)

В результате всех этих действий Вы получите ссылку для размещения на своём сайте без какого-либо дополнительного программирования. И начинайте принимать платежи.

Магазин формирующий уникальный номер счета

Схема работы магазина:

• скрипт магазина, сформировав уникальный номер счета и подпись, направляет пользователя на оплату;
• после оплаты ROBOKASSA уведомляет магазин, что платёж совершён, вызывая скрипт, находящийся по адресу ResultURL. Скрипту передаются параметры платежа, подписанные ROBOKASSA с использованием Пароля/#2. Если в момент оповещения между ROBOKASSA и магазином отсутствует связь, ROBOKASSA будет повторять попытки ещё три раза, а в случае неудачи администратору магазина будет отправлен e-mail следующего вида:

Получена оплата:

Цена: стоимость заказа
inv_id: номер заказа
Метод оплаты: метод, которым был оплачен заказ
shp_...

С уважением,
Проект ROBOKASSA

• после оплаты пользователь перенаправляется на страницу по адресу SuccessURL – ROBOKASSA передаёт те же параметры, что и на ResultURL, но подписанные с использованием Пароля/#1.

В разделе Технические настройки следует прописать:

• Алгоритм расчёта хэша – MD5 (значение по умолчанию).
• ResultURL – e-mail адрес оператора магазина, метод отправки данных – e-mail.
• SuccessURL  – адрес страницы, на которую отправится покупатель после оплаты, метод отправки данных не имеет значения (можно оставить главную страницу сайта, либо разместить по этому адресу страницу с текстом, говорящим клиенту, что его платёж успешно проведён).
• FailURL – адрес страницы, на которую направляется покупатель после неудачной оплаты, метод отправки данных не имеет значения (можно оставить главную страницу сайта, либо разместить по этому адресу страницу с текстом, говорящим клиенту, что его платёж не проведён).

Для такого магазина необходим несложный скрипт.

Для работы Вам понадобится самый простой текстовый редактор, например - Блокнот.

Рассмотрим процедуру создания такой ссылки по шагам.

Воспользуемся шаблоном запроса для перехода на оплату.

В работе рекомендуется использовать самый простой текстовый редактор – Блокнот.

1. Возьмём готовый запрос для перехода на оплату: 
   https://auth.robokassa.ru/Merchant/Index.aspx?MerchantLogin=$mrh_login&OutSum=$out_summ&InvoiceID=$inv_id&Description=$inv_desc&SignatureValue=$crc
2. Подставим в него все уже имеющиеся у нас в наличии данные, исхода из описания Обязательных параметров. 
   Делается это путём замены переменных вида «$mrh_login» на соответствующие им значения. 
   Исходные данные:
   $mrh_login = demo (Идентификатор магазина, прописанный в разделе «Технические настройки» Вашего магазина);
   $out_summ = 11 (Стоимость товара у Вас на сайте, кол-во рублей);
   $inv_id = 0 (Уникальный номер заказа в Вашем магазине. Указываем именно ноль, чтобы ROBOKASSA сама вела нумерацию заказов); 
   $inv_desc = Покупка в демо магазине (Описание покупки);

3. Получаем ссылку вида:
   https://auth.robokassa.ru/Merchant/Index.aspx?MerchantLogin=demo&OutSum=11&InvoiceID=0&Description=Покупка в демо магазине&SignatureValue=$crc

4. В полученной ссылке отсутствует только последнее значение SignatureValue. И его нам необходимо вычислить.
   Строка данных, из которой мы будем его считать:
   $mrh_login:$out_summ:$inv_id:$mrh_pass1
   Подставляем в неё соответствующие значения:
   demo:11:0:Пароль#1 
   Пароль/#1 – Это пароль, придуманный Вами при заполнении раздела Технические настройки. Здесь умышлено не показан реальный пароль.
   Для вычисления Контрольной суммы SignatureValue по алгоритму MD5 можно использовать один из on-line калькуляторов. Например, 
   http://www.codenet.ru/services/md5/ или любой другой. 
   Теперь берём строку с данными demo:11:0:Пароль#1   и вычисляем по ней Контрольную сумму. (Не забудьте указать правильный пароль!!!)
   Результат для нашего примера: 56f978e24d1b51fa7b5ace90a4f4ba53
5. Собираем готовую ссылку для размещения на Вашем сайте: 
   https://auth.robokassa.ru/Merchant/Index.aspx?MerchantLogin=demo&OutSum=11&InvoiceID=0&Description=Покупка в демо
   магазине&SignatureValue=56f978e24d1b51fa7b5ace90a4f4ba53 
   (По этой ссылке Вы можете совершить платёж на 11 рублей в нашем Демонстрационном магазине.)

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

Магазин с применением всех интерфейсов

Использование всех возможностей ROBOKASSA, таких как Дополнительные пользовательские параметры и XML-интерфейсы, позволит Вам настроить максимально глубокую интеграцию между нашей системой и Вашим интернет-магазином. Это позволит обеспечить большую гибкость в использовании ROBOKASSA, и позволит Вам обслуживать своих клиентов на качественно новом уровне. 
XML-интерфейсы позволяют предварительно получать курсы валют ROBOKASSA и список принимаемых валют,  рассчитывать как сумму к получению магазином, так и сумму к оплате для покупателя. Что значительно расширяет Ваши возможности по построению удобного пользовательского интерфейса Вашего сайта.
Также Вы можете в любой момент времени проверить состояние оплаты заказа. Это даст Вам большую стабильность и  повышенную безопасность. К примеру, Ваша система может перед автоматической выдачей товара проверять состояние оплаты заказа непосредственно у ROBOKASSA.

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

Ручная обработка заказов

Если Вы хотите, чтобы клиент мог оплатить счет только после проверки заказа менеджером и согласования с клиентом комплекта поставки, а также если Вы не имеете сайта, а работаете, например, по телефону, Вам очень сложно разобраться в технических деталях подключения и не требуется программист –  Вам необходимо использовать следующий вариант работы. В Личном кабинете Вам доступен раздел «Выставление счетов», который представляет собой простой и понятный интерфейс по созданию письма клиенту со ссылкой на оплату конкретного заказа, проверенного Вашим менеджером и согласованного с клиентом. Для реализации такого механизма работы с ROBOKASSA Вам необходимо:

1. Зарегистрироваться на нашем сайте www.robokassa.ru.

2. После создания магазина, в разделе Технические настройки нужно прописать два пароля (обязательное условие).

3. В полях ResultURL нужно выбрать метод отсылки данных E-Mail и указать электронный почтовый адрес, на который Вы планируете получать уведомления об успешных платежах, для дальнейшей обработки их Вашими менеджерами.

4. Больше никаких дополнительных настроек не требуется, при условии, что Вы планируете работать только в ручном режиме.

Некоторые особенности, которые необходимо учитывать при отправке пользователя на совершение оплаты.

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

• cама операция оплаты стартует только в тот момент, когда пользователь нажимает на кнопку «Оплатить» или «Перейти к оплате» в интерфейсе ROBOKASSA.  (с этого момента начинается отсчёт времени на совершение оплаты), т. е. если пользователь перешёл с Вашего сайта в интерфейс ROBOKASSA, выбрал (выбирал/смотрел) вариант оплаты, но не нажал на кнопку «Оплатить»/«Перейти к оплате», то никакие записи в системе ROBOKASSA не ведутся.
• Есть некоторые способы оплаты время ожидания оплаты по которым, составляет 1-2 часа, и есть такие, которые могут идти от суток до недели. 

Если говорить более подробно, то: 

• банковские карты  и электронные платёжные системы (электронные деньги): QIWI,  Яндекс.Деньги, Единый кошелек и т. д. – время, отведённое на оплату – 45 минут. . Исключение QIWI – сутки (24 часа).
• Терминалы моментальной оплаты: Элекснет и прочие – время, отведённое на оплату – двое суток (48 часов). Исключение QIWI – сутки (24 часа).
• Интернет– банки: Альфа-клик, ВТБ24 и т. д. – время, отведённое на оплату сутки (24 часа).
• Банкоматы – время, отведённое на оплату – сутки (24 часа).
• Другие способы оплаты: Мобильная коммерция – 1 час, салоны Связной и Евросеть – двое суток (48 часов).

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

Работа в тестовом режиме. Отладка, проверка, настройка.

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

Тестовая среда представляет из себя интерфейс «платёжных страниц» ROBOKASSA, но без возможности провести оплату. Она позволяет отладить процесс оплаты.

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

Для работы в тестовом режиме  обязателен параметр  IsTest. 

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

Интерфейс оплаты

Для работы в тестовом режиме магазину необходим дополнительный набор паролей, которые не должны совпадать с Пароль #1 и Пароль #2. Они прописываются в специальном разделе Технических настроек магазина. Там же выбирается Алгоритм расчёта хэша для тестовых платежей. Алгоритм расчета контрольной суммы для тестового режима должен совпадать с рабочим.

 

 

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

Если данный параметр вообще отсутствует, или в качестве значения параметра IsTest передан 0, или значение параметра пусто, то такой запрос не считается тестовым  и происходит инициализация обычной операции оплаты.

Инициализация тестовой оплаты через магазин

Рассмотрим  подробно тестирование оплаты через свой магазин с помощью модифицированного скрипта:

1. Воспользуемся вот этим  скриптом;
   

2. Здесь уже  заменены [значение] соответствующими данными, (подробнее можно почитать тут), следует проделать аналогичные шаги для Вашего тестируемого магазина:

   • MerchantLogin = Test1999
     

     (идентификатор магазина из раздела Технические настройки);

   • Pass1 = Пароль#1

     (Пароль#1 из тестовых настроек);

   • InvId = 678678

     (номер счета);

   • OutSum = 100
     

     (cтоимость товара, рубли);

   • Description = Товары для животных

     (описание покупки);

   • IsTest = 1

     (тестовый параметр, указатель на тестовую оплату);

3. Настроим оповещение об оплате на ResultURL для работы с тестовым интерфейсом. Для этого потребуется в расчёт SignatureValue включить Пароль#2 из тестовых настроек.
4. После сохранения этих настроек Вы можете инициировать из Вашего магазина тестовую операцию оплаты.
5. В результате Вы окажетесь здесь и можете продолжить тестировать процесс оплаты в Вашем магазине.

Процесс тестовой оплаты

После того как Вы нажали кнопку «Оплатить» на странице Вашего Личного кабинета, произойдет переход на страницу тестовой оплаты сайта ROBOKASSA.

 

Предложенный способ оплаты можно изменить. Кликнув по одному из предложенный сбоку страницы вариантов.

Выбрав любой другой. Например:

После того, как Вы нажмёте кнопку «Оплатить», Вы попадёте на специальную страницу тестовой оплаты где можно выбрать один из двух возможных вариантов завершения платежа: "Успешно" или "Ошибка".

После успешной оплаты на Ваш Result URL будет отправлено уведомление об успешно прошедшей оплате, а клиент попадет на страницу успешной оплаты. 

Пример неуспешной тестовой оплаты:

Обратите внимание, что тестовые оплаты не отображаются в поиске операций в Личном кабинете клиента.

Пример кода на PHP с параметром IsTest

<?
  $mrh_login = "Test1999";
  $mrh_pass1 = "password_1";
  $inv_id = 678678;
  $inv_desc = "Товары для животных";
  $out_summ = "100.00";
  $IsTest = 1;
  $crc = md5("$mrh_login:$out_summ:$inv_id:$mrh_pass1");
  print "<html><script language=JavaScript ".
      "src='https://auth.robokassa.ru/Merchant/PaymentForm/FormMS.js?".
      "MerchantLogin=$mrh_login&OutSum=$out_summ&InvoiceID=$inv_id".
      "&Description=$inv_desc&SignatureValue=$crc&IsTest=$IsTest'></script></html>";
?>

Примеры

Все  приведённые примеры предполагают, что в Технических настройках магазина в качестве Алгоритма расчёта хэша используется MD5.

PERL

Скачать архив с примерами реализации кода, можно здесь.

Формирование URL переадресации пользователя на оплату

# connect standard module for building MD5-signs
use Digest::MD5 qw(md5_hex);

# your registration data
my $mrh_login = "test";      ### your login here
my $mrh_pass1 = "securepass1";   ### merchant pass1 here


# order properties
my $inv_id    = 5;        ### shop's invoice number 
                          ### (unique for shop's lifetime)
my $inv_desc  = "desc";   ### invoice desc
my $out_summ  = "5.12";   ### invoice summ

# build CRC value
my $crc  =
    md5_hex("$mrh_login:$out_summ:$inv_id:$mrh_pass1");

# build URL
my $url = "https://auth.robokassa.ru/Merchant/Index.aspx?MerchantLogin=$mrh_login&".
    "OutSum=$out_summ&InvId=$inv_id&Description=$inv_desc&SignatureValue=$crc";

# print URL if you need
print "Content-type: text/html\n\n";
print "<a href='/ru/$url'>Payment link</a>";

Получение уведомления об исполнении операции (ResultURL)

# as a part of ResultURL script 

# connect standard module for building MD5-signs
use Digest::MD5 qw(md5_hex);
# define function for retrieval http-paratemters
sub http_Prm;

# your registration data
my $mrh_pass2 = "securepass2";  ### merchant pass2 here

# load parameters
my %q = http_Prm();
# loaded parameters: $q{OutSum}, $q{InvId}, $q{SignatureValue}

$q{SignatureValue} =~ s/([a-z])/uc "$1"/eg;   # force uppercase

# build own CRC
my $my_crc = md5_hex("$q{OutSum}:$q{InvId}:$mrh_pass2");
$my_crc =~ s/([a-z])/uc "$1"/eg;   # force uppercase

# define the correctness state
my $is_correct = ($my_crc eq $q{SignatureValue} ? 1 : 0);

if (!$is_correct)
{
  print "Content-type: text/html\n\nbad sign\n";
  die "incorrect sign passed";
}

# OK state
# print OK signature
print "Content-type: text/html\n\nOK$q{InvId}\n";

# perform some action (change order state to paid)

exit();


# just function to load http parameters, you can use own

sub http_Prm
{
  my %query;

  {
    # POST params
    my ($q_sz, $i, @q, @cmd);

    my $l     = $ENV{'CONTENT_LENGTH'};
    my $qtext = "";
    while ($l>0)
    { $l-=sysread(STDIN, $qtext, $l, length($qtext)); }

    @q    = split("&", $qtext);
    $q_sz = scalar(@q);

    for($i=0; $i<$q_sz; $i++)
    {
      @cmd = split("=", $q[$i]);
      $cmd[1] =~ s/\+/ /g;
      $cmd[1] =~ s/%([0-9A-Fa-f]{2})/chr(hex($1))/eg;
      $query{$cmd[0]} = $cmd[1];
    }
  }

  {
    # GET params
    my ($q_sz, $i, $qtext, @q, @cmd);

    $qtext = $ENV{'QUERY_STRING'};

    @q    = split("&", $qtext);
    $q_sz = scalar(@q);

    for($i=0; $i<$q_sz; $i++)
    {
      @cmd = split("=", $q[$i]);
      $cmd[1] =~ s/\+/ /g;
      $cmd[1] =~ s/%([0-9A-Fa-f]{2})/chr(hex($1))/eg;
      $query{$cmd[0]} = $cmd[1];
    }
  }

  return %query;
}

Проверка параметров в скрипте завершения операции (SuccessURL)

# as a part of SuccessURL script 

# connect standard module for building MD5-signs
use Digest::MD5 qw(md5_hex);
# define function for retrieval http-paratemters
sub http_Prm;

# your registration data
my $mrh_pass1 = "securepass1";  ### merchant pass1 here

# load parameters
my %q = http_Prm();
# loaded parameters: $q{OutSum}, $q{InvId}, $q{SignatureValue}

$q{SignatureValue} =~ s/([a-z])/uc "$1"/eg;   # force uppercase

# build own CRC
my $my_crc = md5_hex("$q{OutSum}:$q{InvId}:$mrh_pass1");
$my_crc =~ s/([a-z])/uc "$1"/eg;   # force uppercase

# define the correctness state
my $is_correct = ($my_crc eq $q{SignatureValue} ? 1 : 0);

if (!$is_correct)
{
  print "Content-type: text/html\n\nbad sign\n";
  die "incorrect sign passed";
}

# you can check here, that resultURL was called 
# (for better security)

# OK, payment proceeds
print "Content-type: text/html\n\n";
echo "Thank you for using our service\n";

exit();


# just function to load http parameters, you can use own

sub http_Prm
{
  my %query;

  {
    # POST params
    my ($q_sz, $i, @q, @cmd);

    my $l     = $ENV{'CONTENT_LENGTH'};
    my $qtext = "";
    while ($l>0)
    { $l-=sysread(STDIN, $qtext, $l, length($qtext)); }

    @q    = split("&", $qtext);
    $q_sz = scalar(@q);

    for($i=0; $i<$q_sz; $i++)
    {
      @cmd = split("=", $q[$i]);
      $cmd[1] =~ s/\+/ /g;
      $cmd[1] =~ s/%([0-9A-Fa-f]{2})/chr(hex($1))/eg;
      $query{$cmd[0]} = $cmd[1];
    }
  }

  {
    # GET params
    my ($q_sz, $i, $qtext, @q, @cmd);

    $qtext = $ENV{'QUERY_STRING'};

    @q    = split("&", $qtext);
    $q_sz = scalar(@q);

    for($i=0; $i<$q_sz; $i++)
    {
      @cmd = split("=", $q[$i]);
      $cmd[1] =~ s/\+/ /g;
      $cmd[1] =~ s/%([0-9A-Fa-f]{2})/chr(hex($1))/eg;
      $query{$cmd[0]} = $cmd[1];
    }
  }

  return %query;
}

PHP

Скачать архив с примерами реализации кода, можно здесь.

Формирование URL переадресации пользователя на оплату

// your registration data
$mrh_login = "test";      // your login here
$mrh_pass1 = "securepass1";   // merchant pass1 here

// order properties
$inv_id    = 5;        // shop's invoice number 
                       // (unique for shop's lifetime)
$inv_desc  = "desc";   // invoice desc
$out_summ  = "5.12";   // invoice summ

// build CRC value
$crc  = md5("$mrh_login:$out_summ:$inv_id:$mrh_pass1");

// build URL
$url = "https://auth.robokassa.ru/Merchant/Index.aspx?MerchantLogin=$mrh_login&".
    "OutSum=$out_summ&InvId=$inv_id&Description=$inv_desc&SignatureValue=$crc";

// print URL if you need
echo "<a href='/ru/$url'>Payment link</a>";

Получение уведомления об исполнении операции (ResultURL)

// as a part of ResultURL script

// your registration data
$mrh_pass2 = "securepass2";   // merchant pass2 here

// HTTP parameters:
$out_summ = $_REQUEST["OutSum"];
$inv_id = $_REQUEST["InvId"];
$crc = strtoupper($_REQUEST["SignatureValue"]);

// build own CRC
$my_crc = strtoupper(md5("$out_summ:$inv_id:$mrh_pass2"));

if ($my_crc != $crc)
{
  echo "bad sign\n";
  exit();
}

// print OK signature
echo "OK$inv_id\n";

// perform some action (change order state to paid)

Проверка параметров в скрипте завершения операции (SuccessURL)

// as a part of SuccessURL script

// your registration data
$mrh_pass1 = "securepass1";  // merchant pass1 here

// HTTP parameters:
$out_summ = $_REQUEST["OutSum"];
$inv_id = $_REQUEST["InvId"];
$crc = $_REQUEST["SignatureValue"];

$crc = strtoupper($crc);  // force uppercase

// build own CRC
$my_crc = strtoupper(md5("$out_summ:$inv_id:$mrh_pass1"));

if ($my_crc != $crc)
{
  echo "bad sign\n";
  exit();
}

// you can check here, that resultURL was called 
// (for better security)

// OK, payment proceeds
echo "Thank you for using our service\n";

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

// HTML form. Path to action.php handler

//необходимо указать адрес php скрипта
<form action="http://site.ru/action.php" method="POST"> 
    <meta charset="utf-8" />
<input type="text" name="out_sum" placeholder="Сумма платежа" required>
<input type=submit value='Оплатить'>
</form>

<?php


if (!empty($_POST["out_sum"])) {

    $out_sum = trim(htmlspecialchars(strip_tags($_POST["out_sum"])));

    $mrh_login = "udentifier"; // идентификатор магазина
    $mrh_pass1 = "password_1"; // пароль #1

    $inv_id = ""; // номер счета

    $items = array (
  'items' =>
  array (
    0 =>
    array (
      'name' => 'name',
      'quantity' => 1,
      'sum' => trim(htmlspecialchars(strip_tags($_POST["out_sum"]))),
      'payment_method' => 'full_payment',
      'payment_object' => 'commodity',
      'tax' => 'none',
    ),
  ),
);

    $arr_encode = json_encode($items); // Преобразовываем JSON в строку

    $receipt = urlencode($arr_encode);
    $receipt_urlencode = urlencode($receipt);

    $inv_desc = "description"; // описание заказа

    $crc = md5("$mrh_login:$out_sum:$inv_id:$receipt:$mrh_pass1"); // формирование подписи
// Перенаправляем пользователя на страницу оплаты
    Header("Location: https://auth.robokassa.ru/Merchant/Index.aspx?MrchLogin=$mrh_login&OutSum=$out_sum&InvId=$inv_id&Receipt=$receipt_urlencode&Desc=$inv_desc&SignatureValue=$crc");

}

ASP.NET

Скачать архив с примерами реализации кода, можно здесь.

Формирование URL переадресации пользователя на оплату

using System;
using System.Text;
using System.Globalization;
using System.Security.Cryptography;

public partial class Init : System.Web.UI.Page
{
  protected void Page_Load(object sender, EventArgs e)
  {
    // your registration data
    string sMrchLogin = "test";
    string sMrchPass1 = "securepass1";
    // order properties
    decimal nOutSum = 5.12M;
    int nInvId = 5;
    string sDesc = "desc";
  
    string sOutSum = nOutSum.ToString("0.00", CultureInfo.InvariantCulture);
    string sCrcBase = string.Format("{0}:{1}:{2}:{3}", 
                                     sMrchLogin, sOutSum, nInvId, sMrchPass1);

    // build CRC value
    MD5CryptoServiceProvider md5 = new MD5CryptoServiceProvider();
    byte[] bSignature = md5.ComputeHash(Encoding.ASCII.GetBytes(sCrcBase));

    StringBuilder sbSignature = new StringBuilder();
    foreach (byte b in bSignature)
        sbSignature.AppendFormat("{0:x2}", b);

    string sCrc = sbSignature.ToString();

    // LinkButtonPay is System.Web.UI.WebControls.LinkButton;
    LinkButtonPay.Text = "Payment link";
    // build URL
    LinkButtonPay.PostBackUrl = "https://auth.robokassa.ru/Merchant/Index.aspx?" +
                                        "MerchantLogin=" + sMrchLogin +
                                        "&OutSum=" + sOutSum +
                                        "&InvId=" + nInvId +
                                        "&Description=" + sDesc +
                                        "&SignatureValue=" + sCrc;
  }
}

Получение уведомления об исполнении операции (ResultURL)

using System;
using System.Web;
using System.Text;
using System.Globalization;
using System.Security.Cryptography;

public partial class Result : System.Web.UI.Page
{
  protected void Page_Load(object sender, EventArgs e)
  {
    // your registration data  
    string sMrchPass2 = "securepass2";
  
    // HTTP parameters
    string sOutSum = GetPrm("OutSum");
    string sInvId = GetPrm("InvId");
    string sCrc = GetPrm("SignatureValue");
  
    string sCrcBase = string.Format("{0}:{1}:{2}", 
                                     sOutSum, sInvId, sMrchPass2);
    
    // build own CRC
    MD5CryptoServiceProvider md5 = new MD5CryptoServiceProvider();
    byte[] bSignature = md5.ComputeHash(Encoding.ASCII.GetBytes(sCrcBase));

    StringBuilder sbSignature = new StringBuilder();
    foreach (byte b in bSignature)
        sbSignature.AppendFormat("{0:x2}", b);

    string sMyCrc = sbSignature.ToString();

    if (sMyCrc.ToUpper() != sCrc.ToUpper())
    {
      Response.Write("bad sign");
      return;
    }
    
    Response.Write(string.Format("OK{0}", sInvId));
    // perform some action (change order state to paid)    
  }

  private string GetPrm(string sName)
  {
    string sValue;
    sValue = HttpContext.Current.Request.Form[sName] as string;

    if (string.IsNullOrEmpty(sValue))
      sValue = HttpContext.Current.Request.QueryString[sName] as string;

    if (string.IsNullOrEmpty(sValue))
      sValue = String.Empty;

    return sValue;
  }
}

Проверка параметров в скрипте завершения операции (SuccessURL)

using System;
using System.Web;
using System.Text;
using System.Globalization;
using System.Security.Cryptography;

public partial class Success : System.Web.UI.Page
{
  protected void Page_Load(object sender, EventArgs e)
  {
    // your registration data  
    string sMrchPass1 = "securepass1";
  
    // HTTP parameters
    string sOutSum = GetPrm("OutSum");
    string sInvId = GetPrm("InvId");
    string sCrc = GetPrm("SignatureValue");
  
    string sCrcBase = string.Format("{0}:{1}:{2}", 
                                     sOutSum, sInvId, sMrchPass1);
    
    // build own CRC
    MD5CryptoServiceProvider md5 = new MD5CryptoServiceProvider();
    byte[] bSignature = md5.ComputeHash(Encoding.ASCII.GetBytes(sCrcBase));

    StringBuilder sbSignature = new StringBuilder();
    foreach (byte b in bSignature)
        sbSignature.AppendFormat("{0:x2}", b);

    string sMyCrc = sbSignature.ToString();

    if (sMyCrc.ToUpper() != sCrc.ToUpper())
    {
      Response.Write("bad sign");
      return;
    }
    
    // you can check here, that ResultURL was called 
    // (for better security)

    // OK, payment proceeds
    Response.Write("Thank you for using our service");    
  }

  private string GetPrm(string sName)
  {
    string sValue;
    sValue = HttpContext.Current.Request.Form[sName] as string;

    if (string.IsNullOrEmpty(sValue))
      sValue = HttpContext.Current.Request.QueryString[sName] as string;

    if (string.IsNullOrEmpty(sValue))
      sValue = String.Empty;

    return sValue;
  }
}

Требования к сайту магазина со стороны платёжных систем

Требования к сайту магазина со стороны платёжной системы WebMoney

1. Необходимо разместить на своем сайте ссылку на сайт платёжной системы WebMoney в виде кнопки "Мы принимаем WebMoney": https://www.webmoney.ru/rus/developers/logos.shtml
2. На сайте должно быть опубликовано описание порядка оплаты товаров или услуг с помощью системы WebMoney Transfer. Это описание должно быть доступно всем пользователям без обязательной регистрации на сайте.
3. Сайт не должен использоваться для распространения и рекламы товаров или услуг незаконного, криминального характера, не соответствующих общепринятым этическим и правовым нормам.
   Список таких товаров и услуг приведен в Приложении: http://www.wmtransfer.com/rus/cooperation/legal/syagreement1.shtml#2

Требования к магазину от GooglePay

Ознакомьтесь с условиями пользовательского соглашения GooglePay по ссылке.

Условия указанного соглашения действуют полностью при использовании услуги в рамках сервиса ROBOKASSA.

Рекомендации по бухгалтерскому учету

Для разъяснения некоторых вопросов рекомендуем ознакомиться с документом по ссылке.

Логотипы Robokassa

Черно-белый: EPS, JPEG, PNG (Архив ZIP, 852 Kб)
Цветной для печати CMYK: EPS, JPEG, PNG (Архив ZIP, 2,7 Мб)
Цветной Pantone для электронных материалов: EPS, JPEG, PNG (Архив ZIP, 2,7 Мб)