Dokumentation Experience Platform Anleitung zu Quell-Connectoren

[Beta]{class="badge informative"}

Stripe

Last update: Tue Dec 31 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Themen:

Erstellt für:

Entwickler

NOTE

Die Stripe-Quelle befindet sich in der Beta-Phase. Weitere Informationen zur Verwendung von Betagekennzeichneten Quellen finden Sie„Quellen - Übersicht“.

Tausende von Unternehmen aller Größenordnungen nutzen Stripe sowohl online als auch persönlich, um Zahlungen zu akzeptieren, neue Umsatzquellen zu erschließen und mithilfe von Adobe Experience Platform, Adobe Commerce und Magento Open Source global zu expandieren.

Verwenden Sie die Stripe in Experience Platform , um Daten aufzunehmen, die während des Kaufablaufs von Ihren Kunden erfasst werden. Verwenden Sie diese Daten nach der Aufnahme, um personalisierte Angebote zu erstellen und umfassendere geschäftliche Einblicke zu erschließen.

TIP

Bei Fragen zur Stripe auf Experience Platform wenden Sie sich an Stripe unter adobe-Partnership@stripe.com.

recommendation-more-help

Anwendungsbeispiel für die Stripe-Quelle

Ihr Unternehmen ermöglicht es Kunden, Artikel in Ihrem Online-Shop zu kaufen mit der Option jetzt kaufen und später bezahlen (mit Klarna, Afterpay, Affirm oder Zip).

Verwenden Sie die Stripe Datenquelle, um die Verwendung von Optionen Jetzt kaufen und Später bezahlen zu analysieren und mit personalisierten Angeboten für diese Kunden zu experimentieren. Erwägen Sie zum Beispiel, Add-on-Artikel zu empfehlen, um die Anzahl der Artikel in ihrem Warenkorb vor dem Checkout zu erweitern.

style

shade-box

Lesen Sie das folgende Dokument, um Informationen darüber zu erhalten, wie Sie Ihr Stripe-Quellkonto einrichten, die erforderlichen Anmeldeinformationen abrufen und Ihre Schemata erstellen können.

Voraussetzungen prerequisites

In den folgenden Abschnitten finden Sie Informationen zur erforderlichen Einrichtung, die Sie vor dem Verbinden Ihres Stripe-Kontos mit Experience Platform durchführen müssen.

Abrufen Ihres Zugriffs-Tokens

Melden Sie sich mit Ihrer Stripe EStripe Mail-Adresse und Ihrem Passwort beimDashboard“ an.
Wählen Sie im Developers-Dashboard API keys for developers aus.
Wählen Sie auf Registerkarte API-Schlüssel“ die Option Reveal test key aus, um Ihr Zugriffs-Token anzuzeigen.
Sie können dieses Token jetzt als Zugriffstoken verwenden, wenn Sie Ihr Stripe-Konto mit Experience Platform verbinden, entweder mithilfe der Flow Service-API oder der Experience Platform-Benutzeroberfläche.

Sammeln erforderlicher Anmeldedaten

Um Ihr Stripe-Konto mit Experience Platform zu verbinden, müssen Sie Werte für die folgenden Authentifizierungsdaten angeben:

API

Sie müssen die folgenden Anmeldeinformationen angeben, wenn Sie Ihr Stripe-Konto mit der Flow Service-API verbinden.

table 0-row-2 1-row-2 2-row-2
Anmeldedaten	Beschreibung
`accessToken`	Ihr Stripe OAuth 2-Authentifizierungstoken für aktualisierten Code.
`connectionSpec.id`	Die Verbindungsspezifikations-ID der Stripe. Diese ID lautet: `cc2c31d6-7b8c-4581-b49f-5c8698aa3ab3`.

Sie müssen die folgenden Anmeldeinformationen angeben, wenn Sie Ihr Stripe-Konto über die Experience Platform-Benutzeroberfläche verbinden.

table 0-row-2 1-row-2
Anmeldedaten	Beschreibung
Zugriffs-Token	Ihr Stripe OAuth 2-Authentifizierungstoken für aktualisierten Code.

Weitere Informationen zur Verwendung Stripe APIs finden Sie in der Stripe Dokumentation zu API-Schlüsseln.

Erstellen eines Experience-Datenmodell (XDM)-Schemas

Die Stripe-Quelle unterstützt die Aufnahme von Daten aus den folgenden Ressourcenpfaden:

Kosten
Abonnements
Erstattungen
Saldotransaktionen
Kundinnen und Kunden
Preise

Sie müssen ein XDM-Schema erstellen, um einen Datensatz zu beschreiben, in dem die Felder und Datentypen gespeichert werden können, die von Stripe an Experience Platform gesendet werden.

Kosten

In Stripe stellen Gebühren Versuche dar, Geld in Ihre Stripe zu verschieben. Weitere Informationen zu bestimmten Stripe finden SieAPI-Handbuch zu Gebühren .

accordion

Auswählen, um das Stripe-Ladeobjekt anzuzeigen

code language-json

{
  "id": "ch_3MmlLrLkdIwHu7ix0snN0B15",
  "object": "charge",
  "amount": 1099,
  "amount_captured": 1099,
  "amount_refunded": 0,
  "application": null,
  "application_fee": null,
  "application_fee_amount": null,
  "balance_transaction": "txn_3MmlLrLkdIwHu7ix0uke3Ezy",
  "billing_details": {
    "address": {
      "city": null,
      "country": null,
      "line1": null,
      "line2": null,
      "postal_code": null,
      "state": null
    },
    "email": null,
    "name": null,
    "phone": null
  },
  "calculated_statement_descriptor": "Stripe",
  "captured": true,
  "created": 1679090539,
  "currency": "usd",
  "customer": null,
  "description": null,
  "disputed": false,
  "failure_balance_transaction": null,
  "failure_code": null,
  "failure_message": null,
  "fraud_details": {},
  "invoice": null,
  "livemode": false,
  "metadata": {},
  "on_behalf_of": null,
  "outcome": {
    "network_status": "approved_by_network",
    "reason": null,
    "risk_level": "normal",
    "risk_score": 32,
    "seller_message": "Payment complete.",
    "type": "authorized"
  },
  "paid": true,
  "payment_intent": null,
  "payment_method": "card_1MmlLrLkdIwHu7ixIJwEWSNR",
  "payment_method_details": {
    "card": {
      "brand": "visa",
      "checks": {
        "address_line1_check": null,
        "address_postal_code_check": null,
        "cvc_check": null
      },
      "country": "US",
      "exp_month": 3,
      "exp_year": 2024,
      "fingerprint": "mToisGZ01V71BCos",
      "funding": "credit",
      "installments": null,
      "last4": "4242",
      "mandate": null,
      "network": "visa",
      "three_d_secure": null,
      "wallet": null
    },
    "type": "card"
  },
  "receipt_email": null,
  "receipt_number": null,
  "receipt_url": "https://pay.stripe.com/receipts/payment/CAcaFwoVYWNjdF8xTTJKVGtMa2RJd0h1N2l4KOvG06AGMgZfBXyr1aw6LBa9vaaSRWU96d8qBwz9z2J_CObiV_H2-e8RezSK_sw0KISesp4czsOUlVKY",
  "refunded": false,
  "review": null,
  "shipping": null,
  "source_transfer": null,
  "statement_descriptor": null,
  "statement_descriptor_suffix": null,
  "status": "succeeded",
  "transfer_data": null,
  "transfer_group": null
}

Abonnements

In Stripe können Sie Abonnements verwenden, um wiederkehrend eine Kundin oder einen Kunden zu berechnen. Weitere Informationen zu Stripe Abonnementattributen findenim API-Handbuch Abonnements .

accordion

Auswählen, um das Stripe-Abonnementobjekt anzuzeigen

code language-json

{
  "id": "sub_1MowQVLkdIwHu7ixeRlqHVzs",
  "object": "subscription",
  "application": null,
  "application_fee_percent": null,
  "automatic_tax": {
    "enabled": false,
    "liability": null
  },
  "billing_cycle_anchor": 1679609767,
  "billing_thresholds": null,
  "cancel_at": null,
  "cancel_at_period_end": false,
  "canceled_at": null,
  "cancellation_details": {
    "comment": null,
    "feedback": null,
    "reason": null
  },
  "collection_method": "charge_automatically",
  "created": 1679609767,
  "currency": "usd",
  "current_period_end": 1682288167,
  "current_period_start": 1679609767,
  "customer": "cus_Na6dX7aXxi11N4",
  "days_until_due": null,
  "default_payment_method": null,
  "default_source": null,
  "default_tax_rates": [],
  "description": null,
  "discount": null,
  "ended_at": null,
  "invoice_settings": {
    "issuer": {
      "type": "self"
    }
  },
  "items": {
    "object": "list",
    "data": [
      {
        "id": "si_Na6dzxczY5fwHx",
        "object": "subscription_item",
        "billing_thresholds": null,
        "created": 1679609768,
        "metadata": {},
        "plan": {
          "id": "price_1MowQULkdIwHu7ixraBm864M",
          "object": "plan",
          "active": true,
          "aggregate_usage": null,
          "amount": 1000,
          "amount_decimal": "1000",
          "billing_scheme": "per_unit",
          "created": 1679609766,
          "currency": "usd",
          "interval": "month",
          "interval_count": 1,
          "livemode": false,
          "metadata": {},
          "nickname": null,
          "product": "prod_Na6dGcTsmU0I4R",
          "tiers_mode": null,
          "transform_usage": null,
          "trial_period_days": null,
          "usage_type": "licensed"
        },
        "price": {
          "id": "price_1MowQULkdIwHu7ixraBm864M",
          "object": "price",
          "active": true,
          "billing_scheme": "per_unit",
          "created": 1679609766,
          "currency": "usd",
          "custom_unit_amount": null,
          "livemode": false,
          "lookup_key": null,
          "metadata": {},
          "nickname": null,
          "product": "prod_Na6dGcTsmU0I4R",
          "recurring": {
            "aggregate_usage": null,
            "interval": "month",
            "interval_count": 1,
            "trial_period_days": null,
            "usage_type": "licensed"
          },
          "tax_behavior": "unspecified",
          "tiers_mode": null,
          "transform_quantity": null,
          "type": "recurring",
          "unit_amount": 1000,
          "unit_amount_decimal": "1000"
        },
        "quantity": 1,
        "subscription": "sub_1MowQVLkdIwHu7ixeRlqHVzs",
        "tax_rates": []
      }
    ],
    "has_more": false,
    "total_count": 1,
    "url": "/v1/subscription_items?subscription=sub_1MowQVLkdIwHu7ixeRlqHVzs"
  },
  "latest_invoice": "in_1MowQWLkdIwHu7ixuzkSPfKd",
  "livemode": false,
  "metadata": {},
  "next_pending_invoice_item_invoice": null,
  "on_behalf_of": null,
  "pause_collection": null,
  "payment_settings": {
    "payment_method_options": null,
    "payment_method_types": null,
    "save_default_payment_method": "off"
  },
  "pending_invoice_item_interval": null,
  "pending_setup_intent": null,
  "pending_update": null,
  "quantity": 1,
  "schedule": null,
  "start_date": 1679609767,
  "status": "active",
  "test_clock": null,
  "transfer_data": null,
  "trial_end": null,
  "trial_settings": {
    "end_behavior": {
      "missing_payment_method": "create_invoice"
    }
  },
  "trial_start": null
}

Erstattungen

In Stripe können Sie "" verwenden um eine zuvor erstellte Gebühr zurückzuerstatten. Lesen Sie das Stripe API-Handbuch zu Rückerstattungen für weitere Informationen zu bestimmten Rückerstattungsattributen.

accordion

Auswählen, um das Stripe-Rückerstattungsobjekt anzuzeigen

code language-json

{
  "id": "re_1Nispe2eZvKYlo2Cd31jOCgZ",
  "object": "refund",
  "amount": 1000,
  "balance_transaction": "txn_1Nispe2eZvKYlo2CYezqFhEx",
  "charge": "ch_1NirD82eZvKYlo2CIvbtLWuY",
  "created": 1692942318,
  "currency": "usd",
  "destination_details": {
    "card": {
      "reference": "123456789012",
      "reference_status": "available",
      "reference_type": "acquirer_reference_number",
      "type": "refund"
    },
    "type": "card"
  },
  "metadata": {},
  "payment_intent": "pi_1GszsK2eZvKYlo2CfhZyoZLp",
  "reason": null,
  "receipt_number": null,
  "source_transfer_reversal": null,
  "status": "succeeded",
  "transfer_reversal": null
}

Saldotransaktionen

Stripe stellen Saldotransaktionen die Geldbewegung zwischen Ihren Stripe dar. Weitere Stripe zu bestimmten Saldotransaktionsattributen findenim API-Handbuch zu Saldotransaktionen .

accordion

Wählen Sie diese Option, um das Stripe-Saldo-Transaktionsobjekt anzuzeigen.

code language-json

{
  "id": "txn_1MiN3gLkdIwHu7ixxapQrznl",
  "object": "balance_transaction",
  "amount": -400,
  "available_on": 1678043844,
  "created": 1678043844,
  "currency": "usd",
  "description": null,
  "exchange_rate": null,
  "fee": 0,
  "fee_details": [],
  "net": -400,
  "reporting_category": "transfer",
  "source": "tr_1MiN3gLkdIwHu7ixNCZvFdgA",
  "status": "available",
  "type": "transfer"
}

Kunden

In Stripe repräsentieren Kunden einen bestimmten Kunden Ihres Unternehmens. Informationen zu bestimmten Kundenattributen finden Sie im Stripe API-Handbuch für Kunden für weitere Informationen zu bestimmten Kundenattributen.

accordion

Auswählen, um das Stripe-Kundenobjekt anzuzeigen

code language-json

{
  "id": "cus_NffrFeUfNV2Hib",
  "object": "customer",
  "address": null,
  "balance": 0,
  "created": 1680893993,
  "currency": null,
  "default_source": null,
  "delinquent": false,
  "description": null,
  "discount": null,
  "email": "jennyrosen@example.com",
  "invoice_prefix": "0759376C",
  "invoice_settings": {
    "custom_fields": null,
    "default_payment_method": null,
    "footer": null,
    "rendering_options": null
  },
  "livemode": false,
  "metadata": {},
  "name": "Jenny Rosen",
  "next_invoice_sequence": 1,
  "phone": null,
  "preferred_locales": [],
  "shipping": null,
  "tax_exempt": "none",
  "test_clock": null
}

Preise

Stripe stellen Preise die Stückkosten, die Währung und den optionalen Abrechnungszyklus sowohl für wiederkehrende als auch für einmalige Käufe von Produkten dar. Weitere Informationen zu Stripe Preisattributen findenim „API-Handbuch Preise“.

accordion

Auswählen, um das Stripe-Preisobjekt anzuzeigen

code language-json

{
  "id": "price_1MoBy5LkdIwHu7ixZhnattbh",
  "object": "price",
  "active": true,
  "billing_scheme": "per_unit",
  "created": 1679431181,
  "currency": "usd",
  "custom_unit_amount": null,
  "livemode": false,
  "lookup_key": null,
  "metadata": {},
  "nickname": null,
  "product": "prod_NZKdYqrwEYx6iK",
  "recurring": {
    "aggregate_usage": null,
    "interval": "month",
    "interval_count": 1,
    "trial_period_days": null,
    "usage_type": "licensed"
  },
  "tax_behavior": "unspecified",
  "tiers_mode": null,
  "transform_quantity": null,
  "type": "recurring",
  "unit_amount": 1000,
  "unit_amount_decimal": "1000"
}

IP-Adressen-Zulassungsliste

Vor der Arbeit mit Quell-Connectoren muss einer Zulassungsliste eine Liste von IP-Adressen hinzugefügt werden. Wenn Sie Ihre regionsspezifischen IP-Adressen nicht zu Ihrer Zulassungsliste hinzufügen, kann dies bei der Verwendung von Quellen zu Fehlern oder Performance-Einbußen führen. Weitere Information finden Sie unter IP-Adressen-Zulassungsliste.

Konfigurieren von Berechtigungen auf Experience Platform

Sie müssen sowohl Quellen anzeigen als auch Quellen verwalten für Ihr Konto aktiviert haben, um Ihr Stripe-Konto mit Experience Platform zu verbinden. Wenden Sie sich an Ihren Produktadministrator, um die erforderlichen Berechtigungen zu erhalten. Weitere Informationen finden Sie im Handbuch zur Benutzeroberfläche der Zugriffssteuerung.

Nächste Schritte

Nachdem Sie die erforderliche Einrichtung abgeschlossen haben, können Sie fortfahren, eine Verbindung herzustellen und Ihre Stripe Daten auf Experience Platform aufzunehmen. Lesen Sie die folgenden Handbücher, um zu erfahren, wie Sie Stripe Zahlungsdaten mithilfe von APIs oder der Benutzeroberfläche auf Experience Platform aufnehmen:

337b99bb-92fb-42ae-b6b7-c7042161d089