Dokumentation Experience Platform Användarhandbok om Source Connectors

[Beta]{class="badge informative"}

Stripe

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

Ämnen:

Skapat för:

Utvecklare

NOTE

Källan Stripe är i betaversion. Läs källöversikten om du vill ha mer information om hur du använder betatecknade 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 expandera globalt med hjälp av Adobe Experience Platform, Adobe Commerce och Magento Open Source.

Använd källan Stripe i Experience Platform för att importera data som dina kunder har 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

Om du har frågor om källan Stripe på Experience Platform kan du kontakta Stripe på adobe-partnership@stripe.com.

recommendation-more-help

Exempel på användning för Stripe source

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

Använd datakällan Stripe för att analysera användningen av alternativen Köp nu och betala senare 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.

style

shade-box

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

Förhandskrav prerequisites

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

Hämta din åtkomsttoken

Logga in på Stripe instrumentpanelen med din Stripe e-postadress och ditt lösenord.
Välj API keys for developers på kontrollpanelen Developers.
Under fliken API-nycklar väljer du Reveal test key för att visa din åtkomsttoken.
Du kan nu använda den här token som din åtkomsttoken när du ansluter ditt Stripe-konto till Experience Platform, med API:t Flow Service eller användargränssnittet för Experience Platform.

Samla in nödvändiga inloggningsuppgifter

Om du vill ansluta ditt 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 ditt Stripe-konto med API:t Flow Service.

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

Gränssnitt

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

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

Mer information om hur du använder Stripe API:er finns i Stripe dokumentationen om API-nycklar.

Skapa ett XDM-schema (Experience Data Model)

Källan Stripe 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 representerar avgifter försök att flytta pengar till din Stripe. Läs Stripe API-guiden för avgifter om du vill ha mer information om specifika debiteringsattribut.

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 Stripe kan du använda prenumerationer för att debitera en kund regelbundet. Läs Stripe API-guiden för prenumerationer om du vill ha 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 Stripe kan du använda återbetalningar om du vill återbetala en avgift som skapats tidigare. Läs Stripe API-guiden för återbetalningar om du vill ha 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
}

Balansera transaktioner

I Stripe representerar saldotransaktioner rörelsen av medel mellan dina Stripe-konton. Läs Stripe API-guiden för saldotransaktioner om du vill ha mer information om specifika saldotransaktionsattribut.

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 representerar kunder en viss kund i ditt företag. Mer information om specifika kundattribut finns i Stripe API-handboken 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 representerar priser enhetskostnaden, valutan och den valfria faktureringscykeln för både återkommande och engångsköp av produkter. Läs Stripe API-guiden för priser om du vill ha 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. Mer information finns på sidan IP-adress tillåtelselista.

Konfigurera behörigheter i Experience Platform

Du måste ha både behörighet View Sources och behörighet Manage Sources aktiverat för ditt konto för att kunna ansluta ditt Stripe-konto till Experience Platform. Kontakta produktadministratören för att få den behörighet som krävs. Mer information finns i användargränssnittsguiden för åtkomstkontroll.

Nästa steg

När du har slutfört konfigurationen av din förutsättning kan du fortsätta ansluta och importera dina Stripe-data till Experience Platform. Läs följande handböcker om du vill veta hur du importerar Stripe betalningsdata till Experience Platform med API:er eller användargränssnittet:

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