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

Erfahren Sie, wie Sie die Stripe-App für die Salesforce-Plattform konfigurieren

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.
![](https://b.stripecdn.com/docs-statics-srv/assets/sf_billing_sync_setting_new.d7904464f94d18c60009b96a4ae5a43b.png)

## 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:

> Die Version 2025-04-30 fügt `performDMLSaveAfterCallouts` zu Adressbeschränkungen mit mehreren API-Aufrufen hinzu. Dieses Flag steuert, ob der Ablauf Datenbankspeicherungen (z. B. Erstellen von `Sync_Log__c`-Datensätzen, Aktualisieren von Stripe Billing-Objekten) überträgt, nachdem alle Aufrufe abgeschlossen sind. So verhindert es Datenverlust oder Inkonsistenzen bei mehreren API-Aufrufen in einem einzigen Salesforce-Ablauf.

| App-Version der Salesforce-Plattform | Version der API-Erweiterung | Erwartete Auswirkungen                                                  |
| ------------------------------------ | --------------------------- | ----------------------------------------------------------------------- |
| Bis Version `1.2.6`                  | 2022-11-30                  | Keine Auswirkung                                                        |
| Ab Version `2.4.0`                   | 2022-11-30                  | Beschränkt auf einzelne, auf API-Aufrufen basierende Salesforce-Abläufe |
| Ab Version `2.4.0`                   | 2025-04-30                  | Keine Auswirkung                                                        |

## 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:

|  |
|  |
| Abbuchungen | Gutscheine                     | Kunde/Kundinnen     |
| Discounts   | Rechnungen und Rechnungsposten | Zahlungsmethoden    |
| Preise      | Produkte                       | Abos und Abo-Posten |
| Abo-Phase   | Posten der Abo Phase           | Abonnementpläne     |

Ü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**.
1. Wählen Sie Ihr Stripe-Konto aus.
1. Gehen Sie zu **Stripe Billing-Synchronisierung**.
1. Wählen Sie im Dropdown-Menü **Synchronisierungstyp** **Echtzeit** aus.
1. Schalten Sie die Funktion ein.
1. Wählen Sie aus, ob alle Objekte standardmäßig synchronisiert werden sollen oder wählen Sie bestimmte Objekte aus, die überwacht werden sollen.
![](https://b.stripecdn.com/docs-statics-srv/assets/sf_billing_enable_real_time_sync.249a6ca4f4404770b4f366b2ce83f798.png)

Um weitere Änderungen vorzunehmen, klicken Sie auf die Option **Synchronisierung aktualisieren**, um entweder bestehende Ereignisse abzumelden oder neue zu abonnieren.
![](https://b.stripecdn.com/docs-statics-srv/assets/sf_billing_update_real_time_sync.a7e7f5b224a309b9a6f66e323d69f37a.png)

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**.
1. Konfigurieren Sie **Synchronisierungshäufigkeit** und **Startzeit synchronisieren**.
1. Speichern Sie die globale Konfiguration.
1. Öffnen Sie das gewünschte Stripe-Konto und aktivieren Sie **Geplante wiederkehrende Zahlungen**.
1. Nachdem Sie sie aktiviert haben, wird unter **Synchronisierungstyp** die **nächste Laufzeit** angezeigt.

> Verwalten Sie geplante wiederkehrende Synchronisierungen immer im App-Assistenten unter **Stripe Billing**. Konfigurieren oder ändern Sie keine Werte unter **Einrichtung > Umgebungen > Jobs > Geplante Jobs**. Bei der globalen Konfiguration können Sie keine bestimmten Objekte auswählen – es werden entweder alle Objekte synchronisiert oder gar keine.

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**.
1. Wählen Sie das gewünschte **Stripe-Objekt** aus und ordnen Sie dann das **Salesforce-Feld** dem **Stripe-Metadaten-Schlüssel** zu.
1. 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**.
![](https://b.stripecdn.com/docs-statics-srv/assets/sf_billing_data_app.50688b8b10ba38e049aa12f15bf090ef.png)

## 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.

> Achten Sie beim Erstellen neuer Abläufe oder Aktivieren bestehender verpackter Abläufe darauf, den Idempotenz-Schlüssel anzugeben, damit doppelte Transaktionen verhindert werden

## 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.
![](https://b.stripecdn.com/docs-statics-srv/assets/SFU_Sandbox_Template.08e0c4b1d657a14b28d5874a67508b58.png)

## 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:

#### Java

```java
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**.
1. Klicken Sie unter **Konfiguration der Rekursionserkennung** auf **Manage Records** (Datensätze verwalten).
1. 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.
![](https://b.stripecdn.com/docs-statics-srv/assets/sfPlatform_record_retention.d24d5238868093ce3e17aeb5b9074c80.png)

## See also

- [Schulung](https://docs.stripe.com/use-stripe-apps/stripe-app-for-salesforce/training.md)
- [Installationsanleitung](https://docs.stripe.com/use-stripe-apps/stripe-app-for-salesforce/installation-guide.md)