This project is not covered by Drupal’s security advisory policy.

[Русская версия ниже]

Drupal Commerce integration with Robokassa payment system.

Registering with Robokassa

Before you'll start the installation process you must register on Robokassa and create your own merchant.

Installation and Configuration

  • Download the module from Drupal.org and extract it to your modules folder.
  • Enable it.
  • Go to /admin/commerce/config/payment-methods and edit Robokassa rule.
  • Edit Payment method (Just click edit before 'Enable payment method: Robokassa payment').
  • Setup the settings according your data from Robokassa. Please use POST method only for Success/Fail/Result urls in Robokassa account.

That's it :)

Version 7.x-2.x features:

This version have been designed and coded from scratch.

It is strongly recomended to make backup before update from 7.x-1.x

  • Multiple payment rules support have been added. (Only single payment rule was supported in version 7.x-1.0-rc1)
  • Payment transaction and order status change preceed in drupal commerce way
  • Custom success/fail pages was replaced with standard commerce order processing (go to next checkout page on success payment/ go to prev page on fail payment). This behaviour allow add additional order states/statuses using hook_commerce_order_state_info hook_commerce_order_status_info and additional checkout pages without hacks. So standard commerce order complete page is used. If you will update to release 7.x-2.0-rc1 it may need review of checkout process.
  • Payment transaction is created when user redirect to robokassa gateway (In version 7.x-1.0-rc1 payment transaction have been created on robokassa success payment)
  • All allowed hash algos for SignatureValue robokassa parameter are supported. (Only md5 was supported in version 7.x-1.0-rc1)
  • In version 7.x-2.0-rc1 unfinished payment transaction will be processed when they haven't finished in version 7.x-1.0-rc1.
  • Version 7.x-2.0-rc1 settings are not compatible with 7.x-1.0-rc1 version, so you need reconfigure payment method on site and replace urls in robokassa merchant account.
  • Only POST url call method is supported.

Additional information For version 7.x-2.x

Default Success url - /commerce_robokassa/commerce_robokassa/success
Default Fail url - /commerce_robokassa/commerce_robokassa/fail
Default Result url - /commerce_robokassa/commerce_robokassa/result
Please use POST method only for Success/Fail/Result urls in Robokassa account.

For the second rule

You rule machine name must be prefixed with commerce_payment_
For rule with machine name commerce_payment_second_rule
Default Success url - /commerce_robokassa/commerce_robokassa/success
Default Fail url - /commerce_robokassa/second_rule/fail
Default Result url - /commerce_robokassa/second_rule/result

Additional information For version 7.x-1.x

Default Success url - /robokassa/success
Default Fail url - /robokassa/fail
Default Result url - /robokassa/result
Please use POST method only for Success/Fail/Result urls in Robokassa account.
Only md5 hash algo is suported.

Examples and API manual (How to & Interface)

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

Перед началом использования Вам необходимо зарегистрироваться в Robokassa
и создать мерчант.

Установка и настройка

  • Скачайте модуль с Drupal.org и распакуйте его в папку с модулями.
  • Включите его.
  • Зайдите /admin/commerce/config/payment-methods и отредактируйте правило Robokassa.
  • Отредактируйте платежный метод (Кликните по 'Включить платежный метод: Robokassa payment').
  • Настройте платежный метод согласно дынных полученных от Robokassa. Используйте метод обмена POST для ссылок for Success/Fail/Result в кабинете Robokassa.

Готово :)

Особенности версии 7.x-2.x

Эта версия полностью переписана.

Настоятельно рекомендуется сделать резервную копию перед обновлением с версии 7.x-1.x

  • Добавлена поддержка нескольких платежных правил. (В версии 7.x-1.0-rc1 только одно правило разрешено)
  • Изменение статуса платежной транзакции и заказа происходит drupal commerce way
  • Страницы success/fail заменены стандартным для drupal commerce процессингом (перейти на следующую страницу чекаута при успешной оплате или на предыдущую при не успешной). Это поведение позволяет добавлять статусы и стейты заказа при помощи хуков hook_commerce_order_state_info и hook_commerce_order_status_info, а так же дополнительные страницы чекаута без хаков. Как следствие используется стандартная для Drupal Commerce страница завершения заказа. При обновлении до версии 7.x-2.0-rc1 вероятно необходим пересмотр чекаута.
  • Платежная транзакция создается при редиректе пользователя на шлюз robokassa.ru. (В версии 7.x-1.0-rc1 платежная транзакция создавалась только при успешной оплате)
  • Все разрешенные в Robokassa методы хеширования SignatureValue поддерживаются. (В версии 7.x-1.0-rc1 поддерживался только md5).
  • Версия 7.x-2.0-rc1 может грузить и правильно обрабатывать незавершенные платежные транзакции версии 7.x-1.0-rc1.
  • Настройки версии 7.x-2.0-rc1 не совместимы с настройками версии 7.x-1.0-rc1 При обновлении Вы должны Перенастроить платежный метод на сайте и заменить ссылки в robokassa merchant.
  • Поддерживается только метод обмена POST.

Дополнительная информация для версии 7.x-2.x

Success url по умолчанию - /commerce_robokassa/commerce_robokassa/success
Fail url по умолчанию - /commerce_robokassa/commerce_robokassa/fail
Result url по умолчанию - /commerce_robokassa/commerce_robokassa/result
Используйте метод обмена POST для ссылок Success/Fail/Result в кабинете Robokassa.

Для второго правила

Машинное имя правила должно начинаться с префикса commerce_payment_
Для правила с машинным именем commerce_payment_second_rule
Default Success url - /commerce_robokassa/second_rule/success
Default Fail url - /commerce_robokassa/second_rule/fail
Default Result url - /commerce_robokassa/second_rule/result

Дополнительная информация для версии 7.x-1.x

Success url по умолчанию - /robokassa/success
Fail url по умолчанию - /robokassa/fail
Result url по умолчанию - /robokassa/result
Используйте метод обмена POST для ссылок Success/Fail/Result в кабинете Robokassa.
Поддерживается только алгоритм хеширования md5.

Примеры и инструкции: Установка и интерфейсы

Project information

Releases