Банковский перевод

Вариант интеграции SS

Процесс проведения оплаты

Покупатель инициирует оплату на сайте торговца.
Торговец отправляет запрос оплаты в Freepayment.
Freepayment присылает в ответе секцию form с полем action, содержащим URL страницы оплаты.
Продавец перенаправляет покупателя на страницу из параметра form.action из ответа Freepayment.
Страница отображает список банков, доступных для страны, указанной в method.channel. Покупатель выбирает банк, приложение которого он будет использовать для оплаты, и завершает транзакцию.
Freepayment отправляет торговцу автоматическое уведомление со статусом оплаты. Торговец также может запросить статус оплаты у Freepayment с помощью запроса получения статуса транзакции.

Info

Этот вариант интеграции поддерживает только валюту EUR.

Оплата

Запрос

Отправьте запрос оплаты со следующими данными:

Параметр	Тип	Описание
request	object
return_url * обязательный	string	URL, на который будет возвращен покупатель после завершения оплаты.
method	object	Секция параметров способа оплаты.
type * обязательный	string	`bank_transfer`
channel * обязательный	string	Страна банка покупателя в формате ISO 3166-1 alpha-2. Возможные значения: `AT`, `BE`, `BG`, `HR`, `CY`, `CZ`, `DK`, `EE`, `FI`, `FR`, `DE`, `GR`, `HU`, `IS`, `IE`, `IT`, `LV`, `LI`, `LT`, `LU`, `MT`, `NL`, `NO`, `PL`, `PT`, `RO`, `SK`, `SI`, `ES`, `SE`, `GB`.

Пример запроса

{
  "request": {
      "test": true,
      "amount": 500,
      "currency": "EUR",
      "description": "description",
      "return_url": "https://return.com",
      "method": {
          "type": "bank_transfer",
          "channel": "ES"
      }
  }
}

Ответ

Отправьте покупателя на URL, указанный в параметре form.action.

Пример ответа

{
    "transaction": {
        "uid": "d7b88f80-f714-4f64-9aeb-dc880b3b7b4a",
        "type": "payment",
        "status": "pending",
        "amount": 2300,
        "currency": "EUR",
        "description": "test",
        "created_at": "2025-01-11T11:31:09Z",
        "updated_at": "2025-01-11T11:31:10Z",
        "method_type": "bank_transfer",
        "receipt_url": "https://account.freepayment.online/customer/transactions/d7b88f80-f714-4f64-9aeb-dc880b3b7b4a/e598bbe9b8a2deaf99fbcefca028f6c6c2b7eedf593d3ee37151e9acd61844da?language=ru",
        "payment": {
            "status": "pending",
            "gateway_id": 4824,
            "ref_id": "4214474",
            "message": "Invoice is created successfully, waiting for a payment",
            "bank_code": 31
        },
        "bank_transfer": {
            "type": "bank_transfer"
        },
        "customer": {
            "email": null,
            "ip": null
        },
        "manually_corrected_at": null,
        "version": 0,
        "message": "Invoice is created successfully, waiting for a payment",
        "tracking_id": "your_uniq_number21212",
        "test": true,
        "language": "en",
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },
        "gateway": {
            "iframe": false
        },
        "form": {
            "action": "https://test-ss/hosted?transaction-id=5e747509-4b2e-8a0a-03ea-5697eb",
            "method": "GET",
            "fields": []
        }
    }
}