Funcionalidades de cuenta

Las funcionalidades representan funciones que puedes solicitar para tus cuentas conectadas, como aceptar pagos con tarjeta o recibir fondos transferidos desde la cuenta de tu plataforma.

La mayoría de las funcionalidades requieren la verificación de cierta información sobre la empresa de la cuenta conectada antes de que Stripe las habilite para esa cuenta. Las funcionalidades que solicitas para una cuenta conectada determinan la información que debes recopilar para esa cuenta. Para reducir las tareas de onboarding, solicita únicamente las funcionalidades que requieren tus cuentas. La solicitud de más funcionalidades implica que el flujo de onboarding debe verificar más información.

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 la mayoría de las funcionalidades 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, puedes recopilar tanto la información fiscal como la información necesaria para una funcionalidad solicitada.

Solicitar funcionalidades para una cuenta

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_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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_BQokikJOvBiI2HlWgH4olfQ2
:"

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_BQokikJOvBiI2HlWgH4olfQ2
:"

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_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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

Funcionalidades obsoletas

Las funcionalidades descritas en las secciones siguientes son obsoletas. Si es posible, no las solicites para cuentas nuevas. Si tienes cuentas existentes que usan funcionalidades obsoletas, te recomendamos que las actualices para reemplazarlas por otras.

legacy_payments

La funcionalidad legacy_payments permite cargos, transferencias y pagos. Las cuentas más recientes habilitan esas acciones mediante las funcionalidades card_payments y transfers, que admiten configuraciones más flexibles.

Te recomendamos que sigas los siguientes pasos:

1. Actualiza el proceso de onboarding de tu cuenta conectada para solicitar la combinación adecuada de card_payments y transfers en lugar de legacy_payments.

2. Actualiza tus cuentas conectadas existentes para solicitar la combinación adecuada de card_payments y transfers.

3. Actualiza la programación que compruebe el estado de legacy_payments para comprobar el estado de legacy_paymentso de la nueva funcionalidad adecuada. Por ejemplo, actualiza la programación que se basa en la capacidad de una cuenta para realizar pagos con tarjeta a fin de que se ejecute cuando legacy_payments o card_payments estén activas. Del mismo modo, actualiza la programación que se basa en la capacidad de una cuenta para aceptar transferencias de manera que se ejecuten cuando legacy_payments o transfers estén activas. La programación actualizada funciona durante todo el proceso de transición a las nuevas funcionalidades, independientemente de cuándo se activen las nuevas funcionalidades.

4. Una vez que las nuevas funcionalidades estén activas para todas las cuentas conectadas, quita las referencias a legacy_payments de la programación.

Si haces negocios en Canadá, Stripe automáticamente solicita card_payments y transfers para tus cuentas que usan legacy_payments, a fin de cumplir con los requisitos actualizados. Durante el proceso, es posible que veas los siguientes valores en las respuestas de la API de tus cuentas conectadas.

capabilities: {
  legacy_payments: "active"
},
charges_enabled: true,
payouts_enabled: true

capabilities: {
  card_payments: "inactive",
  legacy_payments: "active",
  transfers: "inactive"
},
charges_enabled: true,
payouts_enabled: true

capabilities: {
  card_payments: "active",
  legacy_payments: "active",
  transfers: "active"
},
charges_enabled: true,
payouts_enabled: true