Enregistrer une carte bancaire sans authentification

Tout d’abord, vous avez besoin d’un compte Stripe. Inscrivez-vous dès maintenant.

Avant d’amorcer votre intégration, configurez les SDK Stripe pour iOS et le serveur.

Côté serveur

Cette intégration exige des endpoints sur votre serveur qui communiquent avec l’API Stripe. Utilisez nos bibliothèques officielles :

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

Commencez par présenter un formulaire de paiement à votre client. Collectez ses informations de carte bancaire à l’aide de STPPaymentCardTextField, un composant d’interface utilisateur prêt à l’emploi fourni par le SDK et qui recueille le numéro de carte bancaire, la date d’expiration, le CVC et le code postal.

Transmettez les informations de carte à createPaymentMethod pour créer une PaymentMethod.

class CheckoutViewController: UIViewController {
    lazy var cardTextField: STPPaymentCardTextField = {
        let cardTextField = STPPaymentCardTextField()
        return cardTextField
    }()

    @objc
    func pay() {
        // Collect card details on the client
        STPAPIClient.shared.createPaymentMethod(with: cardTextField.paymentMethodParams) { [weak self] paymentMethod, error in
            guard let paymentMethod = paymentMethod else {
                // Display the error to the user
                return
            }
            let paymentMethodId = paymentMethod.stripeId
            // Send paymentMethodId to your server for the next steps
        }
    }
}

Envoyez l’identifiant PaymentMethod qui en résulte à votre serveur et suivez le reste des étapes pour enregistrer la carte du client et débiter la carte à l’avenir.

Enregistrez la carte en associant le PaymentMethod à un objet Customer. Vous pouvez utiliser l’objet Customer pour enregistrer d’autres données concernant l’utilisateur, telles que des informations de livraison et l’adresse e-mail.

curl https://api.stripe.com/v1/customers \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d payment_method={{PAYMENT_METHOD_ID}}

Si vous avez un Client existant, vous pouvez joindre le PaymentMethod plutôt à cet objet.

curl https://api.stripe.com/v1/payment_methods/{{PAYMENT_METHOD_ID}}/attach \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d customer=
{{CUSTOMER_ID}}

À ce stade, associez l’identifiant de l’objet Customer et l’identifiant du PaymentMethod à votre propre représentation interne d’un client, si vous en avez une.

Au moment de débiter votre client, recherchez l’ID du PaymentMethod à débiter, soit en sauvegardant les deux ID dans votre base de données, soit en utilisant l’ID de l’objet Customer pour rechercher tous les objets PaymentMethod correspondant à ce client.

curl -G https://api.stripe.com/v1/payment_methods \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d type=card

Utilisez l’ID PaymentMethod et l’ID Customer pour créer un PaymentIntent. Définissez error_on_requires_action sur true pour refuser les paiements qui exigent une action de la part de votre client, telle que l’authentification à deux facteurs.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d amount=1099 \
  -d currency=usd \
  -d "payment_method_types[]"=card \
  -d customer=
{{CUSTOMER_ID}} \
  -d payment_method={{PAYMENT_METHOD_ID}} \
  -d error_on_requires_action=true \
  -d confirm=true

Lorsqu’une tentative de paiement échoue, la requête échoue également avec un code d’état HTTP 402 et Stripe renvoie une erreur. Vous devez inviter l’utilisateur à retourner dans votre application (par exemple en lui envoyant un message au sein de l’application) afin de terminer le paiement. Consultez le code de l’erreur généré par la bibliothèque d’API de Stripe ou le paramètre last_payment_error.decline_code du PaymentIntent pour déterminer le motif du refus du paiement par l’émetteur de la carte.

Informez votre client que le paiement a échoué et dirigez-le vers le formulaire de paiement que vous avez créé dans l’étape 1 où il peut saisir les informations d’une nouvelle carte. Envoyez ce nouvel identifiant PaymentMethod à votre serveur à joindre à l’objet Customer et effectuez de nouveau le paiement.

Vous pouvez également créer un PaymentIntent et enregistrer une carte en un seul appel à l’API si vous avez déjà créé un Client.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d amount=1099 \
  -d currency=usd \
  -d "payment_method_types[]"=card \
  -d customer=
{{CUSTOMER_ID}} \
  -d payment_method={{PAYMENT_METHOD_ID}} \
  -d error_on_requires_action=true \
  -d confirm=true \
  -d setup_future_usage=on_session

Le réglage de setup_future_usage sur on_session indique à Stripe que vous souhaitez conserver la carte pour plus tard, sans déclencher d’authentification inutile.

Stripe fournit des cartes de test que vous pouvez utiliser en mode test pour simuler le comportement de différentes cartes bancaires. Utilisez ces cartes avec n’importe quel CVC, code postal et date d’expiration non échue.