PaysafeCard

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

Оплата

Описание процесса оплаты

Покупатель инициирует оплату на странице торговца.
Торговец отправляет запрос оплаты в PaySage.io.
PaySage.io присылает в ответе торговцу ссылку на страницу оплаты.
Торговец перенаправляет покупателя на страницу оплаты.
Покупатель завершает оплату.
PaySage.io высылает торговцу автоматическое уведомление со статусом оплаты.

Info

Этот вариант интеграции поддерживает валюты AUD, CAD, CHF, EUR, GBP, NOK, PLN, RON, SEK и USD.

Запрос

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

object

return_url

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

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

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

type

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

string
pay_safe_card

ip

string
IP-адрес покупателя.

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

first_name обязательный	string Имя покупателя.
last_name обязательный	string Фамилия покупателя.
country обязательный	string Страна покупателя в формате ISO 3166-1 alpha-2. Возможные значения: `AT` (Австрия), `AU` (Австралия), `BE` (Бельгия), `BG` (Болгария), `CA` (Канада), `CH` (Швейцария), `CY` (Кипр), `CZ` (Чехия), `DE` (Германия), `DK` (Дания), `ES` (Испания), `FI` (Финляндия), `FR` (Франция), `GB` (Великобритания), `GE` (Грузия), `GI` (Гибралтар), `GR` (Греция), `HR` (Хорватия), `HU` (Венгрия), `IE` (Ирландия), `IT` (Италия), `LI` (Лихтенштейн), `LT` (Литва), `LU`(Люксембург), `MT` (Мальта), `MX` (Мексика), `NL` (Нидерланды), `NZ` (Новая Зеландия), `NO` (Норвегия), `PE` (Перу), `PL` (Польша), `PT`(Португалия), `RO` (Румыния), `SE` (Швеция), `SI` (Словения), `SK` (Словакия), `UY` (Уругвай).
phone	string Номер телефона покупателя.
email	string Адрес электронной почты покупателя.
city	string (120) Город покупателя.
zip	string (40) Почтовый индекс покупателя.
birth_date	string Дата рождения покупателя в формате ISO-8601 (YYYY-MM-DD).
address	string (510) Адрес покупателя.

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

{
    "request": {
        "amount": 500,
        "currency": "EUR",
        "description": "description",
        "test": true,
        "return_url": "https://return.com",
        "language": "en",
        "customer": {
            "first_name": "John",
            "last_name": "Doe",
            "country": "AT" 
        },
        "method": {
            "type": "pay_safe_card"
        }
    }
}

Ответ

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

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

{
    "transaction": {
        "uid": "e6894788-e26b-43e6-8ad1-19f4c61e9805",
        "type": "payment",
        "status": "pending",
        "amount": 500,
        "currency": "EUR",
        "description": "description",
        "created_at": "2025-09-17T13:57:34Z",
        "updated_at": "2025-09-17T13:57:35Z",
        "method_type": "pay_safe_card",
        "receipt_url": "https://backoffice.paysage.io/customer/transactions/e6894788-e26b-43e6-8ad1-19f4c61e9805/08a86c85fafc9e946abdbbf2f8cbdf9fc7d34c6d14d3939a2b344ebf621e4280?language=en",
        "payment": {
            "status": "pending",
            "gateway_id": 5220,
            "ref_id": "affd698b62d69be9eaf0",
            "message": "Transaction was initialized."
        },
        "pay_safe_card": {
            "type": "pay_safe_card"
        },
        "customer": {
            "country": "AT",
            "last_name": "Doe",
            "first_name": "John",
            "email": null,
            "ip": null
        },
        "manually_corrected_at": null,
        "version": 1,
        "message": "Transaction was initialized.",
        "test": true,
        "language": "en",
        "billing_address": {
            "country": "AT",
            "last_name": "Doe",
            "first_name": "John"
        },
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },       
        "gateway": {
            "iframe": false
        },
        "form": {
            "action": "link_to_payment_page",
            "fields": [],
            "method": "GET"
        }
    }
}

Возврат средств

Запрос

Отправьте стандартный запрос возврата средств. Сумма возврата не должна превышать сумму родительской транзакции. Для одной транзакции оплаты можно совершить несколько транзакций возврата средств при условии, что сумма возвратов не превышает сумму соответствующей им родительской транзакции.