Funcionalidades de cuenta
Las funcionalidades que solicitas para una cuenta conectada determinan los datos que tendrás que recopilar para esa cuenta. Para simplificar las tareas de onboarding, solicita solo las funcionalidades que necesitas. Cuantas más funcionalidades solicites, más información tendrás que recopilar.
Puedes comenzar completando el perfil de la plataforma para identificar qué funcionalidades son convenientes para tu plataforma.
Nota
La solicitud de la mayoría de las funcionalidades implica habilitarlas permanentemente. Si se intenta eliminar o anular la solicitud de una funcionalidad permanente, se verá un mensaje de error.
Funcionalidades compatibles
En la siguiente lista, figuran las funcionalidades disponibles. Haz clic en un elemento para expandirlo o contraerlo.
Envíos de fondos
Pagos con tarjeta
Declaraciones fiscales de EE. UU.
Métodos de pago
Pagos internacionales de la India
Múltiples funcionalidades
La solicitud de varias funcionalidades para una cuenta conectada es habitual, pero debes tener en cuenta lo siguiente:
- Las funcionalidades operan independientemente una de otra.
- Si una cuenta conectada tiene definidas las funcionalidades
card_payments
ytransfers
, y elstatus
de alguna de ellas esinactive
, entonces ambas funcionalidades están desactivadas. - Puedes solicitar o anular la solicitud de una funcionalidad para una cuenta conectada, en cualquier momento, durante el ciclo de vida de la cuenta.
Las funcionalidades también te permiten recopilar información para diversos fines al mismo tiempo de manera de no solicitarles a los usuarios la misma información más de una vez. Por ejemplo, se puede pedir simultáneamente la información fiscal y los datos necesarios para una funcionalidad solicitada. Si estás haciendo el onboarding de un usuario con la funcionalidad transfers
y ese usuario debe presentar un formulario 1099-MISC del IRS (formulario de declaración de impuestos de Estados Unidos), puedes recopilar al mismo tiempo tanto la información fiscal como los datos para el onboarding.
Crea una cuenta con funcionalidades
Las funcionalidades se definen en el objeto Account. Para encontrar la lista de funcionalidades disponibles, utiliza el punto de conexión list_capabilities.
La creación de cuentas y la solicitud de funcionalidades difieren para las cuentas conectadas en diferentes configuraciones.
- Las funcionalidades se solicitan automáticamente en cualquier cuenta que configures con acceso al Dashboard completo de Stripe, incluidas las cuentas Standard.
- Para las cuentas con acceso al Dashboard de Express, incluidas las cuentas de Express, puedes solicitar funcionalidades al crear la cuenta o usar los ajustes de configuración de onboarding para automatizar las funcionalidades solicitadas.
- Debes solicitar funcionalidades cuando creas cuentas conectadas sin acceso a un panel alojado por Stripe, incluidas las cuentas Custom.
Los requisitos de información varían según la funcionalidad, pero suelen relacionarse con la verificación de identidad u otro dato específico del tipo de pago.
Una vez que creas con éxito la cuenta conectada, puedes ver cuáles son los requisitos:
En la respuesta, consulta el hash requirements
para ver cuál es la información necesaria. Los valores de payouts_enabled
y charges_enabled
indican si los pagos y cargos están habilitados para la cuenta.
Más información sobre funcionalidades
Más arriba, hemos explicado los conceptos básicos de la creación de cuentas. No obstante, hay instancias en las que quieras previsualizar los requisitos de información o gestionar las funcionalidades en cuentas existentes. Las siguientes secciones describen cómo ejecutar estas acciones usando la API Capabilities.
Previsualizar requisitos de información
Puedes previsualizar la información que necesitas del usuario para una funcionalidad en particular antes o después de haber solicitado la funcionalidad.
Cuando solicitas funcionalidades, se activan los webhooks account.updated
y los requisitos de la cuenta pueden cambiar. Si primero previsualizas los requisitos, recopila lo que es necesario para la cuenta y luego solicita la funcionalidad. De esta manera, agilizarás la habilitación de los cargos y transferencias para la cuenta. También evitarás la posibilidad de que la cuenta se deshabilite, ya que la información se habrá recopilado con antelación.
El siguiente ejemplo menciona los requisitos de la funcionalidad card_payments
para una cuenta específica.
En la respuesta, consulta el hash requirements
para ver cuál es la información necesaria:
{ "id": "card_payments", "object": "capability", "account":
, "requested": false, "requested_at": null, "requirements": { "past_due": [], "currently_due": ["company.tax_id", ...], "eventually_due": [...], "disabled_reason": ..., "current_deadline": ..., }, "status": "unrequested" }"{{CONNECTED_ACCOUNT_ID}}"
El valor en status
indica si la funcionalidad ha sido requested
. Cuando es solicitada, se activan los requisitos de la cuenta.
Si bien estos pasos muestran cómo previsualizar los requisitos de una funcionalidad antes de solicitarla, puedes usar el mismo punto de conexión para ver cuáles son los requisitos actuales para una funcionalidad. Esto puede ayudarte a estar informado respecto de cuáles son los requisitos de una determinada funcionalidad y también de los cambios que pudiera haber.
Solicitar y anular la solicitud de funcionalidades
Después de crear la mayoría de las cuentas, puedes solicitar funcionalidades adicionales y eliminar las existentes. Para solicitar una funcionalidad, establece el valor requested
de la funcionalidad en true
actualizando la cuenta. Si la solicitud tiene éxito, la API devuelve requested: true
en la respuesta. No puedes solicitar funcionalidades para las cuentas conectadas con acceso al Dashboard completo de Stripe, incluidas las cuentas Standard.
Para anular la solicitud de una funcionalidad, establece el valor requested
de la funcionalidad en false
actualizando la cuenta. Si la funcionalidad no se puede eliminar, esta llamada devuelve un error. Si la llamada tiene éxito, la API devuelve requested: false
en la respuesta.
También puedes solicitar y eliminar las funcionalidades de una cuenta en el Dashboard. Si no se puede eliminar una funcionalidad, el botón Eliminar no estará habilitado.
En el siguiente ejemplo, se solicita la funcionalidad transfers
para una cuenta conectada específica:
En el siguiente ejemplo, se solicitan varias funcionalidades para una cuenta conectada específica: