Dokumentation Experience Platform Anleitung zu Quell-Connectoren

[Beta]{class="badge informative"}

Stripe

Last update: Tue Mar 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Themen:
Sources

Erstellt für:

Developer

NOTE

Die Stripe-Quelle befindet sich in der Beta-Phase. Bitte lesen Sie die Quellen - Übersicht für weitere Informationen zur Verwendung von Beta-beschrifteten Quellen.

Tausende von Unternehmen jeder Größe nutzen Stripe sowohl online als auch persönlich, um Zahlungen zu akzeptieren, neue Einnahmequellen zu generieren und mithilfe von Adobe Experience Platform, Adobe Commerce und Magento Open Source.

Verwenden Sie die Stripe -Quelle in Experience Platform verwenden, um Daten zu erfassen, die während des Kaufvorgangs von Ihren Kunden erfasst wurden. Verwenden Sie nach der Erfassung diese Daten, um personalisierte Angebote zu erstellen und umfassendere geschäftliche Einblicke zu gewinnen.

TIP

Bei Fragen zu Stripe Quelle auf Experience Platform, Kontakt Stripe bei adobe-Partnership@stripe.com

recommendation-more-help

Anwendungsbeispiel für die Stripe source

Ihr Unternehmen ermöglicht es Kunden, Artikel in Ihrem Onlineshop zu erwerben, mit der Möglichkeit, Jetzt kaufen und Später bezahlen (mithilfe von Klarna, Afterpay, Affirmoder Zip).

Verwenden Sie die Stripe Datenquelle zur Analyse der Verwendung von Jetzt kaufen und Später bezahlen Optionen und experimentieren Sie mit personalisierten Angeboten für diese Kunden. Erwägen Sie beispielsweise die Empfehlung von Zusatzartikeln, um die Anzahl der Artikel in ihrem Warenkorb vor dem Checkout zu erhöhen.

style

shade-box

Weitere Informationen zur Einrichtung der Stripe -Quellkonto, rufen Sie die erforderlichen Anmeldeinformationen ab und erstellen Sie Ihre Schemas.

Voraussetzungen prerequisites

In den folgenden Abschnitten finden Sie Informationen zur erforderlichen Einrichtung, die Sie vor dem Herstellen einer Verbindung durchführen müssen Stripe -Konto auf Experience Platform.

Zugriffstoken abrufen

Melden Sie sich bei Stripe Dashboard mit Stripe E-Mail-Adresse und Passwort.
Im Developers Dashboard, auswählen API keys for developers.
Unter dem API-Schlüssel Registerkarte auswählen Reveal test key , um Ihr Zugriffstoken anzuzeigen.
Sie können dieses Token jetzt als Zugriffstoken beim Verbinden Ihrer Stripe -Konto zu Experience Platform verwenden, indem Sie entweder Flow Service API oder der Experience Platform-Benutzeroberfläche.

Sammeln erforderlicher Anmeldeinformationen

Um Ihre Stripe -Konto auf Experience Platform angegeben haben, müssen Sie Werte für die folgenden Authentifizierungsberechtigungen angeben:

API

Sie müssen beim Verbinden Ihrer Stripe -Konto, das Flow Service API.

table 0-row-2 1-row-2 2-row-2
Anmeldedaten	Beschreibung
`accessToken`	Ihre Stripe OAuth 2 Authentifizierungstoken für Code aktualisieren.
`connectionSpec.id`	Die Verbindungsspezifikations-ID der Stripe -Quelle. Diese ID wurde wie folgt festgelegt: `cc2c31d6-7b8c-4581-b49f-5c8698aa3ab3`.

Benutzeroberfläche

Sie müssen beim Verbinden Ihrer Stripe -Konto über die Experience Platform-Benutzeroberfläche.

table 0-row-2 1-row-2
Anmeldedaten	Beschreibung
Zugriffstoken	Ihre Stripe OAuth 2 Authentifizierungstoken für Code aktualisieren.

Weitere Informationen zur Verwendung Stripe APIs, lesen Sie die Stripe Dokumentation zu API-Schlüsseln.

Erstellen eines Experience-Datenmodell (XDM)-Schemas

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

Gebühren
Abonnements
Erstattungen
Bilanztransaktionen
Kunden
Preise

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

Gebühren

In Stripe, charges Versuche darstellen, Geld in Ihre Stripe. Lesen Sie die Stripe API-Handbuch zu Gebühren für weitere Informationen über bestimmte Gebührenattribute.

accordion

Auswählen zum Anzeigen des Stripe Charge-Objekts

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 subscriptions um einen Kunden regelmäßig zu belasten. Lesen Sie die Stripe API-Handbuch zu Abonnements für weitere Informationen zu bestimmten Abonnementattributen.

accordion

Auswählen zum Anzeigen des Stripe-Abonnementobjekts

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 Erstattungen um eine zuvor erstellte Gebühr zurückzuerstatten. Lesen Sie die Stripe API-Handbuch zu Erstattungen für weitere Informationen zu bestimmten Erstattungsattributen.

accordion

Auswählen zum Anzeigen des Stripe-Rückerstattungsobjekts

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
}

Bilanztransaktionen

In Stripe, Bilanztransaktionen den Geldverkehr zwischen Ihren Stripe Konten. Lesen Sie die Stripe API-Handbuch zu Bilanztransaktionen für weitere Informationen zu spezifischen Bilanzkreisattributen.

accordion

Auswählen, um das Stripe Balance-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, Kunden einen bestimmten Kunden Ihres Unternehmens repräsentieren. Informationen zu bestimmten Kundenattributen finden Sie im Abschnitt Stripe API-Handbuch für Kunden für weitere Informationen zu bestimmten Kundenattributen.

accordion

Auswählen zum Anzeigen des Stripe-Kundenobjekts

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

In Stripe, Preise stellen die Stückkosten, die Währung und den optionalen Abrechnungszyklus für den wiederkehrenden und einmaligen Kauf von Produkten dar. Lesen Sie die Stripe API-Leitfaden zu Preisen für weitere Informationen über bestimmte Preisattribute.

accordion

Auswählen zum Anzeigen des Stripe Price-Objekts

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.

Berechtigungen auf Experience Platform konfigurieren

Sie müssen beide Quellen anzeigen und Quellen verwalten für Ihr Konto aktivierte Berechtigungen, um Ihre Stripe -Konto auf Experience Platform. Wenden Sie sich an Ihren Produktadministrator, um die erforderlichen Berechtigungen zu erhalten. Weitere Informationen finden Sie im Abschnitt UI-Handbuch zur Zugriffskontrolle.

Nächste Schritte

Nachdem Sie die erforderliche Einrichtung abgeschlossen haben, können Sie mit der Herstellung der Verbindung fortfahren und Ihre Stripe Daten an Experience Platform. In den folgenden Handbüchern erfahren Sie, wie Sie die Aufnahme vornehmen Stripe Daten über APIs oder die Benutzeroberfläche an Experience Platform übergeben:

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