Ein Abonnement mit Cash App 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.

Erstellen Sie einen SetupIntent, um die kundenseitigen Zahlungsmethoden für spätere Zahlungen zu speichern. Der SetupIntent dokumentiert die Schritte dieses Einrichtungsvorgangs.

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 "payment_method_data[type]"=cashapp \
  -d "payment_method_types[]"=cashapp \
  -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

Der zurückgegebene SetupIntent enthält ein Client-Geheimnis, das die Client-Seite verwendet, um die Einrichtung sicher abzuschließen, anstatt das gesamte SetupIntent-Objekt zu übergeben. Sie können verschiedene Verfahren verwenden, um das Client-Geheimnis an den Client zu übergeben. Die SetupIntent-Antwort enthält auch eine Zahlungsmethoden-ID, die Sie im nächsten Schritt verwenden müssen, um einen PaymentIntent zu bestätigen.

Die SetupIntent-Antwort enthält den Status requires_action, was bedeutet, dass Ihre Nutzer/innen eine weitere Aktion ausführen müssen, um den SetupIntent abzuschließen. Verwenden Sie das next_action.cashapp_handle_redirect_or_display_qr_code-Objekt aus der SetupIntent-Antwort, um Ihre Nutzer/innen zu einer von Stripe gehosteten Seite weiterzuleiten, die den QR-Code anzeigt, oder rendern Sie den QR-Code direkt.

Um Nutzer/innen zu authentifizieren, folgen Sie der Anleitung zum Bestätigen des SetupIntent und Speichern einer Zahlungsmethode. Nach der Authentifizierung leitet die mobile Cash-App-Anwendung die Nutzer/innen an die return_url auf ihrem Mobilgerät weiter und der SetupIntent wechselt in den Status succeeded.

Erstellen Sie ein Abonnement mit einem Preis und einem/einer Kund/in. 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}}

Die Antwort umfasst den ersten PaymentIntent des Abonnements, der das Client-Geheimnis enthält. Dieses verwenden Sie auf der Client-Seite, um den Bezahlvorgang sicher durchzuführen, statt das gesamte PaymentIntent-Objekt zu übergeben. Um die Zahlung abzuschließen, geben Sie das client_secret an das Frontend zurück.