API & SDK

API, созданный для разработчиков

REST API с OpenAPI 3.1, ключами идемпотентности, cursor-пагинацией и SDK на JavaScript, Python, PHP, Ruby, Go и C#.

Разработчик, работающий с Baynoy API

<150ms

P50 латентность API

99.95%

SLA доступности

6

Официальные SDK

  • OpenAPI 3.1 spec
  • Ключи идемпотентности
  • Cursor-пагинация
  • Bearer-аутентификация
  • HMAC webhooks
  • Sandbox + тестовые карты
  • 6 официальных SDK
  • Лимит 1000 req/sec
  • 99,95% SLA доступности

Создать платёж

Один эндпоинт, тридцать методов

Отправьте POST одного ресурса, а Baynoy разберётся с остальным — карта, Apple Pay, Google Pay. Укажите валюту назначения, и мы направим выплату на ваш банк или кошелёк при расчёте.

  • Idempotency-Key предотвращает двойные списания при retry
  • Cursor-пагинация для отчётов больших объёмов
  • Встроенный 3DS-челлендж через checkout_url
  • Sandbox-ключи никогда не касаются реальных денег

Запрос

POST /v1/payments
Authorization: Bearer sk_live_••••
Idempotency-Key: 7a1f2e

{
  "amount": 125000,
  "currency": "EUR",
  "payout":  { "type": "bank", "currency": "TRY" },
  "methods": ["card","usdc","sepa"],
  "metadata": { "patient_id": "p_8821" }
}

Ответ

{
  "id": "pmt_a7c91...",
  "status": "requires_action",
  "checkout_url": "https://pay.baynoy.com/c/a7c91"
}

Быстрый старт

# No SDK to install — it's a plain REST API.
# Create a payment link from any HTTP client:
curl https://baynoy.com/api/v1/payment-links \
  -H "Authorization: Bearer sk_live_..." \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"title":"Invoice 0042","amount":2000,"currency":"USD"}'

REST API

Вызывайте на любом языке

Обычный REST API с Bearer-аутентификацией — без SDK для установки. Вызывайте через curl, fetch, requests или любой HTTP-клиент. Готов к продакшену: версионированные ответы, идемпотентные повторы, подписанные вебхуки и курсорная пагинация.

  • Стабильные версионированные ответы через заголовок Baynoy-Version
  • Idempotency-Key на каждом POST — повтор не спишет дважды
  • Вебхуки с подписью HMAC-SHA256 (t=…,v1=…)
  • Курсорная пагинация на каждом list-эндпоинте
Читать документацию

Webhooks

Событиям можно доверять

Каждый webhook подписан HMAC SHA-256, ретраится с экспоненциальным backoff до 7 дней и просматриваем в дашборде с полной историей request / response. Реплейните любое прошлое событие в один клик.

  • Подписанные HMAC SHA-256 payload'ы
  • 8 типов событий, покрывающих весь жизненный цикл платежа
  • Экспоненциальный backoff до 7 дней
  • Replay из дашборда в один клик
Управлять эндпоинтами

Подписанное событие

POST /your-endpoint
Baynoy-Signature: t=1716210000,v1=8b3...
Content-Type: application/json

{
  "id": "evt_2zX...",
  "type": "payment.succeeded",
  "data": { "object": { "id": "pmt_a7c91..." } }
}

Получите ключ, отправьте платёж

Sandbox-ключи выдаются мгновенно. Прод открывается после верификации Tier 1.