Documentatie Experience Platform Gids voor Source Connectors

[Beta]{class="badge informative"}

Stripe

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

Onderwerpen:

Gemaakt voor:

Ontwikkelaar

NOTE

De bron Stripe is in bèta. Gelieve te lezen het overzicht van bronnenvoor meer informatie bij het gebruiken van bèta-geëtiketteerde bronnen.

Duizenden bedrijven van elke omvang gebruiken Stripe zowel online als persoonlijk om betalingen te accepteren, nieuwe inkomstenbronnen te genereren en wereldwijd uit te breiden met behulp van Adobe Experience Platform, Adobe Commerce en Magento Open Source .

Gebruik de Stripe -bron in Experience Platform om gegevens in te voeren die tijdens de aanschafstroom door uw klanten zijn vastgelegd. Zodra geconsumeerd, gebruik deze gegevens om gepersonaliseerde aanbiedingen tot stand te brengen en rijkere bedrijfsinzichten te ontgrendelen.

TIP

Voor vragen over de Stripe bron op Experience Platform neemt u contact op met Stripe op adobe-partnership @stripe.com.

recommendation-more-help

het gebruiksgeval van de Steekproef voor de Stripe bron

Uw zaken staat klanten toe om punten op uw online opslag met de optie te kopen nu en te betalen later (gebruikend Klarna, Afterpay, Affirm, of Zip).

Gebruik de Stripe gegevensbron om het gebruik van te analyseren kopen nu en betaal later opties en met gepersonaliseerde aanbiedingen aan deze klanten experimenteren. Denk bijvoorbeeld aan het aanbevelen van add-on-items om het aantal artikelen in hun winkelwagentje uit te breiden voordat je het winkelwagentje afhandelt.

style

shade-box

Lees het onderstaande document voor informatie over hoe u uw Stripe bronaccount kunt instellen, de vereiste gegevens kunt ophalen en uw schema's kunt maken.

Vereisten prerequisites

In de volgende secties vindt u informatie over de vereiste instellingen die u moet voltooien voordat u uw Stripe -account kunt verbinden met het Experience Platform.

Uw toegangstoken ophalen

Login aan het Stripe dashboardgebruikend uw Stripe e-mailadres en wachtwoord.
Selecteer API keys for developers in het dashboard van Developers .
Onder de API sleutels tabel, uitgezochte Reveal test key om uw toegangstoken te openbaren.
U kunt dit token nu gebruiken als toegangstoken wanneer u uw Stripe -account aansluit op een Experience Platform met behulp van de Flow Service API of de gebruikersinterface van het Experience Platform.

Vereiste referenties verzamelen

Als u uw Stripe -account wilt verbinden met een Experience Platform, moet u waarden opgeven voor de volgende verificatiereferenties:

API

U moet de volgende referenties opgeven wanneer u een verbinding maakt met uw Stripe -account met de Flow Service API.

table 0-row-2 1-row-2 2-row-2
Credentials	Beschrijving
`accessToken`	Uw token voor Stripe OAuth 2-verificatie van code vernieuwen.
`connectionSpec.id`	De verbindingsspecificatie-id van de Stripe -bron. Deze id is vast als: `cc2c31d6-7b8c-4581-b49f-5c8698aa3ab3`.

U moet de volgende referenties opgeven wanneer u een verbinding maakt met uw Stripe -account via de gebruikersinterface van het Experience Platform.

table 0-row-2 1-row-2
Credentials	Beschrijving
Toegangstoken	Uw token voor Stripe OAuth 2-verificatie van code vernieuwen.

Voor meer informatie bij het gebruiken van Stripe APIs, lees de Stripe documentatie over API sleutels.

Een XDM-schema (Experience Data Model) maken

De Stripe -bron ondersteunt het opnemen van gegevens van de volgende bronpaden:

Heffingen
Lidmaatschappen
Restituties
Transacties balanceren
Klanten
Prijzen

U moet een XDM-schema maken om een dataset te beschrijven, die de velden en gegevenstypen kan opslaan die van Stripe naar Experience Platform worden verzonden.

Heffingen

In Stripe, laden vertegenwoordigen pogingen om geld in uw Stripe te bewegen. Lees de Stripe API gids op lastenvoor meer informatie over specifieke ladingsattributen.

accordion

Selecteren om het object Stripe laden weer te geven

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
}

Abonnementen

In Stripe, kunt u abonnementen gebruiken om een klant op een terugkomende basis te laden. Lees de Stripe API gids op abonnementenvoor meer informatie over specifieke abonnementattributen.

accordion

Selecteren om het Stripe Subscription-object weer te geven

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
}

Terugbetalingen

In Stripe, kunt u terugbetalingen gebruiken om een eerder gecreeerde last terug te betalen. Lees de Stripe API gids over terugbetalingenvoor meer informatie over specifieke terugbetalingsattributen.

accordion

Selecteren om het object Stripe terugbetalen weer te geven

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
}

Transacties van het Saldo

In Stripe, balanstransacties vertegenwoordigen de beweging van middelen tussen uw Stripe rekeningen. Lees de Stripe API gids op saldotransactiesvoor meer informatie over specifieke attributen van de saldotransactie.

accordion

Selecteren om het Transactie-object Stripe balanceren weer te geven

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

Klanten

In Stripe, klanten vertegenwoordigen een bepaalde klant van uw zaken. Voor informatie over specifieke klantenattributen, lees de Stripe API gids over klantenvoor meer informatie over specifieke klantenattributen.

accordion

Selecteren om het Stripe Customer object te bekijken

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
}

Prijzen

In Stripe, prijzen vertegenwoordigen de eenheidskosten, de munt, en de facultatieve factureringscyclus voor zowel terugkomende als eenmalige aankoop van producten. Lees de Stripe API gids op prijzenvoor meer informatie over specifieke prijsattributen.

accordion

Selecteren om het Stripe Price-object weer te geven

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 adres lijst van gewenste personen

Een lijst van IP adressen moet aan een lijst van gewenste personen worden toegevoegd alvorens met bronschakelaars te werken. Het niet toevoegen van uw regio-specifieke IP adressen aan uw lijst van gewenste personen kan tot fouten of niet-prestaties leiden wanneer het gebruiken van bronnen. Zie de 🔗 pagina van de lijst van gewenste personen van het 0} IP adres {voor meer informatie.

Machtigingen configureren voor Experience Platform

U moet zowel View Sources als Manage Sources machtigingen hebben ingeschakeld voor uw account om uw Stripe -account aan Experience Platform te kunnen koppelen. Neem contact op met de productbeheerder om de benodigde machtigingen te verkrijgen. Voor meer informatie, lees de gids UI van de toegangscontrole.

Volgende stappen

Nadat u aan de voorwaarde hebt voldaan, kunt u doorgaan met het maken van een verbinding en het invoeren van de Stripe -gegevens naar het Experience Platform. Lees de volgende handleidingen om te leren hoe u Stripe -betalingsgegevens aan Experience Platform kunt toevoegen met behulp van API's of de gebruikersinterface:

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