baynoy

API та SDK

API, створений для розробників

REST API з OpenAPI 3.1, ключами ідемпотентності, курсорною пагінацією та SDK для JavaScript, Python, PHP, Ruby, Go і C#.

Отримати ключі API Читати документацію
Розробник працює з API Baynoy

<150ms

Затримка API P50

99.95%

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

6

Офіційні SDK

  • Специфікація OpenAPI 3.1
  • Ключі ідемпотентності
  • Курсорна пагінація
  • Аутентифікація Bearer
  • Вебхуки HMAC
  • Пісочниця + тестові картки
  • 6 офіційних SDK
  • Ліміт швидкості 1 000 запитів/сек
  • SLA доступності 99,95%

Створити платіж

Один ендпоінт, тридцять способів

Надішліть POST одного ресурсу, а Baynoy подбає про решту — картка, Apple Pay, Google Pay. Вкажіть валюту призначення, і ми спрямуємо виплату на ваш банк або гаманець під час розрахунку.

  • Idempotency-Key запобігає подвійному списанню при повторі
  • Курсорна пагінація для звітів з великими обсягами
  • Вбудований виклик 3DS з checkout_url
  • Ключі пісочниці ніколи не зачіпають реальні гроші

Запит

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-ендпоінті
Читати документацію

Вебхуки

Події, яким можна довіряти

Кожен вебхук підписаний HMAC SHA-256, повторюється з експоненційною затримкою протягом до 7 днів і доступний для перегляду у вашій панелі керування з повною історією запитів / відповідей. Відтворіть будь-яку минулу подію одним кліком.

  • Корисні навантаження, підписані HMAC SHA-256
  • 8 типів подій, що охоплюють весь життєвий цикл платежу
  • Експоненційна затримка до 7 днів
  • Відтворення одним кліком з панелі керування
Керувати ендпоінтами

Підписана подія

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

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

Отримайте ключ, надішліть платіж

Ключі пісочниці видаються миттєво. Продакшн відкривається після верифікації Tier 1.

Отримати ключі API Читати документацію