Trustly

Банковские переводы из европейских банков через Trustly

Перед тем как начать

Авторизация

Как подписывать запросы API-токеном.

Создание платежа

Базовый запрос на создание заказа, который расширяет эта страница.

Этот способ оплаты доступен не всем мерчантам. Уточните доступность у вашего менеджера.

Обзор

Trustly — это обычный заказ с двумя дополнительными полями:

Поле	Тип	Описание
`extraParams`	string	Всегда `trustly`
`customer`	object	Данные плательщика, см. ниже

Плательщик перенаправляется на paymentLink, выбирает свой банк и подтверждает перевод в онлайн-банке. Trustly поддерживает банки по всей Европе.

Поля customer

Поле	Тип	Обязательное	Описание
`firstName`	string	✅ Да	Имя
`lastName`	string	✅ Да	Фамилия
`email`	string	✅ Да	Email плательщика

Набор обязательных полей может отличаться в зависимости от настроек вашего мерчанта. Уточните точные требования у вашего менеджера.

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

curl -X POST "https://api.riopay.online/v1/orders" \
  -H "Content-Type: application/json" \
  -H "X-Api-Token: YOUR_API_TOKEN" \
  -d '{
    "amount": "1500.00",
    "externalId": "order_12345",
    "purpose": "Payment for order #12345",
    "extraParams": "trustly",
    "customer": {
      "firstName": "John",
      "lastName": "Doe",
      "email": "customer@example.com"
    }
  }'

Ответ

В ответе возвращается стандартный объект заказа. Заказ создаётся со статусом CREATED; перенаправьте плательщика на paymentLink, чтобы он завершил оплату.