Accepter un paiement Sofort

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

Un PaymentIntent représente votre intention d’encaisser un paiement auprès d’un client et suit le cycle de vie du processus de paiement.

Côté serveur

Créez un PaymentIntent sur votre serveur et précisez le montant amount à encaisser ainsi que la devise eur (Sofort ne prend en charge aucune autre devise). Si vous avez déjà une intégration Payment Intents, ajoutez sofort à la liste des types de moyens de paiement.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d currency=eur \
  -d "payment_method_types[]"=sofort

Modification de la langue préférée

Par défaut, Stripe affiche la page d’autorisation de Sofort dans la langue correspondant au code pays spécifié. Vous pouvez remplacer cette langue par la langue préférée de votre client en précisant ce choix dans la requête et en modifiant la valeur de la propriété preferred_language. Les valeurs prises en charge sont de, en, es, it, fr, nl et pl.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d currency=eur \
  -d "payment_method_types[]"=sofort \
  -d "payment_method_options[sofort][preferred_language]"=de

Au lieu de transmettre à l’application la totalité de l’objet PaymentIntent, renvoyez sa clé secrète du client. Il s’agit d’une clé unique qui vous permet de confirmer le paiement et d’actualiser les informations de paiement côté client, le tout sans autoriser la manipulation d’informations sensibles comme le montant du paiement.

Côté client

Côté client, demandez un PaymentIntent depuis votre serveur et sauvegardez la clé secrète du client.

class CheckoutViewController: UIViewController {
var paymentIntentClientSecret: String?

func startCheckout() {
  // Request a PaymentIntent from your server and store its client secret
}
}

Lorsqu’un client appuie sur le bouton permettant de payer avec Sofort, confirmez le PaymentIntent pour finaliser le paiement. Configurez un objet STPPaymentIntentParams avec la clé secrète du client du PaymentIntent côté serveur. Sofort nécessite que vous recueilliez le code pays de la banque de votre client et que vous le transmettiez dans le paramètre STPPaymentMethodSofortParams.

Plutôt que d’envoyer la totalité de l’objet PaymentIntent au client, utilisez sa clé secrète. Il ne s’agit pas de la même chose que vos clés API qui authentifient les requêtes de l’API de Stripe. La clé secrète du client est une chaîne qui permet à votre application d’accéder à des champs importants du PaymentIntent (par exemple, status) tout en masquant les champs sensibles (par exemple, customer).

Configurer une URL de redirection

Le SDK iOS peut présenter une vue Web dans votre application pour effectuer le paiement Sofort. Une fois l’authentification effectuée, la vue Web peut disparaître automatiquement au lieu que ce soit votre client qui la ferme. Pour cela, configurez une URL personnalisée ou un lien universel et configurez votre délégation d’application de façon à transférer l’URL au SDK.

// This method handles opening custom URL schemes (for example, "your-app://stripe-redirect")
func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey: Any] = [:]) -> Bool {
    let stripeHandled = StripeAPI.handleURLCallback(with: url)
    if (stripeHandled) {
        return true
    } else {
        // This was not a Stripe url – handle the URL normally as you would
    }
    return false
}

// This method handles opening universal link URLs (for example, "https://example.com/stripe_ios_callback")
func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
    if userActivity.activityType == NSUserActivityTypeBrowsingWeb {
        if let url = userActivity.webpageURL {
            let stripeHandled = StripeAPI.handleURLCallback(with: url)
            if (stripeHandled) {
                return true
            } else {
                // This was not a Stripe url – handle the URL normally as you would
            }
        }
    }
    return false
}

Appelez STPPaymentHandler confirmPayment pour finaliser le paiement.

let paymentIntentParams = STPPaymentIntentParams(clientSecret: paymentIntentClientSecret)

let sofort = STPPaymentMethodSofortParams()
sofort.country = "DE"

paymentIntentParams.paymentMethodParams = STPPaymentMethodParams(sofort: sofort, billingDetails: nil, metadata: nil)

paymentIntentParams.returnURL = "payments-example://stripe-redirect"
STPPaymentHandler.shared().confirmPayment(paymentIntentParams, with: self) { (handlerStatus, paymentIntent, error) in
    switch handlerStatus {
    case .succeeded:
        // Payment succeeded
        // ...

    case .canceled:
        // Payment canceled
        // ...

    case .failed:
        // Payment failed
        // ...

    @unknown default:
        fatalError()
    }
}

As Sofort is a delayed notification payment method, the PaymentIntent’s status remains in a payment_intent.processing state for up to 14 days from its creation (also known as the cutoff date). In a sandbox, the PaymentIntent’s status remains in the processing state for three minutes to simulate this.

• Stripe recommande d’exécuter les achats pendant l’état de traitement. En moyenne, vous pouvez vous attendre à ce que 0,2 % des tentatives de paiement Sofort échouent après avoir atteint l’état de traitement. Cette recommandation s’applique uniquement aux paiements Sofort en raison de son faible taux d’échec et ne s’applique pas aux autres moyens de paiement avec notification différée.
• Vous préférez peut-être n’exécuter les commandes qu’après avoir reçu l’événement payment_intent.succeeded. Stripe envoie cet événement après que la tentative de paiement a été confirmée et que les fonds sont garantis.
• Si un client n’effectue pas le paiement, Stripe envoie l’événement payment_intent.failed et le PaymentIntent repasse à l’état requires_payment_method.

Utilisez le Dashboard, un webhook personnalisé ou une solution partenaire pour recevoir ces événements et exécuter des actions, comme envoyer une confirmation de commande par e-mail à votre client, enregistrer la vente dans une base de données ou lancer un workflow de livraison.

Manuellement

Utilisez le Dashboard Stripe pour consulter tous vos paiements Stripe, envoyer des reçus par e-mail, gérer les virements et réessayer d’effectuer les paiements ayant échoué.

• Afficher vos paiements tests dans le Dashboard

Code personnalisé

Créez un gestionnaire de webhooks pour écouter des événements et créer des tunnels de paiement asynchrones personnalisés. Testez et déboguez votre intégration de webhooks en local, grâce à la CLI Stripe.

• Créer un webhook personnalisé

Applications préconfigurées

Intégrez une application partenaire pour gérer les événements métier courants, comme l’automatisation, le marketing ou les ventes.