Weiter zum Inhalt
Konto erstellen oder anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellenAnmelden
ÜbersichtZahlung annehmenAktualisieren Sie Ihre Integration
Online-Zahlungen
ÜbersichtIhren Use case findenVerwenden Sie Managed PaymentsWiederkehrende Zahlungen
Präsenzzahlungen
Zahlungsmethoden
Zahlungsvorgänge
Salden und AbwicklungsdauerZahlungsbelegeRückerstattungen und Stornierungen
Erweiterte Integrationen
Mehr als Zahlungen

Künftige Amazon Pay-Zahlungen einrichten

Erfahren Sie, wie Sie Amazon Pay-Details speichern und später Zahlungen Ihrer Kundschaft akzeptieren.

Sie können die Setup Intents API verwenden, um Details zur Zahlungsmethode im Voraus zu erfassen. Der endgültige Betrag bzw. das Zahlungsdatum werden hierbei erst später festgelegt. Dies ist nützlich für Folgendes:

Verwenden Sie die Payment Intents API, um Angaben zur Zahlungsmethode zu erfassen und die gespeicherte Zahlungsmethode umgehend zu belasten.

Erfahren Sie, wie Sie ein Abonnement mit Amazon Pay einrichten und wiederkehrende Zahlungen erstellen, nachdem Sie Ihre Zahlungsmethode in Checkout gespeichert haben.

Stripe einrichten
Serverseitig

Zunächst benötigen Sie ein Stripe-Konto. Registrieren Sie sich jetzt.

Nutzen Sie unsere offiziellen Bibliotheken für den Zugriff auf die Stripe-API über Ihre Anwendung:

Command Line
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
# Available as a gem
sudo gem install stripe
Gemfile
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

Erlaubnis zur Speicherung von Zahlungsmethoden einholen
Serverseitig

Wenn Sie eine Zahlungsmethode für die spätere Verwendung speichern, benötigen Sie hierfür eine kundenseitige Zustimmung. Indem Sie im Voraus eine Vereinbarung (auch Mandat bezeichnet) erstellen, können Sie die Zahlungsdaten Ihrer Kundinnen und Kunden speichern und die Kundenkonten belasten, wenn sie Ihre Website oder App nicht aktiv nutzen.

Binden Sie Geschäftsbedingungen in Ihre Website oder App ein, aus denen hervorgeht, wie Sie die Angaben Ihrer Kundinnen und Kunden zu den Zahlungsmethoden speichern möchten, und holen Sie deren Zustimmung ein. Wenn Sie Zahlungen auch verarbeiten möchten, wenn sie offline sind, müssen Sie sicherstellen, dass Ihre Geschäftsbedingungen außerdem Folgendes abdecken:

  • Die kundenseitige Erlaubnis, eine Zahlung oder mehrere Zahlungen für bestimmte Transaktionen in deren Namen einzuleiten
  • Die voraussichtliche Häufigkeit (d. h. einmalig oder wiederkehrend) und der Zahlungszeitpunkt
  • Wie Sie den Zahlbetrag ermitteln
  • Ihre Stornorichtlinie, wenn Sie die Zahlungsmethode für einen Abonnementdienst einrichten

Dokumentieren Sie unbedingt die schriftliche Zustimmung Ihrer Kundinnen und Kunden zu diesen Bedingungen.

Kundinnen/Kunden erstellen oder abrufen
Serverseitig

Um die Zahlungsmethode Amazon Pay für künftige Zahlungen zu speichern, müssen Sie diese den gewünschten Kundinnen und Kunden zuordnen.

Erstellen Sie ein Kundenobjekt, wenn Ihre Kundinnen und Kunden ein Konto bei Ihrem Unternehmen anlegen. Wenn Sie die ID des Kundenobjekts mit Ihrer eigenen Kundendarstellung verknüpfen, können Sie später die gespeicherten Angaben zur Zahlungsmethode abrufen und verwenden. Wurde kundenseitig noch kein Konto erstellt, können Sie dennoch ein Kundenobjekt erstellen und es zu einem späteren Zeitpunkt mit Ihrer eigenen internen Darstellung des Kontos verknüpfen.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  --data-urlencode description="My First Test Customer (created for API docs)"

Zeigen Sie die Autorisierungsbedingungen auf Ihrem Zahlungsformular an
Clientseitig

Speichern Sie die Amazon Pay-Anmeldeinformationen der Kundin/des Kunden, um ihr/sein Konto für zukünftige Off-Session-Zahlungen zu belasten. Ihr nutzerspezifisches Zahlungsformular muss einen schriftlichen Autorisierungshinweis enthalten, bevor der PaymentIntent oder der SetupIntent bestätigt wird.

Sie müssen die Autorisierung nur anzeigen, wenn Sie die Amazon Pay-Anmeldedaten der Kundin/des Kunden zum ersten Mal speichern.

Wir empfehlen Ihnen, den folgenden Text für Ihr individuelles Zahlungsformular zu verwenden:

Indem Sie fortfahren, erteilen Sie Rocket Rides die Genehmigung, Ihr Amazon Pay-Konto für diese und künftige Zahlungen im Einklang mit den AGB von Rocket Rides zu belasten, bis Sie Ihre Genehmigung widerrufen.

Verwenden Sie die Setup Intents API, um Angaben zur Zahlungsmethode im Voraus zu erfassen. Den endgültigen Betrag bzw. das Zahlungsdatum können Sie zu einem späteren Zeitpunkt bestimmen. Dies ist nützlich für Folgendes:

  • Zahlungsmethoden für Kundinnen/Kunden speichern, damit deren künftige Käufe keine Authentifizierungen erfordern
  • Kostenlosen Testzeitraum für ein Abonnement starten

SetupIntent erstellen und Zahlungsmethode speichern
Serverseitig

Ein SetupIntent ist ein Objekt, mit dem Sie eine Zahlungsmethode eines Kunden/einer Kundin für zukünftige Zahlungen einrichten können. Der SetupIntent verfolgt die Schritte dieses Einrichtungsvorgangs. Erstellen Sie einen SetupIntent auf Ihrem Server, wobei payment_method_types auf amazon_pay gesetzt ist, und geben Sie die Kunden-ID und usage=off_session oder usage=on_session an.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/setup_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "payment_method_types[]"=amazon_pay \
  -d "payment_method_data[type]"=amazon_pay \
  -d usage=off_session \
  -d customer={{CUSTOMER_ID}}

Client-Geheimnis abrufen

Im SetupIntent ist ein Client-Geheimnis enthalten, das auf dem Client verwendet wird, um Zahlungen sicher abzuschließen. Es gibt verschiedene Verfahren zum Übergeben des Client-Geheimnisses an den Client.

Rufen Sie das Client-Geheimnis von einem Endpoint auf Ihrem Server ab, indem Sie die Browser-Funktion fetch verwenden. Diese Vorgehensweise funktioniert am besten, wenn es sich bei Ihrer Client-Seite um eine einseitige Anwendung handelt, insbesondere wenn sie mit einem modernen Frontend-Framework wie React erstellt wurde. Erstellen Sie den Server-Endpoint, der das Client-Geheimnis bereitstellt:

main.rb
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
get '/secret' do
  intent = # ... Create or retrieve the SetupIntent
  {client_secret: intent.client_secret}.to_json
end

Und dann rufen Sie das Client-Geheimnis mit JavaScript auf der Client-Seite ab:

(async () => {
  const response = await fetch('/secret');
  const {client_secret: clientSecret} = await response.json();
  // Render the form using the clientSecret
})();

Als Nächstes speichern Sie Amazon Pay auf dem Client mit Stripe.js.

Binden Sie das Stripe.js-Skript in Ihre Bezahlseite ein, indem Sie es im head Ihrer HTML-Datei einfügen.

checkout.html
<head>
  <title>Checkout</title>
  <script src="https://js.stripe.com/clover/stripe.js"></script>
</head>

Wenn Kundinnen/Kunden über das „Click to Pay“-Verfahren mit Amazon Pay bezahlen, verwenden Sie Stripe.js, um die Zahlungen an Stripe zu übermitteln. Stripe.js ist die grundlegende JavaScript-Bibliothek für die Erstellung von Zahlungsabläufen. Sie verarbeitet automatisch komplexe Szenarien wie die nachfolgend beschriebene Weiterleitung und ermöglicht die Erweiterung Ihrer Integration durch zusätzliche Zahlungsmethoden. Binden Sie das Stripe.js-Skript in Ihre Bezahlseite ein, indem Sie es im head Ihrer HTML-Datei einfügen.

checkout.html
<head>
  <title>Checkout</title>
  <script src="https://js.stripe.com/clover/stripe.js"></script>
</head>

Erstellen Sie auf Ihrer Checkout-Seite mit dem folgenden JavaScript eine Instanz von Stripe.js.

client.js
// Set your publishable key. Remember to change this to your live publishable key in production!
// See your keys here: https://dashboard.stripe.com/apikeys
const stripe = Stripe(
'pk_test_TYooMQauvdEDq54NiTphI7jx'
);

Verwenden Sie stripe.confirmAmazonPaySetup, um den SetupIntent clientseitig zu bestätigen, und geben Sie eine return_url und optionale mandate_data an. Verwenden Sie die return_url, um Kundinnen und Kunden nach einem erfolgreichen SetupIntent auf eine bestimmte Seite weiterzuleiten.

client.js
// Redirects away from the client
 const {error} = await stripe.confirmAmazonPaySetup(
   '{{SETUP_INTENT_CLIENT_SECRET}}',
   {
     return_url: 'https://example.com/setup/complete',
     mandate_data: {
       customer_acceptance: {
         type: 'online',
         online: {
             infer_from_client: true
         }
       }
     },
   }
 );

 if (error) {
   // Inform the customer that there was an error.
 }

OptionalAmazon Pay-Weiterleitung manuell handhaben

Wenn Sie Stripe.js verwenden, können Sie Ihre Integration einfacher um weitere Zahlungsmethoden erweitern. Sie können Ihre Kundinnen und Kunden jedoch auch manuell an Ihren Server weiterleiten.

  1. Erstellen und bestätigen Sie eine PaymentIntent des Typs amazon_pay. Durch Angabe von payment_method_data wird eine PaymentMethod erstellt und sofort mit dem PaymentIntent verwendet.

Im Feld return_url müssen Sie auch die URL angeben, an die Ihre Kund/innen nach Abschluss ihrer Zahlung weitergeleitet werden. Sie können Ihre eigenen Abfrageparameter in dieser URL angeben. Diese Parameter werden nach Abschluss der Weiterleitung in die endgültige URL aufgenommen.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1000 \
  -d currency=usd \
  -d "payment_method_types[]"=amazon_pay \
  -d "payment_method_data[type]"=amazon_pay \
  --data-urlencode return_url="https://example.com/checkout/complete" \
  -d confirm=true
  1. Überprüfen Sie, ob der PaymentIntent den Status requires_action und ob next_action den Typ redirect_to_url hat.
Response
{
  "status": "requires_action",
  "next_action": {
    "type": "redirect_to_url",
    "redirect_to_url": {
      "url": "https://hooks.stripe.com/...",
      "return_url": "https://example.com/checkout/complete"
    }
  },
  "id": "pi_1G1sgdKi6xqXeNtkldRRE6HT",
  "object": "payment_intent",
  ...
}
  1. Leiten Sie die Kundinnen/Kunden an die in der Eigenschaft next_action.redirect_to_url.url angegebene URL weiter. Dieses Codebeispiel ist nur eine Annäherung und kann sich vom Weiterleitungsverfahren in Ihrem Web-Framework unterscheiden.
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
if payment_intent.status == 'requires_action' && payment_intent.next_action.type == 'redirect_to_url'
  url = payment_intent.next_action.redirect_to_url.url
  redirect(url)
end

Bei Abschluss des Bezahlvorgangs werden Ihre Kundinnen/Kunden zu Ihrer return_url weitergeleitet. Die URL-Abfrageparameter payment_intent und payment_intent_client_secret sind zusammen mit Ihren eigenen Abfrageparametern enthalten. Stripe empfiehlt, einen Webhook-Endpoint einzurichten, um den Zahlungsstatus programmgesteuert zu bestätigen.

PaymentIntent mit einer gespeicherten Zahlungsmethode erstellen
Serverseitig

Nachdem Sie eine PaymentMethod erstellt haben, können Sie zukünftige Zahlungen per Amazon Pay annehmen, indem Sie ein PaymentIntent erstellen und bestätigen. Verwenden Sie zum Bestätigen eines PaymentIntent dieselbe Zahlungsmethoden-ID aus dem vorherigen SetupIntent- oder PaymentIntent-Objekt. Der Wert off_session muss auch auf „true“ gesetzt sein, wenn sich Kundinnen und Kunden in diesem PaymentIntent nicht in einem Bezahlvorgang befinden.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "payment_method_types[]"=amazon_pay \
  -d payment_method={{PAYMENT_METHOD_ID}} \
  -d amount=1000 \
  -d currency=usd \
  -d customer={{CUSTOMER_ID}} \
  -d statement_descriptor=test_statement \
  -d capture_method=automatic \
  -d confirm=true \
  -d off_session=true

OptionalWiederverwendbare Zahlungsmethode entfernen

Um eine wiederverwendbare Zahlungsmethode zu deaktivieren, kann Ihr Server die detach PaymentMethod API aufrufen. Stripe sendet sowohl ein mandate.updated-Ereignis als auch ein payment_method.detached-Ereignis. Wenn Sie Benachrichtigungen erhalten möchten, abonnieren Sie Webhook-Ereignisse.