Schnellstart
Erstellen Sie eine Sandbox-Bestellung, öffnen Sie den gehosteten Checkout und prüfen Sie das signierte Zahlungsereignis vor der Erfüllung.
Wichtige Hinweise
- Registrieren Sie ein Händlerkonto, beantragen Sie einen kuko_test_-Schlüssel und senden Sie ihn im Header X-Api-Key.
- Richten Sie einen öffentlichen HTTPS-Sandbox-Webhook für payment.succeeded, payment.failed und payment.expired ein. Ohne Endpunkt können Sie zunächst Bestellungen und Ereignisse abfragen.
- Senden Sie POST /v1/orders mit eindeutiger out_trade_no, ganzzahligem amount und currency. Leiten Sie zur checkout_url weiter, ohne deren Token zu protokollieren.
- Prüfen Sie die Webhook-Signatur anhand des unveränderten Request-Bodys und vermeiden Sie Duplikate per Ereignis-ID. Fragen Sie bei Verzögerung die Bestellung ab.
- Für Live-Zahlungen benötigen Sie die Händlerfreigabe, einen kuko_live_-Schlüssel und einen Live-Webhook oder eine öffentliche HTTPS-notify_url.
Beispiel
bash
curl -X POST "https://api.kukopay.com/v1/orders" \
-H "Content-Type: application/json" \
-H "X-Api-Key: $KUKOPAY_API_KEY" \
-d '{"out_trade_no":"ORD_20260921_0001","amount":2990,"currency":"USD","subject":"Test order"}'