Eine Rechnung in der Vorschau anzeigen

Sie können eine Vorschau einer Rechnung für Ihren Kundinnen und Kunden erstellen, während sie einen Kauf in Erwägung ziehen. Erstellen Sie eine Vorschau, um den gesamten Rechnungsbetrag zu berechnen, jeden Rechnungsposten abzurufen und alle relevanten Steuern oder Rabatte einzubeziehen. Wenn Sie eine Vorschau erstellen, können Sie Ihren Kundinnen/Kunden den gesamten Zahlungsbetrag anzeigen, ohne eine Rechnung erstellen zu müssen.

Beispielsweise können Sie beim Betrieb eines Unternehmens, das Reparaturdienstleistungen für Unternehmen erbringt, Ihren Kundinnen/Kunden mehrere Artikel mit jeweils unterschiedlichen Preisen und Abrechnungsplänen vorlegen:

• Artikel 1: 299 USD einmalige Servicegebühr
• Artikel 2: 29 USD Reparaturmaterial A
• Artikel 3: 99 USD Reparaturmaterial B
• Artikel 4: 49 USD pro Monat Supportplan

Kunden/Kundinnen möchten vielleicht wissen, wie viel verschiedene Kombinationen Ihrer Waren und Dienstleistungen kosten. Wenn sie beabsichtigen, die Artikel 1 und 3 zu kaufen und dabei den Promo-Code WINTERSALE für 15 % Rabatt anwenden, führen Sie den folgenden API-Aufruf durch:

curl https://api.stripe.com/v1/invoices/create_preview \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "invoice_items[0][price]"=price_item_1 \
  -d "invoice_items[0][quantity]"=1 \
  -d "invoice_items[1][price]"=price_item_3 \
  -d "invoice_items[1][quantity]"=1 \
  -d "discounts[0][promotion_code]"=promo_WINTERSALE

Stripe gibt eine Rechnungsvorschau mit jedem der Posten, dem angewendeten Rabatt und dem Gesamtbetrag zurück:

{
  "id": "upcoming_in_1OujwkClCIKljWvsq5v2ICAN",
  "object": "invoice",
  "account_country": "US",
  "account_name": "Stripe Docs",
  "account_tax_ids": null,
  "amount_due": 39800,
  "amount_paid": 0,
  "amount_remaining": 39800,
  "amount_shipping": 0,

Zusätzlich kann die resultierende Rechnungsvorschau über den Endpoint /v1/invoices/:id für die folgenden 72 Stunden abgerufen werden:

curl https://api.stripe.com/v1/invoices/upcoming_in_1OujwkClCIKljWvsq5v2ICAN \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:"

Stripe Tax einbeziehen

Um eine Vorschau der Steuerbeträge von Stripe Tax anzuzeigen, legen Sie automatic_tax[enabled] = true fest und übergeben Sie die Adresse des Kunden/der Kundin in customer_details[address]:

curl https://api.stripe.com/v1/invoices/create_preview \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "customer_details[address][line1]"="920 5th Ave" \
  -d "customer_details[address][city]"=Seattle \
  -d "customer_details[address][state]"=WA \
  -d "customer_details[address][postal_code]"=98104 \
  -d "customer_details[address][country]"=US \
  -d "automatic_tax[enabled]"=true \
  -d "invoice_items[0][price]"=price_item_1 \
  -d "invoice_items[0][quantity]"=1 \
  -d "invoice_items[1][price]"=price_item_3 \
  -d "invoice_items[1][quantity]"=1 \
  -d "discounts[0][promotion_code]"=promo_WINTERSALE

Vorschau von Rechnungen mit Abonnements

Um eine Vorschau der ersten Rechnung mit einem wiederkehrenden Preis anzuzeigen, verwenden Sie den Parameter subscription_details.items:

curl https://api.stripe.com/v1/invoices/create_preview \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "subscription_details[items][0][price]"=price_recurring_4 \
  -d "subscription_details[items][0][quantity]"=1 \
  -d "invoice_items[0][price]"=price_item_1 \
  -d "invoice_items[0][quantity]"=1 \
  -d "invoice_items[1][price]"=price_item_3 \
  -d "invoice_items[1][quantity]"=1 \
  -d "discounts[0][promotion_code]"=promo_WINTERSALE

Um Änderungen an einem bestehenden Abonnement in der Vorschau anzuzeigen, geben Sie die Abonnement- oder Abonnementplan-ID an.

Nur wiederkehrende Zahlungen in der Vorschau anzeigen

Ihr Kunde/Ihre Kundin wünscht möglicherweise ein wiederkehrendes Abonnement zusammen mit einmaligen Posten oder temporären Gutschriften oder Rabatten, die er/sie für seinen Kauf verwenden kann. Wenn sie wissen möchten, wie hoch die wiederkehrenden Zahlungen nach den Anpassungen sind, verwenden Sie den Parameter preview_mode, um den Kundinnen/Kunden eine Vorschau der Gesamtsumme zu zeigen.

Wenn es sich bei WINTERSALE beispielsweise um einen einmaligen Rabatt von 15 % handelt und der Kunde/die Kundin die Artikel 1, 3 und 4 kaufen möchte, können Sie den wiederkehrenden Zahlungsbetrag mit diesem API-Aufruf abrufen:

curl https://api.stripe.com/v1/invoices/create_preview \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d preview_mode=recurring \
  -d "subscription_details[items][0][price]"=price_recurring_4 \
  -d "subscription_details[items][0][quantity]"=1 \
  -d "invoice_items[0][price]"=price_item_1 \
  -d "invoice_items[0][quantity]"=1 \
  -d "invoice_items[1][price]"=price_item_3 \
  -d "invoice_items[1][quantity]"=1 \
  -d "discounts[0][promotion_code]"=promo_WINTERSALE

Die resultierende Rechnung enthält nur den Supportplan von 49 USD pro Monat ohne Rabatte. Ebenso können Sie preview_mode mit subscription oder subscription_schedule kombinieren, um die erwarteten wiederkehrenden Zahlungen anzuzeigen, mit Ausnahme von einmaligen Posten und Rabatten.

Paginierung der Rechnungsposten

Bei Rechnungen mit mehr als 10 Zeilen können Sie eine paginierte Ansicht der Zeilen abrufen:

curl https://api.stripe.com/v1/invoices/upcoming_in_1OujwkClCIKljWvsq5v2ICAN/lines \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:"