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