← gwada.app

Dokumentation

Anmelden

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.

Weiterlesen