Add external payment methods

Add external payment methods to the Payment Element.

Utilisez le Payment Element de Stripe pour afficher les moyens de paiement déjà intégrés. L’ajout de moyens de paiement externes simplifie votre interface utilisateur en affichant tous les moyens de paiement que vous proposez dans le Payment Element de Stripe. L’intégration de moyens de paiement externes nécessite un travail d’intégration supplémentaire, car les transactions par le biais de moyens de paiement externes sont traitées et finalisées en dehors de Stripe.

Avis de non-responsabilité relatif aux moyens de paiement externes

Lorsque les clients sélectionnent un moyen de paiement externe, votre application gère le paiement à la place de Stripe. Consultez l’avis de non-responsabilité relatif aux moyens de paiement externes pour en savoir plus sur vos responsabilités et sur la disponibilité continue des moyens de paiement externes.

Ce guide permet d’ajouter un moyen de paiement externe, Fawry, en utilisant l’exemple du guide de démarrage rapide avec le Payment Element. Consultez la liste de tous les moyens de paiement externes disponibles.

Avant de commencer

Créez un compte Stripe ou connectez-vous.
Suivez le guide de démarrage rapide avec Payment Element pour finaliser l’intégration des paiements.
Pour chaque moyen de paiement externe que vous souhaitez ajouter, assurez-vous d’avoir terminé l’intégration avec chaque moyen de paiement externe et confirmé qu’il fonctionne dans la région dans laquelle vous souhaitez l’activer.

Ajouter des types de moyens de paiement externes

Lorsque vous créez votre objet PaymentSheet.Configuration et initialisez PaymentSheet, spécifiez les moyens de paiement externes à ajouter au Payment Element ainsi qu’un gestionnaire pour effectuer le paiement. L’exemple suivant illustre l’ajout de Fawry :

import StripePaymentSheet

class MyCheckoutVC: UIViewController {
  func setUpPaymentSheet() {
      // ...
      var configuration = PaymentSheet.Configuration()
      configuration.externalPaymentMethodConfiguration = .init(
          externalPaymentMethods: ["external_fawry"]
      ) { externalPaymentMethodType, billingDetails, completion in
          self.handleExternalPaymentMethod(type: externalPaymentMethodType, billingDetails: billingDetails, completion: completion)
      }
      // ...
  }

  func handleExternalPaymentMethod(type: String, billingDetails: STPPaymentMethodBillingDetails, completion: @escaping (PaymentSheetResult) -> Void) {
      // ...explained in the next step
  }
}

Finaliser le paiement

Lorsque le client appuie sur le bouton Acheter dans la PaymentSheet à l’aide d’un moyen de paiement externe, cela appelle le gestionnaire avec le type (par exemple, « external_fawry »), les éventuelles informations de facturation collectées et un gestionnaire d’exécution.

Votre implémentation effectue le paiement (par exemple, en utilisant le SDK de votre prestataire de services de paiement externe) et appelle le gestionnaire d’exécution avec le résultat du paiement : completed, canceled, ou failure(error:).

Si vous transmettez .failure(error:), PaymentSheet affiche errorDescription pour les erreurs Swift et localizedDescription pour les erreurs NSError.

import StripePaymentSheet

class MyCheckoutVC: UIViewController {
    func setUpPaymentSheet() {
        // ...
        var configuration = PaymentSheet.Configuration()
        configuration.externalPaymentMethods = .init(
            externalPaymentMethods: ["external_fawry"]
        ) { [weak self] externalPaymentMethodType, billingDetails, completion in
            self?.handleExternalPaymentMethod(type: externalPaymentMethodType, billingDetails: billingDetails, completion: completion)
        }
        // ...
    }

    func handleExternalPaymentMethod(type: String, billingDetails: STPPaymentMethodBillingDetails, completion: @escaping (PaymentSheetResult) -> Void) {
        // Your implementation should complete the payment with the payment method provider
        // When the payment completes, cancels, or fails, call the `completion` handler
        // Note you can present on top of PaymentSheet by using the `self.presentedViewController`.
        // This example code just immediately fails:
        let exampleError = NSError(domain: "MyErrorDomain", code: 0, userInfo: [NSLocalizedDescriptionKey: "Failed to complete payment!"])
        completion(.failed(error: exampleError))
    }
}

FacultatifOrdonner les moyens de paiement externes

Tester votre intégration

Parcourez votre tunnel de paiement et vérifiez que le Payment Element affiche Fawry. Cet exemple configure Fawry en deuxième position après les cartes.
Choisissez le moyen de paiement Fawry.
Cliquez sur Payer pour tester votre intégration Fawry existante. Vérifiez que votre intégration mène à bien la transaction et que toute action postérieure au paiement (par exemple, l’affichage d’une page de confirmation ou d’un message de réussite ou d’échec) fonctionne toujours avec votre intégration Fawry.

Considérations relatives au Dashboard

Les PaymentIntents des transactions ayant été traités par un prestataire de services de paiement externe sont marqués comme incomplete dans le Dashboard Stripe. Stripe ne gère pas les transactions effectuées via un moyen de paiement externe et n’est pas en mesure de déterminer l’état de ces transactions.

Si vous collectez les informations de paiement avant de créer un Intent, aucune transaction à l’état incomplete ne s’affiche dans le Dashboard Stripe pour les transactions ayant été traitées par un prestataire de services de paiement externe.

Avis de non-responsabilité relatif aux moyens de paiement externes

Vous pouvez utiliser le Payment Element de Stripe pour afficher des moyens de paiement externes qui ne sont pas pris en charge par Stripe, mais que vous pouvez intégrer directement. Lorsque les clients sélectionnent un moyen de paiement externe, ils sont redirigés vers une URL que vous configurez pour le moyen de paiement externe en question. Vous reconnaissez que :

Les moyens de paiement externes ne sont pas proposés ni pris en charge par Stripe. Le traitement et la prise en charge des moyens de paiement externes sont assurés par le prestataire de services de paiement externe.
Vous êtes responsable du maintien d’une intégration directe avec le prestataire de services de paiement externe.
Vous devez conclure un contrat avec le prestataire de services de paiement externe et devez vous conformer aux contrats conclus avec chacun des prestataires de services de paiement externe.
Il vous incombe d’obtenir tous les droits nécessaires à l’utilisation des marques et logos du prestataire de services de paiement externe dans votre processus de paiement, comme indiqué dans la présente documentation.
Stripe n’est pas responsable du traitement des transactions effectuées via un prestataire de services de paiement externe, y compris, par exemple, les paiements, remboursements, litiges, règlements ou mouvements de fonds.
Vous ou le prestataire de services paiement externe êtes responsables de l’exécution du tunnel d’achat après qu’un client a sélectionné un moyen de paiement externe, y compris, par exemple, la confirmation de la commande et le rapprochement des commandes.
Il vous incombe de configurer correctement l’URL de redirection du moyen de paiement externe.
Vous devez immédiatement supprimer tout moyen de paiement externe si vos contrats avec le prestataire de services de paiement externe sont résiliés ou si Stripe venait à mettre fin à la disponibilité d’un moyen de paiement externe.
Vous êtes uniquement autorisé à intégrer et présenter dans le Payment Element les moyens de paiement externes répertoriés dans ce guide.
Il vous incombe de vous assurer que les acheteurs soient correctement redirigés vers le moyen de paiement externe de leur choix.

Disponibilité continue des moyens de paiement externes

Stripe peut à tout moment décider de supprimer un moyen de paiement externe. Le cas échéant, Stripe vous informera de la suppression du moyen de paiement externe, et vous devrez immédiatement le retirer de votre code. Si le moyen de paiement concerné n’est pas supprimé, il ne sera pas présenté à vos clients.

Moyens de paiement externes disponibles

Vous pouvez afficher les moyens de paiement externes suivants. Vous devez utiliser le type de moyen de paiement externe correspondant dans votre code.

Région	Moyen de paiement	Type de moyen de paiement externe

AMÉRIQUE	Interac	`external_interac`
APAC	au PAY	`external_au_pay`
APAC	atone	`external_atone`
APAC	Touch’n Go	`external_tng_ewallet`
APAC	ソフトバンクまとめて支払い (paiements par transporteur Softbank)	`external_softbank_carrier_payment`
APAC	Toss Pay	`external_toss_pay`
APAC	Laybuy	`external_laybuy`
APAC	Bank Pay	`external_bank_pay`
APAC	auかんたん決済 (au easy payments)	`external_au_easy_payment`
APAC	BitCash	`external_bitcash`
APAC	Azupay	`external_azupay`
APAC	d払い (d-barai)	`external_dbarai`
APAC	FamiPay	`external_famipay`
APAC	GCash	`external_gcash`
APAC	GrabPay Later	`external_grabpay_later`
APAC	MoMo	`external_momo`
APAC	NET CASH	`external_net_cash`
APAC	Octopus	`external_octopus`
APAC	Paidy	`external_paidy`
APAC	PayPay	`external_paypay`
APAC	PlanPay	`external_planpay`
APAC	ペイジー (Pay-easy)	`external_pay_easy`
APAC	楽天ペイ (Rakuten Pay)	`external_rakuten_pay`
APAC	メルペイ (Merpay)	`external_merpay`
APAC	WebMoney	`external_webmoney`
Asie-Pacifique, Europe	Shopback Pay	`external_shopback_pay`
Europe	Aplazame	`external_aplazame`
Europe	Bizum	`external_bizum`
Europe	Divido	`external_divido`
Europe	Fonix	`external_fonix`
Europe	Iwocapay	`external_iwocapay`
Europe	KBC	`external_kbc`
Europe	Nexi Pay	`external_nexi_pay`
Europe	Oney	`external_oney`
Europe	Payconiq	`external_payconiq`
Europe	PayPo	`external_paypo`
Europe	Sofinco	`external_sofinco`
Europe	Postepay	`external_postepay`
Europe	PostFinance	`external_postfinance`
Europe	Scalapay	`external_scalapay`
Europe	TrueLayer	`external_truelayer`
Europe	Walley	`external_walley`
Europe	YounitedPay	`external_younited_pay`
International	LINE Pay	`external_line_pay`
International	paysafecard	`external_paysafecard`
International	Samsung Pay	`external_samsung_pay`
International	Sezzle	`external_sezzle`
LATAM	Dapp	`external_dapp`
LATAM	PicPay	`external_picpay`
MEA	Tabby	`external_tabby`
MEA	Benefit	`external_benefit`
MEA	Fawry	`external_fawry`