Ein Abonnement mit Cash App Pay einrichten
Verwenden Sie diesen Leitfaden, um ein Abonnement mit Cash App Pay als Zahlungsmethode einzurichten.
Erstellen und bestätigen Sie ein Abonnement mit zwei API-Aufrufen. Der erste API-Aufruf verwendet die Setup Intents API, um Cash App Pay als Zahlungsmethode festzulegen . Der zweite API-Aufruf sendet Informationen zu Kund/innen, Produkten und Zahlungsmethoden an die Abonnements API, um ein Abonnement zu erstellen Abonnement und eine Zahlung in einem Anruf bestätigen.
Produkt und Preis erstellenDashboard
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:
- Navigieren Sie zur Seite Produkt hinzufügen.
- Geben Sie einen Namen für das Produkt an.
- Geben Sie 15 für den Preis ein.
- Wählen Sie als Währung USD aus.
- 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
.
SetupIntent erstellenServerseitig
Erstellen Sie einen SetupIntent, um die Zahlungsmethoden von Kund/innen für spätere Zahlungen zu speichern. Der SetupIntent
verfolgt die Schritte dieses Einrichtungsvorgangs.
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 die 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 der 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 die SetupIntent wechselt in den Status succeeded
.
Abonnements erstellenServerseitig
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.
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.
Notiz
Informationen dazu, wie Sie ein Abonnement mit einer kostenlosen Testphase erstellen, finden Sie unter Abonnement-Testphasen.