Paylane
ДокументацияСтатус
ВойтиСоздать аккаунт

Начало работы

  • Обзор
  • Адреса и окружения
  • Авторизация
  • Формат ответа
  • Ошибки
  • Идемпотентность
  • Лимиты

Методы API

  • Методы
  • GET/me
  • GET/currencies
  • POST/invoices
  • GET

Справочник

  • Инвойсы: статусы и жизненный цикл
  • Выводы: статусы
  • Вебхуки
  • Проверка подписи
  • Публичный API страницы оплаты
  • Testnet, mainnet и Simnet

Документы

  • Оферта для мерчантов
  • Политика конфиденциальности
  • AML/KYC-политика
Разделы: Идемпотентность

Начало работы

  • Обзор
  • Адреса и окружения
  • Авторизация
  • Формат ответа
  • Ошибки

Paylane

Paylane: приём платежей в стейблкоинах

Продукт

ДокументацияСтатусВойтиСоздать аккаунт

Документы

ОфертаКонфиденциальностьAML-политика
/invoices
  • GET/invoices/{id}
  • DELETE/invoices/{id}
  • GET/balance
  • POST/withdrawals
  • GET/withdrawals/{id}
  • GET/stats
  • POST/webhooks/test
  • POST/webhooks/{update_id}/resend
  • POST/sandbox/invoices/{id}/pay
  • POST/sandbox/events
  • Sandbox и тестовые сценарии
    Идемпотентность
  • Лимиты
  • Методы API

    • Методы
    • GET/me
    • GET/currencies
    • POST/invoices
    • GET/invoices
    • GET/invoices/{id}
    • DELETE/invoices/{id}
    • GET/balance
    • POST/withdrawals
    • GET/withdrawals/{id}
    • GET/stats
    • POST/webhooks/test
    • POST/webhooks/{update_id}/resend
    • POST/sandbox/invoices/{id}/pay
    • POST/sandbox/events

    Справочник

    • Инвойсы: статусы и жизненный цикл
    • Выводы: статусы
    • Вебхуки
    • Проверка подписи
    • Публичный API страницы оплаты
    • Testnet, mainnet и Simnet
    • Sandbox и тестовые сценарии

    Документы

    • Оферта для мерчантов
    • Политика конфиденциальности
    • AML/KYC-политика

    Идемпотентность

    POST /invoices и POST /withdrawals принимают заголовок Idempotency-Key (любая строка, например id заказа или UUID).

    Запрос
    curl -s "$API/invoices" -H "API-Token: $TOKEN" \
      -H "Idempotency-Key: order-5512" -H "Content-Type: application/json" \
      -d '{"amount": "100.00", "network": "tron", "payload": "order-5512"}'
    • Повтор с тем же ключом и тем же телом возвращает сохранённый первый ответ и заголовок Idempotent-Replay: true. Новый инвойс или вывод не создаётся.
    • Тот же ключ с другим телом вернёт 422 IDEMPOTENCY_KEY_REUSED. Тела сравниваются после подстановки значений по умолчанию: {"amount": "10"} и {"amount": "10", "currency": "USDT"} считаются одинаковыми.
    • Ключи действуют в пределах приложения 30 дней. Повтор с тем же ключом позже считается новым запросом.
    • Сохраняется только успешный ответ. Если запрос завершился ошибкой (INSUFFICIENT_FUNDS, DAILY_LIMIT и т. п.), повтор с тем же ключом выполнится заново.
    • Параллельные запросы с одним ключом безопасны: второй ждёт, пока первый завершится, и получает его ответ (блокировка pg_advisory_xact_lock по ключу). Если первый завершился ошибкой, второй выполнится сам.
    • DELETE /invoices/{id} и POST /webhooks/test ключ не используют. Повторная отмена вернёт INVOICE_NOT_CANCELABLE.
    НазадОшибкиДальше Лимиты