baynoy

API & SDK

Eine API für Entwickler

Eine REST-API mit OpenAPI 3.1, Idempotency-Keys, Cursor-Pagination und SDKs in JavaScript, Python, PHP, Ruby, Go und C#.

API-Keys holen Doku lesen
Entwickler, der mit der Baynoy-API arbeitet

<150ms

P50 API-Latenz

99.95%

Uptime-SLA

6

Offizielle SDKs

  • OpenAPI-3.1-Spec
  • Idempotency-Keys
  • Cursor-Pagination
  • Bearer-Auth
  • HMAC-Webhooks
  • Sandbox + Testkarten
  • 6 offizielle SDKs
  • 1.000 req/sec Rate-Limit
  • 99,95% Uptime-SLA

Eine Zahlung erstellen

Ein Endpoint, dreißig Methoden

Senden Sie eine einzelne Ressource per POST, und Baynoy erledigt den Rest — Karte, Apple Pay, Google Pay. Legen Sie die Zielwährung fest, und wir leiten die Auszahlung bei der Abwicklung an Ihr Bankkonto oder Ihre Wallet weiter.

  • Idempotency-Key verhindert Doppelabbuchungen beim Retry
  • Cursor-Pagination für volumenstarke Reports
  • Inline 3DS-Challenge per checkout_url
  • Sandbox-Keys berühren niemals echtes Geld

Request

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

Response

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

Schnellstart

# 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

Aus jeder Sprache aufrufbar

Eine schlichte REST-API mit Bearer-Auth — kein SDK zu installieren. Rufen Sie sie per curl, fetch, requests oder jedem HTTP-Client auf. Produktionsreif: versionierte Antworten, idempotente Retries, signierte Webhooks und Cursor-Pagination.

  • Stabile, versionierte Antworten über den Baynoy-Version-Header
  • Idempotency-Key bei jedem POST — Retries belasten nie doppelt
  • HMAC-SHA256-signierte Webhooks (t=…,v1=…)
  • Cursor-Pagination an jedem List-Endpoint
Doku lesen

Webhooks

Events, denen Sie trauen können

Jeder Webhook ist mit HMAC SHA-256 signiert, wird mit Exponential-Backoff bis zu 7 Tage lang wiederholt und ist im Dashboard mit voller Request/Response-Historie durchsuchbar. Jedes vergangene Event mit einem Klick replayen.

  • HMAC-SHA-256-signierte Payloads
  • 8 Event-Typen, die den gesamten Zahlungs-Lifecycle abdecken
  • Exponential-Backoff bis zu 7 Tage
  • Ein-Klick-Replay aus dem Dashboard
Endpoints verwalten

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

Key holen, Zahlung senden

Sandbox-Keys sind sofort verfügbar. Produktion schaltet nach Tier-1-Verifizierung frei.

API-Keys holen Doku lesen