Beta
Stripe
Creato per:
- Sviluppatore
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.
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.
Per informazioni su come configurare l'account di origine Stripe, recuperare le credenziali necessarie e creare gli schemi, leggere il documento seguente.
Prerequisiti
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:
È necessario fornire le credenziali seguenti quando si connette l'account Stripe utilizzando l'API Flow Service.
accessToken
connectionSpec.id
cc2c31d6-7b8c-4581-b49f-5c8698aa3ab3
.È necessario fornire le credenziali seguenti quando si connette l'account Stripe tramite l'interfaccia utente di Experience Platform.
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.
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.
{
"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
}
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.
{
"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
}
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.
{
"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
}
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.
{
"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"
}
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.
{
"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
}
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.
{
"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: