Documentation Experience Platform Guide des connecteurs sources

Stripe

Last update: Thu Sep 04 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Rubriques :

Créé pour :

Développeur

Des milliers d’entreprises de toutes tailles utilisent Stripe à la fois en ligne et en personne pour accepter les paiements, générer de nouvelles sources de revenus et se développer à l’échelle mondiale avec l’aide de Adobe Experience Platform, Adobe Commerce et Magento Open Source.

Utilisez la source de Stripe dans Experience Platform pour ingérer les données capturées par vos clients lors du flux d’achat. Une fois ingérées, utilisez ces données pour créer des offres personnalisées et déverrouiller des informations commerciales plus riches.

TIP

Pour toute question sur la source de Stripe sur Experience Platform, contactez Stripe à l’adresse adobe-partner@stripe.com.

recommendation-more-help

Exemple de cas d’utilisation pour la source de Stripe

Votre entreprise permet aux clients d'acheter des articles dans votre boutique en ligne avec la possibilité d'acheter maintenant et payer plus tard (à l'aide de Klarna, Afterpay, Affirm ou Zip).

Utilisez la source de données Stripe pour analyser l’utilisation des options acheter maintenant et payer plus tard et tester des offres personnalisées auprès de ces clients. Par exemple, pensez à recommander des articles de module complémentaire pour augmenter le nombre d’articles dans leur panier avant de passer en caisse.

style

shade-box

Lisez le document ci-dessous pour plus d’informations sur la configuration de votre compte source Stripe, la récupération des informations d’identification nécessaires et la création de vos schémas.

Conditions préalables prerequisites

Les sections suivantes apportent des informations sur la configuration requise avant de connecter votre compte Stripe à Experience Platform.

Récupérer votre jeton d’accès

Connectez-vous au Stripe tableau de bord en utilisant votre adresse e-mail Stripe et votre mot de passe.
Dans le tableau de bord de la Developers, sélectionnez API keys for developers.
Sous l’onglet Clés API, sélectionnez Reveal test key pour afficher votre jeton d’accès.
Vous pouvez désormais utiliser ce jeton comme jeton d’accès lors de la connexion de votre compte Stripe à Experience Platform, à l’aide de l’API Flow Service ou de l’interface utilisateur d’Experience Platform.

Collecter les informations d’identification requises

Pour connecter votre compte Stripe à Experience Platform, vous devez fournir des valeurs pour les informations d’authentification suivantes :

API

Vous devez fournir les informations d’identification suivantes lors de la connexion de votre compte Stripe à l’aide de l’API Flow Service.

table 0-row-2 1-row-2 2-row-2
Informations d’identification	Description
`accessToken`	Jeton d’authentification du code d’actualisation OAuth 2 Stripe.
`connectionSpec.id`	Identifiant de spécification de connexion de la source de Stripe. Cet identifiant est corrigé comme suit : `cc2c31d6-7b8c-4581-b49f-5c8698aa3ab3`.

Vous devez fournir les informations d’identification suivantes lors de la connexion de votre compte Stripe à l’aide de l’interface utilisateur d’Experience Platform.

table 0-row-2 1-row-2
Informations d’identification	Description
Jeton d’accès	Jeton d’authentification du code d’actualisation OAuth 2 Stripe.

Pour plus d’informations sur l’utilisation des API Stripe, consultez la Stripe documentation sur les clés API.

Créer un schéma de modèle de données d’expérience (XDM)

La source de Stripe prend en charge l’ingestion des données des chemins d’accès aux ressources suivants :

Frais
Abonnements
Remboursements
Transactions de solde
Clientes et clients
Prix

Vous devez créer un schéma XDM pour décrire un jeu de données, qui peut stocker les champs et les types de données qui seront envoyés de Stripe à Experience Platform.

Frais

En Stripe, les frais représentent des tentatives de transfert d’argent dans votre Stripe. Lisez le Stripe Guide de l’API sur les fraispour plus d’informations sur les attributs de frais spécifiques.

accordion

Sélectionnez pour afficher l’objet Stripe Charge

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

Dans Stripe, vous pouvez utiliser abonnements pour facturer un client sur une base récurrente. Lisez le guide Stripe API sur les abonnements pour plus d’informations sur les attributs d’abonnement spécifiques.

accordion

Sélectionnez pour afficher l’objet Abonnement Stripe .

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
}

Remboursements

En Stripe, vous pouvez utiliser remboursements pour rembourser des frais créés précédemment. Lisez le Stripe Guide de l’API sur les remboursements pour plus d’informations sur les attributs de remboursement spécifiques.

accordion

Sélectionnez cette option pour afficher l’objet Remboursement Stripe

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
}

Transactions de solde

En Stripe, les mouvements de solde représentent le mouvement de fonds entre vos comptes Stripe. Lisez le guide Stripe API sur les transactions de solde pour plus d'informations sur les attributs spécifiques des transactions de solde.

accordion

Sélectionnez cette option pour afficher l<>objet Transaction solde Stripe

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"
}

Clients

En Stripe, les clients représentent un client donné de votre entreprise. Pour plus d’informations sur les attributs spécifiques des clients, consultez le guide Stripe API relatif aux clients pour plus d’informations sur les attributs spécifiques des clients.

accordion

Sélectionner pour afficher l’objet client Stripe

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
}

Prix

En Stripe, les prix représentent le coût unitaire, la devise et le cycle de facturation facultatif pour les achats récurrents et uniques de produits. Lisez le guide Stripe API sur les prix pour plus d’informations sur les attributs de prix spécifiques.

accordion

Sélectionnez pour afficher l’objet Prix Stripe

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"
}

Liste autorisée d’adresses IP

Une liste d’adresses IP doit être ajoutée à une liste autorisée avant d’utiliser les connecteurs source. Si vous n’ajoutez pas vos adresses IP spécifiques à une région à votre liste autorisée, des erreurs ou une absence de performances peuvent se produire lors de l’utilisation de sources. Voir la page Liste autorisée d’adresses IP pour plus d’informations.

Configuration des autorisations sur Experience Platform

Pour connecter votre compte à Experience Platform les autorisations Afficher les sources et Gérer les sourcesStripe doivent être activées. Contactez votre administrateur de produit pour obtenir les autorisations nécessaires. Pour plus d’informations, consultez le guide de l’interface utilisateur du contrôle d’accès.

Étapes suivantes

Une fois la configuration requise terminée, vous pouvez procéder à la connexion et à l’ingestion de vos données Stripe vers Experience Platform. Lisez les guides suivants pour savoir comment ingérer des données de paiements Stripe vers Experience Platform à l’aide d’API ou de l’interface utilisateur :

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