Documentation Experience Platform Guide des connecteurs sources

[Version Beta]{class="badge informative"}

Stripe

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

Rubriques :
Sources

Créé pour :

Développeur

NOTE

La source Stripe est en version Beta. Veuillez lire la présentation des sources pour plus d’informations sur l’utilisation de sources étiquetées bêta.

Des milliers d'entreprises de toutes tailles utilisent Stripe en ligne et en personne pour accepter des paiements, générer de nouvelles sources de revenus et s’étendre à l’ensemble du monde grâce à Adobe Experience Platform, Adobe Commerce et Magento Open Source.

Utilisez la variable Stripe source dans Experience Platform pour ingérer les données capturées pendant le flux d’achat par vos clients. 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 variable Stripe source sur Experience Platform, contact Stripe chez adobe-partenariat@stripe.com.

recommendation-more-help

Exemple de cas d’utilisation pour la fonction Stripe source

Votre entreprise permet aux clients d’acheter des articles sur votre boutique en ligne avec la possibilité de acheter maintenant et payer ultérieurement (en utilisant Klarna, Afterpay, Affirm, ou Zip).

Utilisez la variable Stripe source de données pour analyser l’utilisation de acheter maintenant et payer ultérieurement et expérimenter des offres personnalisées à ces clients. Par exemple, pensez à recommander des éléments supplémentaires pour augmenter le nombre d’articles dans leur panier avant le passage en caisse.

style

shade-box

Pour plus d’informations sur la configuration de votre Stripe source, récupérez les informations d’identification nécessaires et créez vos schémas.

Conditions préalables prerequisites

Les sections suivantes fournissent des informations sur la configuration prérequise que vous devez effectuer avant de vous connecter à votre Stripe compte à Experience Platform.

Récupération de votre jeton d’accès

Connectez-vous au Stripe tableau de bord en utilisant votre Stripe adresse électronique et mot de passe.
Dans le Developers tableau de bord, sélectionnez API keys for developers.
Sous , Clés API onglet, 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 Stripe à l’Experience Platform, à l’aide de l’option Flow Service API ou l’interface utilisateur Experience Platform.

Collecter les informations d’identification requises

Pour connecter votre Stripe pour 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 Stripe à l’aide du Flow Service API.

table 0-row-2 1-row-2 2-row-2
Informations d’identification	Description
`accessToken`	Votre Stripe Jeton d’authentification OAuth 2 Refresh Code.
`connectionSpec.id`	L’identifiant de spécification de connexion de Stripe source. Ce problème d’identifiant a été corrigé comme suit : `cc2c31d6-7b8c-4581-b49f-5c8698aa3ab3`.

Interface utilisateur

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

table 0-row-2 1-row-2
Informations d’identification	Description
Jeton d’accès	Votre Stripe Jeton d’authentification OAuth 2 Refresh Code.

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

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

La variable Stripe source prend en charge l’ingestion de données à partir des chemins de ressources suivants :

Frais
Abonnements
Remboursement
Transactions de solde
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 à partir de . Stripe à Experience Platform.

Frais

Dans Stripe, charges représente les tentatives de transfert d’argent dans votre Stripe. Lisez la section Stripe Guide de l’API sur les frais pour plus d’informations sur les attributs de frais spécifiques.

accordion

Sélectionnez cette option pour afficher l’objet Charge du Stripe

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 subscriptions pour facturer un client de manière récurrente. Lisez la section Stripe Guide API sur les abonnements pour plus d’informations sur des attributs d’abonnement spécifiques.

accordion

Sélectionner pour afficher l’objet d’abonnement du 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
}

Remboursement

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

accordion

Sélectionner pour afficher l’objet de remboursement du 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

Dans Stripe, transactions du solde représente les mouvements de fonds entre vos Stripe comptes. Lisez la section Stripe Guide de l’API sur les transactions de solde pour plus d’informations sur des attributs de transaction de solde spécifiques.

accordion

Sélectionnez cette option pour afficher l’objet Transaction du solde du 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

Dans Stripe, clients représente un client donné de votre entreprise. Pour plus d’informations sur les attributs du client spécifiques, consultez la section Stripe Guide de l’API sur les clients pour plus d’informations sur des attributs de client spécifiques.

accordion

Sélectionner pour afficher l’objet client du 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

Dans Stripe, 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 la section Stripe Guide de l’API sur les prix pour plus d’informations sur des attributs de prix spécifiques.

accordion

Sélectionner pour afficher l’objet Prix du 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

Vous devez disposer des deux Afficher les sources et Gérer les sources autorisations activées pour votre compte afin de connecter Stripe compte à Experience Platform. Contactez votre administrateur de produit pour obtenir les autorisations nécessaires. Pour plus d’informations, consultez la section guide de l’interface utilisateur du contrôle d’accès.

Étapes suivantes

Une fois la configuration de prérequis terminée, vous pouvez vous connecter et ingérer votre Stripe données à Experience Platform. Lisez les guides suivants pour savoir comment ingérer Stripe paiement des données à l’Experience Platform à l’aide d’API ou de l’interface utilisateur :

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