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. Navigieren Sie zur Seite Produkt hinzufügen.
2. Geben Sie einen Namen für das Produkt an.
3. Geben Sie 15 für den Preis ein.
4. Wählen Sie als Währung USD aus.
5. Klicken Sie auf Produkt speichern.

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_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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.