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/Google Pay, USDC, SEPA, ACH. Задайте валюту призначення, і ми спрямуємо виплату на ваш банківський рахунок чи гаманець під час зарахування.

  • 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"
}

Встановлення

# JavaScript / TypeScript
npm i @baynoy/sdk

# Python
pip install baynoy

# PHP
composer require baynoy/baynoy

# Ruby
gem install baynoy

# Go
go get github.com/baynoy/baynoy-go

# C# / .NET
dotnet add package Baynoy

Шість SDK

Типізовані, з повторами, готові до роботи

Офіційні типізовані SDK для JavaScript / TypeScript, Python, PHP, Ruby, Go і C# / .NET. Кожен постачається з тонким клієнтом, автоматичним повтором ідемпотентних операцій, структурованими верифікаторами вебхуків і помічниками для найпопулярніших ендпоінтів.

  • Повні визначення типів, включно з розрізнюваними об'єднаннями для подій
  • Автоматичний повтор з експоненційною затримкою при 5xx
  • Верифікатор підпису вебхука в 4 рядки
  • Ітератори пагінації для кожного ендпоінта списку
Читати документацію

Вебхуки

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

Кожен вебхук підписаний 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 Читати документацію