Cómo usar Connect con cuentas Custom conectadas
Usa cuentas Custom conectadas con Connect para controlar toda la experiencia de tus cuentas conectadas.
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:
- Asegúrate de cumplir con los requisitos mínimos.
- Identifica adecuadamente el país y los requisitos relacionados.
- Crear la cuenta.
- 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.
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":
, "type": "custom" ... }"{{CONNECTED_ACCOUNT_ID}}"
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
For accounts with business_type set to individual
, provide at least one individual
property (for example, individual.
) and a Person object is created automatically. If you don’t, or for accounts with the business_
set to company
, you need to create each Person for the account.
Webhooks
Después de crear una cuenta, todas las notificaciones sobre cambios en la cuenta se envían a tus webhooks como eventos account.
. 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.