Clients multidevises

Utilisez l’API Invoicing pour émettre une facture à un client dans une autre devise. Grâce à la fonctionnalité multidevises, vous pouvez débiter le même client dans une autre devise que celle paramétrée par défaut, et modifier la devise des abonnements d’un client. Vous ne pouvez pas avoir deux abonnements actifs avec des devises différentes.

Ce guide explique également comment créer une note de crédit et consulter le solde créditeur d’un client dans toutes les devises attribuées. À titre d’exemple, nous utilisons le dollar canadien (CAD).

Créer une facture

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

Le nombre maximal de postes de facture est 250. Lorsque vous créez une facture, vous pouvez ajouter jusqu’à 250 postes de facture en attente. Vous devrez ajouter les postes de facture restants à la prochaine facture. Pour connaître les postes de facture en attente de votre client, consultez la page Informations sur le client ou définissez le paramètre pending à true lorsque vous utilisez l’API pour répertorier 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

Vous devez transmettre le paramètre currency lorsque vous émettez une facture multidevises. Le paramètre currency détermine les postes de facture qui doivent être intégrés à la facture. Par exemple, si vous créez deux postes de facture, l’un en USD et l’autre en CAD, pour le même client, le fait de définir la devise à CAD uniquement ne permettrait d’obtenir que le poste de facture en CAD (sans tenir compte du poste de facture en USD).

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 une note de crédit

S’il y a un problème avec la facture, vous pouvez créer une note de crédit. Si vous devez appliquer le crédit au solde créditeur du client (plutôt qu’au mode de paiement d’origine), Stripe allouera le montant du crédit au solde créditeur spécifique an 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 montant du crédit 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 est prélevé sur la prochaine facture CAD créée pour ce client. Il ne sera toutefois pas prélevé pour les factures créées dans différentes devises.