Сторонние интеграции
Trustly
Как интегрировать платежи Trustly
Приём платежей через Trustly работает по тому же принципу, что и обычная оплата через Web-форму, но с некоторыми важными отличиями.
Быстрый старт
Для Trustly при создании заказа нужно указать дополнительные параметры — способ оплаты и данные клиента.
Создание заказа
Заказ создаётся через стандартный endpoint, но с дополнительными параметрами:
| Параметр | Тип | Описание |
|---|---|---|
| extraParams | string | Способ оплаты: trustly |
| customer | object | Данные клиента (обязательны) |
Остальные поля запроса идентичны обычному созданию заказа.
Как создавать заказы
Параметр extraParams
Укажите способ оплаты:
| Значение | Описание |
|---|---|
| trustly | Оплата через Trustly |
Объект customer
Обязательные поля клиента:
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| firstName | string | ✅ Да | Имя клиента |
| lastName | string | ✅ Да | Фамилия клиента |
| string | ✅ Да | Email клиента |
Список обязательных полей может отличаться в зависимости от настроек вашего мерчанта. Уточняйте требования у вашего менеджера.
Пример запроса
curl -X POST "https://api.panel.valutix.kz/v1/orders" \
-H "Content-Type: application/json" \
-H "X-Api-Token: YOUR_API_TOKEN" \
-d '{
"amount": "1500.00",
"externalId": "order_12345",
"purpose": "Оплата заказа №12345",
"extraParams": "trustly",
"customer": {
"firstName": "Ivan",
"lastName": "Ivanov",
"email": "customer@example.com"
}
}'Пример успешного ответа
{
"id": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
"status": "PENDING",
"purpose": "Оплата заказа №12345",
"amount": "1500.0",
"commission": "1.5",
"received": "1498.5",
"currency": "RUB",
"shopId": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
"terminalId": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
"merchantId": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
"externalId": "order_12345",
"paymentLink": "https://example.com/payment?id=a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
"successUrl": null,
"payedAt": null,
"updatedAt": "2023-03-21T12:34:56Z",
"createdAt": "2023-03-21T12:34:56Z"
}Перенаправление пользователя
После создания заказа вы получите paymentLink — ссылку для оплаты.
Перенаправьте пользователя на эту ссылку, чтобы он завершил оплату через Trustly.
Рекомендации
- Убедитесь, что все обязательные поля
customerзаполнены корректно - Trustly поддерживает банковские переводы из европейских банков - Тестируйте интеграцию перед запуском