Ajouter des moyens de paiement externes

Ajoutez des moyens de paiement externes à Mobile Payment Element.

Remarques

Nous avons créé une fonctionnalité de modes de paiement personnalisés qui vous permet d’ajouter à votre intégration de paiement des modes de paiement traités en dehors de Stripe. Nous vous recommandons de l’utiliser pour votre intégration plutôt que des modes de paiement externes.

Les paiements dans l’application peuvent afficher les modes de paiement externes que vous prenez en charge en plus des modes de paiement traités via Stripe. L’intégration de modes de paiement externes nécessite un travail d’intégration supplémentaire, car les transactions effectuées par ces modes de paiement sont traitées et finalisées en dehors de Stripe.

Responsabilité relative aux modes de paiement externes

Lorsque les clients choisissent un mode de paiement externe, votre application gère le paiement à la place de Stripe. Pour en savoir plus sur vos responsabilités et la disponibilité continue des modes de paiement externes, consultez la clause de non-responsabilité relative aux modes de paiement externes.

Ce guide ajoute un moyen de paiement externe, Fawry, à l’aide du guide sur la Payment Sheet Accepter les paiements intégrés. Consultez la liste de tous les moyens de paiement externes disponibles.

Avant de commencer

Créez un compte Stripe ou connectez-vous.
Suivez l’exemple de Payment Sheet pour effectuer une intégration de paiement.
Pour chaque moyen de paiement externe que vous souhaitez ajouter, complétez son intégration et confirmez qu’il fonctionne dans la région où vous souhaitez l’activer.

Ajouter des types de moyens de paiement externes

Lorsque vous créez votre objet PaymentSheet.Configuration et initialisez PaymentSheet, précisez les moyens de paiement externes que vous souhaitez ajouter au Payment Element ainsi qu’un gestionnaire pour finaliser le paiement. Dans cet exemple, l’ajout de Fawry est effectué :

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, il appelle le gestionnaire avec le type (par exemple, « external_fawry »), toutes les informations de facturation qui ont été collectées et un gestionnaire de finalisation.

Votre mise en œuvre finalise le paiement (par exemple, à l’aide de la trousse SDK de votre prestataire de services de paiement externe) et appelle le gestionnaire de finalisation avec le résultat du paiement : completed, canceled, ou failure(error:).

Si vous transférez .failure(error:), la PaymentSheet affichera l’erreur à l’aide de errorDescription pour les erreurs Swift et de localizedDescription pour les NSErrors.

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

FacultatifPositionner les moyens de paiement externes

Les moyens de paiement externes ne sont pas classés de manière intelligente par la logique de commande intelligente de Stripe, car Stripe n’a aucun contexte sur ces moyens de paiement. Par défaut, ils figurent après les moyens de paiement pris en charge par Stripe. Définissez PaymentSheet.Configuration.paymentMethodOrder pour positionner explicitement le moyen de paiement externe dans Payment Element. Les moyens de paiement pris en charge par Stripe, qui suivent le moyen de paiement externe, sont toujours classés de manière intelligente.

var configuration = PaymentSheet.Configuration()
// Show cards first, followed by external_fawry, followed by all other payment methods
configuration.paymentMethodOrder = ["card", "external_fawry"]

Tester une intégration

Passez en revue votre flux 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 maintenant pour tester votre intégration Fawry existante. Vérifiez que votre intégration finalise la transaction et que toutes les actions après paiement (par exemple, l’affichage d’une page de confirmation, d’un message de confirmation ou d’un message d’échec) fonctionnent toujours avec votre intégration Fawry.

Considérations relatives au Dashboard

Les PaymentIntents des transactions traitées avec un prestataire de services de paiement externe ont un état défini à incomplete dans le Dashboard Stripe. Stripe n’est pas impliquée dans les transactions effectuées par l’entremise de modes de paiement externes et ne peut pas 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 sera affichée 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 modes de paiement externes

Vous pouvez utiliser le Payment Element pour mobile de Stripe pour afficher des modes de paiement externes qui ne sont pas pris en charge par Stripe, mais que vous pouvez intégrer directement. Lorsque les clients choisissent un mode de paiement externe, c’est votre application qui finalise la transaction à la place du Payment Element pour mobile de Stripe. Vous reconnaissez que :

Les modes de paiement externes ne sont pas proposés ni pris en charge par Stripe. L’exploitation et la prise en charge des modes de paiement externes sont assurées par le prestataire de services de paiement externe.
Vous devez maintenir 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 êtes responsable du respect de vos contrats avec chaque fournisseur de mode de paiement externe.
Il vous incombe d’obtenir tous les droits nécessaires pour utiliser les marques et logos du prestataire de services de paiement externe dans votre processus de paiement, comme décrit dans la présente documentation.
Stripe n’est pas responsable du traitement des transactions avec un prestataire de services de paiement externe, y compris, par exemple, des paiements, remboursements, litiges, règlements ou mouvements de fonds.
Vous ou le prestataire de services de paiement externe êtes responsable de l’exécution du processus d’achat après qu’un client a sélectionné un mode de paiement externe, y compris, par exemple, la confirmation d’une commande et le rapprochement des commandes.
Il vous incombe de configurer correctement l’URL de redirection pour le mode de paiement externe.
Vous devez retirer immédiatement tout mode de paiement externe dans le cas où vos contrats avec un prestataire de services de paiement externe prennent fin ou que Stripe supprime la disponibilité d’un mode de paiement externe.
Vous êtes uniquement autorisé à intégrer et à présenter dans le Payment Element les modes de paiement externes mentionnés dans ce guide.
Vous avez l’entière responsabilité de vous assurer que les acheteurs sont redirigés correctement vers le mode de paiement externe qu’ils ont choisi.

Disponibilité continue des modes de paiement externes

Stripe peut, à tout moment, décider de supprimer la disponibilité d’un mode de paiement en tant que mode de paiement externe. Stripe vous informera de toute suppression d’un mode de paiement externe que vous utilisez, et vous devrez supprimer immédiatement le mode de paiement externe dans votre code. À défaut, le mode de paiement externe ne sera pas disponible pour vos clients.

Modes de paiement externes disponibles

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

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

AMÉRIQUE	Interac	`external_interac`
Asie-Pacifique	au PAY	`external_au_pay`
Asie-Pacifique	atone	`external_atone`
Asie-Pacifique	Touch’n Go	`external_tng_ewallet`
Asie-Pacifique	ソフトバンクまとめて支払い (paiements à l’opérateur Softbank)	`external_softbank_carrier_payment`
Asie-Pacifique	Toss Pay	`external_toss_pay`
Asie-Pacifique	Laybuy	`external_laybuy`
Asie-Pacifique	Bank Pay	`external_bank_pay`
Asie-Pacifique	auかんたん決済 (au easy payments)	`external_au_easy_payment`
Asie-Pacifique	BitCash	`external_bitcash`
Asie-Pacifique	Azupay	`external_azupay`
Asie-Pacifique	d払い (d-barai)	`external_dbarai`
Asie-Pacifique	FamiPay	`external_famipay`
Asie-Pacifique	GCash	`external_gcash`
Asie-Pacifique	GrabPay Later	`external_grabpay_later`
Asie-Pacifique	MoMo	`external_momo`
Asie-Pacifique	NET AU COMPTANT	`external_net_cash`
Asie-Pacifique	Octopus	`external_octopus`
Asie-Pacifique	Paidy	`external_paidy`
Asie-Pacifique	PayPay	`external_paypay`
Asie-Pacifique	PlanPay	`external_planpay`
Asie-Pacifique	ペイジー (Pay-easy)	`external_pay_easy`
Asie-Pacifique	楽天ペイ (Rakuten Pay)	`external_rakuten_pay`
Asie-Pacifique	メルペイ (Merpay)	`external_merpay`
Asie-Pacifique	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`
Amérique latine	Dapp	`external_dapp`
Amérique latine	PicPay	`external_picpay`
Moyen-Orient et Afrique du Sud	Tabby	`external_tabby`
Moyen-Orient et Afrique du Sud	Avantage	`external_benefit`
Moyen-Orient et Afrique du Sud	Fawry	`external_fawry`