🤖🚫 AI-free content. This post is 100% written by a human, as is everything on my blog. Enjoy!

Проведение платежей через LiqPAY посредством Ruby

January 27, 2012, revised April 17, 2012 in Ruby on Rails

(The English version of this tutorial is at liqpay’s GitHub page).

Я подготовил рабочую версию гема для работы с LiqPAY. LiqPAY – это такая биллинговая система от ПриватБанка. Её конкурентное преимущество – простота подключения; для приема платежей не нужно практически ничего, кроме счета в ПриватБанке.

Установка

Подключи гем liqpay к своему приложению.

Настройка

Гем настраивается в Liqpay.default_options (это хеш).

Там обязательно нужно указать merchant_id и merchant_signature, которые сообщаются при регистрации в LiqPAY в качестве приемщика платежей.

Прием платежей

Общая логика

Пользователь выбирает способ оплаты; ты пересылаешь его на LiqPAY POST-запросом, сообщая все необходимые параметры платежа.
Пользователь проводит платеж через LiqPAY.
LiqPAY пересылает пользователя назад, в приложение.
Ты проверяешь корректность платежа секретной подписью.
Если платеж успешен: ты обрабатываешь платеж внутри приложения.
Если платеж безуспешен: ты отклоняешь операцию.

Процесс оплаты довольно простой, может работать “в один поток”, без фонового обмена информацией с сервером.

Реализация Rails

Настрой Liqpay:

# Gemfile
gem 'liqpay'

# config/initializers/liqpay.rb
Liqpay.default_options[:merchant_id] = 'MY_MERCHANT_ID'
Liqpay.default_options[:merchant_signature] = 'MY_MERCHANT_SIGNATURE'

Создай объект Liqpay::Request.

Обязательные атрибуты – сумма и валюта платежа, а также “идентификатор заказа”.

Идентификатор заказа – произвольная строка, которая нужна будет тебе для опознания платежа после его окончания. Если у тебя есть модель Order (советую её завести), тут может быть ее ID. Если нет, это может быть даже случайно сгенерированный ключ, хранимый в сессии. Главное, чтоб он был уникальным.
```
@liqpay_request = Liqpay::Request.new(
  :amount => '999.99',
  :currency => 'UAH',
  :order_id => '123',
  :description => 'Some Product',
  :result_url => liqpay_payment_url
)
```
Эта операция не делает никаких изменений. Ничего не пишет в базу, ничего не пересылает в LiqPAY.
Размести где-то кнопку оплаты

Поскольку пользователя нужно пересылать POST-запросом, тебе обязательно понадобится форма.

Чтоб показать форму, состоящую из единственной кнопки “Pay with LiqPAY”, напиши
```
<%=liqpay_button @liqpay_request %>
```
Или:
```
<%=liqpay_button @liqpay_request, :title => "Оплатить" %>
```
Или:
```
<%=liqpay_button @liqpay_request do %>
  <%=link_to 'Оплатить!', '#', :onclick => 'document.forms[0].submit();' %>
<% end %>
```

Настрой адрес приемки.

# config/routes.rb
post '/liqpay_payment' => 'payments#liqpay_payment'

# app/controllers/payments_controller.rb
class PaymentsController < ApplicationController
  # Это важно
  protect_from_forgery :except => :liqpay_payment

  def liqpay_payment
    @liqpay_response = Liqpay::Response.new(params)

    if @liqpay_response.success? &&
      @liqpay_response.order_id == ACTUAL_ORDER_ID &&
      @liqpay_reponse.amount == EXPECTED_AMOUNT

      # обработать платеж

    else
      # обработать ошибку
    end
  rescue Liqpay::InvalidResponse
    # обработать ошибку
  end
end

Вот и все.

Безопасность

Проверяй, что сумма платежа в ответе равна ожидаемой;
проверяй правильность идентификатора заказа;
проверяй, что заказ еще не оплачен (чтоб избежать повторного использования ответа от LiqPAY);

Документация по исходникам liqpay

Понравился пост? Купи мне кофе

Leonid Shevtsov