Sberbank Merchant

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

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

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

Установка

RubyGems.org

% gem install sbrf_merchant

Bundler

# Gemfile
gem 'sbrf_merchant'

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

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

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

# Cоздаем клиент
client = SBRF::Api::Client.new(
  user_name: '<Merchant Username>',
  password: '<Merchant Password>',
  host: '<Sberbank API Host>' # например https://3dsec.sberbank.ru'
)

# Вызываем метод API.
# :register - название метода согласно документации Cбербанка в snake_case.
# Далее параметры запроса. Имена передаются в snake_case,
# перед отправкой запроса все параметры приведутся к camelCase.

params = {
  amount: 100,
  order_number: "something_unique_string",
  return_url: 'localhost:3000'
}
response = client.call(:register, params)

response.success? # => true
# В ответе доступ к атрибутам в snake_case
response.order_id #<order-id>

Использование альтернативного http клиента

По умолчанию гем использует Net::Http для отправки HTTP запросов. Если в вашем проекте используется другой Http клиент, например Faraday то нужно реализовать callable класс или Proc и передать его в конструктор:

client = SBRF::Api::Client.new(
  user_name: '<Merchant Username>',
  password: '<Merchant Password>',
  host: '<Sberbank API Host>' # например https://3dsec.sberbank.ru',
  http_client: ->(uri, params) { Faraday.post(uri, params) }
)