Einrichten von Zahlungs-Gateways von Drittanbietern

Erste Einrichtung zum Konfigurieren des Zahlungs-Gateways von Drittanbietern

1. Erstellen Sie einen E-Commerce-Händleraccount im Zahlungs-Gateway des Drittanbieters, den Sie implementieren möchten.
   1. Melden Sie sich bei Ihrem Zahlungs-Gateway-Drittanbieter an und fügen Sie einen E-Commerce-Händleraccount hinzu.
   2. Navigieren Sie zum Abschnitt "Schlüsselverwaltung", "Entwickler" oder "Erweiterte Einstellungen" Ihrer ausgewählten Zahlungs-Gateway-Plattform und generieren Sie einen API-Schlüssel oder geheimen Schlüssel.

      Ihr API-Schlüssel sieht wie folgt aus: AQEvhmfxJ43HaxxHw0m/n3Q5qf3Ve4pBCIBMV3dVwyD4zesmTx/rk8/RZRz2w0bDdqMQwV1bDb7kfNy1WIxIIkxgBw==-C5bPe6tPCqOM35AEGroDa54J1Bl9AnsQKrDsDofVlrk=-i1ibf$Hu2v>8jR:Y9nU hinzu.

   3. Notieren Sie sich den Händleraccount-Benutzernamen und den API-Schlüssel. Sie müssen die Anmeldeinformationen mit Namen erstellen.
2. Erstellen Sie Apex-Klassen für Ihr Zahlungs-Gateway in Ihrer Salesforce-Organisation.
   1. Rufen Sie die Details zur Adapterklasse von Ihrem Zahlungs-Gateway-Anbieter oder AppExchange ab.
      Informationen zum Erstellen und Einrichten von Zahlungs-Gateway-Adaptern finden Sie unter Zahlungs-Gateway-Adapter. Informationen zum Definieren Ihrer Apex Klassen finden Sie unter Namespace für Commerce-Zahlungen.
   2. Speichern Sie Ihre Apex Klassen. Notieren Sie sich den Adapternamen, wie Sie ihn zum Erstellen Ihres Zahlungs-Gateway-Anbieters benötigen.
3. Erstellen Sie Anmeldeinformationen mit Namen der alten Art in Ihrer Salesforce-Organisation, um Authentifizierungsparameter und den URL Ihres Apex Callout-Endpunkts anzugeben.
   1. Geben Sie einen benutzerfreundlichen Namen für die Bezeichnung und einen eindeutigen Kennzeichner für den Namen an.
   2. Geben Sie den URL Ihres Drittanbieter-Zahlungs-Gateways ein.
   3. Wählen Sie Benannter Prinzipal als Identitätstyp und Kennwortauthentifizierung als Authentifizierungsprotokoll aus.
   4. Verwenden Sie den Benutzernamen Ihres Händleraccounts als Benutzernamen. Verwenden Sie den API-Schlüssel als Kennwort, wie von Ihrem Zahlungs-Gateway-Anbieter gefordert.
   5. Speichern Sie die Anmeldeinformationen mit Namen so, wie Sie sie zum Erstellen Ihres Zahlungs-Gateways benötigen.
4. Registrieren Sie Ihre Drittanbieter-Zahlungs-Gateway-Site in Ihrer Salesforce-Organisation, um sicherzustellen, dass Apex Callouts von der Organisation an die Zahlungs-Gateway-Site erfolgreich sind.
   1. Geben Sie einen Namen und einen URL Ihres Drittanbieter-Zahlungs-Gateways ein.
   2. Markieren Sie die Site als aktiv und speichern Sie Ihre Änderungen.
5. Fügen Sie Ihren Drittanbieter-Zahlungs-Gateway-URL als vertrauenswürdigen URL in Ihrer Salesforce-Organisation hinzu.
   1. Geben Sie einen API-Namen ein.
   2. Geben Sie den URL Ihres Drittanbieter-Zahlungs-Gateways ein.
   3. Markieren Sie den URL als aktiv und speichern Sie Ihre Änderungen.
6. Aktivieren und einrichten Sie Ihre Salesforce-Site, damit Sie Zahlungsbenachrichtigungen über Ihr Drittanbieter-Gateway senden und empfangen können.
   1. Geben Sie eine Bezeichnung, einen Namen und eine Startseite für Ihre Site ein.
   2. Legen Sie die Einstellungen für den öffentlichen Zugriff der Site auf "Gastzugriff auf die Zahlungs-API" fest.
   3. Speichern Sie Ihre Site-Details.

Konfigurieren von Benachrichtigungseinstellungen für Ihr Zahlungs-Gateway von Drittanbietern

Das Zahlungs-Gateway verwendet einen Webhook, um Benachrichtigungen an Ihren Zahlungs-Gateway-Adapter zu senden. Ein Webhook ist eine Kombination aus Ihrem Site-Endpunkt und der ID des Zahlungs-Gateway-Anbieters. Erstellen Sie einen Webhook, indem Sie in den Standardeinstellungen für den Benachrichtigungstransport Ihres Zahlungs-Gateways einen URL angeben.

1. Verwenden Sie diesen URL als Endpunkt Ihrer Site und ersetzen Sie MyDomainName durch die Domäne und den URL Ihrer Site. Beispiel:
   https://MyDomainName.my.salesforce-sites.com/solutions/services/data/v65.0/commerce/payments/notify
2. Suchen Sie die ID Ihres Zahlungs-Gateway-Anbieters und hängen Sie den ?provider=ID-Abfrageparameter an den Endpunkt an. Beispiel: https://MyDomainName.my.salesforce-sites.com/solutions/services/data/v65.0/commerce/payments/notify?provider=0cJR00000004CEhMAM
3. Geben Sie den Webhook in die Standardbenachrichtigungseinstellungen Ihres Drittanbieter-Zahlungs-Gateways ein.

Konfigurieren von Zahlungs-Gateway-Anbieter und Zahlungs-Gateway

Fügen Sie einen Zahlungs-Gateway-Anbieter hinzu, nachdem Sie Ihren Händleraccount, Ihre Adapterklassen und Ihre Salesforce-Site eingerichtet haben. Fügen Sie dann ein Zahlungs-Gateway für den Zahlungs-Gateway-Anbieter hinzu.

1. Geben Sie unter "Setup" im Feld "Schnellsuche" den Text Abrechnung ein und wählen Sie dann unter "Geführte Einrichtung" die Option Schritt 7: Zahlungskonfigurationen aus.
2. Erweitern Sie den Schritt "Drittanbieter-Zahlungs-Gateways konfigurieren", klicken Sie auf Zahlungs-Gateways konfigurieren und dann auf Konfigurieren.
   

   Hinweis

   Für Salesforce-Organisationen, die in der Version Winter '26 erstellt wurden, ist die Schaltfläche "Zahlungs-Gateways konfigurieren" in Schritt 7: Zahlungskonfigurationen der geführten Einrichtung "Rechnungsstellung" standardmäßig verfügbar, wodurch Benutzer zur Registerkarte "Zahlungs-Gateway-Konfiguration" umgeleitet werden. Für Salesforce-Organisationen, die vor der Version Winter '26 erstellt wurden, ist die Registerkarte "Zahlungs-Gateway-Konfiguration" standardmäßig nicht verfügbar. Ändern Sie die Einstellungen der Registerkarte "Zahlungs-Gateway-Konfiguration" zu "Standard: Ein", um dieses Problem zu beheben.

3. Füllen Sie diese Felder aus, um einen Zahlungs-Gateway-Anbieter zu erstellen.
   1. Geben Sie einen eindeutigen Namen und eine Bezeichnung für Ihren Zahlungs-Gateway-Anbieter ein.
   2. Wählen Sie in der Dropdown-Liste die Apex-Adapterklasse aus.
   3. Geben Sie Ihre erforderliche Unterstützung für Idempotenz an. Weitere Details finden Sie unter Idempotenzrichtlinien.
   4. Speichern Sie die Details des Zahlungs-Gateway-Anbieters.
4. Füllen Sie diese Felder aus, um ein Zahlungs-Gateway hinzuzufügen.
   1. Geben Sie einen eindeutigen Namen für Ihr Zahlungs-Gateway ein.
   2. Wählen Sie in der Dropdown-Liste einen Zahlungs-Gateway-Anbieter aus.
   3. Wählen Sie eine Anmeldeinformation mit Namen aus der Dropdown-Liste aus.
   4. Markieren Sie den Status Ihres Zahlungs-Gateways als "Aktiv".
   5. Speichern Sie die Details des Zahlungs-Gateways.

   Wenn Sie bereits über einen vorhandenen Zahlungs-Gateway-Anbieter verfügen, wählen Sie unter "Geführte Einrichtung" die Option Schritt 7: Zahlungskonfigurationen aus, erweitern Sie den Schritt "Zahlungs-Gateways konfigurieren" und klicken Sie auf Zahlungs-Gateways konfigurieren. Klicken Sie auf der Seite "Konfiguration des Zahlungs-Gateways" auf Zahlungs-Gateways und dann auf Neu. Die Konfigurationsschritte sind dieselben.

Hinzufügen mehrerer Zahlungsweisen

Konfigurieren Sie die Unterstützung für Zahlungsmethoden wie "Automated Clearing House" (ACH), "Single Euro Payments Area" (SEPA), "Automated Clearing Services" (BACS) und "Bulk Electronic Clearing System" (BECS) in Ihrem Drittanbieter-Zahlungs-Gateway. Sie können Zahlungen verarbeiten, Rückerstattungen ausstellen und diese gespeicherten Zahlungsweisen auf der Registerkarte "Gespeicherte Zahlungsweisen" Ihres Abrechnungsprofils anzeigen.

• Wenn Sie Bankzahlungsmethoden wie ACH, SEPA, BACS und BECS hinzufügen möchten, verwenden Sie die API tokenizePaymentMethod und legen Sie die Eigenschaft bankType im Objekt "bankPaymentMethod" auf Ihre ausgewählte Bankzahlungsweise fest.
• Wenn Sie Kartenzahlungsmethoden wie Kreditkarte oder Debitkarte hinzufügen möchten, verwenden Sie die API tokenizePaymentMethod und legen Sie die Eigenschaft cardCategory im Objekt "cardPaymentMethod" fest.