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

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

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

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

Info

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

Оплата

Запрос

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

object

return_url

обязательный

string
URL, на который будет возвращен покупатель после завершения оплаты.

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": []
        }
    }
}