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 diese 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 Android SDK ist Open Source und vollständig dokumentiert.

Um das SDK zu installieren, fügen Sie stripe-android in den Block dependencies Ihrer app/build.gradle-Datei ein:

plugins {
    id("com.android.application")
}

android { ... }

dependencies {
  // ...

  // Stripe Android SDK
  implementation("com.stripe:stripe-android:21.26.1")
  // Include the financial connections SDK to support US bank account as a payment method
  implementation("com.stripe:financial-connections:21.26.1")
}

Konfigurieren Sie das SDK mit Ihrem veröffentlichbaren Schlüssel von Stripe so, dass dieser Anfragen an die API stellen kann, wie beispielsweise in Ihrer Unterklasse Application:

import com.stripe.android.PaymentConfiguration

class MyApp : Application() {
    override fun onCreate() {
        super.onCreate()
        PaymentConfiguration.init(
            applicationContext,
            
"pk_test_TYooMQauvdEDq54NiTphI7jx"
        )
    }
}

Stripe-Beispiele nutzen auch OkHttp und GSON, um HTTP-Anfragen an einen Server zu stellen.

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 aus dem von Ihnen erstellten SetupIntent ab, und rufen Sie PaymentLauncher bestätigen auf. Dies entspricht einer Webansicht, über die die Kund/innen die Einrichtung mit Cash App Pay durchführen können. Nach Abschluss wird der angegebene PaymentResultCallback mit dem Ergebnis der Zahlung aufgerufen.

class CashAppPaySetupActivity : AppCompatActivity() {

    // ...

    private val paymentLauncher: PaymentLauncher by lazy {
        val paymentConfiguration = PaymentConfiguration.getInstance(applicationContext)
        PaymentLauncher.create(
            activity = this,
            publishableKey = paymentConfiguration.publishableKey,
            stripeAccountId = paymentConfiguration.stripeAccountId,
            callback = ::onPaymentResult,
        )
    }

    override fun onCreate(savedInstanceState: Bundle?) {
        // …
        startCheckout()
    }

    private fun startCheckout() {
        // Create a SetupIntent on your backend and return the client_secret here
        val setupIntentClientSecret = // …

        val cashAppPayParams = PaymentMethodCreateParams.createCashAppPay()

        val confirmParams = ConfirmSetupIntentParams.create(
            paymentMethodCreateParams = cashAppPayParams,
            clientSecret = setupIntentClientSecret,
            // Add a mandate ID or MandateDataParams…
        )

        paymentLauncher.confirm(confirmParams)
    }

    private fun onPaymentResult(paymentResult: PaymentResult) {
        // Handle the setup result…
    }
}

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