[Beta]{class="badge informative"}

Stripe

NOTE
The Stripe källan är i betaversion. Läs källöversikt om du vill ha mer information om hur du använder betamärkta källor.

Tusentals företag av alla storlekar använder Stripe både online och personligen för att ta emot betalningar, generera nya inkomstkällor och utöka globalt med hjälp av Adobe Experience Platform, Adobe Commerce och Magento Open Source.

Använd Stripe i Experience Platform för att importera data som era kunder tagit in under inköpsflödet. Använd dessa data när de har importerats för att skapa personaliserade erbjudanden och få bättre affärsinsikter.

TIP
För frågor om Stripe källa på Experience Platform, kontakta Stripe på adobe-partnerskap@stripe.com.
recommendation-more-help

Exempel på användning för Stripe källa

Med ditt företag kan kunderna köpa artiklar i din onlinebutik med möjlighet att köp nu och betala senare (med Klarna, Afterpay, Affirm, eller Zip).

Använd Stripe datakälla för att analysera användningen av köp nu och betala senare alternativ och experimentera med personaliserade erbjudanden till dessa kunder. Överväg till exempel att rekommendera tilläggsobjekt för att utöka antalet artiklar i kundvagnen före utcheckning.

Läs dokumentet nedan för information om hur du kan konfigurera Stripe källkonto, hämta nödvändiga inloggningsuppgifter och skapa dina scheman.

Förutsättningar prerequisites

I följande avsnitt finns information om den nödvändiga konfiguration som du måste slutföra innan du kan ansluta Stripe konto till Experience Platform.

Hämta din åtkomsttoken

  • Logga in på Stripe kontrollpanel med Stripe e-postadress och lösenord.
  • I Developers kontrollpanel, välja API keys for developers.
  • Under API-nycklar flik, välja Reveal test key för att visa din åtkomsttoken.
  • Du kan nu använda denna token som din åtkomsttoken när du ansluter din Stripe konto till Experience Platform, med Flow Service API för användargränssnittet i Experience Platform.

Samla in nödvändiga inloggningsuppgifter

För att kunna ansluta Stripe konto till Experience Platform måste du ange värden för följande autentiseringsuppgifter:

API

Du måste ange följande autentiseringsuppgifter när du ansluter Stripe kontot med Flow Service API.

table 0-row-2 1-row-2 2-row-2
Autentiseringsuppgifter Beskrivning
accessToken Dina Stripe Autentiseringstoken för OAuth 2-uppdateringskod.
connectionSpec.id Anslutningens spec-ID Stripe källa. Detta ID är fast som: cc2c31d6-7b8c-4581-b49f-5c8698aa3ab3.
UI

Du måste ange följande autentiseringsuppgifter när du ansluter Stripe med användargränssnittet i Experience Platform.

table 0-row-2 1-row-2
Autentiseringsuppgifter Beskrivning
Åtkomsttoken Dina Stripe Autentiseringstoken för OAuth 2-uppdateringskod.

Mer information om hur du använder Stripe API:er, läs Stripe dokumentation om API-nycklar.

Skapa ett XDM-schema (Experience Data Model)

The Stripe Källan stöder inmatning av data från följande resurssökvägar:

  • Avgifter
  • Prenumerationer
  • Återbetalningar
  • Saldotransaktioner
  • Kunder
  • Priser

Du måste skapa ett XDM-schema för att beskriva en datauppsättning, som kan lagra fält och datatyper som ska skickas från Stripe till Experience Platform.

Avgifter

I Stripe, avgifter representerar försök att flytta pengar till Stripe. Läs Stripe API-guide för avgifter för mer information om specifika avgiftsattribut.

accordion
Markera om du vill visa Stripe Charge-objektet
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
}
Prenumerationer

I Stripekan du använda prenumerationer att regelbundet debitera en kund. Läs Stripe API-guide för prenumerationer för mer information om specifika prenumerationsattribut.

accordion
Markera för att visa prenumerationsobjektet för 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
}
Återbetalningar

I Stripekan du använda återbetalningar för att återbetala en tidigare skapad avgift. Läs Stripe API-guide för återbetalningar för mer information om specifika återbetalningsattribut.

accordion
Markera för att visa Stripe-objektet för återanvändning
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
}
Saldotransaktioner

I Stripe, saldotransaktioner representerar rörelsen av medel mellan Stripe konton. Läs Stripe API-guide för saldotransaktioner för mer information om specifika attribut för saldotransaktioner.

accordion
Markera för att visa transaktionsobjektet för saldo i 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"
}
Kunder

I Stripe, kunder representerar en viss kund i ditt företag. Mer information om specifika kundattribut finns i Stripe API-guide för kunder för mer information om specifika kundattribut.

accordion
Markera för att visa kundobjektet 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
}
Priser

I Stripe, priser representerar enhetskostnad, valuta och valfri faktureringscykel för både återkommande och engångsköp av produkter. Läs Stripe API-guide om priser för mer information om specifika prisattribut.

accordion
Markera för att visa Stripe-prisobjektet
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-adress tillåtelselista

En lista med IP-adresser måste läggas till tillåtelselista innan du kan arbeta med källanslutningar. Om du inte lägger till dina regionspecifika IP-adresser i tillåtelselista kan det leda till fel eller sämre prestanda när du använder källor. Se IP-adress tillåtelselista sida för mer information.

Konfigurera behörigheter i Experience Platform

Du måste ha båda View Sources och Manage Sources behörigheter för ditt konto för att ansluta Stripe konto till Experience Platform. Kontakta produktadministratören för att få den behörighet som krävs. Mer information finns i gränssnittsguide för åtkomstkontroll.

Nästa steg

När du är klar med konfigurationen av ditt krav kan du fortsätta ansluta och importera dina Stripe data till Experience Platform. Läs följande handböcker för att lära dig hur man importerar Stripe Betalar data till Experience Platform med API:er eller användargränssnittet:

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