Stripe Connect
El Dashboard fijado monta /stripe-connect para el nivel 0 solo cuando addon_stripe_connect es true o la configuración todavía se está cargando. El elemento de My addons tiene por separado condiciones de nivel 0, no ser de solo lectura, disponibilidad y complemento habilitado.
Esta sección está junto a la configuración del encaminamiento de pagos y las comisiones de las tiendas. Puede mostrar valores confidenciales del proveedor y guardar cambios de configuración persistentes. Para esta guía no se abrió ninguna página o categoría ni se inició una conexión o acción relacionada con credenciales, pagos o proveedores.
Revisa las categorías disponibles
La página solicita las categorías cuya clave es addon_stripe_connect y luego muestra los registros devueltos mediante la interfaz genérica de ajustes. Al seleccionar una categoría se escribe ?category={id} en el historial del cliente; los ID, los campos, las descripciones y los valores son datos de ejecución, no un inventario fijo del código fuente.
La página no establece un conjunto genérico de campos de OAuth o credenciales. Antes de documentar o cambiar algo, revisa la configuración específica y aprobada del proyecto de prueba.
Límites verificados de las solicitudes y los cambios
La solicitud de categorías y las lecturas de configuración posteriores son autenticadas. En el código de la API inspeccionado, los registros de categorías están restringidos a administradores. Los cambios en los ajustes genéricos quedan en un búfer del cliente hasta seleccionar Save; luego se envían de a una configuración por vez. Si falla una actualización posterior, puede haber cambios parciales. Las actualizaciones aceptadas pueden crear registros de auditoría, actualizar el estado de configuración global y ejecutar hooks de complementos.
Esos contratos no demuestran que la categoría Stripe devuelta, una cuenta conectada, la disponibilidad de OAuth, el comportamiento de las comisiones o el encaminamiento de pagos estén desplegados. El flujo independiente de formas de pago de una tienda contiene pasos para conectar al proveedor y guardar credenciales; aquí no se repite ese procedimiento.
Mantén los datos confidenciales fuera de las capturas
No captures ni reveles credenciales del proveedor, identificadores de cuentas conectadas, destinos de webhooks, datos de pago ni valores de configuración activos. La imagen conservada es una captura existente y depurada de la lista de categorías; no se reemplazó ni actualizó.
Para la configuración de comisiones de una tienda, usa el flujo aplicable de formas de pago de la tienda y sigue las mismas medidas de aprobación y protección de datos de prueba.
Solución de problemas
Si falta el elemento del menú, comprueba el nivel de la cuenta, el estado de solo lectura, la disponibilidad del complemento y su indicador de habilitación. Una ruta directa, una lista vacía o una categoría visible no conceden derechos ni confirman la facturación o la conexión con el proveedor.
Guías relacionadas: Resumen de complementos · Catálogo Apps & Addons · Formas de pago de la tienda
Procedimientos relacionados
Comprende la configuración de Connect
Stripe Connect puede respaldar un marketplace que cobra a los clientes y distribuye fondos a cuentas conectadas. Antes de cambiar un ajuste, define quién es responsable de ser el comerciante registrado, el patrón de cargos, el cobro de comisiones, la responsabilidad por saldos negativos y el proceso de registro de cada cuenta conectada. Un campo visible o una redirección exitosa no establece ninguna de esas decisiones.
Topología histórica de cuentas
La configuración conservada describe una cuenta Stripe principal para Dashboard y una cuenta Stripe independiente para cada negocio. Indica que se podían vincular cuentas distintas para cada negocio mientras se mantenía la misma cuenta principal.
Este es solo el contexto histórico de la topología de cuentas. No establece el modelo de cuenta, la ruta OAuth, el registro, la liquidación de pagos, el comportamiento de los pagos, la disponibilidad ni una conexión exitosa actuales. Usa el procedimiento histórico para plataformas solo para conciliar una integración existente aprobada.
La siguiente fuente registra una configuración heredada de redirección de tipo OAuth, que incluye https://apiv4.orderingplus.com/v400/en/YOURPROJECTNAME/payments/stripe_connect/callback. Conserva ese endpoint solo para una integración existente aprobada; no lo tomes como valor predeterminado para una implementación nueva de Connect. Antes de configurar una cuenta conectada, revisa la guía actual de registro de Stripe (en inglés) y los requisitos de capacidades de cuenta (en inglés).
Configura los campos de Dashboard
El flujo de Dashboard capturado muestra campos separados de Client ID para sandbox y producción. Ingresa únicamente el identificador aprobado correspondiente en el campo previsto; no copies credenciales ni identificadores de cuentas conectadas en documentación o mensajes.
Configura una conexión de tienda
- Abre los ajustes de formas de pago de la tienda prevista.
- Selecciona Stripe Connect si esa forma de pago está disponible para la tienda.
- Selecciona Connect With Stripe únicamente como parte de un flujo de configuración aprobado.
- En la página de Stripe, selecciona la cuenta conectada prevista y completa los requisitos de autorización o registro que aparezcan.
- Vuelve a Dashboard, revisa los campos mostrados y luego selecciona Save.
Si la interfaz de la tienda muestra Fixed Fee o Percentage Fee, registra el cálculo comercial aprobado antes de guardar. Un campo de comisión, una redirección, un identificador devuelto o un guardado aceptado no demuestran que se haya creado un cargo, realizado una transferencia ni que se pueda recibir un pago.
Usos habituales en un marketplace
- Un marketplace con varios vendedores puede cobrar al cliente y distribuir los fondos según el diseño de pagos aprobado.
- Un marketplace que conecta a clientes con proveedores de servicios puede usar cuentas conectadas cuando la configuración aprobada les asigne las responsabilidades de pago correspondientes.
- Un flujo de pagos recurrentes puede involucrar a varias partes interesadas, pero la facturación recurrente y la distribución de fondos necesitan su propio diseño aprobado de Connect.
Confirma por separado que esté listo
La conexión aún puede tener requisitos pendientes del proveedor, capacidades deshabilitadas, un registro incompleto o un flujo de pago no elegible. Verifica cada punto por separado mediante el estado actual del proveedor y el entorno de prueba aprobado. No uses un pedido, credencial ni cuenta de cliente reales para probar la documentación.
Integración relacionada
Consulta Stripe Connect para dividir pagos entre plataformas y negocios para obtener un resumen de la integración. Usa esta guía para consultar los detalles de configuración y operación.