Documentazione Experience Platform Guida ai connettori di origini

[Beta]{class="badge informative"}

Stripe

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:

Creato per:

Sviluppatore

NOTE

L'origine Stripe è in versione beta. Per ulteriori informazioni sull'utilizzo di origini con etichetta beta, leggere la panoramica delle origini.

Migliaia di aziende di tutte le dimensioni utilizzano Stripe sia online che di persona per accettare pagamenti, generare nuove fonti di reddito ed espandersi a livello globale con l'aiuto di Adobe Experience Platform, Adobe Commerce e Magento Open Source.

Utilizza l'origine Stripe in Experience Platform per acquisire i dati acquisiti dai tuoi clienti durante il flusso di acquisto. Una volta acquisiti, utilizza questi dati per creare offerte personalizzate e sbloccare informazioni aziendali più approfondite.

TIP

Per domande sull'origine Stripe nell'Experience Platform, contattare Stripe all'indirizzo adobe-partnership@stripe.com.

recommendation-more-help

Caso d'uso di esempio per l'origine Stripe

La tua azienda consente ai clienti di acquistare oggetti nel tuo negozio online con l'opzione di acquistare adesso e pagare più tardi (utilizzando Klarna, Afterpay, Affirm o Zip).

Utilizza l'origine dati Stripe per analizzare l'utilizzo delle opzioni acquista ora e paga più tardi e sperimentare offerte personalizzate per questi clienti. Ad esempio, si consiglia di aggiungere articoli per espandere il numero di articoli nel carrello prima del pagamento.

style

shade-box

Per informazioni su come configurare l'account di origine Stripe, recuperare le credenziali necessarie e creare gli schemi, leggere il documento seguente.

Prerequisiti prerequisites

Nelle sezioni seguenti vengono fornite informazioni sulla configurazione dei prerequisiti che è necessario completare prima di collegare l'account Stripe all'Experience Platform.

Recuperare il token di accesso

Accedi al Stripe dashboard utilizzando l'indirizzo e-mail e la password di Stripe.
Nel dashboard Developers, selezionare API keys for developers.
Nella scheda Chiavi API, seleziona Reveal test key per visualizzare il token di accesso.
È ora possibile utilizzare questo token come token di accesso quando si connette l'account Stripe a Experience Platform, utilizzando l'API Flow Service o l'interfaccia utente di Experience Platform.

Raccogli le credenziali richieste

Per connettere l'account Stripe a Experience Platform, è necessario fornire i valori per le credenziali di autenticazione seguenti:

API

È necessario fornire le credenziali seguenti quando si connette l'account Stripe utilizzando l'API Flow Service.

table 0-row-2 1-row-2 2-row-2
Credenziali	Descrizione
`accessToken`	Token di autenticazione del codice di aggiornamento di Stripe OAuth 2.
`connectionSpec.id`	ID della specifica di connessione dell'origine Stripe. Questo ID è corretto come: `cc2c31d6-7b8c-4581-b49f-5c8698aa3ab3`.

Interfaccia utente

È necessario fornire le credenziali seguenti quando si connette l'account Stripe tramite l'interfaccia utente di Experience Platform.

table 0-row-2 1-row-2
Credenziali	Descrizione
Token di accesso	Token di autenticazione del codice di aggiornamento di Stripe OAuth 2.

Per ulteriori informazioni sull'utilizzo delle API Stripe, leggere la Stripe documentazione sulle chiavi API.

Creare uno schema Experience Data Model (XDM)

L'origine Stripe supporta l'acquisizione di dati dai percorsi di risorse seguenti:

Spese
Abbonamenti
Rimborsi
Transazioni saldo
Clienti
Prezzi

È necessario creare uno schema XDM per descrivere un set di dati, che può memorizzare i campi e i tipi di dati che verranno inviati da Stripe all'Experience Platform.

Spese

In Stripe, gli addebiti rappresentano i tentativi di trasferire denaro in Stripe. Per ulteriori informazioni sugli attributi di addebito specifici, leggere la Stripe guida API per le tariffe.

accordion

Selezionare per visualizzare l<>oggetto Stripe addebito

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
}

Abbonamenti

In Stripe, puoi utilizzare abbonamenti per addebitare un cliente su base periodica. Per ulteriori informazioni sugli attributi di sottoscrizione specifici, consulta la Stripe guida API sulle sottoscrizioni.

accordion

Selezionare questa opzione per visualizzare l<>oggetto Stripe sottoscrizione

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
}

Rimborsi

In Stripe, puoi utilizzare rimborsi per rimborsare un addebito creato in precedenza. Per ulteriori informazioni sugli attributi di rimborso specifici, consulta la Stripe guida API sui rimborsi.

accordion

Selezionare per visualizzare l<>oggetto Stripe rimborso

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
}

Transazioni saldo

In Stripe, transazioni saldo rappresentano il movimento di fondi tra i tuoi account Stripe. Per ulteriori informazioni sugli attributi specifici delle transazioni saldo, leggere la Stripe guida API sulle transazioni saldo.

accordion

Selezionare questa opzione per visualizzare l<>oggetto transazione saldo 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"
}

Clienti

In Stripe, clienti rappresentano un determinato cliente della tua azienda. Per informazioni su attributi cliente specifici, leggere la Stripe guida API sui clienti per ulteriori informazioni su attributi cliente specifici.

accordion

Selezionare questa opzione per visualizzare l<>oggetto Stripe cliente

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
}

Prezzi

In Stripe, i prezzi rappresentano il costo unitario, la valuta e il ciclo di fatturazione facoltativo per l'acquisto di prodotti sia ricorrente che occasionale. Per ulteriori informazioni sugli attributi di prezzo specifici, consulta la Stripe guida API sui prezzi.

accordion

Selezionare per visualizzare l<>oggetto Prezzo 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"
}

ELENCO CONSENTITI di indirizzo IP

Prima di utilizzare i connettori di origine, è necessario aggiungere un elenco di indirizzi IP a un elenco consentiti. La mancata aggiunta all’elenco consentiti degli indirizzi IP specifici per l’area geografica potrebbe causare errori o prestazioni non ottimali durante l’utilizzo delle origini. Per ulteriori informazioni, vedere la pagina elenco consentiti indirizzo IP.

Configurare le autorizzazioni su Experience Platform

Per connettere l'account Stripe all'Experience Platform, è necessario avere entrambe le autorizzazioni Visualizza origini e Gestisci origini abilitate per il proprio account. Contatta l’amministratore del prodotto per ottenere le autorizzazioni necessarie. Per ulteriori informazioni, leggere la guida all'interfaccia utente per il controllo degli accessi.

Passaggi successivi

Dopo aver completato la configurazione dei prerequisiti, puoi procedere con la connessione e acquisire i dati di Stripe per Experience Platform. Leggi le seguenti guide per scoprire come acquisire i dati dei pagamenti Stripe per Experience Platform utilizzando le API o l'interfaccia utente:

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