Kund/innen mit mehreren Währungen

Bevor Sie einem/einer Kund/in eine Rechnung stellen, erstellen Sie einen Rechnungsposten, indem Sie die id, den amount und die currency des/der Kund/in übergeben. Fügen Sie Rechnungsposten jeweils nur einem/einer einzigen Kund/in hinzu, um zu vermeiden, dass Sie sie dem/der falschen Kund/in hinzuzufügen.

Die Höchstzahl für Rechnungsposten beträgt 250. Beim Erstellen einer Rechnung werden bis zu 250 ausstehende Rechnungsposten hinzugefügt, der Rest wird bei der nächsten Rechnung hinzugefügt. Um ausstehende Rechnungsposten Ihrer Kundinnen/Kunden anzuzeigen, rufen Sie die Seite mit Kundendetails auf oder setzen Sie das Attribut pending auf true, wenn Sie die API verwenden, um alle Rechnungsposten aufzuführen.

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

Sie müssen den Parameter currency übergeben, wenn Sie eine Rechnung in mehreren Währungen ausstellen. Der Parameter currency bestimmt, welche Rechnungsposten in die Rechnung aufgenommen werden. Wenn Sie beispielsweise zwei Rechnungsposten – eine in USD und die andere in CAD – für denselben Kunden/dieselbe Kundin erstellen wollten, würde durch Festlegen der Währung auf CAD nur der Rechnungsposten in CAD aufgenommen (und der USD-Rechnungsposten ignoriert).

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

Wenn es ein Problem mit der Rechnung gibt, können Sie eine Stornorechnung erstellen. Wenn Sie das Guthaben dem Kundenguthaben zuweisen müssen (statt der ursprünglichen Zahlungsmethode), weist Stripe den Guthabenbetrag dem CAD-spezifischen Guthaben zu.

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

Verwenden Sie den Parameter invoice_credit_balance, um zu sehen, über wie viel Guthaben ein/e Kund/in in jeder Währung verfügt:

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

Das Guthaben des Kunden/der Kundin wird von der nächsten für ihn/sie erstellten Rechnung in CAD abgezogen. Es wird jedoch nicht von Rechnungen abgezogen, die in unterschiedlichen Währungen erstellt wurden.