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.

Después de crear una cuenta, puedes solicitar funcionalidades adicionales y eliminar las funcionalidades temporales vigentes. Para las cuentas conectadas que controlan otras plataformas, no puedes anular la solicitud de las funcionalidades.

Funcionalidades compatibles

En la siguiente lista, figuran las funcionalidades disponibles. Haz clic en un elemento para expandirlo o contraerlo.

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 y transfers, y el status de alguna de ellas es inactive, 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. 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 una cuenta conectada con la funcionalidad transfers y esa cuenta debe presentar un formulario 1099-MISC del IRS (formulario federal 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 para un objeto Account, 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.

• Para las cuentas conectadas con acceso al Dashboard de Stripe completo, incluidas las cuentas Standard, algunas funcionalidades se solicitan automáticamente, en función de su país. También puedes solicitar otras funcionalidades para ellas.
• Para las cuentas conectadas con acceso al Dashboard de Express, incluidas las cuentas de Express, puedes solicitar funcionalidades o usar los ajustes de configuración de onboarding para automatizar las funcionalidades solicitadas.
• Para las cuentas conectadas sin acceso a un Dashboard alojado en Stripe, incluidas las cuentas Custom, debes solicitar sus funcionalidades.

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "controller[fees][payer]"=application \
  -d "controller[losses][payments]"=application \
  -d "controller[stripe_dashboard][type]"=none \
  -d "controller[requirement_collection]"=application \
  -d country=US \
  -d "capabilities[card_payments][requested]"=true \
  -d "capabilities[transfers][requested]"=true

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.

Cuando la cuenta conectada se crea correctamente, puedes recuperar una lista de sus requisitos:

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}} \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:"

En la respuesta, el hash requirements especifica la información requerida. Los valores de payouts_enabled y charges_enabled indican si los pagos y los cargos están habilitados para la cuenta.

Funcionalidades para las cuentas existentes

En las siguientes secciones se describe cómo tener una vista previa de los requisitos de información o administrar las funcionalidades para las cuentas conectadas existentes utilizando la API Capabilities.

Previsualizar requisitos de información

Puedes obtener una vista previa de la información que necesitas de tu cuenta conectada para una funcionalidad en particular antes o después de haber solicitado la funcionalidad.

Cuando solicitas funcionalidades account.updated, se activan los webhooks y es posible que los requisitos de la cuenta cambien. Para habilitar un requisito más rápido y no tener que deshabilitar la cuenta, obtén una vista previa de ellos y recopila la información requerida antes de solicitar la funcionalidad.

En el siguiente ejemplo, hay una list de los requisitos de la funcionalidad card_payments para una cuenta específica.

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}}
/capabilities/card_payments \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:"

En la respuesta, consulta el hash requirements para ver cuál es la información necesaria:

{
  "id": "card_payments",
  "object": "capability",
  "account": 
"{{CONNECTED_ACCOUNT_ID}}",
  "requested": false,
  "requested_at": null,
  "requirements": {
    "past_due": [],
    "currently_due": ["company.tax_id", ...],
    "eventually_due": [...],
    "disabled_reason": ...,
    "current_deadline": ...,
  },
  "status": "unrequested"
}

El valor de status indica si la funcionalidad fue solicitada. Cuando el valor es solicitada, los requisitos de la cuenta están activos.

Además de tener una vista previa de los requisitos de una funcionalidad antes de solicitarla, puedes usar el mismo punto de conexión para ver los requisitos actuales de una funcionalidad. Esto te mantiene al tanto de cuándo cambian los requisitos.

Solicitar y anular la solicitud de funcionalidades

Si quieres solicitar una funcionalidad para una cuenta, establece el valor requested de la funcionalidad en true mediante la actualización de la cuenta. Si la solicitud se efectúa correctamente, la API devuelve requested: true en la respuesta.

Para anular la solicitud de una funcionalidad para una cuenta, establece el valor requested de la funcionalidad en false mediante la actualización de la cuenta. Si la funcionalidad no se puede eliminar, esta llamada devuelve un error. Si la llamada se efectúa correctamente, la API devuelve requested: false en la respuesta.

También puedes solicitar y eliminar las funcionalidades de una cuenta desde 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:

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}}
/capabilities/transfers \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d requested=true

En el siguiente ejemplo, se solicitan varias funcionalidades para una cuenta conectada específica:

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}} \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "capabilities[bancontact_payments][requested]"=true \
  -d "capabilities[eps_payments][requested]"=true \
  -d "capabilities[ideal_payments][requested]"=true \
  -d "capabilities[p24_payments][requested]"=true \
  -d "capabilities[sepa_debit_payments][requested]"=true