Ir a contenido
Crea una cuenta
o
Inicia sesión
Logotipo de Stripe Docs
/
Pregúntale a la IA
Crear una cuenta
Iniciar sesión
Empieza ahora
Pagos
Ingresos
Plataformas y marketplaces
Gestión del dinero
Herramientas para desarrolladores
Resumen
Empieza a usar Connect
Fundamentos de la integración
Ejemplos de integraciones
Haz el onboarding de las cuentas
Configura los Dashboards de la cuenta
Aceptar pagos
Transfiere a cuentas
Gestiona tu plataforma Connect
Formularios fiscales para tu plataforma Connect
Trabaja con tipos de cuentas conectadas
    Tipos de cuenta conectadas
      Standard
      Express
      Custom
        Onboarding de cuentas Custom
    Métodos de pago dinámicos
InicioPlataformas y marketplacesWork with connected account typesConnected account types

Cómo usar Connect con cuentas Custom conectadas

Usa cuentas Custom conectadas con Connect para controlar toda la experiencia de tus cuentas conectadas.

Copiar página

Nota

Los requisitos de verificación de identidad se actualizan a medida que cambian las leyes y reglamentaciones en todo el mundo. Si estás creando tu propio flujo de onboarding para integrar las cuentas, debes planificar la revisión y actualización de los requisitos de onboarding por lo menos cada seis meses. Para no tener que encargarte de esta obligación de mantenimiento, usa onboarding de Connect para cuentas Custom.

Una cuenta Custom conectada es casi invisible para el titular de la cuenta. Por ser la plataforma, eres responsable de todas las interacciones con las cuentas conectadas y de recopilar toda la información necesaria para verificar cada cuenta.

Con las cuentas Custom conectadas, puedes modificar los datos y la configuración de la cuenta conectada a través de la API, incluida la gestión de las cuentas bancarias y el calendario de transferencias. Debido a que los titulares de cuentas Custom conectadas no pueden iniciar sesión en Stripe, queda a tu cargo crear el flujo de onboarding, el Dashboard de cuenta conectada, la funcionalidad de informes y los canales de comunicación.

Para crear una cuenta Custom conectada, debes seguir los siguientes pasos:

  1. Asegúrate de cumplir con los requisitos mínimos.
  2. Identifica adecuadamente el país y los requisitos relacionados.
  3. Crear la cuenta.
  4. Completa el proceso de verificación de identidad.

Nota

Para cumplir con las normativas francesas de PSD2, las plataformas en Francia deben usar tokens de cuenta. Otro beneficio de los tokens es que la plataforma no tiene que almacenar datos de información personal (PII), que se transfieren de la cuenta conectada directamente a Stripe. Para plataformas de otros países, recomendamos usar tokens de cuenta, pero no son obligatorios.

Requisitos para crear cuentas Custom conectadas

Para usar cuentas Custom conectadas, debes cumplir todos estos requisitos:

  • Versión de API mínima: debes usar como mínimo una versión de API 2014-12-17. Puedes ver y actualizar tu versión de API en el Dashboard, de ser necesario.
  • Actualización de las Condiciones de uso: la creación de cuentas Custom conectadas exige una actualización de tus condiciones de uso, ya que deben incluir una referencia al contrato de servicios de Stripe. Stripe te recomienda que consultes con tu equipo de asesoría legal respecto de si debes actualizar el texto de aceptación de tus condiciones para incluir una referencia a las condiciones de Stripe.
  • Gestión de las solicitudes de información: en lugar de solicitar información (por ejemplo, el número de seguridad social o una copia escaneada del pasaporte) directamente a tu usuario de cuenta conectada, Stripe te solicita a ti la información que necesita. Debes pedirle esta información a la cuenta conectada y proporcionársela a Stripe. De lo contrario, Stripe puede deshabilitar las transferencias a la cuenta conectada.
  • Plataforma de un país admitido: las plataformas en Alemania, Australia, Austria, Bélgica, Brasil, Bulgaria, Canadá, Chipre, Dinamarca, Eslovaquia, Eslovenia, España, Estados Unidos, Estonia, Finlandia, Francia, Grecia, Hong Kong, Hungría, India, Irlanda, Italia, Japón, Letonia, Lituania, Luxemburgo, Malta, México, Noruega, Nueva Zelanda, Países Bajos, Polonia, Portugal, Reino Unido, República Checa, Rumania, Singapur, Suecia, Suiza y Tailandia pueden crear cuentas Custom para los países que Stripe admita. Ponte en contacto con nosotros si quieres que te avisemos cuando las plataformas de tu país puedan usar cuentas Custom conectadas.
  • Países que no admiten el autoservicio: debido a las restricciones que se aplican al usar Connect en los Emiratos Árabes Unidos, India y Tailandia, los usuarios de las plataformas en estos países no pueden usar el autoservicio de cuentas Custom conectadas. Para iniciar el onboarding de cuentas Custom conectadas en estos países, ponte en contacto con nosotros.
  • Plataformas en los Emiratos Árabes Unidos: las plataformas en los Emiratos Árabes Unidos (EAU) solo pueden usar cuentas Custom conectadas establecidas en los EAU con los siguientes tipos de cargos: destination_charges y cargos y envíos de fondos separados. Los cargos a un destino que utilizan el atributo on_behalf_of aún no se admiten para las plataformas de los EAU.

Precaución

Las plataformas ubicadas afuera de México que deseen crear cuentas Custom conectadas en México y hacer que esas cuentas sean los comerciantes a cargo del cobro deben someterse a una revisión adicional. Ponte en contacto con nosotros para iniciar el proceso.

  • Verificación por fraude: Debido a que tu plataforma es responsable de las pérdidas en las cuentas Custom conectadas, debes examinar de cerca todas las cuentas que se creen a través de tu plataforma para detectar posibles fraudes. Consulta nuestra guía de prácticas recomendadas para la gestión de riesgos a fin de obtener más información.

Ten en cuenta que hay un costo adicional para las cuentas Custom conectadas activas. La cuenta Custom conectada se considera activa si recibió al menos una transferencia efectuada correctamente en un mes determinado.

Identificar el país que se utilizará

El único dato que necesitas para crear una cuenta Custom conectada es el país en el que opera el particular o la empresa. Puedes recopilar todo lo demás datos más adelante.

Por ejemplo, si estás en Estados Unidos y la empresa o particular para la que estás creando una cuenta conectada tiene representación legal en Canadá, asigna CA como país.

El valor país también determina la información de verificación requerida para la cuenta conectada.

Crea una cuenta Custom conectada

El proceso básico para crear y conectar una cuenta Custom conectada es llamar al punto de conexión de creación de la cuenta, establecer type en custom y proporcionar un país y las funcionalidades correspondientes.

Command Line
cURL
curl https://api.stripe.com/v1/accounts \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d country=US \ -d type=custom \ -d "capabilities[card_payments][requested]"=true \ -d "capabilities[transfers][requested]"=true

Precaución

Las plataformas de Estados Unidos pueden crear cuentas para envíos de fondos transfronterizos. Para hacerlo, deben especificar el contrato de servicio de destinatario.

El resultado de una llamada API correcta son los datos de la cuenta conectada:

{ ... "id":
"{{CONNECTED_ACCOUNT_ID}}"
, "type": "custom" ... }

Almacena la id en tu base de datos: es la ID de la cuenta. Proporcionarás este valor para autenticarla como la cuenta conectada especificándolo en las solicitudes en el encabezado Stripe-Account.

Nota

Almacena la ID de cuenta recibido. Necesitas este dato para hacer solicitudes en nombre d la cuenta conectada.

Iniciar el proceso de verificación de identidad

La cuenta creada solo con el dato de país es bastante limitada: solo puede recibir pequeñas sumas. Si deseas habilitar transferencias y mantener la cuenta en regla, tienes que proporcionar más información sobre el titular de la cuenta. En la página de información de verificación requerida, se enumeran los requisitos de verificación de identidad mínimos y probables.

La forma más sencilla de recopilar esta información es integrando el onboarding de Connect, lo que permite que Stripe se encargue de la complejidad del proceso de verificación. De lo contrario, no solo debes escribir tus propias llamadas API para la integración inicial, sino que también tendrás que revisar los cambios en los requisitos de onboarding debido a las modificaciones en las reglamentaciones internacionales.

Puedes recopilar la información necesaria cuando tengas que crear una cuenta o actualizarla más tarde. Como mínimo, recomendamos recopilar y proporcionar el nombre y la fecha de nacimiento del usuario de la cuenta conectada por adelantado. Si recopilas información de la dirección por adelantado, asegúrate de validar el valor del estado de las cuentas conectadas de EE. UU., CA y AU en el flujo de onboarding.

Nota

Para las cuentas con business_type establecido en individual, proporciona al menos una propiedad individual (por ejemplo, individual.first_name) y se creará automáticamente un objeto Person. Si no lo haces, o en el caso de que sean cuentas con el business_type establecido en company, tienes que crear cada objeto Person de la cuenta.

Webhooks

Después de crear una cuenta, todas las notificaciones sobre cambios en la cuenta se envían a tus webhooks como eventos account.updated. Proporciona la URL de tu webhook de Connect en la configuración de la cuenta. Luego, debes estar pendiente de estos eventos y responder a ellos según sea necesario.

Consulta también

Obtén más información sobre cómo trabajar con cuentas Custom conectadas.

  • Onboarding de cuentas conectadas
  • Actualización de contratos de servicio
  • Verificación de identidad
  • Autenticación
  • Creación de cargos
  • Referencia de API
¿Te fue útil esta página?
SíNo
¿Necesitas ayuda? Ponte en contacto con soporte.
Únete a nuestro programa de acceso anticipado.
Echa un vistazo a nuestro registro de cambios.
¿Tienes alguna pregunta? Contacto.
¿LLM? Lee llms.txt.
Con tecnología de Markdoc