Weiter zum Inhalt
Konto erstellen oder anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellenAnmelden
ÜbersichtAktualisieren Sie Ihre Integration
Online-Zahlungen
ÜbersichtIhren Use case findenVerwenden Sie Managed Payments
Präsenzzahlungen
Zahlungsmethoden
Zahlungsszenarien
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/clover/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.

OptionalWeiterleitung und Authentifizierung manuell handhaben

Wir empfehlen die Verwendung von Stripe.js, um Weiterleitungen zu verarbeiten und Authentifizierung über confirmCashappSetup durchzuführen. Sie können Weiterleitungen und Authentifizierungen jedoch auch manuell auf Ihrem Server handhaben.

Geben Sie handleActions: false im confirmCashappSetup-Aufruf an.

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

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

  // Set the clientSecret here you got in Step 2
  stripe.confirmCashappSetup(
    clientSecret,
    {
      payment_method: {
        type: 'cashapp',
      },
      return_url: 'https://www.example.com/checkout/done',
    },
    {
      handleActions: false
    },
  ).then((result) => {
    if (result.error) {
      // Display error to your customer.
    } else if (result.paymentIntent.status === "requires_action") {
      const nextAction = result.setupIntent.next_action.cashapp_handle_redirect_or_display_qr_code;
      const expiresAt = nextAction.qr_code.expires_at;
      if (IS_MOBILE) {
        // This URL redirects the customer to Cash App to approve or decline the payment.
        const mobileAuthUrl = nextAction.mobile_auth_url;
      } else if (IS_DESKTOP) {
        // Render the QR code and display it to the customer using the below image source.
        const imageUrlSvg = nextAction.qr_code.image_url_svg;
        const imageUrlPng = nextAction.qr_code.image_url_png;
      }
    }
  });
});

Die SetupIntent-Antwort enthält den Status requires_action. Das bedeutet, dass Ihre Nutzer/innen einen weiteren Schritt ausführen müssen, um die Transaktion abzuschließen. Verwenden Sie das Objekt next_action.cashapp_handle_redirect_or_display_qr_code.hosted_instructions_url aus derselben SetupIntent-Antwort, um Ihre Kundinnen/Kunden zu einer Seite weiterzuleiten, über die sie die mobile Anwendung von Cash App öffnen und die Authentifizierungssitzung abschließen können. Nach einer erfolgreichen In-App-Authentifizierung leitet Cash App die Kundinnen/Kunden an die return_url weiter, die Sie in der Anfrage festgelegt haben. Dort wird der Bezahlvorgang abgeschlossen und der SetupIntent wechselt automatisch in den Status succeeded. Die SetupIntent-Antwort enthält auch eine Zahlungsmethoden-ID, die Sie mit zukünftigen PaymentIntents wiederverwenden können.

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.