Wichtige Hinweise
- Eine Quittung ist ein Zahlungsnachweis, keine Steuerrechnung. Umsatzsteuerrechnungen stellen Sie als Verkäufer selbst aus; die Quittungsseite weist darauf hin.
- Übergeben Sie receipt_email beim Anlegen der Bestellung, wird die Quittung nach der Zahlung einmal per E-Mail versendet. locale (zh oder en) bestimmt die Sprache von Checkout, Quittungsseite und E-Mail.
- POST /v1/orders/{trade_no}/send_receipt versendet sie erneut. email ist optional und wird als receipt_email der Bestellung gespeichert. Unbezahlte Bestellungen liefern 409 conflict; pro Bestellung sind 5 Sendungen pro Stunde erlaubt, danach 429 rate_limited.
- Bezahlte Bestellungen enthalten receipt_url (signiert und dauerhaft gültig), receipt_number, receipt_email, receipt_sent_at und locale. Antworten gehen an Ihre Kontaktadresse aus dem Onboarding; Sandbox-Quittungen tragen [TEST].
Beispiel
bash
curl -X POST "https://api.kukopay.com/v1/orders" \
-H "Content-Type: application/json" \
-H "X-Api-Key: $KUKOPAY_API_KEY" \
-d '{
"amount": 2990,
"currency": "USD",
"subject": "Premium plan",
"receipt_email": "[email protected]",
"locale": "en"
}'