Documentación Experience Platform Guía de conectores de origen

[Beta]{class="badge informative"}

Stripe

Last update: Tue Mar 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Temas:
Fuentes

Creado para:

Desarrollador

NOTE

El Stripe el origen está en versión beta. Lea el información general de orígenes para obtener más información sobre el uso de fuentes etiquetadas como beta.

Miles de empresas de todos los tamaños utilizan Stripe tanto en línea como en persona para aceptar pagos, generar nuevas fuentes de ingresos y expandirse globalmente con la ayuda de Adobe Experience Platform, Adobe Commerce y Magento Open Source.

Utilice el Stripe fuente en Experience Platform para introducir los datos capturados durante el flujo de compra por sus clientes. Una vez introducidos, utilice estos datos para crear ofertas personalizadas y desbloquear perspectivas comerciales más enriquecidas.

TIP

Si tiene alguna pregunta sobre Stripe origen en Experience Platform, contacto Stripe en adobe-partner@stripe.com.

recommendation-more-help

Ejemplo de caso de uso para Stripe origen

Su empresa permite a los clientes comprar artículos en su tienda en línea con la opción de comprar ahora y pagar más tarde (con Klarna, Afterpay, Affirm, o Zip).

Utilice el Stripe para analizar el uso de comprar ahora y pagar más tarde y experimentar con ofertas personalizadas a estos clientes. Por ejemplo, considere la posibilidad de recomendar elementos adicionales para ampliar el número de elementos en su carro de compras antes del cierre de compra.

style

shade-box

Lea el siguiente documento para obtener información sobre cómo configurar su Stripe Cuenta de origen, recupere las credenciales necesarias y cree los esquemas.

Requisitos previos prerequisites

Las secciones siguientes proporcionan información sobre la configuración de requisitos previos que debe completar antes de conectar su Stripe cuenta para el Experience Platform.

Recuperación del token de acceso

Inicie sesión en Stripe tablero uso de su Stripe correo electrónico y contraseña.
En el Developers panel, seleccione API keys for developers.
En el Claves de API pestaña, seleccione Reveal test key para mostrar el token de acceso.
Ahora puede utilizar este token como token de acceso al conectar su Stripe cuenta al Experience Platform, utilizando el Flow Service API para la IU de Experience Platform.

Recopilar credenciales necesarias

Para conectar su Stripe cuenta al Experience Platform, debe proporcionar valores para las siguientes credenciales de autenticación:

API

Debe proporcionar las siguientes credenciales al conectar su Stripe cuenta que utiliza Flow Service API.

table 0-row-2 1-row-2 2-row-2
Credencial	Descripción
`accessToken`	Su Stripe Token de autenticación de código de actualización de OAuth 2.
`connectionSpec.id`	El ID de especificación de conexión del Stripe origen. Este ID se corrigió como: `cc2c31d6-7b8c-4581-b49f-5c8698aa3ab3`.

Debe proporcionar las siguientes credenciales al conectar su Stripe cuenta de mediante la interfaz de usuario de Experience Platform.

table 0-row-2 1-row-2
Credencial	Descripción
Token de acceso	Su Stripe Token de autenticación de código de actualización de OAuth 2.

Para obtener más información sobre el uso de Stripe API, lea la Stripe documentación sobre las claves API.

Creación de un esquema de modelo de datos de experiencia (XDM)

El Stripe source admite la ingesta de datos desde las siguientes rutas de recursos:

Gastos
Suscripciones
Reembolsos
Transacciones de Saldo
Clientes
Precios

Debe crear un esquema XDM para describir un conjunto de datos, que puede almacenar los campos y tipos de datos que se enviarán desde Stripe al Experience Platform.

Cargos

Entrada Stripe, gastos representar intentos de mover dinero a su Stripe. Lea el Stripe Guía de API sobre cargos para obtener más información sobre atributos de cargos específicos.

accordion

Seleccione para ver el objeto Gastos de Stripe

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
}

Suscripciones

Entrada Stripe, puede utilizar suscripciones para cargar a un cliente de forma recurrente. Lea el Stripe Guía de API sobre suscripciones para obtener más información sobre atributos de suscripción específicos.

accordion

Seleccione para ver el objeto Suscripción de 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
}

Reembolsos

Entrada Stripe, puede utilizar devoluciones para reembolsar un cargo creado anteriormente. Lea el Stripe Guía de API sobre reembolsos para obtener más información sobre atributos de devolución específicos.

accordion

Seleccione esta opción para ver el objeto de reembolso del Stripe

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
}

Transacciones de Saldo

Entrada Stripe, transacciones de saldo representar el movimiento de fondos entre sus Stripe cuentas. Lea el Stripe Guía de API sobre transacciones de saldo para obtener más información sobre atributos específicos de transacciones de saldo.

accordion

Seleccione esta opción para ver el objeto Transacción de saldo de 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"
}

Clientes

Entrada Stripe, clientes representar a un cliente determinado de su negocio. Para obtener información sobre los atributos específicos del cliente, lea la Stripe Guía de API sobre clientes para obtener más información sobre atributos específicos del cliente.

accordion

Seleccione esta opción para ver el objeto Cliente del 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
}

Precios

Entrada Stripe, precios representan el coste unitario, la divisa y el ciclo de facturación opcional para la compra recurrente y única de productos. Lea el Stripe Guía de API sobre precios para obtener más información sobre atributos de precio específicos.

accordion

Seleccione para ver el objeto Precio de 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"
}

LISTA DE PERMITIDOS de direcciones IP

Se debe agregar una lista de direcciones IP a una lista de permitidos antes de trabajar con conectores de origen. Si no se agregan las direcciones IP específicas de la región a la lista de permitidos, pueden producirse errores o no rendimiento al utilizar fuentes. Consulte la LISTA DE PERMITIDOS de direcciones IP para obtener más información.

Configuración de permisos en el Experience Platform

Debe tener ambos Ver orígenes y Administrar fuentes permisos habilitados para su cuenta con el fin de conectar su Stripe cuenta para el Experience Platform. Póngase en contacto con el administrador del producto para obtener los permisos necesarios. Para obtener más información, lea la guía de IU de control de acceso.

Pasos siguientes

Una vez que haya completado la configuración de requisitos previos, puede continuar con la conexión e ingerir su Stripe datos al Experience Platform. Lea las siguientes guías para aprender a ingerir Stripe datos de pagos al Experience Platform mediante API o la interfaz de usuario:

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