Работа с платежами
Создание платежа
Как создать платёж
Перед тем как начать
Как авторизовывать запросы
Параметры запроса
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| amount | string (decimal) | ✅ Да | Сумма заказа |
| externalId | string / null | ❌ Нет | Внешний ID заказа от мерчанта (ваше значение) |
| externalUserId | string / null | ❌ Нет | Внешний ID пользователя от мерчанта (ваше значение) |
| isFeeOnUser | boolean | ❌ Нет | Перекладывать ли комиссию на пользователя |
| purpose | string / null | ❌ Нет | Назначение платежа |
| successUrl | string / null | ❌ Нет (если указан в настройках) | URL для редиректа после успешной оплаты |
| failUrl | string / null | ❌ Нет | URL для редиректа после неуспешной оплаты |
| callbackUrl | string / null | ❌ Нет | URL для webhook-уведомлений |
Пример запроса
curl -X POST "https://api.panel.valutix.kz/v1/orders" \
-H "Content-Type: application/json" \
-H "X-Api-Token: YOUR_API_TOKEN" \
-d '{
"amount": "1000.50",
"externalId": "order_1234",
"externalUserId": "user_987",
"isFeeOnUser": true,
"purpose": "Оплата заказа №1234",
"successUrl": "https://example.com/success"
}'Пример успешного ответа
{
"id": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
"status": "PENDING",
"purpose": "Оплата заказа №1234",
"amount": "1000.5",
"commission": "1.5",
"received": "999.0",
"currency": "RUB",
"paymentType": "SBP",
"shopId": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
"terminalId": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
"merchantId": "a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6",
"externalId": "sesemasese3252362632",
"externalUserId": "user15236236",
"paymentLink": "https://example.com/index.php?route=extension/trip/payments/create?id=a1b2c3d4-e5f6-7g8h-i9j0-k1l2m3n4o5p6&amount=1000&hash=2792ob1jhvyif81bhcvfy8iwbhck",
"successUrl": "https://example.com",
"payedAt": null,
"updatedAt": "2023-03-21T12:34:56Z",
"createdAt": "2023-03-21T12:34:56Z"
}Перенаправление пользователя
После успешного создания заказа вы получите поле:
"paymentLink": "https://example.com/..."Перенаправьте пользователя на эту ссылку, чтобы он завершил оплату.
Проверка статуса заказа
После оплаты вы можете проверить статус заказа в разделе:
Проверка статуса заказа
Подробные и актуальные схемы запросов и ответов доступны в Swagger-документации.