Accéder directement au contenu
Créez un compte
 ou
connectez-vous
Le logo de la documentation Stripe
/
Créer un compte
Connectez-vous

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.

Le Mobile Payment Element peut afficher des modes de paiement externes que vous prenez en charge en plus des modes de paiement traités par 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 menées à bien 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

  1. Créez un compte Stripe ou connectez-vous.
  2. Suivez l’exemple de Payment Sheet pour effectuer une intégration de paiement.
  3. 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))
    }
}

Tester une intégration

  1. 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.
    Le Payment Element lors de l'ajout de Fawry
  2. Choisissez le moyen de paiement Fawry.
    Le Payment Element lors de la sélection de Fawry
  3. 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 :

  1. 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.
  2. Vous devez maintenir une intégration directe avec le prestataire de services de paiement externe.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. Il vous incombe de configurer correctement l’URL de redirection pour le mode de paiement externe.
  8. 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.
  9. Vous êtes uniquement autorisé à intégrer et à présenter dans le Payment Element les modes de paiement externes mentionnés dans ce guide.
  10. 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égionMoyen de paiementType de mode de paiement externe
AMÉRIQUEInteracexternal_interac
Asie-Pacifiqueau PAYexternal_au_pay
Asie-Pacifiqueatoneexternal_atone
Asie-PacifiqueTouch’n Goexternal_tng_ewallet
Asie-Pacifiqueソフトバンクまとめて支払い (paiements à l’opérateur Softbank)external_softbank_carrier_payment
Asie-PacifiqueToss Payexternal_toss_pay
Asie-PacifiqueLaybuyexternal_laybuy
Asie-PacifiqueBank Payexternal_bank_pay
Asie-Pacifiqueauかんたん決済 (au easy payments)external_au_easy_payment
Asie-PacifiqueBitCashexternal_bitcash
Asie-PacifiqueAzupayexternal_azupay
Asie-Pacifiqued払い (d-barai)external_dbarai
Asie-PacifiqueFamiPayexternal_famipay
Asie-PacifiqueGCashexternal_gcash
Asie-PacifiqueGrabPay Laterexternal_grabpay_later
Asie-PacifiqueMoMoexternal_momo
Asie-PacifiqueNET AU COMPTANTexternal_net_cash
Asie-PacifiqueOctopusexternal_octopus
Asie-PacifiquePaidyexternal_paidy
Asie-PacifiquePayPayexternal_paypay
Asie-PacifiquePlanPayexternal_planpay
Asie-Pacifiqueペイジー (Pay-easy)external_pay_easy
Asie-Pacifique楽天ペイ (Rakuten Pay)external_rakuten_pay
Asie-Pacifiqueメルペイ (Merpay)external_merpay
Asie-PacifiqueWebMoneyexternal_webmoney
Asie-Pacifique, EuropeShopback Payexternal_shopback_pay
EuropeAplazameexternal_aplazame
EuropeBizumexternal_bizum
EuropeDividoexternal_divido
EuropeFonixexternal_fonix
EuropeIwocapayexternal_iwocapay
EuropeKBCexternal_kbc
EuropeNexi Payexternal_nexi_pay
EuropeOneyexternal_oney
EuropePayconiqexternal_payconiq
EuropePayPoexternal_paypo
EuropeSofincoexternal_sofinco
EuropePostepayexternal_postepay
EuropePostFinanceexternal_postfinance
EuropeScalapayexternal_scalapay
EuropeTrueLayerexternal_truelayer
EuropeWalleyexternal_walley
EuropeYounitedPayexternal_younited_pay
InternationalLINE Payexternal_line_pay
Internationalpaysafecardexternal_paysafecard
InternationalSamsung Payexternal_samsung_pay
InternationalSezzleexternal_sezzle
Amérique latineDappexternal_dapp
Amérique latinePicPayexternal_picpay
Moyen-Orient et Afrique du SudTabbyexternal_tabby
Moyen-Orient et Afrique du SudAvantageexternal_benefit
Moyen-Orient et Afrique du SudFawryexternal_fawry
Cette page vous a-t-elle été utile?
OuiNon
Besoin d'aide? Contactez le service d'assistance.
Rejoignez notre programme d'accès anticipé.
Consultez notre journal des modifications.
Des questions? Contactez l'équipe commerciale.
GML? Lire llms.txt.
Optimisé par Markdoc