PaysafeCard

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

Оплата

Info

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

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

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

Запрос

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

object

return_url

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

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

language

string
Язык страницы оплаты. Допустимые значения: BG, JA, CS, KO, DA, NL, DE, PL, EL, PT, EN, RO, ES, RU, FI, SV, FR, TR, IT, ZH.

object
Секция параметров способа оплаты.

type обязательный	string `pay_safe_card`
account_number обязательный	string Идентификатор счета покупателя, в данном варианте интеграции – email покупателя.

object
Секция информации о покупателе.

first_name	string Имя покупателя.
last_name	string Фамилия покупателя.
country	string Страна покупателя в формате ISO 3166-1 alpha-2. Возможные значения: AU (Австралия), AT (Австрия), BE (Бельгия), BG (Болгария), HR (Хорватия), CY (Кипр), CZ (Чехия), DK (Дания), FI (Финляндия), FR (Франция), DE (Германия), HU (Венгрия), IS (Исландия), IE (Ирландия), IT (Италия), LV (Латвия), LT (Литва), LU (Люксембург), MT (Мальта), NL (Нидерланды), NZ (Новая Зеландия), NO (Норвегия), PY (Парагвай), PL (Польша), PT (Португалия), RO (Румыния), SK (Словакия), SI (Словения), ES (Испания), SE (Швеция), CH (Швейцария), GB (Великобритания), UY (Уругвай), US (США).

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

{
  "request": {
    "amount": 100,
    "currency": "EUR",
    "description": "description",
    "return_url": "https://merchant.ltd/return",
    "customer": {
      "first_name": "John",
      "last_name": "Doe",
      "country": "DE"
    },
    "method": {
      "type": "pay_safe_card",
      "account_number": "example@example.com"
    }
  }
}

Ответ

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

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

{
  "transaction": {
      "uid": "b79cd2e2-2598-482c-9336-ebbec6a43e62",
      "type": "payment",
      "status": "pending",
      "amount": 100,
      "currency": "EUR",
      "description": "description",
      "created_at": "2025-05-06T12:32:01Z",
      "updated_at": "2025-05-06T12:32:02Z",
      "method_type": "pay_safe_card",
      "receipt_url": "https://demo-backoffice.begateway.com/customer/transactions/b79cd2e2-2598-482c-9336-ebbec6a43e62/9fc125f86dd695c0398101350a5853c22d68f0cd5ca446440c2d0f133b8e7e06",
      "payment": {
          "status": "pending",
          "gateway_id": 5334,
          "message": "Transaction was initialized."
      },
      "pay_safe_card": {
          "type": "pay_safe_card"
      },
      "customer": {
          "first_name": "John",
          "last_name": "Doe",
          "country": "DE",
          "email": null,
          "ip": null
      },
      "manually_corrected_at": null,
      "version": 0,
      "message": "Transaction was initialized.",
      "test": false,
      "billing_address": {
          "first_name": "John",
          "last_name": "Doe",
          "country": "DE"
      },
      "additional_data": {
          "payment_method": {
              "type": "alternative"
          }
      },        
      "gateway": {
          "iframe": false
      },
      "form": {
          "action": "payment_url",
          "method": "GET",
          "fields": []
      }
  }
}