Konfiguration der Stripe-Anwendung für die Salesforce-Plattform

Die Stripe-App für die Salesforce-Plattform kann je nach Ihren Integrationsanforderungen auf verschiedene Weise konfiguriert werden. Sie können Ihre eigene benutzerdefinierte Integration mit Abläufe und Apex mit Stripe-Aktionen und -Ereignissen erstellen oder eine Abrechnungsintegration mit vorhandenen Standardfunktionen implementieren. Zu diesen Funktionen gehören das Salesforce-Datenmodell mit benutzerdefinierten Stripe-Objekten und eine dedizierte Synchronisierung, um Stripe-Abrechnungsdaten bei Erstellungs- und Aktualisierungsvorgängen Salesforce zuzuordnen. Darüber hinaus können Sie die Vorlagenabläufe für die Abonnementverwaltung wiederverwenden oder erweitern, um Ihre Automatisierungsprozesse zu erstellen.

Verwalten Sie Ihr Konto

In der Registerkarte Kontoverwaltung können Sie Ihre Stripe-Konten in Salesforce verbinden und verwalten. Nachdem Sie ein Konto hinzugefügt haben, haben Sie zwei Möglichkeiten:

• Abonnieren Sie entweder Stripe Ereignisse aus Alle Webhook Ereignisse, um Abläufe zu erstellen oder Custom Logic mit Apex für Echtzeit-Integrationen mit Stripe.
• Oder fahren Sie mit der Einrichtung der Synchronisierung von Stripe Billing fort, indem Sie auf Ihr Konto klicken und zur Registerkarte Mehr navigieren. Dort finden Sie auch die Option, um zu steuern, wie Stripe Billing-Daten in Salesforce übertragen werden.

API-Erweiterung

Ab Version 2.4.0 unterstützt die Bibliothek die API-Version 2025-04-30 und führt ein Upgrade von der vorherigen Version 2022-11-30 durch.

Wenn Sie die App zum ersten Mal in Ihrer Instanz installieren, wird automatisch 2025-04-30 ausgewählt. Wenn Sie ein Upgrade von einer früheren Version durchführen, können Sie die neuesten Versionen der Erweiterungen im Abschnitt Erweiterungen des App-Assistenten prüfen und die neueste API-Erweiterung installieren.

Auswirkungen

Da es sich um zwei separate API Erweiterungen handelt, müssen Sie die Aktions- und Apex-Nodes, in denen in Ihrer Integration auf die älteren API Versionen verwiesen wird, manuell aktualisieren.

So wirkt sich die Erweiterung der API-Version auf die Einrichtung aus:

Abrechnungsdatenmodell

Die Funktion „Stripe Billing Data“ führt ein umfassendes Salesforce-Datenmodell für die Abrechnungsobjekte von Stripe ein. Damit können Händler/innen wichtige Daten zu Abos, Rechnungen, Zahlungen und Produkten direkt in Salesforce speichern und verwalten. Dazu gehören benutzerdefinierte Objektdarstellungen der folgenden Stripe-Objekte:

Über das Datenmodell hinaus werden diese benutzerdefinierten Objekte derzeit standardmäßig den folgenden Salesforce-Objekten zugeordnet. Sie können diese Zuordnungen je nach Use Case erweitern oder anpassen:

Die folgenden Salesforces-Objekte werden Stripe-Objekten zugeordnet:

• PricebookEntry zu Preis
• Konto an Kundin/Kunde
• Vertrag zu Abonnementplan
• Vertrag zu Abo
• Bestellung zu Abonnementplan
• Bestellung zu Abonnement

Stripe Billing-Synchronisierung

Wenn Sie keine benutzerdefinierte Integration mit Abläufe und Apex erstellen möchten, verwenden Sie Stripe Billing Sync, um Daten aus Stripe automatisch mit Salesforce zu synchronisieren. Dabei werden die Daten übertragen und mithilfe der Standard-Objektzuordnungen von Salesforce benutzerdefinierten Objekten zugeordnet. Es gibt zwei Möglichkeiten zur Synchronisierung, von denen Sie auf Kontoebene jeweils nur eine aktivieren können.

Die Echtzeitsynchronisierung verwendet Stripe Webhooks, um Salesforce sofort mit Stripe Billing Data zu aktualisieren, wenn Objekte erstellt, aktualisiert oder geändert werden. So aktivieren Sie sie:

1. Navigieren Sie zu Kontoverwaltung.
2. Wählen Sie Ihr Stripe-Konto aus.
3. Gehen Sie zu Stripe Billing-Synchronisierung.
4. Wählen Sie im Dropdown-Menü Synchronisierungstyp Echtzeit aus.
5. Schalten Sie die Funktion ein.
6. Wählen Sie aus, ob alle Objekte standardmäßig synchronisiert werden sollen oder wählen Sie bestimmte Objekte aus, die überwacht werden sollen.

Um weitere Änderungen vorzunehmen, klicken Sie auf die Option Synchronisierung aktualisieren, um entweder bestehende Ereignisse abzumelden oder neue zu abonnieren.

Verwenden Sie Geplante wiederkehrende Synchronisierung, um Daten in Salesforce auf dem neuesten Stand zu halten, ohne API-Grenzwerte zu überschreiten – im Gegensatz zur Echtzeit-Synchronisierung auf Basis von Webhooks. Es handelt sich um eine globale Konfiguration, die für alle Stripe-Konten gilt, die mit Ihrer Salesforce-Organisation verknüpft sind.

So aktivieren Sie es:

1. Öffnen Sie im App-Assistenten die App Stripe Billing.
2. Konfigurieren Sie Synchronisierungshäufigkeit und Startzeit synchronisieren.
3. Speichern Sie die globale Konfiguration.
4. Öffnen Sie das gewünschte Stripe-Konto und aktivieren Sie Geplante wiederkehrende Zahlungen.
5. Nachdem Sie sie aktiviert haben, wird unter Synchronisierungstyp die nächste Laufzeit angezeigt.

Konfigurieren Sie zusätzlich zur globalen Konfiguration für die geplante wiederkehrende Synchronisierung Metadatenzuordnungen und benutzerdefinierte Feldzuordnungen, um Stripe-Metadaten und benutzerdefinierte Feldwerte Salesforce-Objekten zuzuordnen. Sie müssen die benutzerdefinierten Felder manuell in Ihrer Salesforce-Organisation hinzufügen, damit sie unter dem von Ihnen verwendeten Stripe-Objekt angezeigt werden.

1. Klicken Sie im Abschnitt Metadatenzuordnungen auf Objekt hinzufügen.
2. Wählen Sie das gewünschte Stripe-Objekt aus und ordnen Sie dann das Salesforce-Feld dem Stripe-Metadaten-Schlüssel zu.
3. Für benutzerdefinierte Feldzuordnungen ist diese Option derzeit nur für Stripe-Rechnungen verfügbar.

Stripe Billing Data

Stripe Billing Data in Salesforce bieten einen zentralen Ort zum Anzeigen und Verwalten Ihrer Stripe Billing-Daten. Dazu gehören in erster Linie synchronisierte Objekte und Salesforce-Seitenlayouts für Stripe-Objekte, die auf dem vordefinierten Objektmodell basieren. Um zu dieser App zu gelangen, verwenden Sie den App-Launcher und navigieren Sie zu Stripe Billing Data.

Nachverfolgung von Transaktionen

Diese Funktion verhindert doppelte Verarbeitungen, indem sie von Salesforce initiierte Stripe-Transaktionen markiert und so sicherstellt, dass alle resultierenden Stripe-Ereignisse während der Synchronisierung ignoriert werden. Sie können diese Transaktionen anzeigen, indem Sie im App Launcher zu Stripe API-Transaktionen navigieren. Dort sehen Sie den Idempotenz-Schlüssel, der mit dem Stripe-Konto verknüpft ist, das die Ereignisse generiert.

Mit Sandboxen und Umgebungsklonen arbeiten

Wenn Sie eine Salesforce-Sandbox erstellen oder Produktionsdaten kopieren, stellen Sie sicher, dass die Stripe for Salesforce Platform ausgewählte Daten aus dem Klon auslässt. Kopieren Sie keine Verbindungen und Konfigurationen aus der Produktionsumgebung oder anderen Umgebungen. Verwenden Sie Sandbox-Vorlagen, die keine stripeGC-Objekte enthalten.

Konfigurieren Sie die Stripe for Salesforce-Plattform unabhängig für jede Salesforce-Organisation und führen Sie den Einrichtungsprozess für jede Salesforce-Organisation aus.

Auf einen Klon kopierte Daten entfernen

Wenn Sie Daten aus den StripeGC-Objekten in eine neue Salesforce-Organisation kopieren, entfernen Sie die Daten, indem Sie ein anonymes Anonymous Apex-Skript ausführen:

delete [SELECT Id FROM stripeGC__Setup_Data__c];
delete [SELECT Id FROM stripeGC__Stripe_Account__c];
delete [SELECT Id FROM stripeGC__Stripe_Event__c];
delete [SELECT Id FROM stripeGC__Stripe_Webhook_Endpoint__c];
delete [SELECT Id FROM stripeGC__Sync_Log__c];

Rekursionserkennung

Die Salesforce-Plattform von Stripe setzt Prüfungen ein, um zu verhindern, dass Aktionen in einer Endlosschleife stecken bleiben. Eine logische Schleife kann z. B. auftreten, wenn eine Ressourcen-Gruppe ständig Updates von einer anderen Gruppe erkennt und auf diese reagiert. Angenommen, Sie haben einen Flow, der die customer.updated-Ereignisse von Stripe überwacht und infolge ein Salesforce-Account aktualisiert. Gleichzeitig haben Sie vielleicht aber auch noch einen anderen Flow, der Aktualisierungen am Salesforce-Account entdeckt und das zugehörige Kundenkonto aktualisiert. Diese Einrichtung führt zu einer Endlosschleife, die auf unbestimmte Zeit fortgesetzt wird.

Konfiguration der Rekursionserkennung

Sie können bestimmte Ereignisse bei der Rekursionserkennung ein- und ausschließen. Wenn Sie ein Administrator sind, können Sie diese Ereignisse in Ihren Einstellungen ändern, indem Sie die Rekursionserkennung konfigurieren.

Die Konfiguration der Rekursionserkennung kann wie folgt aufgerufen werden:

1. Navigieren Sie zu Einrichtung > Benutzerdefinierter Code > Benutzerdefinierte Metadaten.
2. Klicken Sie unter Konfiguration der Rekursionserkennung auf Manage Records (Datensätze verwalten).
3. Klicken Sie neben Standard auf Bearbeiten.

Innerhalb dieser Konfiguration kann ein Administrator entweder Enthaltene Ereignisse oder Ausgeschlossene Ereignisse hinzufügen.

Datensatzaufbewahrung konfigurieren

Um die Datensatz- und Protokollbereinigung zu konfigurieren, öffnen Sie im Salesforce-App-Assistenten Datensatzaufbewahrung. In diesem Abschnitt können Sie Einstellungen konfigurieren, die Stripe-Ereignis- und Synchronisierungsprotokolldatensätze automatisch aus Ihrer Salesforce-Organisation entfernen.