Skip to main content

​
Предварительные требования

  • Аккаунт в Tranzor
  • API ключ (формат trz_...)

​
1. Получите API ключ

Перейдите в Личный кабинет → Настройки → API ключи и создайте новый ключ. Вы получите:
  • API Key — для аутентификации запросов
  • Secret Key — для HMAC-подписи (храните в безопасности!)

​
2. Создайте инвойс

curl -X POST https://sand.tranzor.io/api/v1/invoices \
  -H "Authorization: Bearer trz_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 10.50,
    "currency": "USD",
    "description": "Заказ #1234",
    "orderId": "order-1234"
  }'

​
3. Ответ API

{
  "success": true,
  "data": {
    "invoiceId": "inv_abc123",
    "payUrl": "https://pay.tranzor.io/inv_abc123",
    "status": "PENDING",
    "amount": 10.50,
    "currency": "USD",
    "orderId": "order-1234",
    "addresses": [
      {
        "chain": "tron",
        "address": "TXyz...",
        "expectedAmount": "10500000",
        "isToken": true,
        "tokenSymbol": "USDT"
      },
      {
        "chain": "ethereum",
        "address": "0xAbc...",
        "expectedAmount": "10500000",
        "isToken": true,
        "tokenSymbol": "USDT"
      }
    ],
    "expiresAt": "2025-01-01T01:00:00Z",
    "createdAt": "2025-01-01T00:00:00Z"
  }
}

​
4. Перенаправьте клиента

Отправьте клиента на payUrl — он увидит страницу оплаты с адресами и QR-кодом. Или отобразите адреса из addresses в своём интерфейсе.

​
5. Обработайте вебхук

После оплаты Tranzor отправит POST-запрос на ваш webhookUrl: 
{
  "event": "invoice.paid",
  "invoiceId": "inv_abc123",
  "orderId": "order-1234",
  "amountUsd": 1050,
  "status": "PAID",
  "paidChain": "tron:USDT",
  "paidAmount": "10500000",
  "timestamp": "2025-01-01T00:05:00Z"
}
Всегда проверяйте подпись вебхука через заголовок X-Tranzor-Signature перед обработкой. Подробнее в разделе Вебхуки.

​
Следующие шаги

Аутентификация

HMAC-подпись и Bearer-токен

Инвойсы

Жизненный цикл и статусы