Wichtige Hinweise
- Aktivieren Sie es im Portal unter Entwickler → Epay-Gateway. Das Gateway ist https://api.kukopay.com/epay; die numerische pid bestimmt Sandbox oder Live, jede Umgebung hat einen eigenen 32-stelligen Schlüssel.
- submit.php (Browser-Weiterleitung) und mapi.php (Serveraufruf, liefert payurl) erzeugen eine normale KukoPay-Bestellung; api.php?act=order fragt sie ab. Dieselbe out_trade_no liefert dieselbe Bestellung.
- Signieren wie im Referenz-SDK: sign, sign_type und leere Werte entfernen, nach Namen sortieren, ohne URL-Kodierung als k=v&k=v verbinden, Schlüssel anhängen, MD5 in Kleinbuchstaben.
- money ist eine Dezimalzahl ohne Währung und wird in der im Portal gewählten Währung belastet, mit höchstens zwei Nachkommastellen.
- Benachrichtigt wird nur eine erfolgreiche Zahlung: ein signiertes GET an notify_url mit trade_status=TRADE_SUCCESS. Antworten Sie mit dem Text success, sonst wird erneut gesendet, insgesamt höchstens 6-mal.
- Epay-Bestellungen sind normale Bestellungen: Erstattungen, Rückbuchungen und Auszahlungen funktionieren wie gewohnt, spätere Ereignisse erreichen weiterhin Ihre Webhook-Endpunkte.
- Stellen Sie die Gültigkeit (standardmäßig 30 Minuten) nicht länger ein als die Bestell-Zeitüberschreitung Ihres Systems, sonst kann eine bereits stornierte Bestellung bezahlt werden.
Beispiel
json
{
"code": 1,
"msg": "success",
"trade_no": "TRD_SB_9F3A…",
"payurl": "https://checkout.kukopay.com/checkout?trade_no=TRD_SB_9F3A…&token=…",
"request_id": "req_…"
}