Clients multi-devises

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.

Vous ne pouvez pas dépasser 250 postes de facture. Lorsque vous créez une facture, vous pouvez ajouter jusqu’à 250 postes de facture en attente, et les postes de facture restants sont ajoutés à la prochaine facture. Pour connaître les postes de facture en attente de votre client, consultez la page des informations client ou définissez le paramètre pending 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_VePHdqKTYQjKNInc7u56JBrQ
:" \
  -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_VePHdqKTYQjKNInc7u56JBrQ
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d collection_method=send_invoice \
  -d days_until_due=30 \
  -d pending_invoice_items_behavior=include \
  -d currency=cad

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_VePHdqKTYQjKNInc7u56JBrQ
:" \
  -d invoice={{INVOICE_ID}} \
  -d reason=duplicate \
  -d amount=1000 \
  -d credit_amount=1000

To see how much credit a customer has in each currency, use the invoice_credit_balance parameter:

curl https://api.stripe.com/v1/customers/{{CUSTOMER_ID}} \
  -u "
sk_test_VePHdqKTYQjKNInc7u56JBrQ
:" \
  -d "expand[]"=invoice_credit_balance

The customer’s credit balance is drawn down from the next CAD invoice created for this customer. It won’t, however, be drawn down for invoices created in different currencies.