Документація

Усе, що потрібно для інтеграції з Baynoy: приймайте платежі, керуйте рахунками й картками та переміщуйте крипто — через один API.

Ще не запущено — домен api.baynoy.com не резолвиться, тож приклади нижче сьогодні не виконаються. Вони описують контракт, до якого ми йдемо, і схеми на цій сторінці ще можуть змінитися.

One API for money in, money held, money out

Payments, accounts, payouts, cards and crypto share one REST API, one error envelope and one idempotency model. Amounts are always integers in the currency's smallest unit with an explicit currency code — floats are never accepted or returned.

Authentication

Keys can be created in the dashboard today, and they are real — but api.baynoy.com does not resolve yet, so there is nowhere to send them. When it does: server-to-server calls use secret keys (bk_test_/bk_live_) as a Bearer token, publishable keys only start checkout sessions, and payouts, refunds and card reveal require separately scoped keys.

cURL

curl https://api.baynoy.com/v1/payment_links \
  -H "Authorization: Bearer bk_test_..." \
  -H "Idempotency-Key: 4f7c9a2e-..." \
  -d amount=4900 -d currency=EUR -d title="Design retainer"

Versioning

The major version lives in the URL (/v1). Additive fields arrive without notice — tolerate unknown fields; breaking changes only ever ship as a new version with a dated migration guide.

← Документація