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

Этот endpoint позволяет создать новый платёжный ордер в системе.

Основная информация

URL: https://api.donuts.tg/v1/merchants/orders

Метод: POST

Аутентификация: Требуется API токен в заголовке

Заголовки запроса

Заголовок Обязательный Описание
Authorization Да API токен мерчанта в формате Bearer <token>

Параметры запроса

Параметр Тип Обязательный Описание
amount number Да Сумма платежа
currency_id number Да ID валюты платежа

1 - TON 2 - USDT | | comment | string | Да | Комментарий к платежу | | expires_at | number | Да | Timestamp истечения срока действия ордера в формате Unix | | payload | string | Нет | Дополнительные данные для платежа, можно добавлять произвольно. | | return_url | string | Нет | URL для перенаправления после совершения платежа |

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

{
  "amount": 1,
  "comment": "Услуга обработки данных на 1 день",
  "currency_id": 2,
  "expires_at": 1731766973,
  "payload": "дополнительные данные",
  "return_url": "<https://durevpn.com/ru>"
}

Ответ

Успешный ответ

Код: 201 Created

Поле Тип Описание
order.uuid string Уникальный идентификатор ордера, uuid.
order.created_at string Дата и время создания ордера в формате ISO 8601
order.expires_at string Дата и время истечения срока действия ордера в формате ISO 8601
order.amount string Сумма платежа, в нанозначениях
Возвращается в decimals

Для USDT 1 USDT = 10^6 = 1000000 Для TON 1 TON = 10^9 = 1000000000 | | order.merchant_uuid | string | Уникальный идентификатор мерчанта, формат uuid | | order.comment | string | Комментарий к платежу | | order.status | number | Статус ордера | | order.currency | object | Информация о валюте (может быть null) | | payment_url | string | URL для оплаты ордера |

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

{
  "order": {
    "uuid": "e9e7467e-8682-407a-8bfc-344fb69f0afc",
    "created_at": "2024-11-16T14:24:02.617582585Z",
    "expires_at": "2024-11-16T14:22:53Z",
    "amount": "1000000",
    "merchant_uuid": "ebcb6398-aac2-4a1a-a519-6abd4c008e07",
    "comment": "string",
    "status": 2,
    "currency": null
  },
  "payment_url": "<https://donuts.tg/order/e9e7467e-8682-407a-8bfc-344fb69f0afc?return_url=string>"
}

Статусы ордера