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

PaysafeCard

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

Оплата

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

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

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

Запрос

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

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

Оплата

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

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

Info

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

Запрос

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

object
return_url
обязательный
string
URL, на который будет возвращен покупатель после завершения транзакции в платёжной системе.
ip
string
IP-адрес покупателя.
object
Секция параметров способа оплаты.
type
обязательный
string
pay_safe_card
object
Секция информации о покупателе.
first_name
обязательный
string (60)
Имя покупателя.
last_name
обязательный
string (60)
Фамилия покупателя.
email
обязательный
string
Адрес электронной почты покупателя.
external_id
обязательный
string (128)
Уникальный идентификатор покупателя в системе торговца.
birth_date
string
Дата рождения покупателя в формате ISO-8601 (YYYY-MM-DD).
phone
string
Номер телефона покупателя.
country
обязательный
string
Страна покупателя в формате ISO 3166-1 alpha-2. Возможные значения: AU (Австралия), AT (Австрия), BE (Бельгия), BG (Болгария), CA (Канада), HR (Хорватия), CY (Кипр), CZ (Чехия), DK (Дания), EE (Эстония), FI (Финляндия), FR (Франция), GE (Грузия), DE (Германия), GI (Гибралтар), HU (Венгрия), IS (Исландия), IE (Ирландия), KW (Кувейт), LV (Латвия), LI (Лихтенштейн), LT (Литва), LU (Люксембург), MT (Мальта), MX (Мексика), MD (Молдова), ME (Черногория), NL (Нидерланды), NZ (Новая Зеландия), NO (Норвегия), PE (Перу), PL (Польша), RO (Румыния), SA (Саудовская Аравия), SK (Словакия), SI (Словения), ES (Испания), SZ (Эсватини), SE (Швеция), GB (Великобритания), UY (Уругвай).
city
обязательный
string (50)
Город покупателя.
address
обязательный
string (300)
Адрес покупателя.
state
string (40)
Штат/регион покупателя.
zip
обязательный
string (12)
Почтовый индекс покупателя.
Пример запроса
{
    "request": {
        "amount": 100,
        "currency": "EUR",
        "description": "description",
        "tracking_id": "123abc",
        "notification_url": "https://your-notification.url",
        "return_url": "https://test.com",
        "ip": "127.0.0.1",
        "language": "en",
        "customer": {
            "first_name": "John",
            "last_name": "Doe",
            "country": "BE",
            "email": "test@test.com",
            "external_id": "123abc",
            "address": "1st Street",
            "city": "Antwerp",
            "zip": "2018"
        },
        "method": {
            "type": "pay_safe_card"
        }
    }
}
Ответ

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

Пример ответа
{
    "transaction": {
        "uid": "0d75243e-a1b5-4bf6-812f-f9f10e09ad1e",
        "type": "payment",
        "status": "pending",
        "amount": 100,
        "currency": "EUR",
        "description": "description",
        "created_at": "2026-07-16T06:36:32Z",
        "updated_at": "2026-07-16T06:36:32Z",
        "method_type": "pay_safe_card",
        "receipt_url": "https://backoffice.paysage.io/customer/transactions/0d75243e-a1b5-4bf6-812f-f9f10e09ad1e/fd24e44537bebac636c2cf212b1c9dfcdd8d4644a9913126e4f425ba993a2bb4?language=en",
        "payment": {
            "status": "pending",
            "gateway_id": 6874,
            "ref_id": "36749994",
            "message": "Transaction was initialized."
        },
        "pay_safe_card": {
            "type": "pay_safe_card"
        },
        "customer": {
            "email": "test@test.com",
            "country": "BE",
            "last_name": "Doe",
            "first_name": "John",
            "ip": "127.0.0.1",
            "external_id": "123abc",
            "address": "1st Street",
            "city": "Antwerp",
            "zip": "2018"
        },
        "manually_corrected_at": null,
        "version": 1,
        "message": "Transaction was initialized.",
        "tracking_id": "123abc",
        "test": false,
        "language": "en",
        "billing_address": {
            "email": "test@test.com",
            "country": "BE",
            "last_name": "Doe",
            "first_name": "John",                
            "address": "1st Street",
            "city": "Antwerp",
            "zip": "2018"
        },
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },
        "smart_routing_verification": {
            "status": "skipped"
        },
        "gateway": {
            "iframe": false
        },
        "form": {
            "action": "link-to-payment-page",
            "fields": [],
            "method": "GET"
        }
    }
}