Commerce robokassa

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

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.

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