Stripe

Über

Das offizielle Stripe-Plugin verbindet Payload-Collections mit Stripe-Ressourcen, sodass Dokumente und Stripe-Objekte synchron bleiben. Über Sync-Maps wird ein Collection-Slug einem Stripe-Ressourcentyp zugeordnet, mit Feld-Pfaden, die auf Stripe-Properties gemappt werden. Das Plugin fügt der jeweiligen Collection ein schreibgeschütztes Feld stripeID, eine Checkbox skipSync und einen Sidebar-Link zum Dashboard hinzu. Die Synchronisation läuft über Collection-Hooks. Bei der Erstellung legt ein beforeValidate-Hook das Stripe-Objekt an und speichert dessen ID. Bei Änderungen aktualisiert ein beforeChange-Hook das entsprechende Stripe-Objekt. Beim Löschen entfernt ein afterDelete-Hook das Objekt bei Stripe. Über das Feld skipSync lässt sich die Synchronisation pro Dokument deaktivieren. Eingehende Stripe-Events verarbeitet ein Endpunkt unter POST /stripe/webhooks, der mit dem konfigurierten stripeWebhooksEndpointSecret verifiziert wird. Es kann ein einzelner Handler oder eine Map mit Handlern registriert werden, die nach Event-Namen verschlüsselt sind. Jeder Handler erhält die Stripe-Instanz, das geparste Event, die Payload-Instanz, den Request, die Plugin-Konfiguration und die Payload-Konfiguration. Ein optionaler REST-Proxy unter POST /stripe/rest leitet stripeMethod und stripeArgs direkt an das Stripe SDK weiter. Der Proxy erfordert einen authentifizierten Payload-Nutzer und stellt den Secret Key nicht im Browser bereit. Die Synchronisation unterstützt derzeit die Ressourcentypen customers und products. Mit der exportierten Utility stripeProxy lassen sich benutzerdefinierte Aufrufe gegen das Stripe SDK durchführen.

Paketinformationen

Paketname

@payloadcms/plugin-stripe

Neueste Version

3.90.2

Entpackte Größe

172 kB

Lizenz

MIT

Wöchentliche Downloads

15.446

Zuletzt veröffentlicht

23. Sep. 2026