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 ein Abonnement, das einen Preis und eine Kundin/einen Kunden mit dem Status incomplete hat, indem Sie den Parameter payment_behavior mit dem Wert default_incomplete angeben. Legen Sie den Parameter payment_settings.save_default_payment_method=on_subscription fest, um eine Zahlungsmethode bei der Aktivierung eines Abonnements zu speichern.

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer={{CUSTOMER_ID}} \
  -d payment_behavior=default_incomplete \
  -d "items[0][price]"={{PRICE_ID}} \
  -d "payment_settings[save_default_payment_method]"=on_subscription \
  -d "expand[0]"="latest_invoice.payments" \
  -d "expand[1]"="latest_invoice.confirmation_secret"

Die Antwort enthält die erste Rechnung des Abonnements. Dies enthält die Zahlungen der Rechnung, einschließlich eines Standard-PaymentIntent, den Stripe für diese Rechnung generiert hat, und des Bestätigungsgeheimnisses, das Sie clientseitig verwenden können, um den Zahlungsvorgang sicher abzuschließen, anstatt das gesamte PaymentIntent-Objekt zu übergeben. Geben Sie das latest_invoice.confirmation_secret.client_secret an das Frontend zurück, um die Zahlung abzuschließen.

Rufen Sie die PaymentIntent-ID, die Sie zum Bestätigen einer Zahlung verwenden müssen, von latest_invoice.payments ab.

Bestätigen Sie eine Zahlung mit PaymentIntents unter Verwendung der PaymentIntent-ID aus der Abonnement-Antwort.

Fügen Sie die PaymentIntent ID zum URL-Pfad hinzu und legen Sie den Wert des Parameters payment_method_types auf cashapp fest.

curl https://api.stripe.com/v1/payment_intents/:id/confirm \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "payment_method_data[type]"=cashapp \
  --data-urlencode return_url="https://www.stripe.com" \
  -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 \
  -d "mandate_data[customer_acceptance][accepted_at]"=1660000000

Die Antwort des PaymentIntent enthält den Status requires_action, was bedeutet, dass Ihre Nutzer/innen eine weitere Aktion durchführen müssen, um den PaymentIntent abzuschließen. Verwenden Sie das next_action.cashapp_handle_redirect_or_display_qr_code-Objekt aus der PaymentIntent-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, befolgen Sie die Anweisungen zum Weiterleiten und Authentifizieren von Transaktionen. Nach der Authentifizierung leitet die mobile Cash App-Anwendung die Nutzer/innen an die return_url auf ihrem Mobilgerät weiter und der PaymentIntent wechselt in den Status succeeded.

Nach einer erfolgreichen Zahlung wird das Abonnement aktiv und die Zahlungsmethode wird als Standard-Zahlungsmethode gespeichert.