Funcionalidades de cuenta

Aprende sobre las funcionalidades que puedes habilitar en las cuentas y los requisitos que debes cumplir para utilizarlas.

Las funcionalidades representan capacidades que puedes solicitar para tus cuentas conectadas, como aceptar pagos con tarjeta o recibir fondos transferidos desde tu cuenta de la plataforma. Una funcionalidad debe estar activa para que una cuenta conectada realice acciones asociadas a ella.

Prueba de funcionalidades

Es posible que los entornos de prueba y el modo de prueba no apliquen algunas funciones. En ciertos casos, pueden permitir que una cuenta realice acciones dependientes de la funcionalidad incluso cuando el estado de la funcionalidad asociada no esté activo.

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.

Nota

La solicitud de algunas funcionalidades implica habilitarlas permanentemente. Si se intenta eliminar o anular la solicitud de una funcionalidad permanente, se verá un mensaje de error.

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.

Transferencias

Puedes transferir fondos a cuentas conectadas con la funcionalidad transfers. Las plataformas on-demand suelen utilizarla para pagar a sus cuentas conectadas. Por ejemplo, una plataforma de vehículos de transporte con conductor podría usar esta funcionalidad para pagar a sus conductores. El siguiente diagrama ilustra el flujo de fondos y la relación entre el cliente, la plataforma y la cuenta conectada.

Relación entre los clientes, la plataforma y las cuentas conectadas.

Cuando utilizas la funcionalidad transfers, tu plataforma, y no la cuenta conectada, procesa los cargos. Por lo tanto, en los extractos bancarios de los clientes de una cuenta conectada se muestra la descripción del cargo de tu plataforma, y no la de la cuenta conectada.

Los pagos que usan la funcionalidad transfers incluyen cargos a un destino y cargos y envíos de fondos separados.

Nota

Antes de la versión de la API 2019-08-14, la funcionalidad transfers se llamaba platform_payments. Si usas una versión de API anterior a 2019-08-14, usa platform_payments.

Transferencias transfronterizas

Las transferencias de dinero entre países agregan otros requisitos y solo se aceptan en los siguientes escenarios:

Plataformas de la Unión Europea, el Reino Unido y Gibraltar que envían fondos a los países de la SEPA.
Plataformas de Estados Unidos que envían fondos a destinos de transferencias transfronterizas mediante un contrato de servicio con el destinatario.

Para otros casos, crea una cuenta de plataforma en la misma región que tus cuentas conectadas. Según cuál sea la estructura de tu empresa, quizás tengas que crear una entidad jurídica en esa región y llevar a cabo otras tareas para integrar cuentas conectadas.

Pagos con tarjeta

Las cuentas conectadas con la funcionalidad card_payments pueden recibir pagos de tu plataforma y procesar directamente pagos con tarjeta y con ACH. Una tienda de ecommerce con esta funcionalidad, por ejemplo, puede hacer el cobro de sus propios pagos. En el siguiente diagrama se muestra el flujo de fondos y la relación entre los clientes, las cuentas conectadas y la plataforma:

Relación entre los clientes, las cuentas conectadas y la plataforma.

Para que una cuenta pueda tener la funcionalidad card_payments, debes solicitar card_payments y transfers.

Cuando una cuenta conectada tiene esta funcionalidad, en los extractos bancarios de sus clientes se muestra la descripción del cargo de la cuenta conectada, y no la de la plataforma.

La funcionalidad card_payments se aplica a todos los tipos de cargos.

Declaración fiscal de EE. UU.

El Servicio de Impuestos Internos de los Estados Unidos (IRS) les exige a algunas plataformas presentar los formularios 1099 ante el IRS entre enero y marzo, y entregar informes sobre esas presentaciones a sus cuentas conectadas antes del 31 de enero. Para presentar los formularios, esas plataformas deben recopilar información adicional de sus cuentas conectadas.

Nota

Stripe te recomienda que consultes a un asesor impositivo para determinar tus requisitos en materia de declaración y presentación de impuestos.

Si tu plataforma debe presentar formularios 1099 a nivel federal, y decides presentarlos a través de Stripe, puedes usar las funcionalidades tax_reporting_us_1099_misc y tax_reporting_us_1099_k para recopilar los datos personales y comerciales de tus cuentas conectadas.

Formulario 1099-MISC

Muchos tipos de pagos requieren un formulario 1099-MISC del Servicios de Impuestos Internos de los Estados Unidos (IRS), como los pagos a contratistas o no empleados, regalías, premios, etc. La funcionalidad tax_reporting_us_1099_misc te ayuda a recopilar la información requerida para el formulario 1099-MISC. Por ejemplo, una plataforma de creadores podría utilizar la funcionalidad tax_reporting_us_1099_misc a fin de recopilar la información necesaria de sus proveedores de contenido para la temporada de presentación de impuestos.

Formulario 1099-K

En un formulario 1099-K se declaran pagos recibidos de transacciones con tarjetas de crédito y de redes de pago de terceros. Tradicionalmente, las organizaciones de acreditación de fondos de terceros usaron el formulario 1099-K para declarar sus transacciones de pago bruto en un año calendario. Por ejemplo, una plataforma de ecommerce usa la funcionalidad tax_reporting_us_1099_k a fin de recopilar la información necesaria para la presentación fiscal de cada tienda.

Para obtener más información sobre las declaraciones fiscales de las cuentas conectadas establecidas en los EE. UU., consulta Gestiona los formularios fiscales.

Métodos de pago

Algunos métodos de pago se activan con la funcionalidad card_payments, mientras que otros se activan con su propia funcionalidad.

Si primero realizas el cobro y luego transfieres los fondos, consulta el Dashboard para ver los métodos de pago que puedes usar.

Si deseas permitir que las cuentas conectadas acepten un método de pago para cargos Direct o cargos con on_behalf_of, debes solicitar esa funcionalidad de método de pago para esas cuentas.

Acceso al Dashboard de la cuenta:

Para las cuentas conectadas con acceso al Dashboard de Stripe completo, incluidas las cuentas Standard, la mayoría de las funcionalidades de métodos de pago están habilitadas de forma predeterminada. Esas cuentas pueden administrar sus propias funcionalidades de métodos de pago. También puedes solicitar funcionalidades para ellas con una llamada a la API Capabilities Update y enumerar las funcionalidades habilitadas de una cuenta con una llamada a la API Accounts.

En la siguiente tabla, la columna Se admiten todos los tipos de empresas indica que se admiten todos los tipos de empresas, excepto que Stripe los prohíba. La columna Requisitos adicionales de verificación se refiere a aquellos que son obligatorios además de los necesarios para la funcionalidad card_payments.

Método de pago y funcionalidad asociada	Todos los tipos de empresas aceptados	Disponible por defecto	Requisitos adicionales de verificación	Disponibilidad por país	Soporte para Accounts v2

Débito directo ACH `us_bank_account_ach_payments`	Sí	Sí	No	La cuenta conectada debe ser de un país admitido.	Sí; el nombre de la capacidad v2 es `ach_debit_payments`
Affirm `affirm_payments`	No, consulta las empresas prohibidas.	Sí	No	La cuenta conectada debe ser de un país admitido.	Sí
Afterpay Clearpay `afterpay_clearpay_payments`	No, consulta las empresas prohibidas.	Sí	No	La cuenta conectada debe ser de un país admitido.	Sí
Alipay `alipay_payments`	No, consulta las empresas prohibidas.	El método de pago debe activarse en la página de configuración del Dashboard. Además, solicita una invitación para crear cargos en nombre de otras cuentas.	No	La cuenta conectada debe ser de un país admitido.	No
Apple Pay Disponible con `card_payments`	Sí	Con Checkout: sí Con Payment Element: el método de pago debe configurarse en la página de configuración del Dashboard.	No	La cuenta conectada debe ser de un país admitido.	Sí
Débito directo Bacs `bacs_debit_payments`	Sí	Sí	No	La cuenta conectada debe ser de un país admitido.	Sí
Bancontact `bancontact_payments`	Sí	Sí	No	La cuenta conectada debe ser de un país admitido.	Sí
Débito BECS `au_becs_debit_payments`	Sí	Sí	No	La cuenta conectada debe ser de un país admitido.	Sí
BLIK `blik_payments`	Sí	El método de pago debe activarse en la página de configuración del Dashboard.	No	La cuenta conectada debe ser de un país admitido.	Sí
Boleto `boleto_payments`	Sí	Sí	No	La cuenta conectada debe ser de un país admitido.	Sí
Débito preautorizado de Canadá `acss_debit_payments`	Sí	Sí	No	La cuenta conectada debe ser de un país admitido.	Sí
Cartes Bancaires `cartes_bancaires_payments`	Sí	Sí	No	La cuenta conectada debe ser de un país admitido.	Sí
Cash App Pay `cashapp_payments`	Sí	Sí	No	La cuenta conectada debe ser de un país admitido.	Sí
EPS `eps_payments`	Sí	Sí	No	La cuenta conectada debe ser de un país admitido.	Sí
FPX `fpx_payments`	No, solo empresas con un número de registro de empresa válido.	La funcionalidad debe activarse en la página de configuración del Dashboard.	Sí	La cuenta conectada debe ser de un país admitido.	Sí
Google Pay Disponible con `card_payments`	Sí	Sí	No	La cuenta conectada debe ser de un país admitido.	Sí
GrabPay `grabpay_payments`	Sí	Sí	No	La cuenta conectada debe ser de un país admitido.	Sí
iDEAL `ideal_payments`	Sí	Sí	Sí, es necesario la identificación fiscal para propietarios únicos.	La cuenta conectada debe ser de un país admitido.	Sí
JCB Japón `jcb_payments`	Sí	Sí	No	La cuenta conectada debe ser de Japón.	Sí
Klarna `klarna_payments`	No, consulta empresas prohibidas.	Sí	No	La cuenta conectada debe ser de un país admitido.	Sí
Konbini `konbini_payments`	No, consulta las empresas prohibidas.	El método de pago debe activarse en la página de configuración del Dashboard.	No	La cuenta conectada debe ser de un país admitido.	Sí
Link `link_payments`	Sí	Sí	No	La cuenta conectada debe ser de un país admitido.	Sí
MobilePay `mobilepay_payments`	No, consulta las empresas prohibidas.	El método de pago debe activarse en la página de configuración del Dashboard.	No	La cuenta conectada debe ser de un país admitido.	Sí
Multibanco `multibanco_payments`	Sí	El método de pago debe activarse en la página de configuración del Dashboard.	No	La cuenta conectada debe ser de un país admitido.	Sí
OXXO `oxxo_payments`	Sí	Sí, en el primer intento de pago.	No	La cuenta conectada debe ser de un país admitido.	Sí
P24 `p24_payments`	Sí	Sí	No	La cuenta conectada debe ser de un país admitido.	Sí
Pay by Bank `pay_by_bank_payments`	Sí	El método de pago debe activarse en la página de configuración del Dashboard.	No	La cuenta conectada debe ser de un país admitido.	Sí
PayNow `paynow_payments`	No, consulta las empresas prohibidas.	Sí, si el MCC no figura en la lista de empresas prohibidas de PayNow	No	La cuenta conectada debe ser de un país admitido.	Sí
Pix `pix_payments`	Sí	La funcionalidad debe activarse en la página de configuración del Dashboard.	No	La cuenta conectada debe ser de un país admitido.	No
PromptPay `promptpay_payments`	Sí	Sí	No	La cuenta conectada debe ser de un país admitido.	Sí
Satispay `satispay_payments`	No, consulta las empresas prohibidas.	La funcionalidad debe activarse en la página de configuración del Dashboard.	No	La cuenta conectada debe estar en un país admitido.	Sí
Transferencias bancarias SEPA `sepa_bank_transfer_payments`	Sí	Sí	No	La cuenta conectada debe ser de un país admitido.	Sí
Débito SEPA `sepa_debit_payments`	Sí	Sí	Sí	La cuenta conectada debe ser de un país admitido.	Sí
Sofort `sofort_payments`	Sí	Sí	No	La cuenta conectada debe ser de un país admitido.	No
Transferencias bancarias en USD `us_bank_transfer_payments`	Sí	Sí	No	La cuenta conectada debe ser de un país admitido.	Sí
WeChat Pay `wechat_pay_payments`	No, consulta las empresas prohibidas.	El método de pago debe activarse en la página de configuración del Dashboard. Además, solicita una invitación para crear cargos en nombre de otras cuentas.	No	La cuenta conectada debe ser de un país admitido.	No

Obtén más información sobre la compatibilidad de métodos de pago con Connect.

Pagos internacionales de la India

Debes solicitar la capacidad de admitir transacciones de compradores ubicados fuera de la India que usen una moneda diferente a INR. Completa lo siguiente durante tu proceso de onboarding para habilitar los pagos internacionales:

Especifica un código de propósito de transacción. El campo export_purpose_code describe la naturaleza de un pago recibido en moneda extranjera. El Banco de la Reserva de la India (RBI) conserva la lista completa de códigos de propósito de la transacción. Puedes encontrar el subconjunto de códigos de propósito de transacción que admite Stripe en el Listado de códigos de propósito de transacción.
Especifica tu código de importador o exportador (IEC). El campo export_license_id contiene el valor del código IEC. La Dirección General de Comercio Exterior de la India (DGFT) emite este código para la India. Puedes solicitar un IEC en el sitio web de la DGFT. En ciertas condiciones, se requiere un IEC.
- Si planeas aceptar Visa o Mastercard, se requiere un IEC solo si vendes bienes físicos. Tu export_purpose_code es para bienes físicos.
- Si planeas aceptar pagos internacionales AMEX para todas las transacciones de exportación, incluida la venta de bienes físicos y servicios. Esto se describe en la Política de Comercio Exterior de la India.

Para obtener más detalles, consulta Acepta pagos internacionales desde 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 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.

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:

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.

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:

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

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:

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.
Actualiza tus cuentas conectadas existentes para solicitar la combinación adecuada de card_payments y transfers.
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.
Una vez que las nuevas funcionalidades estén activas para todas las cuentas conectadas, quita las referencias a legacy_payments de la programación.

Nota

No puedes anular la solicitud de la funcionalidad legacy_payments. Stripe te notificará con antelación antes de que la quitemos.

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.

Antes de solicitar nuevas funcionalidades Nuevas funcionalidades solicitadas Nuevos requisitos completados

Antes de solicitar nuevas funcionalidades	Nuevas funcionalidades solicitadas	Nuevos requisitos completados
`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`

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

Nota

Durante la transición, es posible que los requisitos card_payments y transfers aparezcan en past_due. Sin embargo, si legacy_payments está activo, los cargos, las transferencias y los pagos permanecen habilitados.

Consulta también

Crea un cargo