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
Zahlungsmethoden
Zahlungsschnittstellen
Zahlungsszenarien
Präsenzzahlungen
Mehr als Zahlungen

Verwenden Sie die API, um Zahlungslinks zu erstellen und zu verwalten

Erstellen und verwalten Sie Zahlungslinks mit der API.

Mit der Payment Links API können Sie einen Zahlungslink erstellen, den Sie mit Ihren Kundinnen/Kunden teilen können. Stripe leitet Kundinnen/Kunden, die diesen Link öffnen, auf eine von Stripe gehostete Zahlungsseite weiter.

Ihren Produktkatalog einrichten

Payment Links verwendet Produkte und Preise, um zu modellieren, was Ihr Unternehmen verkauft. Um mit Payment Links zu starten, [Payment Links‍, ‍create a product‍ und verwenden Sie dieses Produkt dann, um create a price. Wenn Sie alternativ einen Ad-hoc-Preis oder ein Produkt für die einmalige Verwendung erstellen möchten, können Sie diesen Schritt überspringen und in Schritt 2 price_data verwenden.

Payment Links unterstützt Pauschal-, Staffel-, Paket- und kundenseitig festgelegte Preise, bei denen die Kundinnen/Kunden den Preis eingeben können. Die Funktion Kundenseitige Preisfestlegung unterstützt derzeit keine wiederkehrenden Zahlungen oder Spenden.

Verwenden Sie Pauschalpreis, um ein Produkt oder Abo mit einem festen Betrag zu erstellen.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/prices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d currency=usd \
  -d unit_amount=1000 \
  -d product=
"{{PRODUCT_ID}}"

Zahlungslink erstellen

Um einen Zahlungslink zu erstellen, übergeben Sie line_items. Jeder Posten enthält einen price (oder price_data) und eine quantity. Zahlungslinks können bis zu 20 Posten enthalten, wenn eine Pauschalgebühr verwendet wird, und einen Posten, wenn Customer chooses price verwendet wird.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[0][quantity]"=1

Ihren Zahlungslink teilen

Jeder Zahlungslink enthält eine url, die Sie mit Ihren Kundinnen/Kunden per E-Mail, über Social Media, über einen Website-Link, in einer App oder über andere Kanäle teilen können.

Zahlungen nachverfolgen

Wenn Kundinnen/Kunden mithilfe eines Zahlungslinks eine Zahlung abschließen, sendet Stripe den Webhook checkout.session.completed, den Sie für die Abwicklung und den Abgleich verwenden können.

Überwachen Sie unbedingt weitere Webhooks, wenn Sie Zahlungsmethoden wie Banklastschriften oder Gutscheine aktiviert haben, bei denen es 2–14 Tage dauern kann, bis die Zahlung bestätigt wird. Weitere Informationen finden Sie im Leitfaden für die Ausführung von Bestellungen nach der Bezahlung durch die Kundin/den Kunden.

Nachdem Kundinnen/Kunden einen Kauf abgeschlossen haben, können Sie sie an eine URL weiterleiten oder ihnen eine individuelle Nachricht anzeigen, indem Sie den Parameter after_completion des Zahlungslinks festlegen.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[0][quantity]"=1 \
  -d "after_completion[type]"=redirect \
  --data-urlencode "after_completion[redirect][url]"="https://example.com"

Zahlungslink deaktivieren

Nachdem Sie einen Zahlungslink erstellt haben, können Sie ihn nicht mehr löschen. Sie können diesen stattdessen deaktivieren, indem Sie das Attribut active auf false festlegen.

Nachdem Sie einen Link deaktiviert haben, können Kundinnen/Kunden Käufe über diesen Link nicht mehr abschließen und werden an eine Ablaufseite weitergeleitet. Wenn Sie einen deaktivierten Zahlungslink wiederverwenden möchten, aktivieren Sie diesen erneut, indem Sie das Attribut active auf true festlegen.

Zahlungsmethoden konfigurieren

Standardmäßig wählt Stripe die relevanten Zahlungsmethoden aus den in Ihrem Stripe-Dashboard aktivierten Zahlungsmethoden. Um unterstützte Zahlungsmethoden hinzufügen, aktivieren Sie die entsprechenden Methoden in Ihren Einstellungen für Zahlungsmethoden.

OptionalGutscheine und Promo-Codes erlauben

Erstellen und konfigurieren Sie Gutscheine und Promo-Codes für Ihre Zahlungslinks über das Dashboard oder die Promotion Code API:

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[0][quantity]"=1 \
  -d allow_promotion_codes=true

OptionalSteuern über Ihren Zahlungslink einziehen

Payment Links funktionieren mit Stripe Tax. Damit können Sie für Ihre Zahlungen Steuern berechnen und einziehen. Stripe Tax ist ein kostenpflichtiges Produkt, das Steuern für Ihre Transaktionen automatisch und ohne vordefinierte Steuersätze und -regeln berechnet.

Um loszulegen, müssen Sie Stripe Tax in Ihrem Dashboard aktivieren. Sobald Sie Stripe Tax eingerichtet haben, können Sie es für neue Zahlungslinks aktivieren:

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[0][quantity]"=1 \
  -d "automatic_tax[enabled]"=true

Weitere Informationen dazu, wie Sie Ihren Produktkatalog für Stripe Tax einrichten, finden Sie unter Produktsteuercodes und Steuerverhalten festlegen.

OptionalRechnungs- und Versandadressen erfassen

Zahlungslinks erfassen automatisch die Rechnungsadresse Ihrer Kundin/Ihres Kunden, wenn dies zum Abschluss des Kaufs erforderlich ist. Sie können Ihren Zahlungslink auch mithilfe von billing_address_collection so aktualisieren, dass die Rechnungsadresse immer erfasst wird. Alternativ können Sie die Versandadresse erfassen, indem Sie mithilfe von shipping_address_collection die unterstützten Länder angeben:

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[0][quantity]"=1 \
  -d billing_address_collection=required \
  -d "shipping_address_collection[allowed_countries][0]"=US

Wenn Sie Versandadressen erfassen, können Sie auch Versandraten zu Ihrem Zahlungslink hinzufügen, indem Sie ein Array von shipping_options übergeben.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[0][quantity]"=1 \
  -d billing_address_collection=required \
  -d "shipping_address_collection[allowed_countries][0]"=US \
  -d "shipping_options[0][shipping_rate]"=
"{{SHIPPING_RATE_ID}}"

OptionalAnpassbare Mengen zulassen

Damit Ihre Kundinnen/Kunden die Menge der von ihnen gekauften Posten anpassen können, geben Sie den Parameter adjustable_quantity für den entsprechenden Posten an. Sie können auch die zulässigen Mindest- und Höchstmengen für den Kauf festlegen:

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[0][quantity]"=1 \
  -d "line_items[0][adjustable_quantity][enabled]"=true \
  -d "line_items[0][adjustable_quantity][minimum]"=1 \
  -d "line_items[0][adjustable_quantity][maximum]"=10

OptionalAbonnements erstellen

Um ein Abonnement mithilfe eines Zahlungslinks zu erstellen, geben Sie für line_items einen Preis mit dem Attribut type=recurring an. Sie können den Parameter subscription_data verwenden, um die Konfiguration für die über den Zahlungslink erstellten Abonnements, einschließlich Testzeiträumen, festzulegen:

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[0][quantity]"=1 \
  -d "subscription_data[trial_period_days]"=7

OptionalGeben Sie die Zahlungsmethoden an, die Sie akzeptieren möchten

Um einen anderen Satz von Zahlungsmethoden anzugeben, legen Sie beim Erstellen des Zahlungslinks den Parameter payment_method_types fest:

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[0][quantity]"=1 \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=klarna

Bei einigen Zahlungsmethoden, beispielsweise Banklastschriften oder Gutscheinen, dauert es 2–14 Tage, bis die Zahlung bestätigt wird. Richten Sie Webhooks ein, damit Sie benachrichtigt werden, wenn die Zahlung freigegeben wird, sodass Sie mit der Ausführung beginnen können.

Ihren Kundinnen und Kunden werden die Optionen von Apple Pay oder Google Pay angezeigt, wenn sie diese Zahlungsmethoden auf ihrem Gerät aktiviert haben. Die angezeigten Zahlungsmethoden hängen auch vom verwendeten Browser ab.

OptionalVereinbarung über die Allgemeinen Geschäftsbedingungen einholen

Erfassen Sie die allgemeinen Geschäftsbedingungen von Ihren Kundinnen/Kunden, indem Sie consent_collection.terms_of_service auf required festlegen. Dadurch wird ein Kontrollkästchen zur Erfassung der allgemeinen Geschäftsbedingungen angezeigt und die Kundinnen/Kunden werden mit der URL der allgemeinen Geschäftsbedingungen verlinkt, die in den öffentlichen Details Ihres Stripe-Dashboards festgelegt wurde.

Wenn Sie consent_collection.terms_of_service auf none festlegen, zeigt Checkout das Kontrollkästchen nicht an und fordert die Kundinnen/Kunden nicht auf, Ihre allgemeinen Geschäftsbedingungen zu akzeptieren.

Bevor Sie die Zustimmung zu Ihren Bedingungen einholen, legen Sie die URL Ihrer allgemeinen Geschäftsbedingungen in den öffentlichen Details Ihres Unternehmens fest. Das Festlegen einer URL für die Datenschutzerklärung ist optional. Checkout verweist auch auf Ihre Datenschutzerklärung, wenn in Ihren öffentlichen Details eine URL zu Ihrer Datenschutzerklärung festgelegt ist.

Command Line
curl
Ruby
Python
PHP
Node.js
No results
curl https://api.stripe.com/v1/payment_links \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "payment_method_types[0]"=card \
  -d "line_items[0][price]"=
'{{PRICE_ID}}'
 \
  -d "line_items[0][quantity]"=2 \
  -d "consent_collection[terms_of_service]"="required"

OptionalBenutzerdefinierte Felder hinzufügen

Vorsicht

Verwenden Sie keine benutzerdefinierten Felder, um geschützte oder sensible Daten oder Informationen zu erfassen, die gesetzlich eingeschränkt sind.

Erstellen Sie einen Payment Link , während Sie ein Array nutzerdefinierter Felder angeben. Jedes Feld muss einen eindeutigen key haben, den Ihre Integration zum Abgleich verwendet. Geben Sie auch eine Bezeichnung für das Feld an, die Sie Ihren Kundinnen und Kunden anzeigen. Bezeichnungen für nutzerdefinierte Felder werden nicht übersetzt, Sie können aber die locale URL-Parameter verwenden, um die Sprache Ihres Payment Link so festzulegen, dass sie mit der Sprache Ihrer Label übereinstimmt.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[0][quantity]"=1 \
  -d "custom_fields[0][key]"=engraving \
  -d "custom_fields[0][label][type]"=custom \
  -d "custom_fields[0][label][custom]"="Personalized engraving" \
  -d "custom_fields[0][type]"=text

Nachdem Ihr Kunde/Ihre Kundin die Checkout-Sitzung abgeschlossen hat, sind die Felder auf der Seite mit den Zahlungsdetails im Dashboard verfügbar, oder Sie können die ausgefüllten nutzerdefinierten Felder abrufen.

OptionalAnmeldegebühren über Connect

Sie können für jede mit einem Zahlungslink getätigte Zahlung eine Plattformgebühr erheben. Informationen zum Einzug von Plattformgebühren mit der Payment Links API finden Sie in unserem Leitfaden.

OptionalRechnungen nach Zahlungseingang senden

Sie können Payment Links so konfigurieren, dass für einmalige erfolgreiche Zahlungen detaillierte Rechnungen an Ihre Kundinnen/Kunden gesendet werden. Die Rechnungserstellung für einmalige Zahlungen mit Payment Links ist eine Invoicing-Funktion und wird separat berechnet.

Notiz

Payment Links für Abonnements erstellen Rechnungen automatisch und erfordern keine zusätzliche Konfiguration.

Um die Rechnungserstellung für einen Zahlungslink zu aktivieren, legen Sie invoice_creation[enabled] auf true fest:

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[0][quantity]"=1 \
  -d "invoice_creation[enabled]"=true

Sie können den Hash invoice_data in invoice_creation verwenden, um die Rechnung anzupassen:

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[0][quantity]"=1 \
  -d "invoice_creation[enabled]"=true \
  -d "invoice_creation[invoice_data][description]"="Invoice for Product X" \
  -d "invoice_creation[invoice_data][metadata][order]"=order-xyz \
  -d "invoice_creation[invoice_data][account_tax_ids][0]"=DE123456789 \
  -d "invoice_creation[invoice_data][custom_fields][0][name]"="Purchase Order" \
  -d "invoice_creation[invoice_data][custom_fields][0][value]"=PO-XYZ \
  -d "invoice_creation[invoice_data][rendering_options][amount_tax_display]"=include_inclusive_tax \
  -d "invoice_creation[invoice_data][footer]"="B2B Inc."

Nach der Sitzung sendet Stripe eine Rechnungsübersicht an die E-Mail-Adresse, die Ihr/e Kund/in beim Bezahlvorgang angegeben hat. Die Rechnungsübersicht enthält Links zum Herunterladen der Rechnungs-PDF und des Rechnungsbelegs.

Belege für Zahlungen, die mit Ihren Test-API-Schlüsseln erstellt wurden, werden nicht automatisch gesendet. Sie können Zahlungsbelege über das Dashboard anzeigen oder manuell versenden.

Screenshot der Rechnungs-PDF, die Kund/innen aus der E-Mail mit der Rechnungsübersicht herunterladen können

Lassen Sie Kundinnen/Kunden die Rechnungs-PDF herunterladen

Screenshot des Rechnungsbelegs, den Kund/innen aus der E-Mail mit der Rechnungsübersicht herunterladen können

Lassen Sie Kundinnen/Kunden den Rechnungsbeleg herunterladen

Screenshot der von Stripe gesendeten E-Mail mit der Rechnungsübersicht

E-Mail-Links zum Herunterladen der Rechnungs-PDF bzw. des Zahlungsbelegs

War diese Seite hilfreich?
JaNein