Accepter un paiement Multibanco

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

Stripe utilise un objet PaymentIntent pour représenter votre intention d’encaisser le paiement d’un client, qui suit les changements d’état du paiement, de la création du bon Multibanco à la finalisation du règlement.

Côté serveur

Créez un PaymentIntent sur votre serveur en précisant un montant et la devise eur (Multibanco ne prend pas en charge d’autres devises). Si votre intégration inclut déjà l’API Payment Intents, ajoutez multibanco à la liste des types de moyens de paiement valides pour votre PaymentIntent.

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

Le PaymentIntent renvoyé contient la clé secrète du client, que vous utiliserez pour confirmer le PaymentIntent. Renvoyez cette clé secrète côté client pour permettre son utilisation à l’étape suivante.

Côté client

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

class CheckoutViewController: UIViewController {
    var paymentIntentClientSecret: String?

    // ...continued from previous step

    override func viewDidLoad() {
        // ...continued from previous step
        startCheckout()
    }

    func startCheckout() {
        // Request a PaymentIntent from your server and store its client secret
        // Click View full sample to see a complete implementation
    }
}

Dans votre application, collectez les informations de facturation requises suivantes auprès du client. Ensuite, créez un objet STPPaymentIntentParams à l’aide de ces informations.

let billingDetails = STPPaymentMethodBillingDetails()
billingDetails.email = "jenny@example.com"

Soumettez les informations de facturation du client en appelant STPPaymentHandler confirmPayment avec la clé secrète du client de l’objet PaymentIntent que vous avez créé. Une vue web affiche alors le bon Multibanco. Ensuite, le bloc de finalisation est appelé avec le résultat du paiement.

let paymentIntentParams = STPPaymentIntentParams(clientSecret: paymentIntentClientSecret)
let multibancoParams = STPPaymentMethodMultibancoParams();
paymentIntentParams.paymentMethodParams = STPPaymentMethodParams(
    multibanco: multibancoParams,
    billingDetails: billingDetails,
    metadata: nil
)

STPPaymentHandler.shared().confirmPayment(paymentIntentParams, with: self) { (handlerStatus, paymentIntent, error) in
    switch handlerStatus {
    case .succeeded:
        // The Multibanco voucher was displayed successfully. The customer can now pay the Multibanco voucher
    case .canceled:
        // Handle cancelation
    case .failed:
        // Handle failure
    @unknown default:
        fatalError()
    }
}

Stripe envoie un événement payment_intent.requires_action lors de la création d’un bon Multibanco. Si vous avez besoin d’envoyer un e-mail avec le lien vers les instructions de paiement du bon, vous pouvez localiser le hosted_voucher_url dans payment_intent.next_action.multibanco_display_details.hosted_voucher_url.

Multibanco est un moyen de paiement à notification différée. Un client règle un bon Multibanco en dehors de votre tunnel de paiement, via son espace bancaire en ligne ou à un distributeur automatique de billets.

Une fois qu’un paiement Multibanco aboutit, Stripe envoie un événement payment_intent.succeeded. Utilisez le Dashboard ou créez un gestionnaire de webhooks 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 flux de livraison.

En savoir plus sur l’expiration des bons Multibanco.

Recevoir des événements et exécuter des actions métier

Manuellement

Utilisez le Dashboard Stripe pour consulter tous vos paiements Stripe, envoyer des reçus par e-mail, gérer les virements et relancer les paiements en échec.

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 localement, grâce à l’interface de ligne de commande Stripe.

Découvrez comment créer un webhook personnalisé.

En environnement de test, définissez STPPaymentMethodBillingDetails email sur les valeurs suivantes lorsque vous appelez STPPaymentHandler confirmPayment pour tester différents scénarios.