Перейти к содержанию

iDeal

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

Оплата

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

  1. Покупатель инициирует оплату на сайте торговца.
  2. Торговец отправляет PaySage.io запрос оплаты.
  3. PaySage.io присылает в ответе торговцу ссылку на страницу оплаты. Время жизни ссылки – 15 минут.
  4. Торговец перенаправляет покупателя на страницу оплаты.
  5. Покупатель завершает платёж.
  6. 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"
        }
    }
}

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

Запрос

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

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

Оплата

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

  1. Покупатель инициирует оплату на сайте торговца.
  2. Торговец отправляет PaySage.io запрос оплаты.
  3. PaySage.io присылает в ответе торговцу ссылку на страницу оплаты.
  4. Торговец перенаправляет покупателя на страницу оплаты.
  5. Покупатель завершает платёж, следуя инструкциям.
  6. PaySage.io высылает торговцу автоматическое уведомление.

Info

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

Запрос

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

object
return_url
обязательный
 string
URL, на который будет возвращен покупатель после завершения транзакции в платёжной системе.
object
Секция параметров способа оплаты.
type
обязательный
 string
ideal
object
Секция информации о покупателе.
external_id
 string
Уникальный идентификатор покупателя в системе торговца.
first_name
 string
Имя покупателя.
last_name
 string
Фамилия покупателя.
email
 string
Адрес электронной почты покупателя.
country
 string
Страна покупателя в формате ISO 3166-1 alpha-2. Например, NL.
Пример запроса 
{
    "request": {
        "amount": 500,
        "currency": "EUR",
        "description": "description",
        "test": true,
        "return_url": "https://return.com",
        "language": "en",
        "method": {
            "type": "ideal"
        },
        "customer": {
            "first_name": "John",
            "last_name": "Doe",
            "external_id": "123abc",
            "email": "email@example.com",
            "country": "NL"
        }
    }
}
Ответ

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

Пример ответа 
{
    "transaction": {
        "uid": "901710dd-8d02-4484-829b-51b7b9dba598",
        "type": "payment",
        "status": "pending",
        "amount": 500,
        "currency": "EUR",
        "description": "description",
        "created_at": "2026-04-05T17:12:52Z",
        "updated_at": "2026-04-05T17:12:53Z",
        "method_type": "ideal",
        "receipt_url": "https://backoffice.paysage.io/customer/transactions/901710dd-8d02-4484-829b-51b7b9dba598/a2ad0b74c363267ff8218cdd24e8594c2c2f70c557218acc3d7b59f5e162cced?language=en",
        "payment": {
            "status": "pending",
            "gateway_id": 6428,
            "ref_id": "22185cd2-1389-48bc-93a2-2730c0e16fc9",
            "message": "Transaction was initialized"
        },
        "ideal": {
            "type": "ideal"
        },
        "customer": {
            "email": "email@example.com",
            "country": "NL",
            "last_name": "Doe",
            "first_name": "John",
            "external_id": "123abc",
            "ip": null
        },
        "manually_corrected_at": null,
        "version": 1,
        "message": "Transaction was initialized",
        "test": true,
        "language": "en",
        "billing_address": {
            "email": "email@example.com",
            "country": "NL",
            "last_name": "Doe",
            "first_name": "John"
        },
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },
        "smart_routing_verification": {
            "status": "successful"
        },
        "gateway": {
            "iframe": false
        },
        "form": {
            "action": "link-to-payment-page",
            "method": "GET",
            "fields": []
        }
    }
}