# Bonifici istantanei per Connect

Offri agli account connessi l'accesso immediato ai fondi con bonifici istantanei.

Se vuoi abilitare Instant Payouts e sei un utente della DashboardStripe, consulta [Instant Payouts per utenti della Dashboard 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.

Puoi utilizzare Instant Payouts per:

- Attract and retain new connected accounts
- Genera ulteriori ricavi [applicando una commissione](https://docs.stripe.com/connect/instant-payouts.md#monetization-and-fees)

I fondi acquisiti dai pagamenti con carta sono disponibili per i bonifici istantanei non appena l’addebito è stato completato. Gli addebiti bancari o ACH sono disponibili per i bonifici istantanei solo dopo che il pagamento è stato regolato.

## 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

### Idoneità dei conti esterni

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**.

| Paese                                              | Tipo di conto esterno idoneo                                                                                                      |
| -------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| US, GB, European Union (Euro Area), SE, DK, SG, AU | Carta di debito, alcuni conti bancari ([verifica le banche supportate](https://docs.stripe.com/payouts/instant-payouts-banks.md)) |
| CA,CZ,HU,NO,PL,RO,NZ,MY,AE                         | Carta di debito ([verifica le banche supportate](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 "<<YOUR_SECRET_KEY>>:" \
  -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 "<<YOUR_SECRET_KEY>>:" \
  -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.

## Monetizzazione e commissioni

Alcuni marketplace e piattaforme scelgono di monetizzare i bonifici istantanei offrendo questo servizio a pagamento. Se monetizzi i bonifici istantanei, Stripe propone due metodi per riscuotere le commissioni dagli utenti: commissioni: commissioni della piattaforma e addebiti sull’account.

### Commissioni della piattaforma

Con le [commissioni della piattaforma](https://docs.stripe.com/api/application_fees.md), Stripe riscuote la commissione da te indicata e dispone il bonifico istantaneo in modo sincrono. Stripe consiglia di applicare una commissione della piattaforma perché si tratta di una transazione unica e semplice:

- Gli utenti non possono pagare più del loro saldo disponibile
- Le commissioni possono essere rimborsate tramite l’API o la Dashboard
- Le opzioni di monetizzazione includono commissioni fisse o variabili con minimi e massimi
- Le commissioni vengono associate ai ricavi di Instant Payouts con l’[oggetto Payout](https://docs.stripe.com/api/payouts/object.md), per facilitare la rendicontazione e la riconciliazione. Puoi visualizzare la [scheda Pagamenti](https://dashboard.stripe.com/connect/application_fees) della 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.

### Addebiti sull’account

Puoi [addebitare direttamente](https://docs.stripe.com/connect/account-debits.md) il saldo Stripe del tuo account connesso e accreditare il saldo Stripe dell’account della tua piattaforma per riscuotere le commissioni. Dopo il bonifico istantaneo, chiama l’[API Charge](https://docs.stripe.com/api.md#create_charge) e specifica l’ID dell’account connesso come parametro `source`. Tieni presente le seguenti limitazioni quando utilizzi gli addebiti sull’account per riscuotere le commissioni dei bonifici istantanei:

- Both your platform and the connected account must be in the same region.
- Devi ottenere il consenso giuridicamente vincolante da parte dei tuoi account connessi.
- Gli addebiti sull’account comportano un [costo aggiuntivo](https://stripe.com/connect/pricing).
- Non puoi addebitare su un account connesso un importo superiore al suo saldo a meno che non siano [attive le riserve](https://docs.stripe.com/connect/account-balances.md#understanding-connected-reserve-balances) (impostazione predefinita per tutte le nuove piattaforme create dopo il 31 gennaio 2017) e che la valuta del conto bancario sia la stessa dell’addebito.
- Se l’account connesso ha già versato la totalità del saldo disponibile, la riscossione della commissione potrebbe subire ritardi.
- Per la riconciliazione devi creare un database interno degli addebiti e dei relativi bonifici.

## 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.

#### Componenti incorporati

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. Chiama [retrieve balance](https://docs.stripe.com/api/balance/balance_retrieve.md), espandendo [instant_available-net_available](https://docs.stripe.com/api/balance/balance_object.md#balance_object-instant_available-net_available).

La proprietà `instant_available.net_available` rappresenta il saldo istantaneo dell’account connesso, al netto delle commissioni della piattaforma per ogni destinazione immediatamente disponibile. Devi utilizzare questo campo se monetizzi con le [commissioni della piattaforma](https://docs.stripe.com/connect/instant-payouts.md#application-fees). L’importo viene calcolato in base alla struttura tariffaria della commissione della piattaforma impostata nella Dashboard.

La proprietà `instant_available.amount` rappresenta il saldo lordo dell’account connesso, escluse le commissioni della piattaforma.

L’esempio seguente mostra una piattaforma che imposta la tariffa 2% per qualsiasi bonifico istantaneo in USD:

```curl
curl -G https://api.stripe.com/v1/balance \
  -u "<<YOUR_SECRET_KEY>>:" \
  -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
      }
    }
  ],
  ...
}
```

> I fondi degli addebiti con carta sono disponibili immediatamente, ma i fondi degli addebiti bancari (come ACH) non sono disponibili immediatamente.

Considerazioni chiave:

- `net_available` viene visualizzato solo se incluso come [parametro espanso](https://docs.stripe.com/expand.md).
- `net_available` viene visualizzato solo per gli account connessi. Riceverai un messaggio di errore durante l’espansione di questa funzionalità per la tua piattaforma.
- Un hash in `net_available` viene visualizzato solo per i conti esterni immediatamente disponibili. I conti esterni che non sono destinazioni di bonifici istantanei valide non verranno visualizzati.
- I conti esterni possono avere saldi `net_available` diversi in base alle proprietà dei conti esterni e alle regole sulle tariffe stabilite dalla piattaforma.

1. Chiama [create payout](https://docs.stripe.com/api/payouts/create.md) con `method=instant`. Utilizza il campo dell’importo corrispondente alla tua strategia di monetizzazione oppure `instant_available.amount` `instant_available.net_available[0].amount`. Utilizza la `destination` dell’endpoint del saldo per effettuare un pagamento su un conto esterno previsto.

```curl
curl https://api.stripe.com/v1/payouts \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d amount=490 \
  -d currency=usd \
  -d method=instant \
  -d "destination={{BANKACCOUNTTOKEN_ID}}"
```

> I bonifici istantanei a conti esterni non idonei non andranno a buon fine, quindi [verifica l’idoneità](https://docs.stripe.com/connect/instant-payouts.md#external-account-eligibility) prima di rendere disponibile la funzionalità per i tuoi account connessi.

1. Visualizza la [commissione della piattaforma](https://docs.stripe.com/api/application_fee/retrieve.md) creata dal bonifico.

```curl
curl https://api.stripe.com/v1/application_fees/{{APPLICATIONFEE_ID}} \
  -u "<<YOUR_SECRET_KEY>>:"
```

#### 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. Vai alla pagina dell’account connesso specifico.
1. Se l’account connesso ha un saldo disponibile istantaneo, fai clic su **Trasferisci dal saldo dell’account**.
1. Nella finestra modale, inserisci l’importo e scegli **Istantaneo** come tipo di bonifico.
1. Fai clic su **Paga** per completare il pagamento.

## Idoneità e limiti del volume giornaliero

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 

Se le piattaforme e i marketplace sono responsabili delle perdite, sei responsabile dei saldi negativi non coperti dovuti a rimborsi o contestazioni.

Stripe consiglia di impostare parametri di rischio per proteggere la piattaforma da perdite indesiderate. Offriamo una serie di [pratiche ottimali per gestire frodi e rischi](https://docs.stripe.com/connect/risk-management/best-practices.md#fraud), ad esempio l’impostazione di soglie di fiducia come le seguenti:

- Volume minimo di elaborazione
- Giorni attivi
- Tasso di storno

### 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).

## Tariffe

Indipendentemente dalle tue scelte in termini di monetizzazione Stripe addebita ai marketplace e alle piattaforme una commissione dell’1% per tutti i bonifici istantanei. Ogni transazione con bonifico istantaneo ha un importo minimo e massimo che dipende dalla valuta. Queste commissioni vengono incluse nella tariffa complessiva di Connect.

| Paese                      | 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

Le comunicazioni di marketing su Instant Payouts destinate agli account connessi devono indicare in modo chiaro e visibile le commissioni che intendi applicare per 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.