Cómo usar Connect con cuentas Custom
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 de Stripe es casi invisible para el titular de la cuenta. Por ser la plataforma, eres responsable de todas las interacciones con los usuarios y de recopilar toda la información necesaria para verificar la cuenta.
Con las cuentas Custom, 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 no pueden iniciar sesión en Stripe, queda a tu cargo crear el flujo de onboarding, el Dashboard de usuario, la funcionalidad de informes y los canales de comunicación.
Si bien una cuenta Custom se crea con una simple llamada a la API, por cada cuenta que crees, hay tres pasos que debes considerar:
- Identificar adecuadamente el país que se utilizará.
- Crear la cuenta.
- Poner en marcha el proceso de verificación de identidad.
Pero primero, asegúrate de cumplir con los requisitos mínimos.
Nota
Las plataformas francesas deben utilizar tokens de cuenta, que constituyen una alternativa al modelo de agentes para el cumplimiento de la normativa PSD2 de la plataforma. El beneficio clave de los tokens para las plataformas francesas es que la información se transfiere del usuario directamente a Stripe. Si bien no tener que almacenar información personal de identificación es un beneficio, no es necesariamente un requisito. Para las plataformas de otros países, los tokens de cuentas son opcionales, pero es lo que se recomienda.
Requisitos para crear cuentas Custom
Para usar cuentas Custom, debes cumplir todos estos requisitos:
- Minimum API version: You must be using an API version at least as recent as 2014-12-17. You can view and upgrade your API version in the Dashboard if needed.
- Actualización de las Condiciones de uso: la creación de cuentas Custom 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.
- Handling information requests: Instead of requesting information—such as a Social Security Number or passport scan—directly from your user, Stripe requests the information it needs from you. You must collect this information from your user and provide it to Stripe. Otherwise, Stripe may disable payouts to the connected account.
- Plataforma en 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.
- 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, las personas usuarias de la plataforma en estos países no pueden usar el autoservicio de cuentas de Custom Connect. Para iniciar el onboarding de cuentas de Custom Connect en estos países, ponte en contacto con nosotros.
- Plataformas en los Emiratos Árabes Unidos: Las plataformas en los Emiratos Árabes Unidos solo pueden usar cuentas Custom con sede en los Emiratos Árabes Unidos con los siguientes tipos de cargos: destination_charges y cargos y envíos de fondos separados. Los cargos de destino que utilizan el atributo on_behalf_of aún no son compatibles con las plataformas de los EAU.
Precaución
Las plataformas ubicadas afuera de México que deseen crear cuentas Custom en México y hacer que esas cuentas sean el comerciante 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, 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 activas. La cuenta Custom 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 es el país en el que operará el particular o la empresa. Todo lo demás se puede recopilar y actualizar más adelante.
Por ejemplo, si estás en Estados Unidos y la empresa o el usuario para el que estás creando la cuenta tiene representación legal en Canadá, utiliza CA
como país.
El valor país también determina la información de verificación requerida para la cuenta conectada.
Crear una cuenta Custom
Para crear y conectar una cuenta Custom, como mínimo define type
en custom
en la solicitud de creación de la cuenta y proporciona un país y las funcionalidades correspondientes.
Precaución
Las plataformas de Estados Unidos pueden crear cuentas para envíos de fondos transfronterizos especificando el contrato de servicio de destinatario.
El resultado de una llamada correcta a la API son los datos de la cuenta del usuario:
{ ... "id":
, "type": "custom" ... }"{{CONNECTED_ACCOUNT_ID}}"
Almacena el id
en tu base de datos: es el 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 el ID de cuenta recibido. Necesitas este dato para hacer solicitudes en nombre del usuario.
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 de 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 crees la cuenta o actualices la cuenta más tarde. Como mínimo, recomendamos recopilar y proporcionar el nombre y la fecha de nacimiento del usuario 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 tu flujo de onboarding.
Nota
Para cuentas con el 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 atento a estos eventos y responder a ellos según sea necesario.
Consulta también
Más información sobre cómo trabajar con cuentas Custom.