# Clients multi-devises

Modifiez la devise de facturation d'un client afin d'accepter plusieurs devises.

Si vous devez vendre dans plusieurs devises, mais que chaque client utilise une seule devise, consultez la page [Tarifs multidevises](https://docs.stripe.com/products-prices/how-products-and-prices-work.md#multiple-currencies).

Utilisez l’API Invoicing pour émettre une facture client dans une autre devise. La fonctionnalité multi-devises vous permet de facturer un même *client* (Customer objects represent customers of your business. They let you reuse payment methods and give you the ability to track multiple payments) dans une autre devise que sa devise par défaut et de modifier la devise de son abonnement. Vous ne pouvez pas avoir deux abonnement actifs dans deux devises différentes.

Ce guide explique également comment créer un avoir et consulter le solde créditeur d’un client pour toutes les devises qui lui sont attribuées. Dans notre exemple, nous utilisons le dollar canadien (CAD).

## Créer une facture

Avant de facturer un client, créez un poste de facture en transmettant l’`id`, le `amount` et la `currency` du client. Pour éviter toute erreur, ajoutez les postes de facture d’un seul client à la fois.

Une facture peut comporter 250 postes de facture maximum. Lorsque vous créez une facture, jusqu’à 250 postes de facture en attente y sont automatiquement ajoutés. Les éventuels postes de facture restants sont ajoutés à la facture suivante. Pour connaître les postes de facture en attente de votre client, consultez la **page des informations sur le client** ou définissez le paramètre [en attente](https://docs.stripe.com/api/invoiceitems/list.md#list_invoiceitems-pending) sur `true` lorsque vous utilisez l’API pour établir la liste de tous les postes de facture.

> Une facture en CAD n’applique aucun solde de crédit client libellé dans une autre devise que le CAD. Elle ignore également tout bon de réduction appliqué au client et libellé dans une devise différente du CAD.

#### Accounts v2

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

#### Customers&nbsp;v1

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

Lorsque vous émettez une facture multi-devises, vous devez transmettre le paramètre `currency`, qui définit les postes à inclure dans la facture. Par exemple, si vous créez deux postes de facture pour le même client, l’un en USD et l’autre en CAD, et que vous définissez la devise sur CAD, seul le poste dans la devise correspondante apparaîtra sur la facture (le poste en USD sera ignoré).

#### Accounts&nbsp;v2

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

#### Customers&nbsp;v1

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

## Créer un avoir

En cas d’erreur sur la facture, vous pouvez créer un avoir. Si vous devez appliquer l’avoir au solde créditeur du client (par opposition à un remboursement classique du moyen de paiement utilisé), Stripe applique le montant de l’avoir au solde créditeur libellé en 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
```

## Consulter le solde créditeur

Pour consulter le solde créditeur d’un client dans une devise spécifique, utilisez le paramètre `invoice_credit_balance`&nbsp;:

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

Le solde créditeur du client sera utilisé pour le règlement de la prochaine facture en CAD créée pour ce client, mais pas pour les factures libellées dans d’autres devises.

## See also

- [Réaliser une intégration avec l’API Invoicing](https://docs.stripe.com/invoicing/integration.md)
- [Gérer les clients](https://docs.stripe.com/invoicing/customer.md)
- [Produits et tarifs](https://docs.stripe.com/invoicing/products-prices.md)