Zum Hauptinhalt springen

SDKs & Libraries

Beschleunigen Sie Ihre Integration mithilfe offizieller SDKs für TypeScript, Python, Go, PHP, Java, Kotlin, C#, Ruby und React Native. Diese Bibliotheken vereinfachen API-Anfragen, Authentifizierung und Fehlerbehandlung, sodass Sie sich auf die Entwicklung großartiger Zahlungserlebnisse konzentrieren können.

​
Umgebungs-URLs

Erfahren Sie mehr über Testmodus vs Live-Modus.

​
API-Schlüsselverwaltung und Authentifizierung

1

Access API Keys

Navigieren Sie in Ihrem Dashboard zu Developer → API Keys, um Ihre Schlüssel zu verwalten.
2

Generate a New Key

Wählen Sie Add API Key, geben Sie einen beschreibenden Namen an und konfigurieren Sie die Schreibberechtigung:
  • Schreibzugriff aktivieren (aktiviert): Vollständige Lese- und Schreibberechtigungen für alle API-Operationen
  • Schreibzugriff aktivieren (deaktiviert): Nur Lesezugriff - kann nur Daten abrufen (Zahlungen, Abonnements, Kunden, Produkte). Kann keine Ressourcen erstellen oder ändern.
Deaktivieren Sie „Enable write access“ für Dashboard-Integrationen, Analysewerkzeuge und alle Systeme, die nur Daten anzeigen müssen, ohne Änderungen vorzunehmen.
3

Store Your Key Securely

Kopieren Sie den generierten Schlüssel sofort und stellen Sie sicher, dass er sicher gespeichert wird.
4

Authenticate Your API Requests

Verwenden Sie Ihre API-Schlüssel zur Authentifizierung aller Anfragen. Wenden Sie folgendes Autorisierungsformat an:
Authorization: Bearer YOUR_API_KEY
Geben Sie Ihre geheimen API-Schlüssel niemals in clientseitigem Code oder öffentlichen Repositories preis.

​
Antwortformat

{
  "id": "pay_1234567890",
  "status": "completed",
  "amount": 2999,
  "currency": "USD",
  "created_at": "2024-01-15T10:30:00Z"
}

​
Ratenlimits

Unsere API verwendet ein Dualfenster-Rate-Limit-System mit Schutz gegen Spitzenlast. Limits werden anhand Ihrer Authentifizierungsmethode und Ihres Geschäftstiers angewendet.

​
Standardlimits (Stufe 0)

FensterLimit
Pro Sekunde (Spitzenlast)40 Anfragen
Pro Minute (Nachhaltig)240 Anfragen

​
Geschäftsstufen

Höhere Rate Limits stehen Unternehmen mit erhöhtem API-Bedarf zur Verfügung:
StufeSpitzenlast (pro Sekunde)Nachhaltig (pro Minute)
Tier 0 (Standard)40240
Tier 11001.000
Tier 25005.000
Kontaktieren Sie den Support, um Ihr Unternehmen auf eine höhere Rate-Limit-Stufe anzuheben.

​
Nicht authentifizierte Anfragen

Anfragen ohne gültige Authentifizierungsheader werden nach IP-Adresse limitiert:
FensterLimit
Pro Sekunde (Spitzenlast)20 Anfragen
Pro Minute (Nachhaltig)100 Anfragen

​
Rate-Limit-Header

Überwachen Sie Ihre Nutzung mit diesen Antwort-Headern:
  • X-RateLimit-Limit - maximal erlaubte Anfragen
  • X-RateLimit-Remaining - verbleibende Anfragen im aktuellen Fenster
  • X-RateLimit-Reset - Zeitpunkt, an dem das Rate-Limit zurückgesetzt wird
Wenn Sie die Rate-Limits überschreiten, gibt die API eine 429 Too Many Requests-Antwort zurück. Implementieren Sie exponentielles Backoff in Ihrer Retry-Logik.

​
Fehlerbehandlung

Um Fehler effektiv zu verwalten, konsultieren Sie die Abschnitte Error Codes und Transaction Failures für detaillierte Hinweise.

Error Codes

Vertiefen Sie sich in umfassende Fehlerdetails und deren Lösungen.

Transaction Failures

Erhalten Sie Einblicke in häufige Transaktionsprobleme und deren Lösungen.

​
Webhooks

Erhalten Sie Echtzeitbenachrichtigungen zu Zahlungsvorgängen. Siehe unseren Webhook-Leitfaden für Anweisungen zur Einrichtung.

Webhook Guide

Richten Sie Webhooks für Echtzeitbenachrichtigungen und Ereignisverarbeitung ein.