PayU

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

Оплата

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

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

Info

Этот вариант интеграции поддерживает валюты PLN и CZK.

Запрос

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

object

return_url

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

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

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

type

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

string
pay_u

ip

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

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

first_name обязательный	string Имя покупателя.
last_name обязательный	string Фамилия покупателя.
country обязательный	string Страна покупателя в формате ISO 3166-1 alpha-2. Возможные значения: `CZ` (Чехия), `PL` (Польша).
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": "CZK",
        "description": "description",
        "test": true,
        "return_url": "https://return.com",
        "language": "en",
        "customer": {
            "first_name": "John",
            "last_name": "Doe",
            "country": "CZ"
        },
        "method": {
            "type": "pay_u"
        }
    }
}

Ответ

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

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

{
    "transaction": {
        "uid": "90d6ab04-dc9c-4812-973e-1ae7534d59c5",
        "type": "payment",
        "status": "pending",
        "amount": 500,
        "currency": "CZK",
        "description": "description",
        "created_at": "2025-09-17T20:23:31Z",
        "updated_at": "2025-09-17T20:23:32Z",
        "method_type": "pay_u",
        "receipt_url": "https://backoffice.paysage.io/customer/transactions/90d6ab04-dc9c-4812-973e-1ae7534d59c5/5d8fec864352e534bc09d9bd013d492f1695016a483143fabd0837dfba94ad2b?language=en",
        "payment": {
            "status": "pending",
            "gateway_id": 5220,
            "ref_id": "f823e8d9c1ecf65a6d11",
            "message": "Transaction was initialized."
        },
        "pay_u": {
            "type": "pay_u"
        },
        "customer": {
            "country": "CZ",
            "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": "CZ",
            "last_name": "Doe",
            "first_name": "John"
        },
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },
        "gateway": {
            "iframe": false
        },
        "form": {
            "action": "link_to_payment_page",
            "fields": [],
            "method": "GET"
        }
    }
}

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

Запрос

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