Trustly

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

Оплата

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

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

Info

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

Запрос

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

Параметр	Тип данных	Описание
request	object
return_url * обязательный	string	URL, на который будет возвращен покупатель после завершения операции в платёжной системе.
ip	string	IP-адрес покупателя.
method	object	Секция параметров способа оплаты.
type * обязательный	string	`blik`
customer	object	Секция информации о покупателе.
first_name * обязательный	string	Имя покупателя.
last_name * обязательный	string	Фамилия покупателя.
country * обязательный	string	Страна покупателя в формате ISO 3166-1 alpha-2. Например, `ES`.
external_id * обязательный	string	Идентификатор покупателя в системе торговца.
email	string	Адрес электронной почты покупателя.
phone	string	Номер телефона покупателя.
city	string	Город покупателя.
address	string	Адрес покупателя.
zip	string	Почтовый индекс покупателя.
birth_date	string	Дата рождения покупателя в формате ISO-8601 (YYYY-MM-DD).

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

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

Ответ

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

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

{
    "transaction": {
        "uid": "d210921d-092e-4a04-b8b7-add19669e234",
        "type": "payment",
        "status": "pending",
        "amount": 500,
        "currency": "EUR",
        "description": "description",
        "created_at": "2025-04-07T09:49:22Z",
        "updated_at": "2025-04-07T09:49:23Z",
        "method_type": "trustly",
        "receipt_url": "https://backoffice.paysage.io/customer/transactions/d210921d-092e-4a04-b8b7-add19669e234/987099812e37868ad17a102557b98c9103b62401b2b2e8e8cdb4d7c8d73f7cdf?language=en",
        "payment": {
            "status": "pending",
            "gateway_id": 5220,
            "ref_id": "5b5d36630263200a4982",
            "message": "Transaction was initialized."
        },
        "trustly": {
            "type": "trustly"
        },
        "customer": {
            "first_name": "John",
            "last_name": "Doe",
            "country": "ES",
            "external_id": "1306999j",
            "email": null,
            "ip": null
        },
        "manually_corrected_at": null,
        "version": 0,
        "message": "Transaction was initialized.",
        "test": true,
        "language": "en",
        "billing_address": {
            "first_name": "John",
            "last_name": "Doe",
            "country": "ES"
        },
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },

        "gateway": {
            "iframe": false
        },
        "form": {
            "action": "link-to-payment-page",
            "method": "GET",
            "fields": []
        }
    }
}

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

Запрос

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