API
EnglishБыстрый старт с API
Один запрос создаёт платёж и возвращает страницу для клиента. Ключ передаётся в заголовке X-API-Key.
1. Создайте платёж
curl https://gate.teleport.ltd/api/crypto-acquiring/v1/invoice/create/ \
-H "X-API-Key: <YOUR_API_KEY>" \
-H "Content-Type: application/json" \
-d '{"amount": "100.00", "currency": "USDT", "order_id": "order_123", "description": "Order #123"}'{
"success": true,
"payment_id": "pay_3f9a1c2b7d4e5f60",
"bill_uid": "3f9a1c2b-7d4e-5f60-…",
"payment_url": "https://…",
"expires_at": "2026-11-18T10:00:00+00:00",
"payment_methods": ["crypto"]
}Отправьте клиента на payment_url. Сохраните bill_uid: по нему платёж находится в проверке статуса и в уведомлениях. Платёж, созданный через API, истекает через 24 часа после создания.
Поля
| Поле | Обязательно | Что значит |
|---|---|---|
| amount | да | Сумма строкой или числом. Крипто-платежи в USDT или USD — от 1. |
| currency | да | Валюта платежа, например USDT. |
| order_id | нет | Номер вашего заказа; возвращается в уведомлениях. |
| description | нет | За что платит клиент. |
| customer_email, customer_name | нет | Данные клиента для страницы оплаты. |
| return_url, cancel_url | нет | Куда вернуть клиента после оплаты или отмены. |
| payment_methods | нет | Какие способы предложить, например ["crypto", "card"]. По умолчанию — все, что разрешает счёт. |
| webhook_url | нет | Адрес уведомлений для этого платежа; иначе — адрес по умолчанию из настроек ключа. |
2. Проверьте статус
curl https://gate.teleport.ltd/api/crypto-acquiring/v1/invoice/<bill_uid>/ \
-H "X-API-Key: <YOUR_API_KEY>"В ответе — платёж с текущим статусом: draft, pending, verification, paid, expired и остальные, описанные на странице «Статусы ссылки и оплаты».
Отмечайте заказ оплаченным только по проверенному сигналу: вебхуку с проверенной подписью или этому запросу, вернувшему статус paid. Как проверять подпись — на странице «Вебхуки».
Ограничения
- Один новый платёж раз в 5 секунд на пользователя; на более частые запросы — 429 со временем ожидания.
- Ошибки приходят в JSON с success: false и текстом в поле error.