Configurer les futurs paiements Cash App Pay

Tout d’abord, il vous faut un compte Stripe. Inscrivez-vous.

Côté serveur

Pour cette intégration, votre serveur doit être doté d’endpoints qui communiquent avec l’API Stripe. Utilisez les bibliothèques officielles pour accéder à l’API Stripe depuis votre serveur :

# Available as a gem
sudo gem install stripe

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

Côté client

Le SDK iOS de Stripe est disponible en open source et fait l’objet d’une documentation complète. Il est également compatible avec les applications prenant en charge iOS 13 et les versions ultérieures.

Configurez le SDK avec votre clé publiable Stripe au démarrage de votre application. Cela lui permet d’envoyer des requêtes à l’API Stripe.

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

Pour enregistrer un moyen de paiement Cash App Pay pour de futurs paiements, vous devez le rattacher à un objet Customer.

Créez un objet Customer lorsque votre client crée un compte auprès de votre entreprise. Associez l’ID de l’objet Customer à votre propre représentation interne d’un client. Vous pouvez également créer l’objet Customer juste avant d’enregistrer un moyen de paiement pour votre client pour ses paiements ultérieurs.

Ajoutez le code suivant à votre serveur pour créer un nouveau client.

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

Un SetupIntent est un objet qui représente votre intention de configurer le moyen de paiement d’un client en vue de futurs paiements. Le SetupIntent suit les étapes de ce processus de configuration. Créez un SetupIntent sur votre serveur avec payment_method_types défini sur cashapp, spécifiez l’ID du client et configurez usage=off_session ou usage=on_session.

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

Enregistrez les informations d’identification Cash App Pay de votre client ($Cashtag) pour débiter son compte lors de futurs paiements hors session. Votre formulaire de paiement personnalisé doit présenter un avis d’autorisation écrit avant la confirmation du PaymentIntent ou du SetupIntent.

Les conditions d’autorisation ne doivent être affichées que la première fois où vous enregistrez le $Cashtag d’un client.

Nous vous recommandons d’intégrer le texte suivant à votre formulaire de paiement personnalisé :

En continuant, vous autorisez Rocket Rides à débiter votre compte Cash App pour ce paiement et les paiements futurs, conformément aux conditions de Rocket Rides, jusqu’à la révocation de cette autorisation. Vous pouvez modifier cela à tout moment dans les paramètres de Cash App.

Récupérez la clé secrète du client auprès du SetupIntent que vous avez créé, puis appelez le STPPaymentHandler confirmSetupIntent. Une vue Web s’affiche pour permettre au client de finaliser le paiement dans Cash App. Une fois l’opération terminée, le bloc de finalisation est appelé avec le résultat du paiement.

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

Après avoir créé un PaymentMethod, vous pouvez accepter les futurs paiements Cash App Pay en créant et en confirmant un PaymentIntent. Lors de la confirmation d’un PaymentIntent, utilisez le même ID de moyen de paiement que celui de l’objet SetupIntent ou PaymentIntent précédent. La valeur off_session doit également être définie sur true si le client ne se trouve pas dans un flux de paiement pour ce PaymentIntent.

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