Kund/innen mit mehreren Währungen

Verwenden Sie die Invoicing API, um einem Kunden/einer Kundin eine Rechnung in einer anderen Währung auszustellen. Mit der Funktion für mehrere Währungen für Kundinnen/Kunden können Sie für den/die Kunden/Kundin Rechnungen in einer anderen Währung ausstellen als der festgelegten Standardwährung und die Währung für die Abonnements eines Kunden/einer Kundin ändern. Sie können nicht zwei aktive Abonnements mit unterschiedlichen Währungen haben.

In diesem Leitfaden wird ebenfalls erläutert, wie Sie eine Stornorechnung erstellen und das Guthaben einer Kundin/eines Kunden in allen zugewiesenen Währungen prüfen können. Zur Veranschaulichung wird der kanadische Dollar (CAD) verwendet.

Rechnung erstellen

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_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d collection_method=send_invoice \
  -d days_until_due=30 \
  -d pending_invoice_items_behavior=include \
  -d currency=cad

Stornorechnung

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

Guthaben überprüfen

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_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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.