Clients multi-devises

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 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 sur true lorsque vous utilisez l’API pour établir la liste de tous les postes de facture.

curl https://api.stripe.com/v1/invoiceitems \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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é).

curl https://api.stripe.com/v1/invoices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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 https://api.stripe.com/v1/credit_notes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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 :

curl -G https://api.stripe.com/v1/customers/{{CUSTOMER_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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.