Быстрый старт с 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"}'
Ответ — 201
{
  "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.

Teleport

Run your financial operations from one place.

Tell us how your business works. We'll show you the platform, map your current financial flow and discuss the right setup.