baynoy

API & SDK

Geliştiriciler için kurulmuş bir API

OpenAPI 3.1, idempotency anahtarları, cursor pagination ve JavaScript, Python, PHP, Ruby, Go ve C# SDK'ları ile REST API.

API anahtarı al Dokümanları oku
Baynoy API ile çalışan geliştirici

<150ms

P50 API gecikme

99.95%

Çalışma süresi SLA

6

Resmi SDK

  • OpenAPI 3.1 spec
  • Idempotency anahtarları
  • Cursor pagination
  • Bearer auth
  • HMAC webhook'lar
  • Sandbox + test kartları
  • 6 resmi SDK
  • 1.000 req/sn rate limit
  • %99,95 uptime SLA

Bir tahsilat oluştur

Tek endpoint, otuz yöntem

Tek bir kaynağı POST edin, gerisini Baynoy halletsin — kart, Apple Pay, Google Pay. Hedef para birimini belirleyin, ödemeyi mutabakatta bankanıza veya cüzdanınıza yönlendirelim.

  • Idempotency-Key retry'da çift tahsilatı önler
  • Yüksek hacimli raporlar için cursor pagination
  • checkout_url ile satır içi 3DS challenge
  • Sandbox anahtarları asla gerçek paraya dokunmaz

İstek

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

Yanıt

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

Hızlı başlangıç

# 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

Her dilden çağır

Bearer kimlik doğrulamalı düz bir REST API — kurulacak SDK yok. curl, fetch, requests ya da herhangi bir HTTP istemcisinden çağır. Üretim için tasarlandı: sürümlü yanıtlar, idempotent yeniden denemeler, imzalı webhook'lar ve cursor sayfalama.

  • Baynoy-Version header'ı ile kararlı, sürümlü yanıtlar
  • Her POST'ta Idempotency-Key — yeniden deneme asla çift ücretlendirmez
  • HMAC-SHA256 imzalı webhook'lar (t=…,v1=…)
  • Her liste endpoint'inde cursor sayfalama
Dokümanları oku

Webhook'lar

Güvenebileceğin event'ler

Her webhook HMAC SHA-256 ile imzalanır, 7 güne kadar exponential backoff ile yeniden denenir ve dashboard'ınızda tam request / response geçmişiyle gezilebilir. Geçmiş bir event'i tek tıkla replay edin.

  • HMAC SHA-256 imzalı payload'lar
  • Tüm ödeme yaşam döngüsünü kapsayan 8 event türü
  • 7 güne kadar exponential backoff
  • Dashboard'dan tek tık replay
Endpoint'leri yönet

İmzalı event

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

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

Bir anahtar al, bir tahsilat gönder

Sandbox anahtarları hemen verilir. Üretim Tier 1 doğrulama sonrasında açılır.

API anahtarı al Dokümanları oku