Wie die Webhook-Auslieferung funktioniert
Shopify löst ein ORDERS_PAID-Ereignis in dem Moment aus, in dem die Zahlung erfasst wird. Das Ereignis landet in einem Google-Cloud-Pub/Sub-Topic, Alvas Worker holt die Nachricht ab, schreibt die Customer- und Purchase-Zeilen in PostgreSQL, dann sendet er die Liefer-E-Mail über Postmark oder MailerToGo. Der Pub/Sub-Puffer macht dies zuverlässig: Wenn ein Deploy mitten im Rollout ist oder die Datenbank kurz langsam ist, wartet die Nachricht in der Warteschlange und wird erneut zugestellt, bis der Worker den Erfolg quittiert.
Einfaches horizontales Pipeline-Diagramm mit fünf beschrifteten Stufen: Shopify ORDERS_PAID → Google-Cloud-Pub/Sub-Topic → Alva-Worker → PostgreSQL (Customer + Purchase) → E-Mail-Versand (Postmark / MailerToGo). Verwenden Sie Alva-Brand-Türkis/Blau. Keine echten Kundendaten.
Häufige Gründe für Verzögerung
Hohe Last auf der Pub/Sub-Warteschlange
Während Flash-Sales kann das Topic Tausende ausstehender Nachrichten halten. Alvas Worker leert sie der Reihe nach, sodass eine Bestellung am Ende einer 5.000-Nachrichten-Warteschlange wartet. Latenz hier liegt meist unter zwei Minuten.
Betrugsprüfung hält die E-Mail zurück
Wenn Betrugsprüfungen aktiviert sind, schreibt der Worker die Bestellung in die FraudCheckQueue und pausiert die Auslieferung, bis Shopifys Risk-API antwortet. Die meisten Prüfungen lösen sich in Sekunden; zur manuellen Prüfung weitergeleitete Bestellungen warten, bis Sie sie genehmigen. Lizenzschlüssel werden nie vor der Betrugs-Genehmigung zugewiesen.
Große ZIP-Paket-Regeneration
Wenn das Produkt ein Paket ist und sich eine seiner Dateien seit dem Bau des letzten gecachten ZIPs geändert hat, regeneriert Alva das Archiv in R2 vor dem Senden der E-Mail. Multi-Gigabyte-Pakete können Minuten dauern.
Produktspezifische E-Mail-Einstellung mitten im Flug geändert
Wenn Sie eine produktspezifische E-Mail-Vorlage umschalten oder E-Mails für ein Produkt deaktivieren, während eine Bestellung im Flug ist, liest der Worker ProductEmailSettings beim nächsten Versuch erneut. Die Bestellung wird trotzdem abgeschlossen — die E-Mail verwendet einfach die neue Regel.
Webhook-Wiederholungen von Shopify
Shopify wiederholt einen fehlgeschlagenen Webhook bis zu 19 Mal über etwa 48 Stunden, mit Backoff zwischen den Versuchen. Wenn die erste Lieferung Alva während eines Deploys getroffen hat, erscheint die Bestellung möglicherweise erst, wenn der nächste Wiederholungsversuch erfolgreich ist — meist innerhalb von 5–10 Minuten.
Was zu tun ist, wenn es länger als 5 Minuten gedauert hat
Fünf Minuten decken die überwiegende Mehrheit der Fälle ab. Über dieses Fenster hinaus arbeiten Sie diese Checkliste ab:
- Bestätigen Sie, dass die Bestellung in Shopify bezahlt ist — ausstehende oder autorisierte Bestellungen lösen
ORDERS_PAIDnie aus. - Öffnen Sie die Alva-Admin-Bestelliste. Zurückgehalten bedeutet, dass Betrug die Auslieferung blockiert; In Bearbeitung bedeutet, dass der Worker noch daran arbeitet.
- Prüfen Sie Einstellungen → E-Mail, um zu bestätigen, dass die E-Mail-Auslieferung aktiviert und ein verifizierter Absender konfiguriert ist.
- Wenn die Bestellung komplett fehlt, fallen Sie auf Download-Link eines Kunden finden zurück, um die Auslieferung manuell erneut auszulösen.
Häufig gestellte Fragen
Pub/Sub puffert Webhooks während Deploys, Ausfällen und Verkehrsspitzen, sodass eine bezahlte Bestellung nie fallen gelassen wird. Der Worker quittiert die Nachricht erst, nachdem die Purchase-Zeile geschrieben ist.
Nein. Die Danke-Seite verwendet ein provisorisches Download-Token aus der Checkout-Erweiterung, sodass Dateien sofort erscheinen, selbst wenn der ORDERS_PAID-Webhook noch im Flug ist.
Bis zu 19 Mal über etwa 48 Stunden, mit exponentiellem Backoff. Solange Alva schließlich Erfolg zurückgibt, wird die Bestellung normal verarbeitet.
Siehe auch
War das hilfreich?
Zuletzt aktualisiert 2026-05-06