Steuern für wiederkehrende Zahlungen erheben

Melden Sie sich an oder registrieren Sie sich bei Stripe, um Stripe Tax zu aktivieren.

Stripe Tax verwendet Informationen, die zu Produkten und Preisen gespeichert sind, um Steuern zu berechnen, wie z. B. Steuercode und Steuerverhalten. Wenn Sie diese Konfigurationen nicht explizit angeben, verwendet Stripe Tax den in den Steuereinstellungen ausgewählten Standard-Steuercode.

Weitere Informationen finden Sie unter Produktsteuercodes und Steuerverhalten festlegen.

curl https://api.stripe.com/v1/invoices/create_preview \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "automatic_tax[enabled]"=true \
  -d "customer_details[tax][ip_address]"={{IP_ADDRESS}} \
  -d "subscription_details[items][0][price]"=
{{PRICE_ID}}

Überprüfen Sie den automatic_tax.status der Rechnung. Wenn der Status requires_location_inputs ist, bedeutet dies, dass die Adressdaten ungültig oder unzureichend sind. Fordern Sie Ihre Kundinnen/Kunden in diesem Fall auf, ihre Adressdaten erneut einzugeben oder genaue Adressdaten anzugeben.

Die Rechnungssumme gibt an, wie viel Ihr Kunde/Ihre Kundin zahlt, und die Steuer ist die Summe aller Steuerbeträge auf der Rechnung. Eine Aufschlüsselung der Steuern finden Sie unter total_tax_amounts. Alle Beträge sind in Cent angegeben.

Nachdem Sie eine Schätzung der Steuern und der Gesamtsumme erhalten haben, beginnen Sie mit der Erfassung von Kundeninformationen, einschließlich der Versandadresse (falls zutreffend), der Rechnungsadresse und der Zahlungsdaten. Beachten Sie, dass Sie bei der Verwendung von Stripe Tax Zahlungsdetails ohne Intent erfassen. Im ersten Schritt erstellen Sie ein Elements-Objekt ohne Intent:

const stripe = Stripe(
"pk_test_TYooMQauvdEDq54NiTphI7jx");

const elements = stripe.elements({
  mode: 'subscription',
  currency: '{{CURRENCY}}',
  amount: 
{{TOTAL}},
});

Erstellen Sie als Nächstes ein Address Element und ein Payment Element und verbinden Sie beide:

const addressElement = elements.create('address', {
  mode: 'billing' // or 'shipping', if you are shipping goods
});
addressElement.mount('#address-element');

const paymentElementOptions = { layout: 'accordion'};
const paymentElement = elements.create('payment', paymentElementOptions);
paymentElement.mount('#payment-element');

Anschließend können Sie das Address Element auf Änderungsereignisse überwachen. Wenn sich die Adresse ändert, schätzen Sie die Steuern und die Gesamtsumme neu.

addressElement.on('change', function(event) {
  // Throttle your requests to avoid overloading your server or hitting
  // Stripe's rate limits.
  const { tax, total } = await updateEstimate(event.value.address);

  elements.update({ amount: total });
  // Update your page to display the new tax and total to the user...
});

Wenn Ihre Kundinnen/Kunden das Formular absenden, rufen Sie elements.submit() auf, um die Formularfelder zu validieren und alle für Wallets erforderlichen Daten zu erfassen. Sie müssen warten, bis das Promise dieser Funktion aufgelöst wurde, bevor Sie weitere Vorgänge ausführen.

document.querySelector("#form").addEventListener("submit", function(event) {
  // We don't want to let default form submission happen here,
  // which would refresh the page.
  event.preventDefault();

  const { error: submitError } = await elements.submit();
  if (submitError) {
    // Handle error...
    return;
  }

  const { value: customerDetails } = await addressElement.getValue();

  // See the "Save customer details" section below to implement this
  // server-side.
  await 
saveCustomerDetails(customerDetails);

  // See the "Create subscription" section below to implement this server-side.
  const { 
clientSecret
 } = await 
createSubscription();

  const { error: confirmError } = await stripe.confirmPayment({
    elements,
    clientSecret,
    confirmParams: {
      return_url: 
{{RETURN_URL}},
    },
  });
  if (confirmError) {
    // Handle error...
    return;
  }

  // Upon a successful confirmation, your user will be redirected to the
  // return_url you provide before the Promise ever resolves.
});

Aktualisieren Sie Ihr Customer-Objekt anhand der Angaben, die Sie von Ihren Kundinnen/Kunden erfasst haben, damit Stripe Tax den genauen Standort des Kunden/der Kundin bestimmen kann und genaue Ergebnisse erhält.

Wenn Sie noch kein Customer-Objekt erstellt haben (zum Beispiel bei der ersten Anmeldung Ihres Kunden/Ihrer Kundin auf Ihrer Website), können Sie jetzt eines erstellen.

curl https://api.stripe.com/v1/customers/
{{CUSTOMER_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "address[line1]"={{LINE1}} \
  -d "address[line2]"={{LINE2}} \
  -d "address[city]"={{CITY}} \
  -d "address[state]"={{STATE}} \
  -d "address[postal_code]"={{POSTAL_CODE}} \
  -d "address[country]"={{COUNTRY}} \
  -d "tax[validate_location]"=immediately

Mit dem tax.validate_location-Enum-Wert können Sie sicherstellen, dass der Steuerstandort des Kunden/der Kundin als Erebnis dieses Vorgangs gültig wird oder (bleibt). Andernfalls lässt Stripe Ihre Anfrage mit dem Fehlercode customer_tax_location_invalid fehlschlagen. Dies ist wichtig, da Sie für einen Kunden/eine Kundin mit einem ungültigen Steuerstandort kein automatisch steueraktiviertes Abonnement erstellen können. Wenn Sie den automatic_tax.status Ihrer Rechnungen in der Vorschau wie zuvor beschrieben überprüft haben, wird diese zusätzliche Validierung nie fehlschlagen. Es empfiehlt sich jedoch tax[validate_location]="immediately" immer dann festzulegen, wenn Sie ein Customer-Objekt erstellen oder aktualisieren.

Erstellen Sie ein Abonnement mit aktivierten automatischen Steuern

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "automatic_tax[enabled]"=true \
  -d customer=
{{CUSTOMER_ID}} \
  -d "items[0][price]"=
{{PRICE_ID}} \
  -d "payment_settings[save_default_payment_method]"=on_subscription \
  -d "expand[0]"="latest_invoice.payment_intent"

Das latest_invoice.payment_intent.client_secret ist das Client-Geheimnis des Payment Intent der ersten (und der letzten) Rechnung des neuen Abonnements. Sie müssen das Client-Geheimnis an Ihr Frontend übergeben, um den Payment Intent bestätigen zu können.

Wenn Ihr Kunde/Ihre Kundin über eine Standardzahlungsmethode verfügt, wird die erste Rechnung des Abonnements automatisch bezahlt. Sie können dies mit dem latest_invoice.status des Abonnements bestätigen. Wenn Sie die neuen Zahlungsdetails, die Sie von Ihrem Kunden/Ihrer Kundin erfasst haben in Ihrem Bezahlvorgang verwenden möchten, müssen Sie sicherstellen, dass die erste Rechnung nicht automatisch bezahlt wird. Übergeben Sie default_incomplete für das payment_behavior, wenn Sie Ihr Abonnement erstellen, und bestätigen Sie den Payment Intent mit stripe.confirmPayment(), wie dargestellt. Weitere Informationen finden Sie unter Billing-Einzugsmethoden.