Installieren und konfigurieren Sie den Stripe Payment Connector für Commercetools Checkout

Erfahren Sie, wie Sie Ihr Commercetools Merchant Center einrichten, um den Checkout Connector zu installieren.

Integrate Stripe payments with the Commercetools Checkout, which provides a pre-built checkout UI for secure payments.

Eintrag des Checkout Connectors im Commercetools Merchant Center

Bevor Sie loslegen

Before you install the app:

Geben Sie Ihre Stripe-Kontoinformationen ein, um die Verbindung herzustellen.
Identify the organization and project in your Commercetools instance where you want to install the app.
Aktivieren Sie Commercetools Checkout im Composable Commerce-Projekt.
Prepare to install and configure the app directly from your Commercetools instance.

Install the app

Wählen Sie im Connect-Marktplatz in Ihrer Commercetools-Instanz die Option Zahlung für Stripe Payment for Checkout aus.
On the Commercetools configuration page, select the region, organization, and projects in which to install the app.
Geben Sie als Nächstes Ihre Umgebungsvariablen und Konfigurationsdetails an.
Klicken Sie auf der Konfigurationsseite von Commercetools Checkout auf Zahlungen hinzufügen, um Zahlungsmethoden zu aktivieren.
Führen Sie auf der Seite Zahlungen hinzufügen Folgendes aus:
- For Payment app, select Stripe Payment for Checkout.
- Geben Sie unter Drop-in-Zahlungsintegrationsname den anzuzeigenden Integrationsnamen ein.
- Geben Sie für den Zahlungsintegrationsschlüssel einen Schlüssel zwischen 2 und 256 alphanumerischen Zeichen, Unterstrichen und Bindestrichen ein.
- Schalten Sie den Status um, um ihn zu aktivieren.

Configure the Stripe Payment app

Use the following installation variables to configure the app.

Variable	Beschreibung
`CTP_API_URL`	Die URL für die Commercetools Composable Commerce API. Der Standardwert ist `https://api.europe-west1.gcp.commercetools.com`.
`CTP_AUTH_URL`	Die URL für die Authentifizierung in der Commercetools-Plattform, die zum Generieren eines OAuth 2.0-Tokens verwendet wird. Jeder API Aufruf des Commercetools Composable Commerce erfordert ein OAuth 2.0-Token. Der Standardwert ist `https://auth.europewest1.gcp.commercetools.com`.
`CTP_CLIENT_ID`	Die Client-ID des Commercetools-Composable-Commerce-Benutzerkontos. Der Commercetools-Client verwendet die Client-ID, um über das SDK mit dem Commercetools Composable Commerce zu kommunizieren.
`CTP_CLIENT_SECRET`	Das Client-Geheimnis des Commercetools-Composable-Commerce-Benutzerkontos. Der Commercetools-Client verwendet das Client-Geheimnis, um über das SDK mit dem Commercetools Composable Commerce zu kommunizieren.
`CTP_JWKS_URL`	Die URL, die den JSON Web-Schlüsselsatz bereitstellt.
`CTP_JWT_ISSUER`	Der Aussteller im JSON Web-Token, das für den JWT-Validierungsprozess erforderlich ist.
`CTP_PROJECT_KEY`	Der Schlüssel für das Commercetools-Composable-Commerce-Projekt.
`CTP_SCOPE`	Der Anwendungsbereich definiert, auf welche Endpoints der Commercetools-Client zugreifen kann und Lese- und Schreibzugriff hat.
`CTP_SESSION_URL`	Die URL für die Erstellung einer Sitzung in der Commercetools-Plattform. Connectors verwenden die erstellte Sitzung, um Informationen zwischen dem Enabler und dem Prozessor auszutauschen. Der Standardwert ist `https://session.europewest1.gcp.commercetools.com`.
`STRIPE_APPEARANCE_EXPRESS_CHECKOUT`	Stripe Elements unterstützt die visuelle Anpassung, sodass Sie die Erscheinungsbildoption an das Design Ihrer Website anpassen können. Dieser Wert definiert das Erscheinungsbild des Express Checkout Elements.
`STRIPE_APPEARANCE_PAYMENT_ELEMENT`	Stripe Elements unterstützt die visuelle Anpassung, sodass Sie die Erscheinungsbildoption an das Design Ihrer Website anpassen können. Dieser Wert definiert das Erscheinungsbild des Payment Element.
`STRIPE_CAPTURE_METHOD`	Die Stripe-Erfassungsmethode (manuell oder automatisch). Der Standardwert ist `automatic`.
`STRIPE_SECRET_KEY`	Stripe authentifiziert API-Anfragen mithilfe der API Schlüssel Ihres Kontos. Wir empfehlen, einen eingeschränkten Zugriffsschlüssel zu erstellen, statt den geheimen Standardschlüssel für die API zu verwenden.
`STRIPE_WEBHOOK_ID`	Die eindeutige Stripe-Kennung für Webhook-Endpoints.
`STRIPE_WEBHOOK_SIGNING_SECRET`	Der Stripe-Geheimschlüssel, der von offiziellen Bibliotheken zum Verifizieren von Webhook-Signaturen verwendet wird. Dieser Schlüssel wird im Stripe-Dashboard erstellt.

Allgemeine Einstellungen

Sie können den Erfassungsmodus (manuell oder automatisch) von Komponenten, die vom Payment Connector Enabler generiert werden, in der Connector-Konfiguration ändern. Der Enabler verwaltet die Zahlungskomponenten, die mit dem Zahlungsabwickler verbunden sind. Der Abwickler erstellt den Payment Intent in Stripe mit den entsprechenden Metadaten und wandelt Webhook-Ereignisse in Zahlungstransaktionen in Commercetools um.

Sie können das Erscheinungsbild des Payment Element und des Stripe Express Checkout Element über die Konfiguration des Stripe Payment Connector ändern.

Webhooks

Stripe verwendet Webhooks, um Ihre Anwendung zu benachrichtigen, wenn ein Ereignis in Ihrem Konto stattfindet. Webhooks sind nützlich, um Zahlungstransaktionen zu aktualisieren, wenn die Bank eines Kunden/einer Kundin eine Zahlung bestätigt oder ablehnt oder wenn die Zahlung storniert oder zurückerstattet wird.

Stripe unterstützt die folgenden Webhooks:

Ereignistyp	Beschreibung
`charge.refunded`	Wenn `charge.captured` „true“ ist, fügen Sie der Zahlung eine `Refund:Success`-Transaktion in Commercetools hinzu.
`charge.succeeded`	Wenn die Zahlung nicht erfasst wurde, erstellen Sie eine Zahlung in Commercetools. Wenn die Zahlung erfolgt ist, fügen Sie der Zahlung eine `Authorization:Success`-Transaktion in Commercetools hinzu.
`payment_intent.canceled`	Fügen Sie der Zahlung in Commercetools eine `CancelAuthorization:Success`-Transaktion hinzu.
`payment_intent.payment_failed`	Protokolliert die Informationen in den Prozessorprotokollen in der Connector-App.
`payment_intent.requires_action`	Protokolliert die Informationen in den Prozessorprotokollen in der Connector-App.
`payment_intent.succeeded`	Sie können dieses Ereignis mit einer der folgenden Erfassungsmethoden handhaben: Automatisch: Wenn `paymentIntent.capture_method` automatisch ist, erstellen Sie eine Zahlung in Commercetools und fügen Sie dieser eine `Charge:Success`-Transaktion hinzu. Manuell: Wenn `paymentIntent.capture_method` manuell ist, fügen Sie der Zahlung eine `Charge:Success`-Transaktion in Commercetools hinzu.

Änderungsprotokoll und Zugriff auf Code

Sie können Änderungen und Upgrades am Connector über das Github-Repository überwachen.