Einheitliche Zahlungs-API
Bestellungen erstellen, Status abfragen und Erstattungen per HTTP + JSON auslösen.
Zahlungsinfrastruktur für den globalen Handel
Grenzüberschreitende Zahlungen.Klar und zuverlässig.
Zahlungen, Erstattungen, Ereignisse und Auszahlungen über eine übersichtliche serverseitige API verwalten. So kann sich Ihr Team auf das Geschäft konzentrieren.
- Kostenlose Testumgebung
- Gehostete Bezahlseite
- Prüfbare Webhooks
Bestellbetrag
$29.90 USD
ORD_2026_001
TestumgebungBezahlt
Zahlungsablauf
- Bestellung erstellt
POST /v1/orders - Bezahlseite geöffnet
checkout_url - Zahlung erfolgreich
payment.succeeded - Webhook zugestellt
HTTP 200 - Im Kontobuch erfasst
+ $29.90
- Eine API
- HTTP + JSON
- Passt zu Ihrem Backend
- Test und Live getrennt
- Zwei Umgebungen
- Durch Schlüsselpräfixe unterschieden
- Signierte Webhooks
- HMAC-SHA256
- Verlässliche Ereignisse
- Offene Zahlungen
- Autom. Abgleich
- Endstatus erneut geprüft
Plattform
Der gesamte Zahlungsablauf
Die wichtigsten Funktionen in einer API. Status und Geldbewegungen bleiben nachvollziehbar.
Gehostete Bezahlseite
Kunden über einen signierten Link weiterleiten, ohne Zahlungsdaten selbst zu verarbeiten.
Getrennte Umgebungen
Unabhängige Test- und Live-Schlüssel senken das Risiko versehentlicher echter Zahlungen.
Zuverlässige Webhooks
Signaturen prüfen, fehlgeschlagene Zustellungen wiederholen und Ereignisse erneut senden.
Automatischer Abgleich
Offene Zahlungen und Erstattungen werden bei fehlenden Meldungen erneut geprüft.
Wallet und Kontobuch
Zahlungen, Erstattungen und Auszahlungen sind als Saldenänderungen nachvollziehbar.
Für Entwickler
Die erste Zahlung beginnt mit einer Anfrage
Erstellen Sie eine Bestellung auf Ihrem Server und leiten Sie Kunden zur Bezahl-URL weiter. Ihre Bestellreferenz dient zugleich als Idempotenzschlüssel.
Schnellstart ansehenAnfrage
curl -X POST https://api.kukopay.com/v1/orders \
-H "X-Api-Key: kuko_test_•••" \
-H "Content-Type: application/json" \
-d '{
"out_trade_no": "ORD_2026_001",
"amount": 2990,
"currency": "USD",
"subject": "Premium plan"
}'Antwort 201
{
"code": 201,
"data": {
"trade_no": "TRD_SB_9F3A2C7E…",
"status": "pending",
"checkout_url": "https://checkout.kukopay.com/…"
}
}Integrationsablauf
In vier Schritten zur Zahlung
Die Browser-Rückkehr dient der Nutzerführung. Grundlage für die Leistung ist ein verifiziertes Server-Ereignis.
- 1
Testschlüssel erhalten
Händlerkonto anlegen und Testschlüssel für die Integration anfordern.
- 2
Bestellung erstellen
Betrag, Referenz und Benachrichtigungs-URL senden; Bezahl-Link erhalten.
- 3
Kunde bezahlt
Kunden zur gehosteten Bezahlseite von KukoPay weiterleiten.
- 4
Prüfen und erfüllen
payment.succeeded verifizieren und Ereignisse anhand ihrer ID deduplizieren.
Sicherheit von Anfang an
Schutz im Ablauf verankert
Getrennte Umgebungen, signierte Ereignisse und Kontobuchregeln reduzieren Bedienfehler.
Geschützte Schlüssel
Schlüssel werden verschlüsselt gespeichert und können zurückgesetzt werden.
Zugriffskontrolle
API-Limits pro Händler und optionale IP-Freigabelisten.
Getrennte Umgebungen
Test und Live nutzen unabhängige Schlüssel und Kontobücher.
Konsistente Geldflüsse
Idempotente Statuswechsel und Saldenänderungen sind dokumentiert.
FAQ
Vor der Integration
Wo finde ich die API-Dokumentation?
Die öffentliche Dokumentation steht unter kukopay.com/docs. Schlüssel, Bestellungen und Webhook-Protokolle finden Sie im Händlerportal.
Wie vermeide ich doppelte Bestellungen oder Leistungen?
Verwenden Sie beim Erstellen eine eindeutige out_trade_no und deduplizieren Sie Webhooks per Ereignis-ID. Nach einem Timeout kann dieselbe Referenz erneut gesendet werden.
Beweist die Browser-Rückkehr eine erfolgreiche Zahlung?
Nein. Erfüllen Sie erst nach Prüfung eines payment.succeeded-Webhooks und fragen Sie den Bestellstatus bei Bedarf zusätzlich ab.
Bereit für Ihre erste Testbestellung?
Händlerkonto eröffnen, Testschlüssel anfordern und dem Schnellstart folgen.