# Installieren Sie die Stripe-App für Salesforce Order Management Richten Sie die Stripe-App ein und konfigurieren Sie sie. ## Vor der Installation der Salesforce Order Management-App 1. Ermitteln Sie die Organisation und den B2C-Commerce-Shop in Ihrer Salesforce-Instanz, in der Sie die Anwendung installieren und zuordnen möchten. 1. Überprüfen Sie die Berechtigungen und [Voraussetzungen](https://docs.stripe.com/use-stripe-apps/salesforce-order-management.md), bevor Sie mit der Installation beginnen. 1. Beachten Sie die Einschränkungen der Integration: 1. Unterstützt nur eine einzelne B2C-Storefront 1. Unterstützt nur einmalige manuelle Erfassung 1. Unterstützt keine komplexen Szenarien wie Übererfassung und Mehrfacherfassung ## Installation Um mehr über die Integration mit Salesforce Order Management zu erfahren, kontaktieren Sie uns bitte über das Formular unter [Stripe-Support](https://support.stripe.com). Stellen Sie sicher, dass **Install for Admins only** (Nur für Admins installieren) ausgewählt ist, und klicken Sie auf **Install** (Installieren). ![](https://b.stripecdn.com/docs-statics-srv/assets/sfom-install.a95bc450897ae2c8fec49837590ce099.png) Genehmigen Sie den Zugriff auf und durch Drittanbieter-Websites. Aktivieren Sie das Kontrollkästchen Grant Access (Zugriff gewähren) und klicken Sie auf **Continue** (Fortfahren). ![](https://b.stripecdn.com/docs-statics-srv/assets/sfom-3p-access.fea0d91a0e164d00b01c288cbe51475e.png) Wenn die Installation länger dauert, erhalten Sie eine E-Mail, in der Sie darüber informiert werden, dass das Paket installiert wurde. Um dies zu überprüfen, gehen Sie zu **Setup > Apps > Pakete > Installierte Pakete** und stellen Sie sicher, dass das Paket installiert ist. ## Konfiguration Die Anweisungen in den folgenden Abschnitten beschreiben, wie Sie Ihre Integration konfigurieren. ### Synchronen Zahlungs-Gateway-Adapter von Stripe konfigurieren 1. Befolgen Sie die Anweisungen in Schritt 3 unter [Synchronen Zahlungs-Gateway-Adapter in Salesforce einrichten](https://developer.salesforce.com/docs/atlas.en-us.apexcode.meta/apexcode/apex_commercepayments_sync_adapter_setup.htm), um einen Zahlungs-Gateway-Anbieter zu erstellen. Folgende Werte werden für die Nutzlast empfohlen: ```json { "ApexAdapterId": "Output of this Query: SELECT Id FROM ApexClass WHERE Name IN ('StripeAdapter')", "DeveloperName": "StripeProvider", "MasterLabel": " StripeProvider", "IdempotencySupported": "No", "Comments": "Stripe Synchronous Payment Gateway Adapter" } ``` 1. Befolgen Sie die Anweisungen in Schritt 4 unter [Synchronen Zahlungs-Gateway-Adapter in Salesforce einrichten](https://developer.salesforce.com/docs/atlas.en-us.apexcode.meta/apexcode/apex_commercepayments_sync_adapter_setup.htm), um einen Zahlungs-Gateway-Eintrag zu erstellen. Empfohlene Werte: | Feldbezeichnung | Wert | | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | SALESFORCE_PAYMENT | | Händler-Anmeldedaten | Ausgabe dieser Abfrage: `SELECT Id FROM NamedCredential WHERE DeveloperName = 'StripeAPI'` | | Zahlungs-Gateway-Anbieter | Ausgabe der Abfrage (ändern Sie die Abfrage entsprechend, wenn Ihr Synchroner Zahlungs-Gateway-Anbieter von Stripe ein anderer als ‘StripeProvider’ ist): `SELECT Id FROM PaymentGatewayProvider WHERE DeveloperName ='StripeProvider'` | | Status | Aktiv | ### Asynchronen Zahlungs-Gateway-Adapter von Stripe konfigurieren 1. Befolgen Sie die Anweisungen unter [Gateway-Adapter für asynchrone Zahlungen in Salesforce einrichten](https://developer.salesforce.com/docs/atlas.en-us.apexcode.meta/apexcode/apex_commercepayments_async_adapter_setup.htm), um den asynchronen Zahlungs-Gateway-Adapter von Stripe in Salesforce zu konfigurieren. (Überspringen Sie Schritt 2 und 3, wenn Sie bereits das gleiche Verfahren für den synchronen Zahlungs-Gateway-Adapter von Stripe durchgeführt haben.) Zum Erstellen eines asynchronen Zahlungs-Gateway-Anbieters führen Sie Schritt 4 unter dem obigen Link aus. Hier ist der empfohlene Satz von Werten für die Nutzlast: ```json { "ApexAdapterId": "Output of this Query: SELECT Id FROM ApexClass WHERE Name IN (‘StripeAsyncAdapter’)", "DeveloperName": "StripeAsyncAdapter", "MasterLabel": " StripeAsyncAdapterProvider ", "IdempotencySupported": "No", "Comments": "Stripe Asynchronous Payment Gateway Adapter" } ``` 1. Befolgen Sie die Anweisung aus Schritt 5 (Zahlungs-Gateway-Eintrag erstellen) unter [Gateway-Adapter für asynchrone Zahlungen in Salesforce einrichten](https://developer.salesforce.com/docs/atlas.en-us.apexcode.meta/apexcode/apex_commercepayments_async_adapter_setup.htm), um den Eintrag für das ansynchrone Zahlungs-Gateway von Stripe in Salesforce zu registrieren. Hier sind die empfohlenen Werte für die Felder, die eingefügt (wenn Sie zum ersten Mal einen Gateway-Eintrag erstellen) oder aktualisiert (wenn Sie bereits einen Gateway-Eintrag beim Einrichten des synchronen Zahlungsgateway-Adapters erstellt haben) werden sollen. | Feldbezeichnung | Wert | | ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | SALESFORCE_PAYMENT | | Händler-Anmeldedaten | Ausgabe dieser Abfrage: `SELECT Id FROM NamedCredential WHERE DeveloperName = 'StripeAPI'` | | Zahlungs-Gateway-Anbieter | Ausgabe der Abfrage (ändern Sie die Abfrage entsprechend, wenn Ihr synchroner Zahlungs-Gateway-Anbieter von Stripe nicht ‘StripeProvider’ ist): `SELECT Id FROM PaymentGatewayProvider WHERE DeveloperName ='StripeAsyncAdapter'.` | | Status | Aktiv | 1. Befolgen Sie die Anweisungen in Schritt 6, um die Webhook-URL für Stripe zu konfigurieren. Das übliche Format der Webhook-URL ist eine öffentlich zugängliche HTTPS-URL. Beispiel: https://mydomainname.my.salesforce-sites.com/subdomain/services/data/v[Replace_ME_version]/commerce/payments/notify%20?provider= ```sql SELECT Id FROM PaymentGatewayProvider WHERE DeveloperName = ‘StripeAsyncAdapter’ ``` [Replace_ME_version] durch die API-Version 49.0 Ihrer Organisation und höher 1. Führen Sie die folgenden Schritte aus, um Ihre Webhooks-URL in Stripe zu registrieren: 1. Melden Sie sich beim [Stripe-Dashboard](https://dashboard.stripe.com/dashboard) an. 1. Wechseln Sie in Workbench zur Registerkarte [Webhooks](https://dashboard.stripe.com/webhooks). 1. Klicken Sie auf **Neuen Endpoint erstellen**. 1. Fügen Sie die folgenden Ereignistypen hinzu: `charge.refunded`, `charge.succeeded`, `charge.captured`. Klicken Sie dann auf **Weiter**. 1. Geben Sie Ihre Webhooks-URL ein und klicken Sie dann auf **Ziel erstellen**. 1. Kopieren Sie Ihren Geheimschlüssel für die Webhook-Signatur und speichern Sie ihn für die spätere Verwendung.![](https://b.stripecdn.com/docs-statics-srv/assets/sfom-stripe-copy-wh-secret.6520c64215f84d4053a8bf9c927d8796.png) ## Konfigurationen mit Stripe OM Setup (Stripe OM-Einrichtung) abschließen Die Anweisungen in den folgenden Abschnitten beschreiben, wie Sie die Konfiguration Ihrer Integration abschließen. ### Stripe OMS-App mit Ihrem Stripe-Konto autorisieren Führen Sie in Ihrer Salesforce Order Management-Organisation den Stripe Setup Assistant aus, um Ihre Organisation mit Ihrem Stripe-Konto zu verbinden. 1. Klicken Sie auf den App Launcher und dann auf **View all** (Alle anzeigen). ![](https://b.stripecdn.com/docs-statics-srv/assets/sfom-launch-app-launcher.abb6c08a1cde704115918ebaddfe3ff4.png) 1. Klicken Sie auf ** Stripe OM Setup** (Stripe OM-Einrichtung). ![](https://b.stripecdn.com/docs-statics-srv/assets/sfom-launch-om-setup.d84d6c532e02356ab40073b2bec20f14.png) 1. Klicken Sie auf **Get Started** (Jetzt starten). 1. Live-Modus umschalten. Wir empfehlen, den Live-Modus deaktiviert zu lassen, um Ihre Stripe-Integration ohne Auswirkungen auf Ihre Live-Daten zu testen, und den Live-Modus zu aktivieren, wenn Sie bereit sind, mit der Verarbeitung echter Transaktionen mit dem Stripe-Zahlungs-Gateway zu beginnen. Gehen Sie zu diesem Schritt zurück und autorisieren Sie Ihre Verbindung erneut, um zwischen dem Test-Modus und dem Live-Modus zu wechseln. Wenn Sie sich im Live-Modus befinden und wieder in den Test-Modus wechseln möchten, müssen Sie sich nicht erneut autorisieren. 1. Klicken Sie auf **Authorize** (Autorisieren). ![](https://b.stripecdn.com/docs-statics-srv/assets/sfom-authorize.d4883cff2b90cce49e6054a05daa9079.png) So kann Salesforce auf Ihre Stripe-Daten zugreifen, um Zahlungen zu erfassen und zurückzuerstatten. Die Stripe-Website wird geöffnet, um den Autorisierungsvorgang abzuschließen. Möglicherweise müssen Sie hierfür Anmeldeinformationen eingeben oder Ihr Stripe-Konto aktivieren. Wenn Sie fertig sind, werden Sie auf diese Seite weitergeleitet, um den Einrichtungsvorgang abzuschließen. Nachdem die Autorisierung erfolgreich abgeschlossen wurde, wird die folgende Meldung angezeigt: ![](https://b.stripecdn.com/docs-statics-srv/assets/sfom-authorize-complete.8ff6523255d2652a3dacaa56304c0090.png) Speichern Sie das Webhook-Signaturgeheimnis für die asynchrone Zahlungsverarbeitung durch Stripe . ![](https://b.stripecdn.com/docs-statics-srv/assets/sfom-store-wh-secret.9918a70a19d3886755228a68102c1979.png) 1. Fügen Sie den Wert des Webhook-Signaturgeheimnisses unter **Signiergeheimnis** hinzu. 1. Klicken Sie auf **Update** (Aktualisieren). 1. Oben wird eine Meldung angezeigt, die das erfolgreiche Einfügen bestätigt. Klicken Sie auf **Fertigstellen**. ### Bestehende Abläufe der Auftragsverwaltung ändern Die Authentifizierung bei Stripe erfolgt über OAuth, wobei Stripe der OAuth-Anbieter ist. Salesforce unterstützt Stripe nicht als OAuth-Anbieter. Daher wird das OAuth-Token mithilfe einer nutzerdefinierten Integration über ein **getAccesToken** der aufrufbaren Aktion abgerufen. Dies ist im verwalteten Paket der Stripe OM-App enthalten. Identifizieren Sie den Ablauf, der die Zahlung oder Rückerstattung an Stripe initiiert, und fügen Sie die aufrufbare Methode **getAccessToken** in eine Aktion direkt vor der Aktion **Guthaben sicherstellen** in den Ablauf ein (wie im folgenden Beispiel gezeigt). Die zu ändernden Abläufe unterscheiden sich von dem im folgenden Beispiel dargestellten Ablauf. 1. Navigieren Sie zu **Setup > Prozessautomatisierung > Abläufe**. 1. Wählen Sie den aktiven **Ablauf** aus, den Sie zum Erfassen von Geldern verwenden möchten. 1. Erstellen Sie eine neue **Aktion**, die die aufrufbare Methode `getAccessToken` aufruft. ![](https://b.stripecdn.com/docs-statics-srv/assets/sfom-generate-token.4e707e9311288fd5e7f6e93a47dc638d.png) 1. Stellen Sie sicher, dass die Aktion **Zugriffs-Token erhalten** vor der Aktion **Gelder erfassen** erfolgt. Speichern Sie nach Abschluss des Vorgangs eine neue Version dieses **Ablaufs**, um sicherzustellen, dass in Ihren Prozesse die neue Version verwendet wird. ![](https://b.stripecdn.com/docs-statics-srv/assets/sfom-flowbuilder.22b239ea431eca499ef4cddd690ade94.png) 1. Sie sollten jetzt die Stripe-Zahlung als Zahlungsmethode in Ihrer Bestellverwaltung verwenden können. Sie können jetzt Bestellungen über die Salesforce B2C Commerce Cloud aufgeben und Transaktionen abschließen, z. B. das Erfassen und Erstatten von Transaktionen für Zahlungsmethoden, die mit Salesforce Commerce-Zahlungen verknüpft sind. ## Nächste Schritte - [Betrieb und Wartung](https://docs.stripe.com/use-stripe-apps/salesforce-order-management/operations-and-maintenance.md) - [Testen](https://docs.stripe.com/use-stripe-apps/salesforce-order-management/testing.md)