Weiter zum Inhalt
Konto erstellen
 oder
anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellen
Anmelden
ÜbersichtAktualisieren Sie Ihre Integration
Online-Zahlungen
ÜbersichtIhren Use case findenVerwenden Sie Managed Payments
Erstellen Sie eine benutzerdefinierte Integration mit Elements
Zahlungsmethoden
Zahlungsschnittstellen
Zahlungsszenarien
Präsenzzahlungen
Mehr als Zahlungen

Versandkosten berechnen

Erstellen Sie unterschiedliche Versandraten für Ihre Kundinnen und Kunden.

Mit Versandkosten können Sie verschiedene Versandoptionen wie Standard, Express und Über-Nacht-Versand mit genaueren Schätzungen für die Lieferzeiten anzeigen. Berechnen Sie Ihren Kund/innen die Kosten für den Versand mit verschiedenen Stripe-Produkten. Bevor Sie Versandkosten erstellen, informieren Sie sich darüber, wie Sie Rechnungs- und Lieferadressen erfassen.

Notiz

Versandkosten unterstützen nur feste Betragswerte für die gesamte Bestellung. Sie können die Versandkosten nicht basierend auf der Anzahl der Posten in der Bestellung anpassen.

Versandrate erstellen
Serverseitig

Notiz

Versandkosten unterstützen nur feste Beträge für die gesamte Bestellung. Sie können die Versandkosten nicht basierend auf der Anzahl der Artikel in der Bestellung anpassen.

So fügen Sie eine Versandrate über das Dashboard hinzu:

  1. Klicken Sie auf Versandrate erstellen.
  2. Geben Sie einen Betrag, eine Beschreibung und eine optionale geschätzte Lieferung ein.
  3. Klicken Sie auf Speichern und kopieren Sie die Versandraten-ID (shr_123456).

Einzelheiten zu Ihren Versandkosten eingeben

Versandrate aktualisieren

Sie können Versandkosten im Dashboard nicht aktualisieren. Um Versandkosten im Dasboard zu aktualisieren, müssen Sie die Versandkosten archivieren und anschließend neue erstellen.

Versandkosten archivieren

So archivieren Sie Versandkosten:

  1. Wählen Sie auf der Registerkarte Versandkosten die entsprechenden Versandkosten aus.
  2. Klicken Sie auf das Überlaufmenü und wählen Sie Archivieren aus.

Um die Archivierung der Versandkosten aufzuheben, klicken Sie auf das Überlaufmenü und wählen Sie Archivierung der Versandrate aufheben aus.

Checkout-Sitzung erstellen
Serverseitig

Um eine Checkout-Sitzung zu erstellen, die Ihre Versandkosten einbezieht, übergeben Sie die generierte Versandkosten-ID an den Parameter shipping_options. Wenn Sie die Versandkosten gleichzeitig mit einer Checkout-Sitzung erstellen möchten, verwenden Sie den Parameter shipping_rate_data mit shipping_options. Nur Checkout-Sitzungen im Zahlungsmodus unterstützen Versandoptionen.

Im folgenden Codebeispiel werden der Checkout-Sitzung zwei Versandoptionen hinzugefügt:

  • Kostenloser Versand mit einer geschätzten Lieferzeit von 5–7 Werktagen.
  • Luftfracht über Nacht, Kosten von 15,00 USD mit geschätzter Lieferzeit von genau 1 Werktag.
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d billing_address_collection=required \
  -d "shipping_address_collection[allowed_countries][0]"=US \
  -d "shipping_address_collection[allowed_countries][1]"=CA \
  -d "shipping_options[0][shipping_rate_data][type]"=fixed_amount \
  -d "shipping_options[0][shipping_rate_data][fixed_amount][amount]"=0 \
  -d "shipping_options[0][shipping_rate_data][fixed_amount][currency]"=usd \
  -d "shipping_options[0][shipping_rate_data][display_name]"="Free shipping" \
  -d "shipping_options[0][shipping_rate_data][delivery_estimate][minimum][unit]"=business_day \
  -d "shipping_options[0][shipping_rate_data][delivery_estimate][minimum][value]"=5 \
  -d "shipping_options[0][shipping_rate_data][delivery_estimate][maximum][unit]"=business_day \
  -d "shipping_options[0][shipping_rate_data][delivery_estimate][maximum][value]"=7 \
  -d "shipping_options[1][shipping_rate_data][type]"=fixed_amount \
  -d "shipping_options[1][shipping_rate_data][fixed_amount][amount]"=1500 \
  -d "shipping_options[1][shipping_rate_data][fixed_amount][currency]"=usd \
  -d "shipping_options[1][shipping_rate_data][display_name]"="Next day air" \
  -d "shipping_options[1][shipping_rate_data][delivery_estimate][minimum][unit]"=business_day \
  -d "shipping_options[1][shipping_rate_data][delivery_estimate][minimum][value]"=1 \
  -d "shipping_options[1][shipping_rate_data][delivery_estimate][maximum][unit]"=business_day \
  -d "shipping_options[1][shipping_rate_data][delivery_estimate][maximum][value]"=1 \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d ui_mode=custom \
  --data-urlencode return_url="https://example.com/return"

Gewählte Versandoption des/der Kund/in erfassen
Clientseitig

Verwenden Sie auf dem Client das shippingOptions-Objekt, um die verfügbaren Versandoptionen zu rendern, etwa in einer Optionsfeldliste. Wenn Ihr/e Kund/in eine Versandoption auswählt, rufen Sie updateShippingOption mit der ID der Versandoption auf.

index.html
<div id="shipping-options"></div>
checkout.js
checkout.session().shippingOptions.forEach((option) => {
  const form = document.createElement('form');

  shippingOptions.forEach(option => {
    const label = document.createElement('label');
    const radio = document.createElement('input');
    radio.type = 'radio';
    radio.id = option.id;
    radio.name = 'shippingOption';
    radio.value = option.id;
    radio.addEventListener('click', () => {
      checkout.updateShippingOption(option.id)
    })

    const labelText = document.createTextNode(option.displayName);

    label.appendChild(radio);
    label.appendChild(labelText);
    form.appendChild(label);
  });

  document.getElementById('shipping-options').appendChild(form);
});
const shippingAddressElement = checkout.createShippingAddressElement();
shippingAddressElement.mount('#shipping-address');

OptionalAbgeschlossene Transaktionen verarbeiten

Nach erfolgreicher Zahlung können Sie den Versandbetrag im Attribut amount_total der shipping_cost abrufen. Sie können die ausgewählte Versandrate auch mithilfe des Attributs shipping_rate attribute in shipping_cost abrufen. Um auf die Eigenschaft shipping_cost zuzugreifen, müssen Sie einen Ereignis-Handler erstellen, um abgeschlossene Checkout-Sitzungen zu verarbeiten. Sie können einen Handler testen, indem Sie die Stripe CLI installieren und stripe listen --forward-to localhost:4242/webhook verwenden, um Ereignisse an Ihren lokalen Server weiterzuleiten. Im folgenden Codebeispiel ermöglicht der Handler den Nutzerinnen und Nutzern den Zugriff auf die shipping_property:

Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = 
"sk_test_BQokikJOvBiI2HlWgH4olfQ2"


require 'sinatra'

# You can find your endpoint's secret in your webhook settings
endpoint_secret = 'whsec_...'

post '/webhook' do
  event = nil

  # Verify webhook signature and extract the event
  # See https://stripe.com/docs/webhooks#verify-events for more information.
  begin
    sig_header = request.env['HTTP_STRIPE_SIGNATURE']
    payload = request.body.read
    event = Stripe::Webhook.construct_event(payload, sig_header, endpoint_secret)
  rescue JSON::ParserError => e
    # Invalid payload
    return status 400
  rescue Stripe::SignatureVerificationError => e
    # Invalid signature
    return status 400
  end

  if event['type'] == 'checkout.session.completed'
    checkout_session = event['data']['object']

    fulfill_order(checkout_session)
  end

  status 200
end

def fulfill_order(checkout_session)
  selected_shipping_rate = Stripe::ShippingRate.retrieve(checkout_session.shipping_cost.shipping_rate)
  shipping_total = checkout_session.shipping_cost.amount_total

  # TODO: Remove error and implement...
  raise NotImplementedError.new(<<~MSG)
    Given the Checkout Session "#{checkout_session.id}" load your internal order from the database then implement your own fulfillment logic.
  MSG
end

OptionalGeschätzte Lieferzeit festlegen

Sie können Versandkosten mit einer Reihe von Kombinationen für geschätzte Lieferzeiten einrichten. Die folgende Tabelle enthält einige Beispiele für Lieferzeitenschätzungen in einfachem Englisch sowie die entsprechenden Werte für delivery_estimate.minimum und delivery_estimate.maximum:

Geschätzte LieferzeitMinimumMaximum
1 Tag
{
  unit: 'day',
  value: 1,
}

{
  unit: 'day',
  value: 1,
}
1 Werktag
{
  unit: 'business_day',
  value: 1,
}

{
  unit: 'business_day',
  value: 1,
}
Mindestens 2 Werktage
{
  unit: 'business_day',
  value: 2,
}

null
3 bis 7 Tage
{
  unit: 'day',
  value: 3,
}

{
  unit: 'day',
  value: 7,
}
4 bis 8 Stunden
{
  unit: 'hour',
  value: 4,
}

{
  unit: 'hour',
  value: 8,
}
4 Stunden bis 2 Werktage
{
  unit: 'hour',
  value: 4,
}


{
  unit: 'business_day',
  value: 2,
}

OptionalVersandsteuern einziehen

Mit Stripe Tax können Sie automatisch den Steuersatz für Versandgebühren berechnen, indem Sie für Ihre Versandgebühr einen tax_code und ein tax_behavior festlegen. Stripe Tax ermittelt automatisch, ob der Versand zu versteuern ist (die Steuerpflicht variiert zwischen Land und Bundesstaaten) und berechnet ggf. den korrekten Steuersatz.

Wenn Sie mit shipping_rate_data oder über Eine Versandgebühr erstellen eine Versandgebühr festlegen, können Sie die Parameter tax_behavior und tax_code dieser Gebühr hinzufügen.

Wir empfehlen, den tax_code auf Shipping (txcd_92010001) zu setzen, um sicherzustellen, dass immer der korrekte Steuersatz berechnet wird. Sie können den tax_code der Versandgebühr auch auf Nontaxable (txcd_00000000) setzen, wenn Sie keine Steuer berechnen wollen.

In diesem Beispiel legen wir das tax_behavior auf exclusive fest, was in den USA üblich ist. Erfahren Sie mehr über das Steuerverhalten.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d billing_address_collection=required \
  -d "shipping_address_collection[allowed_countries][0]"=US \
  -d "shipping_address_collection[allowed_countries][1]"=CA \
  -d "shipping_options[0][shipping_rate_data][type]"=fixed_amount \
  -d "shipping_options[0][shipping_rate_data][fixed_amount][amount]"=0 \
  -d "shipping_options[0][shipping_rate_data][fixed_amount][currency]"=usd \
  -d "shipping_options[0][shipping_rate_data][display_name]"="Free shipping" \
  -d "shipping_options[0][shipping_rate_data][tax_behavior]"=exclusive \
  -d "shipping_options[0][shipping_rate_data][tax_code]"=txcd_92010001 \
  -d "shipping_options[0][shipping_rate_data][delivery_estimate][minimum][unit]"=business_day \
  -d "shipping_options[0][shipping_rate_data][delivery_estimate][minimum][value]"=5 \
  -d "shipping_options[0][shipping_rate_data][delivery_estimate][maximum][unit]"=business_day \
  -d "shipping_options[0][shipping_rate_data][delivery_estimate][maximum][value]"=7 \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][price_data][tax_behavior]"=exclusive \
  -d "line_items[0][quantity]"=1 \
  -d "automatic_tax[enabled]"=true \
  -d mode=payment \
  -d ui_mode=custom \
  --data-urlencode return_url="https://example.com/return"
War diese Seite hilfreich?
JaNein