Cash App Pay-Zahlungen

Fügen Sie Ihrer Integration Unterstützung für Cash App Pay hinzu.

Internet

Mobil

Wir empfehlen die Implementierung des nutzerdefinierten Zahlungsablaufs. Mit dem nutzerdefinierten Zahlungsablauf können Sie Cash App Pay und andere Zahlungsmethoden mit wenig Aufwand zu Ihrer Integration hinzufügen. Die Annahme von Zahlungen per Cash App Pay über eine direkte API-Integration umfasst die folgenden Schritte:

Erstellen eines PaymentIntent-Objekts, um eine Zahlung zu verfolgen.
Zahlung wird zur Abwicklung an Stripe übermittelt.
Authentifizierung der Zahlung (durch Weiterleitung einer mobilen App oder QR-Code).
Ereignisse nach der Zahlung verarbeiten, um Kundinnen/Kunden nach erfolgreicher oder fehlgeschlagener Bestellung weiterzuleiten.

Stripe einrichten
Serverseitig

Zunächst benötigen Sie ein Stripe-Konto. Registrieren Sie sich jetzt.

Nutzen Sie unsere offiziellen Bibliotheken für den Zugriff auf die Stripe-API über Ihre Anwendung:

Erstellen Sie ein PaymentIntent
Serverseitig

Ein PaymentIntent ist ein Objekt, das Ihre Absicht, eine Kundenzahlung einzuziehen, darstellt und den gesamten Zahlungsvorgang dokumentiert.

So erstellen Sie einen PaymentIntent auf Ihrem Server:

Geben Sie den einzuziehenden Betrag und die Währung an.
Fügen Sie cashapp zur Liste der Zahlungsmethoden für Ihren PaymentIntent hinzu. Vergewissern Sie sich, dass Cash App Pay im Dashboard aktiviert ist.

Client-Geheimnis abrufen

Im PaymentIntent 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:

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
})();

Zahlung an Stripe senden und Transaktionen clientseitig authentifizieren

In diesem Schritt führen Sie Cash App Pay-Zahlungen auf dem Client mit Stripe.js durch. Um eine Transaktion zu authentifizieren, müssen Sie die Kundinnen/Kunden an Cash App weiterleiten.

Binden Sie das Stripe.js-Skript in Ihre Bezahlseite 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 Bezahlseite 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.confirmCashappPayment, um den PaymentIntent auf der Client-Seite zu bestätigen.

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

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

  // Pass the clientSecret obtained from the server in step 2 as the first argument
  stripe.confirmCashappPayment(
    clientSecret,
    {
      payment_method: {
        type: 'cashapp',
      },
      return_url: 'https://www.example.com/checkout/done',
    },
  );
});

Vorsicht

confirmCashappPayment leitet nur mobile Browser an Ihre return_url, nicht die Desktop-Browser. Sie können Kundinnen/Kunden, die Desktop-Browser verwenden, manuell zu Ihrer Rückgabe-URL weiterleiten, nachdem das zurückgegebene Promise aufgelöst wurde.

Kundinnen/Kunden können Transaktionen per Cash App Pay mit der mobilen App oder der Desktop-App authentifizieren. Der kundenseitig verwendete Client bestimmt die Authentifizierungsmethode, nachdem confirmCashappPayment aufgerufen wurde.

Nachdem confirmCashappPayment aufgerufen wurde, werden die Kundinnen/Kunden zu Cash App weitergeleitet, um die Zahlung zu genehmigen oder abzulehnen. Nachdem die Zahlung kundenseitig autorisiert wurde, werden diese zur return_url des Payment Intent weitergeleitet. Stripe fügt payment_intent, payment_intent_client_secret, redirect_pm_type und redirect_status als URL-Abfrageparameter hinzu (zusätzlich zu allen vorhandenen Abfrageparametern in return_url ).

Eine Authentifizierungssitzung läuft nach 60 Minuten ab, der Status des PaymentIntent wechselt dann wieder auf require_payment_method. Nach der Statusänderung sehen Kundinnen/Kunden einen Zahlungsfehler und müssen den Zahlungsvorgang von vorne beginnen.

OptionalWeiterleitung und Authentifizierung manuell handhaben

OptionalSeparate Autorisierung und Erfassung

OptionalEreignisse nach der Zahlung verarbeiten

Integration testen

Um Ihre Integration zu testen, wählen Sie als Zahlungsmethode Cash App Pay aus und tippen Sie auf Bezahlen. Während des Tests werden Sie auf eine Testzahlungsseite weitergeleitet, auf der Sie die Zahlung genehmigen oder ablehnen können.

Wenn Sie im Live-Modus auf Bezahlen tippen, werden Sie zur mobilen Anwendung von Cash App weitergeleitet. In der Cash App haben Sie keine Möglichkeit, die Zahlung zu genehmigen oder abzulehnen. Die Zahlung wird nach abgeschlossener Weiterleitung automatisch genehmigt.

Fehlgeschlagene Zahlungen

Cash App Pay verwendet mehrere Datenpunkte, um zu entscheiden, wann eine Transaktion abgelehnt wird (zum Beispiel hat das KI-Modell ein hohes Verbraucherbetrugsrisiko für die Transaktion festgestellt oder der Verbraucher/die Verbraucherin hat die Zustimmung zur Abbuchung über die Cash App widerrufen).

In diesen Fällen wird die PaymentMethod getrennt und der Status des PaymentIntent-Objekts wechselt automatisch zu requires_payment_method.

Anders als bei einer abgelehnten Zahlung müssen Kundinnen/Kunden bei einem Cash App Pay-PaymentIntent mit dem Status requires_action die Zahlung innerhalb von 10 Minuten nach Weiterleitung zur Cash App-Website abschließen. Wenn nach 10 Minuten keine Aktion erfolgt ist, wird die Verbindung mit der PaymentMethod getrennt, und der Status des PaymentIntent-Objekts wechselt automatisch zu requires_payment_method.

In diesem Fall zeigt das Payment Element Fehlermeldungen an und fordert Ihre Kundinnen/Kunden auf, es mit einer anderen Zahlungsmethode erneut zu versuchen.

Fehlercodes

In der folgenden Tabelle finden Sie häufige Fehlercodes und die empfohlenen Maßnahmen:

Fehlercode	Empfohlene Maßnahme
`payment_intent_invalid_currency`	Geben Sie die korrekte Währung ein. Cash App Pay unterstützt nur `usd`.
`missing_required_parameter`	In der Fehlermeldung erhalten Sie weitere Informationen zum erforderlichen Parameter.
`payment_intent_payment_attempt_failed`	Dieser Code kann im Feld last_payment_error.code eines PaymentIntent angezeigt werden. Eine genauere Fehlerursache und Vorschläge zur Fehlerbehebung finden Sie in der Fehlermeldung.
`payment_intent_redirect_confirmation_without_return_url`	Geben Sie eine `return_url` an, wenn Sie einen PaymentIntent mit Cash App Pay bestätigen.