Den Stripe Payment Connector von Commercetools installieren und konfigurieren

Installieren und konfigurieren Sie den Connector über den Connect-Marktplatz in Ihrer Commercetools-Storefront.

Vor der Installation des Stripe Payment Connectors:

Identifizieren Sie die Organisation und das Projekt in Ihrer Commercetools-Instanz, in der Sie den Connector installieren möchten.
Bereiten Sie sich darauf vor, den Connector direkt von Ihrer Commercetools-Instanz aus zu konfigurieren und zu installieren.

Stripe Payment Connector installieren

Wählen Sie den Stripe Payment Connector im Commercetools Connect-Marktplatz innerhalb Ihrer Commercetools-Instanz aus.
Connector-Liste in der Commercetools-Projektansicht
Wählen Sie die gewünschte Region, das/die Projekt(e) und die Organisation aus, um den Connector zu installieren.
Projektkonfiguration für Commercetools
Geben Sie Ihre Konfigurationsdaten und Umgebungsinformationen ein
Umgebungsvariablen und Connector-Konfiguration
Erstellen Sie im Stripe-Dashboard einen Webhook mit einer Test-Transaktions-URL und stellen Sie sicher, dass Sie den Webhook-Geheimschlüssel für Signatur kopieren.
Diese Test-Translations-URL wird automatisch über ein Post-Deploy-Skript des Payment Connector mit der korrekten URL aktualisiert.

Stripe Payment Connector konfigurieren

CTP_PROJECT_KEY: Der Schlüssel des Commercetools Composable Commerce-Projekts.
CTP_SCOPE: Der Geltungsbereich schränkt die Endpoints ein, auf die der Commercetools-Client Zugriff hat, sowie das Lese- und Schreibzugriffsrecht auf einen Endpoint.
CTP_AUTH_URL: Die URL für die Authentifizierung in der Commercetools-Plattform. Sie wird verwendet, um ein OAuth 2.0-Token zu generieren, das in jedem API-Aufruf an Commercetools Composable Commerce erforderlich ist. Der Standardwert ist: https://auth.europewest1.gcp.commercetools.com.
CTP_API_URL: Die URL für die zusammensetzbare Commerce API von Commercetools. Der Standardwert ist: https://api.europe-west1.gcp.commercetools.com.
CTP_SESSION_URL: Die URL für die Sitzungserstellung in der Commercetools-Plattform. Connectors sind auf die erstellte Sitzung angewiesen, um Informationen zwischen Enabler und Prozessor austauschen zu können.verlassen sich auf die erstellte Sitzung, um Informationen zwischen Enabler und Abwickler austauschen zu können. Der Standardwert ist: https://session.europewest1.gcp.commercetools.com.
CTP_JWKS_URL: Die URL, die JSON Web Key Set zur Verfügung stellt.
CTP_JWT_ISSUER: Der Aussteller innerhalb des JSON Web Token, der im JWT-Validierungsvorgang erforderlich ist.
STRIPE_CAPTURE_METHOD: Die Stripe-Erfassungsmethode (manuell oder automatisch). Der Standardwert ist: automatic.
STRIPE_APPEARANCE_PAYMENT_ELEMENT: Stripe Elements unterstützt die visuelle Anpassung, mit der Sie das Design Ihrer Website an die Erscheinungsbild-Option anpassen können. Dieser Wert definiert das spezifische Erscheinungsbild der Komponente Payment Element.
STRIPE_APPEARANCE_EXPRESS_CHECKOUT: Stripe Elements unterstützt visuelle Anpassungen, mit denen Sie das Design Ihrer Website an die Erscheinungsbild-Option anpassen können. Dieser Wert hat das spezifische Erscheinungsbild der Komponente Express Checkout Element.
CTP_CLIENT_SECRET: Das Client-Geheimnis des Commercetools Composable Commerce-Nutzerkontos. Es wird im Commercetools-Client verwendet, um mit Commercetools Composable Commerce über das SDK zu kommunizieren.
CTP_CLIENT_ID: Die Client-ID Ihres Commercetools-Composable-Commerce-Nutzerkontos. Sie wird im Commercetools-Client verwendet, um mit Commercetools Composable Commerce über SDK zu kommunizieren.
STRIPE_SECRET_KEY: Stripe authentifiziert Ihre API-Anfragen mithilfe der API-Schlüssel Ihres Kontos. Es wird dringend empfohlen, hierfür einen Schlüssel mit eingeschränktem Zugriff zu erstellen und nicht den Standard-API-Geheimschlüssel zu verwenden
STRIPE_WEBHOOK_ID: Eindeutige Kennung von Stripe für Webhook-Endpoints.
STRIPE_WEBHOOK_SIGNING_SECRET: Der Geheimschlüssel von Stripe zur Überprüfung von Webhook-Signaturen unter Verwendung der offiziellen Bibliotheken. Dieser Schlüssel wird im Stripe-Dashboard erstellt.

Der Payment Connector erstellt zwei Hauptlinks:

Payment Connector JS Enabler-Komponente: Die URL, in die die Zahlungskomponenten eingebettet sind (zum Beispiel https://assets-{{uuid}}.assets.uscentral1.gcp.preview.commercetools.app/connector-enabler.es.js)
Payment Connector-Abwickler: Die URL, an die alle Webhooks gesendet und in Zahlungstransaktionen in Commercetools umgewandelt werden (zum Beispiel: https://service-{{uuid}}.uscentral1.gcp.preview.commercetools.app)

Zahlungsintegration erweitern

Wenn Sie die bestehende Zahlungsintegration aufbauen und erweitern möchten, um Ihre spezifischen Anforderungen zu erfüllen:

Verwenden Sie die auf GitHub verfügbare Connector-Codebasis.
Stellen Sie den Connector lokal bereit.
Aktualisieren Sie die .env-Konfiguration sowohl im Prozessor als auch im Enabler.

Wenn Sie diesen Pfad wählen, sind Sie für die Bereitstellung und Konfiguration des Connectors verantwortlich.

Allgemeine Einstellungen

Sie können den Erfassungsmodus von Komponenten, die vom Payment Connector Enabler generiert wurden, in der Payment Connentor-Konfiguration ändern (manuell oder automatisch).
Der Payment Connector Enabler verwaltet die mit dem Payment Connector-Abwickler verbundenen Zahlungskomponenten.
Der Payment Connector-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 der Komponenten Stripe Payment Element und Express Checkout Element über die Payment Connector-Konfiguration ändern.

Webhooks

Stripe verwendet Webhooks, um Ihre Anwendung zu benachrichtigen, wenn ein Ereignis in Ihrem Konto auftritt. 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.

Wir unterstützen die folgenden Webhooks:

charge.succeeded: Wenn die Zahlung nicht erfasst wurde, erstellen Sie eine neue Zahlung in Commercetools. Wenn die Zahlung getätigt wird, fügen Sie dieser die Transaktion „Authorization:Success“ hinzu
payment_intent.succeeded: Es gibt zwei Möglichkeiten, dieses Ereignis zu handhaben:
- Automatische Erfassungsmethode: Wenn paymentIntent.capture_method „automatisch“ ist, erstellen Sie eine neue Zahlung in Commercetools und fügen Sie dieser dann die Transaktion „Charge:Success“ hinzu.
- Manuelle Erfassungsmethode: Wenn paymentIntent.capture_method „manuell“ ist, fügen Sie die Transaktion „Charge:Success“ der Zahlung in Commercetools hinzu.
charge.refunded: Wenn charge.captured„true“ ist, fügen Sie die Transaktion „Refund:Success“ der Zahlung in Commercetools hinzu.
payment_intent.canceled: Fügen Sie die Transaktion „CancelAuthorization:Success“ der Zahlung in Commercetools hinzu.
payment_intent.payment_failed: Protokolliert die Informationen in der Connector-App in den Abwicklerprotokollen.
payment_intent.requires_action: Protokolliert die Informationen in der Connector-App in den Abwicklerprotokollen.