# Instant Payouts para Connect Ofrece a las cuentas conectadas acceso inmediato a sus fondos con transferencias instantáneas. Si quieres habilitar Instant Payouts y eres usuario del Dashboard de Stripe, consulta [Instant Payouts para usuarios del Dashboard de Stripe](https://docs.stripe.com/payouts/instant-payouts.md). With Instant Payouts, Connect platforms and marketplaces can allow their connected accounts to access their balances immediately following a successful charge. Instant Payouts are available at any day or time, including weekends and holidays, and funds typically settle in the associated bank account within 30 minutes. Puedes usar Instant Payouts para: - Attract and retain new connected accounts - Conseguir ingresos adicionales [evaluando el uso de una comisión](https://docs.stripe.com/connect/instant-payouts.md#monetization-and-fees) Los fondos adquiridos de los pagos con tarjeta están disponibles para Instant Payouts tan pronto como se completa el cargo. Los adeudos ACH o bancarios solo están disponibles para Instant Payouts después de que se haya liquidado el pago. ## Eligible connected accounts Instant Payouts can also be made to connected accounts that are in different regions from the platform. Instant Payouts are available for connected accounts when: - The connected account is onboarded using full [terms of service](https://docs.stripe.com/connect/service-agreement-types.md). - The connected account is using the local currency for payout. - Both the platform and connected account are in supported countries. Instant Payouts are available to platforms and their connected accounts in the following countries. ### Availability - AE - AU - CA - DK - EU - GB - HK - MY - NO - NZ - SE - SG - US ### Requisitos de la cuenta externa To receive Instant Payouts, a connected account must have an eligible external account. An external account in the context of Stripe Connect refers to a bank account or debit card associated with a connected account, and eligibility varies by country. If you’re responsible for connected accounts (including Custom and Express accounts) that might not be able to refund negative balances, enable Stripe-hosted onboarding and dashboard interfaces to collect debit card details. To enable this, go to your [External Account settings](https://dashboard.stripe.com/settings/connect/payouts/external_accounts), and under **Allow debit cards?**, select **Yes**. | País | Tipo de cuenta externa que cumple los requisitos | | -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | | US, GB, European Union (Euro Area), SE, DK, SG, AU | Tarjeta de débito; algunas cuentas bancarias ([consulta los bancos admitidos](https://docs.stripe.com/payouts/instant-payouts-banks.md)) | | CA,CZ,HU,NO,PL,RO,NZ,MY,AE | Tarjeta de débito ([consulta los bancos admitidos](https://docs.stripe.com/payouts/instant-payouts-banks.md)) | | HK | Some bank accounts ([check supported banks](https://docs.stripe.com/payouts/instant-payouts-banks.md)) | To verify a connected account’s eligibility for Instant Payouts, retrieve its external accounts by calling the [External Accounts API](https://docs.stripe.com/api/external_account_bank_accounts/list.md) with the connected account’s ‘Account’ ID. External accounts that include `instant` in the `available_payout_methods` array are eligible to receive Instant Payouts. The response returns the account’s 10 most recently active External Accounts, and you can paginate through the results if you need to review more than the default display of 10. ```curl curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}}/external_accounts \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" ``` ```json { "object": "list", "data": [ { "object": "bank_account", "available_payout_methods": [ "standard", "instant" ], ... } ], } ``` ### Invite connected accounts to add eligible accounts If a connected account doesn’t have an external account that’s eligible for Instant Payouts, you can prompt them to provide one and add it using the [External Accounts API](https://docs.stripe.com/api/external_account_bank_accounts/create.md). ```curl curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "external_account={{BANKACCOUNTTOKEN_ID}}" ``` > For information on how to manage which of your connected accounts are eligible for Instant Payouts, see the section on [Managing Risk and Eligibility](https://docs.stripe.com/connect/instant-payouts.md#manage-risk-and-eligibility) below. ## Monetización y comisiones Algunos marketplaces y plataformas optan por monetizar Instant Payouts y ofrecen comodidad a cambio de una comisión. Si monetizas Instant Payouts, Stripe admite dos métodos de cobro de comisiones: comisiones de la plataforma y adeudos a cuenta ### Comisiones de la plataforma Con las [comisiones de la plataforma](https://docs.stripe.com/api/application_fees.md), Stripe cobra la comisión que determines e inicia la transferencia instantánea de forma sincrónica. Stripe recomienda aplicar una comisión de la plataforma porque se trata de una transacción única y fluida: - Los usuarios no pueden transferir más de su saldo disponible - Las comisiones se pueden reembolsar a través de la API o del Dashboard - Las opciones de monetización incluyen comisiones fijas o variables con mínimos y máximos - Las comisiones se asocian a tus ingresos de Instant Payouts con el [objeto Payout](https://docs.stripe.com/api/payouts/object.md), lo que ayuda a la generación de informes y a la conciliación. Puedes consultar las comisiones que se han cobrado en la [pestaña Pagos](https://dashboard.stripe.com/connect/application_fees) del Dashboard You can control application fee pricing for Instant Payouts using the [Platform Pricing Tool](https://dashboard.stripe.com/test/settings/connect/platform_pricing/instant_payouts) in your Dashboard. > Application fees for Instant Payouts rely on the `Balance` object’s [instant_available.net_available](https://docs.stripe.com/api/balance/balance_object.md#balance_object-instant_available-net_available) property. Turning on Instant Payouts without using the `instant_available.net_available` property could break your API integration. ### Débitos a cuenta Puedes [adeudar directamente](https://docs.stripe.com/connect/account-debits.md) el saldo de Stripe de tu cuenta conectada y acreditar el saldo de Stripe de tu cuenta de la plataforma para cobrar comisiones. Después de la transferencia instantánea, llama a la [API Charge](https://docs.stripe.com/api.md#create_charge) y especifica el ID de la cuenta conectada como parámetro `source`. Ten en cuenta las siguientes limitaciones cuando uses adeudos en cuenta para cobrar comisiones de Instant Payouts: - Both your platform and the connected account must be in the same region. - Debes obtener el consentimiento legalmente vinculante de tus cuentas conectadas. - Los adeudos a cuenta conllevan un [coste adicional](https://stripe.com/connect/pricing). - El adeudo en una cuenta no puede hacer que el saldo de la cuenta conectada sea negativo a menos que tengas [habilitadas](https://docs.stripe.com/connect/account-balances.md#understanding-connected-reserve-balances) las reservas (activadas de manera predeterminada para todas las plataformas nuevas creadas después del 31 de enero del 2017) y tengas una cuenta bancaria en la misma divisa que el adeudo. - Si la cuenta conectada ya ha transferido el saldo disponible en su totalidad, es posible que te retrases en el cobro de la comisión. - La conciliación requiere mantener una base de datos interna de los adeudos y las transferencias relacionadas. ## Enable your connected accounts to initiate instant payouts You can initiate Instant Payouts either manually on your users’ behalf or use the Stripe APIs or [Connect embedded components](https://docs.stripe.com/connect/get-started-connect-embedded-components.md) to create user interfaces that allow your users to initiate an Instant Payout themselves. When you initiate Instant Payouts on your users’ behalf, make sure to follow the instructions and authorizations provided by your users. #### Componentes integrados You can enable your connected accounts to initiate Instant Payouts directly from your website by using the [instant-payouts-promotion](https://docs.stripe.com/connect/supported-embedded-components/instant-payouts-promotion.md) component, [balances](https://docs.stripe.com/connect/supported-embedded-components/balances.md) component, or [payouts](https://docs.stripe.com/connect/supported-embedded-components/payouts.md) component, and then enabling the `instant_payouts` [account session feature](https://docs.stripe.com/api/account_sessions/create.md#create_account_session-components-balances-features-instant_payouts). Connect embedded components offer an alternative to using the API directly and handle evaluating eligibility and making all relevant API calls to initiate an Instant Payout. Note: The following is a preview/demo component that behaves differently than live mode usage with real connected accounts. The actual component has more functionality than what might appear in this demo component. For example, for connected accounts without Stripe dashboard access (custom accounts), no user authentication is required in production. Learn how to [get started with Connect embedded components](https://docs.stripe.com/connect/get-started-connect-embedded-components.md) or create an integration using the [quickstart](https://docs.stripe.com/connect/connect-embedded-components/quickstart.md). #### API 1. Llama a [recuperar saldo](https://docs.stripe.com/api/balance/balance_retrieve.md), expandiendo [instant_available-net_available](https://docs.stripe.com/api/balance/balance_object.md#balance_object-instant_available-net_available). La propiedad `instant_available.net_available` es el saldo instantáneo de la cuenta conectada, neto de las comisiones de la plataforma para cada destino disponible al instante. Debes usar este campo si vas a monetizar con [comisiones de la plataforma](https://docs.stripe.com/connect/instant-payouts.md#application-fees). Este importe se calcula a partir de la estructura de precios de comisiones de la plataforma que se establece en el Dashboard. La propiedad `instant_available.amount` es el saldo bruto de la cuenta conectada, sin incluir las comisiones de la plataforma. El siguiente ejemplo muestra una plataforma que establece una tarifa del 2 % para cualquier transferencia instantánea en USD: ```curl curl -G https://api.stripe.com/v1/balance \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "expand[]=instant_available.net_available" ``` ```json { "object": "balance", "available": [ { "amount": 500, "currency": "usd", "source_types": { "card": 500 } } ], "instant_available": [ { "amount": 500, "currency": "usd", "net_available": [ { "amount": 490, "destination": "ba_abc123", "source_types": { "card": 490 } } ], "source_types": { "card": 500 } } ], ... } ``` > Los fondos de los cargos de la tarjeta están disponibles de inmediato, a diferencia de los fondos de los adeudos bancarios (como ACH). Aspectos clave a tener en cuenta: - `net_available` solo aparece cuando se incluye como un [parámetro expandido](https://docs.stripe.com/expand.md). - `net_available` solo aparece para las cuentas conectadas. Recibirás un mensaje de error al expandirlo para tu plataforma. - Un hash en `net_available` solo aparece para las cuentas externas disponibles al instante. No aparecerán las cuentas externas que no sean destinos válidos para transferencias instantáneas. - Las cuentas externas pueden tener diferentes saldos `net_available` según las propiedades de las cuentas externas y las reglas de tarifas establecidas por la plataforma. 1. Llama a [crear una transferencia](https://docs.stripe.com/api/payouts/create.md) con `method=instant`. Utiliza el campo de importe correspondiente a tu estrategia de monetización, ya sea `instant_available.amount` o `instant_available.net_available[0].amount`. Usa el `destination` del punto de conexión del saldo para hacer transferencias a una cuenta externa prevista. ```curl curl https://api.stripe.com/v1/payouts \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d amount=490 \ -d currency=usd \ -d method=instant \ -d "destination={{BANKACCOUNTTOKEN_ID}}" ``` > Las transferencias instantáneas a cuentas externas que no cumplan los requisitos darán error, así que [confirma que se cumplen los requisitos](https://docs.stripe.com/connect/instant-payouts.md#external-account-eligibility) antes de hacer pasar la funcionalidad a tus cuentas conectadas. 1. Consulta la [comisión de la plataforma](https://docs.stripe.com/api/application_fee/retrieve.md) creada por la transferencia. ```curl curl https://api.stripe.com/v1/application_fees/{{APPLICATIONFEE_ID}} \ -u "<>:" ``` #### Dashboard You can manually initiate an Instant Payout for a connected account in the Dashboard. If you want your connected accounts to have the ability to do this independently from your website, use Connect Embedded Components or the API. To initiate an Instant Payout manually in the Dashboard: 1. Dirígete a la página específica de la cuenta conectada. 1. Si la cuenta conectada tiene un saldo instantáneo disponible, haz clic en **Transferir el saldo de la cuenta**. 1. En el modal, introduce el importe y elige **Instantánea** como tipo de transferencia. 1. Haz clic en **Transferir** para completar el pago. ## Cumplimiento de los requisitos y límites de volumen diario Each platform account has a maximum amount that it can pay out instantly per day across all connected accounts. Your connected accounts can’t initiate Instant Payouts after you reach your daily limit. Daily limits reset at midnight US Central Time (CT). ## Manage risk and eligibility Cuando las plataformas y los marketplaces son responsables de pérdidas, tú eres responsable de los saldos negativos descubiertos debido a reembolsos o disputas. Stripe recomienda establecer parámetros de riesgo para proteger tu plataforma de pérdidas no deseadas. Ofrecemos una serie de [prácticas recomendadas para gestionar el fraude y el riesgo](https://docs.stripe.com/connect/risk-management/best-practices.md#fraud) como, por ejemplo, el establecimiento de umbrales de confianza como los siguientes: - Volumen mínimo de procesamiento - Días activos - Tasa de contracargos ### Using the Stripe dashboard to manage your risk (Private preview) You can use the Stripe Dashboard eligibility tools to easily determine which of your accounts are eligible for Instant Payouts based on your target values for these fields. When you’re liable for negative balances, users that meet your criteria will get access to Instant Payouts in their Express dashboard, Standard dashboard, or embedded components. Sign in to request access to Dashboard eligibility tools for Instant Payouts in private preview. If you don’t have a Stripe account, you can [register here](https://dashboard.stripe.com/register). ## Tarifas Independientemente de tus decisiones de monetización, Stripe carga a los marketplaces y plataformas una comisión del 1 % por todas las transferencias instantáneas. Cada transacción de Instant Payouts tiene un importe mínimo y un importe máximo que dependen de la divisa. Estas comisiones se evalúan como parte de tus comisiones generales de Connect. | País | Instant Payout minimum | Instant Payout maximum | | -------------------------- | ---------------------- | ---------------------- | | US | 0,50 USD | 9,999 USD | | CA | 0,60 CAD | 9,999 CAD | | SG | 0,50 SGD | 9,999 SGD | | GB | 0,40 GBP | 9,999 GBP | | AU | 0,50 AUD | 9,999 AUD | | European Union (Euro Area) | 0,40 EUR | 9,999 EUR | | CZ | 10.00 CZK | 99,999 CZK | | DK | 5.00 DKK | 9,999 DKK | | HU | 200.00 HUF | 999,999 HUF | | NO | 5.00 NOK | 9,999 NOK | | PL | 2.00 PLN | 9,999 PLN | | RO | 2.00 RON | 9,999 RON | | SE | 5.00 SEK | 9,999 SEK | | NZ | 0.50 NZD | 9,999 NZD | | MY | 2.00 MYR | 9,999 MYR | | AE | 2.00 AED | 9,999 AED | | HK | 5.00 HKD | 9,999 HKD | ## Marketing Tu marketing sobre las transferencias instantáneas a cuentas conectadas debe indicar de manera clara y visible cualquier comisión que tengas la intención de aplicar para Instant Payouts. Make sure your marketing is consistent with Stripe’s marketing of the product, which states that: “You can request Instant Payouts 24/7, including weekends and holidays, and funds typically appear in the associated bank account within 30 minutes”. Instant Payouts normally settle within 30 minutes, but might be delayed, depending on your bank.