# Clienti multi-valuta

Modificare la valuta di addebito per consentire ai clienti di accettare più valute

Se devi vendere in più valute ma ogni singolo cliente ne usa una, consulta [Prezzi multi-valuta](https://docs.stripe.com/products-prices/how-products-and-prices-work.md#multiple-currencies).

Usa l’API Invoicing per emettere una fattura per un cliente in una valuta diversa. Grazie alla funzione clienti multi-valuta, puoi addebitare gli importi allo stesso *cliente* (Customer objects represent customers of your business. They let you reuse payment methods and give you the ability to track multiple payments) utilizzando una valuta diversa da quella impostata come predefinita e modificare la valuta degli abbonamenti di un cliente. Non puoi avere due abbonamenti attivi con valute diverse.

Questa guida spiega anche come creare una nota di credito e consultare il saldo a credito di un cliente in tutte le valute assegnate. A scopo illustrativo, utilizziamo il dollaro canadese (CAD).

## Crea una fattura

Prima di emettere la fattura a un cliente, crea una voce fattura specificando `id`, `amount` e `currency`. del cliente. Aggiungi le voci fattura a un solo cliente alla volta per evitare di aggiungerle a quello sbagliato.

Il numero massimo di voci fattura è 250. Quando crei una fattura, puoi aggiungere 250 voci fattura in sospeso, mentre le restanti verranno aggiunte alla fattura successiva. Per visualizzare le voci della fattura in sospeso del cliente, consulta la pagina **Dettagli cliente** o imposta l’attributo [pending](https://docs.stripe.com/api/invoiceitems/list.md#list_invoiceitems-pending) su `true` se utilizzi l’API per elencare tutte le voci della fattura.

> Una fattura in CAD non applica un saldo a credito del cliente denominato in USD o in qualsiasi altra valuta diversa da CAD. Inoltre, tutti i coupon di sconto applicati al cliente denominati in valute diverse da CAD verranno ignorati.

```curl
curl https://api.stripe.com/v1/invoiceitems \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d customer="{{CUSTOMER_ID}}" \
  -d amount=1000 \
  -d currency=cad
```

Quando emetti una fattura multi-valuta, devi specificare il parametro `currency`, che determina quali voci della fattura vengono inserite nella fattura. Ad esempio, se crei due voci fattura, una in USD e l’altra in CAD, per lo stesso cliente, e imposti la valuta su CAD, verrà visualizzata solo la voce fattura in CAD, mentre la voce fattura in USD verrà ignorata.

```curl
curl https://api.stripe.com/v1/invoices \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d customer="{{CUSTOMER_ID}}" \
  -d collection_method=send_invoice \
  -d days_until_due=30 \
  -d pending_invoice_items_behavior=include \
  -d currency=cad
```

## Crea una nota di credito

In casi di problemi con la fattura, puoi creare una nota di credito. Se devi applicare il credito al saldo a credito del cliente (anziché al metodo di pagamento originale), Stripe alloca l’importo del credito al saldo a credito specifico del CAD.

```curl
curl https://api.stripe.com/v1/credit_notes \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d invoice={{INVOICE_ID}} \
  -d reason=duplicate \
  -d amount=1000 \
  -d credit_amount=1000
```

## Ispeziona il saldo a credito

Per visualizzare l’importo del credito di un cliente in ciascuna valuta, utilizza il parametro `invoice_credit_balance`:

```curl
curl -G https://api.stripe.com/v1/customers/{{CUSTOMER_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "expand[]"=invoice_credit_balance
```

Il saldo a credito del cliente viene utilizzato per pagare la prossima fattura in CAD creata per questo cliente, ma non per le fatture create in altre valute.

## See also

- [Eseguire l’integrazione con l’API Invoicing](https://docs.stripe.com/invoicing/integration.md)
- [Gestire i clienti](https://docs.stripe.com/invoicing/customer.md)
- [Prodotti e prezzi](https://docs.stripe.com/invoicing/products-prices.md)