Gutscheine
Online-Wertgutscheine kaufen (dieselbe DB wie die Kasse). Config lesen und Kauf starten.
Modul-ID im Schlüssel: gift_vouchers (opt-in). URL-Pfad: /api/v1/gift-vouchers.
Voraussetzung: POS-Abo und Online-Verkauf unter Einstellungen → Gutscheine aktiv.
Nach erfolgreicher Zahlung (Webhook) ist der Gutschein aktiv; Beleg/PDF gehen per E-Mail. TSE erst bei Kasseneinlösung.
Methoden: GET, POST, OPTIONS · Endpunkt: GET /api/v1/gift-vouchers
GET — Verkaufskonfiguration
curl -s "https://gwada.app/api/v1/gift-vouchers" \ -H "Authorization: Bearer gwada_sk_live_…" \ -H "Accept: application/json"
POST — Kauf starten
curl -s -X POST "https://gwada.app/api/v1/gift-vouchers" \
-H "Authorization: Bearer gwada_sk_live_…" \
-H "Content-Type: application/json" \
-d '{
"amountCents": 5000,
"payMethod": "creditcard",
"purchaserName": "Max Mustermann",
"purchaserEmail": "max@example.com"
}'payMethod
- creditcard — Karte
- paypal — PayPal
- applepay — Apple Pay
- googlepay — Google Pay
Hinweise
- Antwort enthält checkoutUrl für Provider-Redirect (3DS/PayPal/Wallets) — kein Mollie Methoden-Picker
- Kanal im System: api (Filter/Export im Dashboard)
- 403 pos_subscription_required oder online_sale_disabled wenn Verkauf gesperrt
Fehler
Auth- und Limit-Fehler sind einheitlich — siehe Rate Limits & Fehler. Typisch: 401 invalid_api_key, 403 module_not_enabled, 403 restaurant_not_published, 404 not_found, 429 rate_limit_exceeded.