iDeal

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

Оплата

Процесс оплаты

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

Info

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

Запрос

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

object

return_url

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

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

ip

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

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

type

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

string
ideal

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

first_name	string Имя покупателя.
last_name	string Фамилия покупателя.
address	string Адрес покупателя.
birth_date	string Дата рождения покупателя в формате ISO-8601 (`YYYY-MM-DD`).
city	string Город покупателя.
state	string Двухбуквенная аббревиатура штата, только если указанная страна покупателя `US`, `CA` или `AU`.
country	string Страна покупателя в формате ISO 3166-1 alpha-2. Например, `DE`.
phone	string Номер телефона покупателя, включая код страны.
email	string Адрес электронной почты покупателя.
zip	string Почтовый индекс покупателя.

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

{
    "request": {
        "amount": 20,
        "currency": "EUR",
        "description": "description",
        "return_url": "https://your_return_url.com",
        "ip": "127.0.0.1",
        "method": {
            "type": "ideal"
        },
        "customer": {
            "first_name": "John",
            "last_name": "Doe",
            "address": "First Str. 2",
            "country": "GB",
            "city": "London",
            "phone": "0123456789",
            "zip": "SE22 8FA",
            "email": "email@example.com"
        }
    }
}

Ответ

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

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

{
    "transaction": {
        "uid": "ab1c05ac-334b-4430-913c-ba2eb3f9ee97",
        "type": "payment",
        "status": "pending",
        "amount": 20,
        "currency": "EUR",
        "description": "description",
        "created_at": "2025-11-11T13:42:59Z",
        "updated_at": "2025-11-11T13:43:00Z",
        "method_type": "ideal",
        "receipt_url": "https://backoffice.paysage.io/customer/transactions/ab1c05ac-334b-4430-913c-ba2eb3f9ee97/666769f41a97c80a8b0086f6b0a9edbb7bfbee4a7825a0ac4f43c268d0796e25",
        "payment": {
            "status": "pending",
            "gateway_id": 5902,
            "ref_id": "3475097\n",
            "message": "Transaction was initialized."
        },
        "ideal": {
            "type": "ideal"
        },
        "customer": {
            "zip": "SE22 8FA",
            "city": "London",
            "email": "email@example.com",
            "phone": "0123456789",
            "address": "First Str. 2",
            "country": "GB",
            "last_name": "Doe",
            "first_name": "John",
            "ip": "127.0.0.1"
        },
        "manually_corrected_at": null,
        "version": 1,
        "message": "Transaction was initialized.",
        "test": false,
        "billing_address": {
            "zip": "SE22 8FA",
            "city": "London",
            "email": "email@example.com",
            "phone": "0123456789",
            "address": "First Str. 2",
            "country": "GB",
            "last_name": "Doe",
            "first_name": "John"
        },
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },       
        "gateway": {
            "iframe": true
        },
        "form": {
            "action": "link-to-payment-page",
            "fields": [],
            "method": "GET"
        }
    }
}

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

Запрос

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