# Cómo usar Connect con cuentas Custom conectadas

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

> #### Nuevas integraciones de Connect
> 
> La información de esta página solo se aplica a plataformas que ya usan tipos de cuentas conectadas heredadas. Si estás configurando una nueva plataforma Connect o tu integración usa la API Accounts v2, consulta [Configurar el comportamiento de cuentas conectadas](https://docs.stripe.com/connect/accounts-v2/connected-account-configuration.md) para obtener más información sobre las configuraciones de cuentas conectadas. Si tu integración usa la API Accounts v1, consulta [Propiedades del controlador de cuentas](https://docs.stripe.com/connect/migrate-to-controller-properties.md#account-controller-properties).

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* (A payout is the transfer of funds to an external account, usually a bank account, in the form of a deposit). 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](https://docs.stripe.com/connect/custom-accounts.md#requirements).
1. Identifica adecuadamente el [país](https://docs.stripe.com/connect/custom-accounts.md#country) y los requisitos relacionados.
1. [Crear](https://docs.stripe.com/connect/custom-accounts.md#create) la cuenta.
1. Completa el proceso de [verificación de identidad](https://docs.stripe.com/connect/custom-accounts.md#identity-verification).

Los requisitos de verificación de identidad se actualizan a medida que cambian las leyes y reglamentaciones en el mundo. Si estás creando tu propio flujo de onboarding para integrar 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, utiliza el [onboarding de Connect para cuentas Custom](https://docs.stripe.com/connect/custom/hosted-onboarding.md).

> Para cumplir con las normativas francesas de PSD2, las plataformas en Francia [deben usar tokens de cuenta](https://stripe.com/guides/frequently-asked-questions-about-stripe-connect-and-psd2#regulatory-status-of-connect). 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](https://dashboard.stripe.com/workbench) 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](https://docs.stripe.com/connect/updating-service-agreements.md#tos-acceptance), 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](https://stripe.com/global). [Ponte en contacto con nosotros](connect@stripe.com) 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](https://support.stripe.com/questions/connect-availability-in-the-uae), [India](https://support.stripe.com/questions/stripe-india-support-for-marketplaces) y [Tailandia](https://support.stripe.com/questions/stripe-thailand-support-for-marketplace), 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](https://stripe.com/contact/sales).
- **Plataformas en los EAU**: las plataformas establecidas en los EAU solo pueden usar cuentas personalizadas conectadas establecidas en los EAU con los siguientes tipos de cargos: [destination_charges](https://docs.stripe.com/connect/destination-charges.md) y [cargos y envíos de fondos separados](https://docs.stripe.com/connect/separate-charges-and-transfers.md). Los cargos a un destino que usan el atributo [on_behalf_of](https://docs.stripe.com/api/payment_intents/object.md#payment_intent_object-on_behalf_of) aún no se aceptan para plataformas establecidas en los EAU.

> 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](https://docs.stripe.com/connect/account-capabilities.md#card-payments) deben someterse a una revisión adicional. [Ponte en contacto con nosotros](https://support.stripe.com/contact) 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](https://docs.stripe.com/connect/risk-management/best-practices.md) a fin de obtener más información.

Ten en cuenta que hay un [costo adicional](https://stripe.com/connect/pricing) 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](https://docs.stripe.com/connect/required-verification-information.md) 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](https://docs.stripe.com/connect/account-capabilities.md#supported-capabilities).

```curl
curl https://api.stripe.com/v1/accounts \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d country=US \
  -d type=custom \
  -d "capabilities[card_payments][requested]"=true \
  -d "capabilities[transfers][requested]"=true
```

Stripe admite transferencias transfronterizas en el saldo de pagos entre los Estados Unidos, Canadá, el Reino Unido, el EEE y Suiza. En otras situaciones, tu plataforma y cualquier cuenta conectada deben estar en la misma región. Intentar transferir fondos a través de fronteras o saldos no admitidos devuelve un error. Consulta [Transferencias transfronterizas](https://docs.stripe.com/connect/cross-border-payouts.md) para ver los flujos de fondos admitidos entre otras regiones.

Solo debes usar transferencias en combinación con los casos de uso permitidos para [cargos](https://docs.stripe.com/connect/charges.md), [recargas](https://docs.stripe.com/connect/top-ups.md) y [comisiones](https://docs.stripe.com/connect/custom-accounts.md#collect-fees). Te recomendamos usar cargos y envíos de fondos separados solo cuando seas responsable de los saldos negativos de tus cuentas conectadas.

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

```json
{
  ...
  "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](https://docs.stripe.com/connect/authentication.md) como la cuenta conectada especificándolo en las solicitudes en el encabezado `Stripe-Account`.

> 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](https://docs.stripe.com/connect/identity-verification.md) sobre el titular de la cuenta. En la página de [información de verificación requerida](https://docs.stripe.com/connect/required-verification-information.md), 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](https://docs.stripe.com/connect/custom/hosted-onboarding.md), 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](https://docs.stripe.com/api.md#create_account) o [actualizarla](https://docs.stripe.com/api.md#update_account) 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](https://support.stripe.com/questions/connect-address-validation) 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.

> Para las cuentas con [business_type](https://docs.stripe.com/api/accounts/object.md#account_object-business_type) establecido en `individual`, proporciona al menos una propiedad `individual` (por ejemplo, `individual.first_name`) y se creará automáticamente un objeto [Person](https://docs.stripe.com/api/persons/object.md). 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](https://docs.stripe.com/api/persons/create.md) de la cuenta.

## Webhooks

Después de crear una cuenta, todas las notificaciones sobre cambios en la cuenta se envían a tus [webhooks](https://docs.stripe.com/connect/webhooks.md) como eventos `account.updated`. Proporciona la URL de tu *webhook* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests) de *Connect* (Connect is Stripe's solution for multi-party businesses, such as marketplace or software platforms, to route payments between sellers, customers, and other recipients) en la [configuración de la cuenta](https://dashboard.stripe.com/account/webhooks). Luego, debes estar pendiente de estos eventos y responder a ellos según sea necesario.

## See also

- [Onboarding de cuentas conectadas](https://docs.stripe.com/connect/custom/onboarding.md)
- [Actualización de contratos de servicio](https://docs.stripe.com/connect/updating-service-agreements.md)
- [Verificación de identidad](https://docs.stripe.com/connect/identity-verification.md)
- [Autenticación](https://docs.stripe.com/connect/authentication.md)
- [Creación de cargos](https://docs.stripe.com/connect/charges.md)