Zukünftige Zahlungen per Cash App Pay einrichten

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

Serverseitig

Diese Integration erfordert Endpoints auf Ihrem Server, die mit der Stripe-API kommunizieren können. Nutzen Sie die offiziellen Bibliotheken für den Zugriff auf die Stripe-API von Ihrem Server aus:

# Available as a gem
sudo gem install stripe

# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

Clientseitig

Das Stripe iOS SDK ist Open Source, vollständig dokumentiert und kompatibel mit Apps, die iOS 13 oder höher unterstützen.

Konfigurieren Sie das SDK mit Ihrem veröffentlichbaren Schlüssel von Stripe, um es beim Start der App auszuführen. Dadurch kann Ihre App Anfragen an die Stripe-API senden.

import UIKit
import StripePaymentsUI

@main
class AppDelegate: UIResponder, UIApplicationDelegate {

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        StripeAPI.defaultPublishableKey = 
"pk_test_TYooMQauvdEDq54NiTphI7jx"
        // do any other necessary launch configuration
        return true
    }
}

Um die Zahlungsmethode Cash App Pay für künftige Zahlungen zu speichern, müssen Sie sie den gewünschten Kund/innen zuordnen.

Erstellen Sie Kundenobjekte, wenn Kund/innen Konten bei Ihrem Unternehmen anlegen. Verknüpfen Sie die ID der Kundenobjekte mit Ihrer eigenen internen Darstellung der Kund/innen. Alternativ können Sie das Kundenobjekt erstellen, bevor Sie eine Zahlungsmethode für künftige Zahlungen speichern.

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

curl https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  --data-urlencode description="My First Test Customer (created for API docs)"

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.

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

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 eines Kunden/einer Kundin 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 zu belasten im Einklang mit den AGB von Rocket Rides, bis diese Genehmigung widerrufen wird. Sie können dies jederzeit in Ihren Cash-App-Einstellungen ändern.

Rufen Sie das Client-Geheimnis von der erstellten SetupIntent ab und rufen Sie STPPaymentHandler confirmSetupIntent. auf. Dies entspricht einer Webansicht, sodass die Kund/innen die Zahlung in Cash App durchführen können. Danach wird der Completion-Block mit dem Ergebnis der Zahlung aufgerufen.

let setupIntentParams = STPSetupIntentConfirmParams(clientSecret: setupIntentClientSecret)
setupIntentParams.paymentMethodParams = paymentMethodParams
setupIntentParams.returnURL = "payments-example://stripe-redirect"

STPPaymentHandler.shared().confirmSetupIntent(withParams: setupIntentParams, authenticationContext: self) { (handlerStatus, setupIntent, error) in
    switch handlerStatus {
    case .succeeded:
        // Setup succeeded

    case .canceled:
        // Setup was canceled

    case .failed:
        // Setup failed

    @unknown default:
        fatalError()
    }
}

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.

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