Weiter zum Inhalt
Konto erstellen
 oder
anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellen
Anmelden
ÜbersichtAktualisieren Sie Ihre Integration
Online-Zahlungen
ÜbersichtIhren Use case findenZahlungen verwalten
Zahlungsmethoden
Zahlungsschnittstellen
Zahlungsszenarien
Präsenzzahlungen
Mehr als Zahlungen

Zukünftige Zahlungen per Cash App Pay einrichten

Erfahren Sie, wie Sie Details für Cash App Pay speichern und später Zahlungen Ihrer Kundinnen/Kunden akzeptieren.

Verwenden Sie die Setup Intents API, um die Details der Zahlungsmethode im Voraus zu erfassen und den endgültigen Betrag oder das Zahlungsdatum zu einem späteren Zeitpunkt zu bestimmen. Dies ist nützlich für Folgendes:

Verwenden Sie die Payment Intents API, um Angaben zur Zahlungsmethode zu erfassen und die gespeicherte Zahlungsmethode umgehend zu belasten.

Wie Sie wiederkehrende Zahlungen nach dem Speichern einer Zahlungsmethode in Checkout erstellen, erfahren Sie unter Ein Abonnement mit Cash App Pay einrichten.

Stripe einrichten
Serverseitig

Zunächst benötigen Sie ein Stripe-Konto. Jetzt registrieren.

Verwenden Sie unsere offiziellen Bibliotheken für den Zugriff auf die Stripe-API von Ihrer Anwendung aus:

Command Line
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
# Available as a gem
sudo gem install stripe
Gemfile
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

Eine/n Kund/in erstellen oder abrufen
Serverseitig

Um eine Cash App Pay-Zahlungsmethode für zukünftige Zahlungen zu speichern, müssen Sie sie einem/einer Kund/in zuordnen.

Erstellen Sie ein Kundenobjekt, wenn Ihr/e Kund/in ein Konto bei Ihrem Unternehmen anlegt. Verknüpfen Sie die ID des Kundenobjekts mit Ihrer eigenen internen Darstellung eines/einer Kund/in. Alternativ können Sie das Kundenobjekt erstellen, bevor Sie eine Zahlungsmethode für zukünftige Zahlungen speichern.

Fügen Sie den folgenden Code auf Ihrem Server ein, um eine/n neue/n Kund/in zu erstellen.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  --data-urlencode description="My First Test Customer (created for API docs)"

Zeigen Sie die Autorisierungsbedingungen auf Ihrem Zahlungsformular an
Client-seitig

Speichern Sie die Cash App Pay-Anmeldeinformationen Ihrer Kundinnen/Kunden($Cashtag), um deren Konto für zukünftige Off-Session-Zahlungen zu belasten. Ihr nutzerspezifisches Zahlungsformular muss einen schriftlichen Autorisierungshinweis enthalten, bevor der PaymentIntent bzw. SetupIntent bestätigt wird.

Die Autorisierungsbedingungen müssen nur angezeigt werden, wenn Sie das $Cashtag von Kundinnen/Kunden zum ersten Mal speichern.

Wir empfehlen Ihnen, den folgenden Text für Ihr individuelles Zahlungsformular zu verwenden:

Indem Sie fortfahren, erteilen Sie Rocket Rides die Genehmigung, Ihr Cash App-Konto in Höhe dieser und künftiger Zahlungen im Einklang mit den AGB von Rocket Rides zu belasten, bis diese Genehmigung widerrufen wird. Sie können diese Zustimmung jederzeit in Ihren Cash App-Einstellungen ändern.

Verwenden Sie die Setup Intents API, um Angaben zur Zahlungsmethode im Voraus zu erfassen. Den endgültigen Betrag bzw. das Zahlungsdatum können Sie zu einem späteren Zeitpunkt bestimmen. Dies ist nützlich für Folgendes:

  • Zahlungsmethoden für Kund/innen speichern, damit deren spätere Käufe keine Authentifizierungen erfordern
  • Kostenlosen Testzeitraum für ein Abonnement starten

SetupIntent erstellen und Zahlungsmethode speichern
Serverseitig

Ein SetupIntent ist ein Objekt, mit dem Sie eine Zahlungsmethode eines Kunden/einer Kundin für zukünftige Zahlungen einrichten können. Der SetupIntent verfolgt die Schritte dieses Einrichtungsvorgangs. Erstellen Sie einen SetupIntent auf Ihrem Server, wobei payment_method_types auf cashapp gesetzt ist, und geben Sie die Kunden-ID und usage=off_session oder usage=on_session an.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/setup_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "payment_method_types[]"=cashapp \
  -d "payment_method_data[type]"=cashapp \
  -d usage=off_session \
  -d customer={{CUSTOMER_ID}}

Client-Geheimnis abrufen

Im SetupIntent ist ein Client-Geheimnis enthalten, das auf dem Client verwendet wird, um Zahlungen sicher abzuschließen. Es gibt verschiedene Verfahren zum Übergeben des Client-Geheimnisses an den Client.

Rufen Sie das Client-Geheimnis von einem Endpoint auf Ihrem Server ab, indem Sie die Browser-Funktion fetch verwenden. Diese Vorgehensweise funktioniert am besten, wenn es sich bei Ihrer Client-Seite um eine einseitige Anwendung handelt, insbesondere wenn sie mit einem modernen Frontend-Framework wie React erstellt wurde. Erstellen Sie den Server-Endpoint, der das Client-Geheimnis bereitstellt:

main.rb
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
get '/secret' do
  intent = # ... Create or retrieve the SetupIntent
  {client_secret: intent.client_secret}.to_json
end

Und dann rufen Sie das Client-Geheimnis mit JavaScript auf der Client-Seite ab:

(async () => {
  const response = await fetch('/secret');
  const {client_secret: clientSecret} = await response.json();
  // Render the form using the clientSecret
})();

Als Nächstes speichern Sie Cash App Pay mittels Stripe.js auf dem Client.

Binden Sie das Stripe.js-Skript in Ihre Zahlungsseite ein, indem Sie es im head Ihrer HTML-Datei einfügen.

checkout.html
<head>
  <title>Checkout</title>
  <script src="https://js.stripe.com/basil/stripe.js"></script>
</head>

Erstellen Sie auf Ihrer Checkout-Seite mit dem folgenden JavaScript eine Instanz von Stripe.js:

client.js
// Set your publishable key. Remember to change this to your live publishable key in production!
// See your keys here: https://dashboard.stripe.com/apikeys
const stripe = Stripe(
'pk_test_TYooMQauvdEDq54NiTphI7jx'
);

Verwenden Sie stripe.confirmCashappSetup, um den SetupIntent clientseitig zu bestätigen, und geben Sie eine return_url und optionale mandate_data an. Verwenden Sie die return_url, um Kundinnen und Kunden nach einem erfolgreichen SetupIntent auf eine bestimmte Seite weiterzuleiten.

client.js
const form = document.getElementById('setup-form');

form.addEventListener('submit', function(event) {
  event.preventDefault();

  // Set the clientSecret here
  stripe.confirmCashappSetup(
    clientSecret,
    {
      payment_method: {
        type: 'cashapp',
      },
      return_url: 'https://www.example.com/checkout/done',
    },
  );
});

Kundinnen/Kunden können Cash App Pay über ihr Mobilgerät oder Desktop-Apps authentifizieren. Nachdem confirmCashappSetup aufgerufen wurde, bestimmt der kundenseitig verwendete Client die Authentifizierungsmethode, also z. B. eine Weiterleitung für Mobilgeräte oder einen QR-Code für Desktops. Die Authentifizierungsantwort enthält außerdem eine Zahlungsmethoden-ID, die Sie im nächsten Schritt verwenden müssen, um eine PaymentIntent zu erstellen.

Nachdem confirmCashappSetup aufgerufen wurde, leitet Stripe Ihre Kundinnen/Kunden zur Autorisierung an Cash App weiter. Nachdem sie die Zahlung autorisiert haben, sendet Stripe Ihre Kundinnen/Kunden an die return_url des Setup Intent. Stripe fügt setup_intent, setup_intent_client_secret, redirect_pm_type und redirect_status als URL-Abfrageparameter zusätzlich zu allen vorhandenen Abfrageparametern in return_url hinzu.

Eine Authentifizierungssitzung läuft nach 10 Minuten ab und dann wechselt der Status des SetupIntent wieder auf require_payment_method. Nach der Statusänderung sehen Kundinnen/Kunden einen Autorisierungsfehler und müssen den Vorgang von vorne beginnen.

PaymentIntent mit einer gespeicherten Zahlungsmethode erstellen
Serverseitig

Nachdem Sie eine PaymentMethod erstellt haben, können Sie zukünftige Zahlungen per Cash App Pay annehmen, indem Sie ein PaymentIntent erstellen und bestätigen. Verwenden Sie zum Bestätigen eines PaymentIntent dieselbe Zahlungsmethoden-ID aus dem vorherigen SetupIntent- oder PaymentIntent-Objekt. Der Wert off_session muss auch auf „true“ gesetzt sein, wenn sich Kundinnen und Kunden in diesem PaymentIntent nicht in einem Bezahlvorgang befinden.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "payment_method_types[]"=cashapp \
  -d payment_method={{PAYMENT_METHOD_ID}} \
  -d amount=1000 \
  -d currency=usd \
  -d customer={{CUSTOMER_ID}} \
  -d statement_descriptor=test_statement \
  -d capture_method=automatic \
  -d confirm=true \
  -d off_session=true

Umgang mit dem Widerruf wiederverwendbarer Zahlungsmethoden

Es gibt zwei Möglichkeiten, eine wiederverwendbare Zahlungsmethode zu widerrufen:

  • Kundinnen und Kunden können eine wiederverwendbare Zahlungsmethode in der mobilen App von Cash App deaktivieren. In diesem Fall sendet Stripe das Ereignis mandate.updated. Abonnieren Sie Webhook-Ereignisse und rufen Sie PaymentMethod trennen auf, um sie zu deaktivieren.
  • Kundinnen/Kunden können auch wiederverwendbare Zahlungsmethoden auf Ihrer Nutzeroberfläche deaktivieren, sofern dies unterstützt wird. In diesem Fall kann Ihr Server detach PaymentMethod aufrufen, um sie zu deaktivieren.

In beiden Fällen wird Ihnen nach dem Aufruf der detach PaymentMethod, ein payment_method.detached-Ereignis gesendet.

War diese Seite hilfreich?
JaNein