Sberbank Merchant

Build Status Gem Version Code Climate Test Coverage

Ruby клиент для работы с платёжным шлюзом Сбербанка.

Ключевые особенности:

  • Простой (~200 LOC).
  • Расширяемый из коробки. Если В API появится новый метод то данный клиент будет его поддерживать без каких либо правок в исходный код
  • Написан в ОО + ФП стиле без "магии". Легко встроится в ваши сервисные объекты и юнит тесты

Установка

RubyGems.org

% gem install sbrf_merchant

Bundler

# Gemfile
gem 'sbrf_merchant', '~> 2.0.0`

Документация

Использование

Пример регистрации заказа

# Перед использованием необходимо проинициализировать библиотеку.
SbrfMerchant.configure do |config|
  config.user_name = '<Merchant Username>'
  config.password = '<Merchant Password>'
  config.host =     '<Sberbank API Host>'
end

# или

SbrfMerchant.configuration = SbrfMerchant::Configuration.new(
  host: '<Sberbank API Host>',
  user_name: '<Merchant Username>',
  password: '<Merchant Password>'
)


# Cоздаем клиент
client = SbrfMerchant::Api::Client.new

# Вызываем метод API.
# :register - название метода согласно документации Cбербанка в snake_case.
# Далее параметры запроса. Имена передаются в snake_case, перед отправкой запроса все параметры приведутся к camelCase.
response = client.call(:register, amount: 100, order_number: SecureRandom.hex, return_url: 'localhost:3000')
response.success? # => true
# В ответе имена возвращаются в snake_case
response.order_id #<order-id>

Copyright (c) 2018 Eugene Kozlov. See LICENSE for details.