Zum Inhalt springenKostenlose Sandbox — Ihre erste Testbestellung in Minuten
Jetzt starten

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.

Händlerkonto erstellenDokumentation lesen

Bestellungen rein,Geld gutgeschrieben.

Fig. 1nur zur Illustration

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
  • Kostenlose Testumgebung
  • Gehostete Bezahlseite
  • Prüfbare Webhooks

01Plattform

Der gesamte Zahlungsablauf

Die wichtigsten Funktionen in einer API. Status und Geldbewegungen bleiben nachvollziehbar.

Einheitliche Zahlungs-API

Bestellungen erstellen, Status abfragen und Erstattungen per HTTP + JSON auslösen.

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.

02Zahlungsarten und Preise

Was Sie annehmen können – und was es kostet

Die Standardkonditionen der Plattform. Freigegebene Händler sehen ihre vereinbarten Preise im Händlerportal.

Zahlungsarten
  • Karten
  • Apple Pay
  • Google Pay
  • Alipay
  • WeChat Pay
  • PayPal
In der Testumgebung stehen alle Zahlungsarten bereit. Live-Zahlungsarten werden bei der Freigabe je Händler aktiviert; weitere lassen sich im Portal beantragen.
Währungen
USD · HKD · CNY
Jede Währung ist ein eigenes Wallet und wird in derselben Währung ausgezahlt. Es gibt keine automatische Umrechnung.
Standardpreis
3.5% + Fixgebühr
Je erfolgreicher Zahlung; die Fixgebühr beträgt $0.30 · HK$2.35 · ¥2.00. Die Gebühr übersteigt nie den Bestellbetrag.
Gebühren und Abrechnung

03Fü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.

Beispielanfrage · Testumgebung

Anfrage

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

Bestellbetrag

$29.90 USD

ORD_2026_001

TestumgebungBezahlt

Zahlungsablauf

  1. Bestellung erstelltPOST /v1/orders
  2. Bezahlseite geöffnetcheckout_url
  3. Zahlung erfolgreichpayment.succeeded
  4. Webhook zugestelltHTTP 200
  5. Im Kontobuch erfasst+ $29.90

Fig. 2Beispielansicht, keine echte Zahlung

Schnellstart ansehen

04Integrationswege

Der kürzeste Weg für Ihr System

Jeder Weg erzeugt dieselben Bestellungen auf derselben gehosteten Bezahlseite, mit derselben Abrechnung und denselben Benachrichtigungen. Der Unterschied ist nur, wer den Code schreibt.

Server-API

Bestellungen, Erstattungen, Rückbuchungen, Abgleich und Auszahlungen per HTTP + JSON. Volle Kontrolle.

Zahlungslinks

Eine feste URL für ein Produkt oder eine Leistung. Jeder Aufruf öffnet eine neue Bestellung – ohne Code.

Protokoll-kompatibles Gateway

Ihr System spricht bereits ein gängiges Zahlungsprotokoll? Mit Gateway-URL und Schlüssel verbinden Sie es mit KukoPay – ohne neuen Code.

Plattform-Plugins

Plugin für Ihre Plattform installieren, Schlüssel eintragen – Bestellungen werden auf der gehosteten Bezahlseite bezahlt.

05Integrationsablauf

In vier Schritten zur Zahlung

Die Browser-Rückkehr dient der Nutzerführung. Grundlage für die Leistung ist ein verifiziertes Server-Ereignis.

  1. 01

    Testschlüssel erhalten

    Händlerkonto anlegen und Testschlüssel für die Integration anfordern.

  2. 02

    Bestellung erstellen

    Betrag, Referenz und Benachrichtigungs-URL senden; Bezahl-Link erhalten.

  3. 03

    Kunde bezahlt

    Kunden zur gehosteten Bezahlseite von KukoPay weiterleiten.

  4. 04

    Prüfen und erfüllen

    payment.succeeded verifizieren und Ereignisse anhand ihrer ID deduplizieren.

06Sicherheit 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.

07FAQ

Vor der Integration

Was ist KukoPay?

KukoPay ist ein Payment-Gateway für Unternehmen, die grenzüberschreitend verkaufen. Ihr Server erstellt mit einem API-Aufruf eine Bestellung und leitet Kunden zur gehosteten Bezahlseite von KukoPay. Die Plattform bestätigt die Zahlung beim Zahlungskanal, schreibt den Nettobetrag dem Wallet der jeweiligen Währung gut und benachrichtigt Sie per signiertem Webhook. Erstattungen, Rückbuchungen, Abgleich und Auszahlungen laufen über dieselbe API und das Händlerportal.

Welche Zahlungsarten und Währungen werden unterstützt?

Karten, Apple Pay, Google Pay, Alipay, WeChat Pay und PayPal, in USD, HKD und CNY. In der Testumgebung steht alles bereit; live werden Zahlungsarten und Währungen bei der Freigabe je Händler aktiviert, weitere lassen sich im Portal beantragen. Jede Währung ist ein eigenes Wallet, ohne automatische Umrechnung.

Was kostet KukoPay?

Der Standardpreis beträgt 3.5% plus eine Fixgebühr je erfolgreicher Zahlung: $0.30 in USD, HK$2.35 in HKD und ¥2.00 in CNY. Die Gebühr übersteigt nie den Bestellbetrag. Preise können bei Vertragsabschluss je Zahlungsartengruppe vereinbart werden; der angewandte Satz wird an jeder Bestellung gespeichert. Die Testumgebung ist kostenlos.

Brauche ich ein eingetragenes Unternehmen?

Nein. Neben Unternehmen in Festlandchina, Einzelunternehmern und außerhalb Festlandchinas eingetragenen Gesellschaften können auch Privatpersonen ab 18 Jahren mit ihrem eigenen Ausweis ein Konto eröffnen. Für Privatpersonen gelten Zahlungslimits, Auszahlungen gehen nur auf ein Privatkonto auf ihren Namen, und digitale Güter sowie Onlinespiele sind ausgeschlossen.

Kann ich Zahlungen ohne Programmierung annehmen?

Ja. Zahlungslinks brauchen keinen Code; Systeme mit einem gängigen Zahlungsprotokoll verbinden sich über Gateway-URL und Schlüssel, und für unterstützte Plattformen gibt es fertige Plugins. Erstattungen, Abgleich und Belege für Rückbuchungen erledigen Sie im Händlerportal.

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.

Testkonto erstellenDokumentation ansehen