Moyens de paiement externes

Ajoutez des moyens de paiement externes au Payment Element.

Utilisez le composant Payment Element de Stripe pour afficher les moyens de paiement auxquels vous êtes déjà intégré. 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.

Clause de non-responsabilité relative aux moyens de paiement externes

Lorsque les clients sélectionnent un moyen de paiement externe, ils sont redirigés vers l’URL que vous avez configurée pour le moyen de paiement externe en question. Renseignez-vous sur vos responsabilités et sur la disponibilité continue pour les moyens de paiement externes.

Ce guide ajoute un moyen de paiement externe, Divido, en utilisant l’exemple HTML/JS du guide de démarrage avec le composant Payment Element.

Avant de commencer

Créez un compte Stripe ou connectez-vous.
Suivez le guide de démarrage rapide avec le 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

Dans votre fichier checkout.js, où vous initialisez Stripe Elements, spécifiez les moyens de paiement externes que vous souhaitez ajouter au Payment Element. L’exemple suivant illustre l’ajout de Divido :

checkout.js

elements = stripe.elements({
    clientSecret: clientSecret,
    externalPaymentMethodTypes: ['external_divido']
  });

Gérer l'écouteur de sélection du moyen de paiement

Vous pouvez gérer la redirection vers le moyen de paiement externe de deux manières :

Remplacez l’action du bouton Payer de Stripe par une redirection vers le moyen de paiement externe.
Remplacez le bouton Payer de Stripe par le bouton du prestataire de services de paiement externe.

Cet écouteur remplace l’action du bouton Payer de Stripe pour rediriger le client vers la page de paiement de Divido, où il peut finaliser la transaction. Dans checkout.js, ajoutez le code de l’écouteur après l’appel paymentElement.mount :

checkout.js

paymentElement.mount("#payment-element");

// Track selected payment method
const selectedPaymentMethod;
paymentElement.on('change', (event) => {
  selectedPaymentMethod = event?.value?.type;
});

Modifiez la fonction handleSubmit pour rediriger vers la page de paiement de Divido :

checkout.js

async function handleSubmit(e) {
  if (selectedPaymentMethod === 'external_divido') {
    // Redirect customer to the Divido checkout page to complete the transaction
    const dividoRedirectUrl = "<< fill the Divido redirect URL here >>";
    window.location.href = dividoRedirectUrl;
  } else {
    ...
  }

FacultatifOrdonner les moyens de paiement externes

Tester votre intégration

Parcourez votre tunnel de paiement et vérifiez que le composant Payment Element affiche Divido. Cet exemple configure Divido en deuxième position après les cartes bancaires.
Composant Payment Element avec Divido
Choisissez le moyen de paiement Divido pour vérifier le message concernant la prochaine étape de redirection vers Divido.
Cliquez sur Payer pour tester votre intégration Divido existante. Vérifiez que vous êtes redirigé(e) vers Divido pour finaliser 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 Divido.

Considérations relatives au Dashboard

Le Dashboard Stripe affiche des PaymentIntents pour les transactions à l’état incomplete ayant été traitées par un prestataire de services de paiement externe. 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.

Clause de non-responsabilité relative aux moyens de paiement externes

Les moyens de paiement externes sont conçus pour vous permettre d’afficher dans le composant Stripe Payment Element certains moyens de paiement que vous intégrez directement à Stripe. Lorsque les clients sélectionnent un moyen de paiement externe, ils sont redirigés vers l’URL que vous avez configurée 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 à ou 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.
Vous devez configurer correctement l’URL de redirection du moyen de paiement externe.
Vous devez immédiatement supprimer tout moyen de paiement externe si votre ou vos contrats avec le prestataire de services de paiement externe sont résiliés ou si Stripe décide de rendre un moyen de paiement externe obsolète.
Vous êtes uniquement autorisé à intégrer et présenter dans le composant Payment Element les moyens de paiement externes répertoriés dans ce guide.
Il vous incombe de veiller à ce 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 rendre obsolète tout moyen de paiement externe. Le cas échéant, Stripe vous informera de l’obsolescence du moyen de paiement externe, et vous devrez immédiatement le supprimer dans 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`
Asie-Pacifique	au PAY	`external_au_pay`
Asie-Pacifique	atone	`external_atone`
Asie-Pacifique	Touch’n Go	`external_tng_ewallet`
Asie-Pacifique	ソフトバンクまとめて支払い (paiements par transporteur 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 CASH	`external_net_cash`
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 PayLater	`external_shopback_paylater`
Europe	Aplazame	`external_aplazame`
Europe	Billie.io	`external_billie`
Europe	Bizum	`external_bizum`
Europe	Divido	`external_divido`
Europe	Fonix	`external_fonix`
Europe	Iwocapay	`external_iwocapay`
Europe	KBC	`external_kbc`
Europe	Kriya	`external_kriya`
Europe	Mondu	`external_mondu`
Europe	Nexi Pay	`external_nexi_pay`
Europe	Oney	`external_oney`
Europe	Payconiq	`external_payconiq`
Europe	PayPo	`external_paypo`
Europe	Pledg	`external_pledg`
Europe	Postepay	`external_postepay`
Europe	PostFinance	`external_postfinance`
Europe	Scalapay	`external_scalapay`
Europe	Sequra	`external_sequra`
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	Sizzle	`external_sezzle`
LATAM	Dapp	`external_dapp`
LATAM	PicPay	`external_picpay`
Moyen-Orient et Afrique	Tabby	`external_tabby`
Moyen-Orient et Afrique	Benefit	`external_benefit`
Moyen-Orient et Afrique	Fawry	`external_fawry`

Vous souhaitez ajouter des moyens de paiement externes au Payment Element mobile pour iOS ou Android ?

Indiquez votre adresse e-mail pour participer à la version bêta.

Inscription réussie !
Merci ! Nous vous contacterons bientôt.