Ein Abonnement mit Amazon Pay einrichten

Produkte stehen für den von Ihnen angebotenen Artikel oder Dienst. Preise geben an, wie viel und wie häufig Sie für ein Produkt berechnen. Dies schließt ein, wie viel ein Produkt kostet, welche Währung Sie akzeptieren und ob es sich um eine einmalige oder eine wiederkehrende Zahlung handelt. Wenn Sie nur ein paar wenige Produkte und Preise haben, können Sie diese im Dashboard erstellen und verwalten.

In diesem Leitfaden wird ein Stock-Foto-Service als Beispiel verwendet, für den Kund/innen ein monatliches Abonnement mit dem Betrag von 15 USD berechnet werden. Um dies zu modellieren:

1. Gehen Sie zur Seite Produkte und klicken Sie auf Produkt erstellen.
2. Geben Sie einen Namen für das Produkt an. Sie können optional eine Beschreibung hinzufügen und ein Bild des Produkts hochladen.
3. Wählen Sie einen Produktsteuercode aus. Erfahren Sie mehr über Produktsteuercodes.
4. Wählen Sie Wiederkehrend aus. Geben Sie im Anschluss daran 15 für den Preis ein und wählen Sie USD als Währung aus.
5. Wählen Sie, ob die Steuer im Preis berücksichtigt werden soll. Sie können entweder den Standardwert aus Ihren Steuereinstellungen verwenden oder den Wert manuell festlegen. Wählen Sie in diesem Beispiel Auto aus.
6. Wählen Sie Monatlich als Abrechnungszeitraum aus.
7. Klicken Sie auf Weitere Preisoptionen. Wählen Sie dann Pauschalpreis als Preismodell für dieses Beispiel aus. Erfahren Sie mehr über Pauschalpreise und andere Preismodelle.
8. Fügen Sie eine interne Preisbeschreibung und einen Lookup-Schlüssel hinzu, um bestimmte Preise in Zukunft zu organisieren, abzufragen und zu aktualisieren.
9. Klicken Sie auf Weiter. Klicken Sie dann auf Produkt hinzufügen.

Zeichnen Sie nach Erstellen des Produkts und des Preises die Preis-ID auf, sodass Sie diese in nachfolgenden Schritten verwenden können. Die ID wird auf der Preisseite angezeigt und sieht in etwa so aus: price_G0FvDp6vZvdwRZ.

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 Customer-Objekt, wenn Ihre Kundinnen und Kunden ein Konto bei Ihrem Unternehmen anlegen. Wenn Sie die ID des Customer-Objekts 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 Customer-Objekt erstellen und es zu einem späteren Zeitpunkt mit Ihrer eigenen internen Darstellung des Kontos verknüpfen.

curl https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  --data-urlencode description="My First Test Customer (created for API docs)"

Erstellen Sie einen SetupIntent, um die Zahlungsmethode eines Kunden/einer Kundin für zukünftige Zahlungen zu speichern. 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.

curl https://api.stripe.com/v1/setup_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d confirm=true \
  --data-urlencode return_url="https://www.stripe.com" \
  -d usage=off_session \
  -d customer=cus_ODQluYFNl44ODI \
  -d "payment_method_data[type]"=amazon_pay \
  -d "payment_method_types[]"=amazon_pay \
  -d "mandate_data[customer_acceptance][type]"=online \
  -d "mandate_data[customer_acceptance][online][ip_address]"="127.0.0.0" \
  -d "mandate_data[customer_acceptance][online][user_agent]"=device

Das SetupIntent-Objekt enthält ein client_secret, einen eindeutigen Schlüssel, den Sie auf der Client-Seite an Stripe.js übergeben müssen, um Ihre Käufer/innen an Amazon Pay weiterzuleiten und Mandate zu autorisieren.

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.

get '/secret' do
  intent = # ... Create or retrieve the SetupIntent
  {client_secret: intent.client_secret}.to_json
end

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

Speichern Sie als Nächstes 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.

<head>
  <title>Checkout</title>
  <script src="https://js.stripe.com/basil/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.

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

Erstellen Sie auf Ihrer Checkout-Seite mit dem folgenden JavaScript eine Instanz von Stripe.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.

// 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.
 }

Erstellen Sie ein Abonnement mit einem Preis und einer Kundin/einem Kunden. Legen Sie den Wert des Parameters default_payment_method auf die PaymentMethod-ID aus der SetupIntent-Antwort fest.

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer={{CUSTOMER_ID}} \
  -d "items[0][price]"={{PRICE_ID}} \
  -d default_payment_method={{PAYMENT_METHOD_ID}} \
  -d off_session=true

Wenn Sie Abonnements erstellen, werden Kundinnen und Kunden ausstehende Zahlungen automatisch über deren voreingestellte Standardzahlungsmethode berechnet. War eine Zahlung erfolgreich, so ändert sich der Status im Stripe-Dashboard in Aktiv. Der Preis, den Sie zuvor festgelegt haben, bestimmt den Betrag für zukünftige Abrechnungen. Erfahren Sie, wie Sie ein Abonnement mit kostenlosem Testzeitraum erstellen.