Accepter un paiement FPX
Mise en garde
Stripe propose automatiquement à vos clients des options de moyens de paiement selon leur devise, les restrictions sur les moyens de paiement et d’autres paramètres. Nous vous recommandons de configurer vos moyens de paiement à partir du Dashboard Stripe en suivant les instructions indiquées dans Accepter un paiement.
Si vous souhaitez continuer à configurer manuellement les moyens de paiement proposés à vos clients avec Checkout, utilisez ce guide (par exemple, pour accepter des paiements en mode abonnement). Sinon, migrez vers le Dashboard.
FPX est un moyen de paiement à usage unique. Pour effectuer un paiement avec FPX, les clients quittent votre site Web, autorisent le paiement, puis reviennent vers votre site Web. Vous recevez alors une notification immédiate indiquant si le paiement a abouti ou échoué.
Déterminer la compatibilité
Une session Checkout doit remplir toutes les conditions suivantes pour prendre en charge les paiements FPX :
- Les tarifs de tous les postes de facture doivent être exprimés dans la même devise. Pour définir des postes dans différentes devises, créez des sessions Checkout distinctes pour chacune d’entre elles.
- Vous ne pouvez utiliser que des postes ponctuels (les postes récurrents dans le cadre de plans d’abonnement ne sont pas pris en charge).
Accepter un paiement
Note
Avant d’utiliser ce guide, commencez par créer une intégration permettant d’accepter un paiement avec Checkout.
Suivez ce guide pour savoir comment activer FPX et découvrir les différences entre l’acceptation d’un paiement par carte bancaire et l’utilisation de FPX.
Activer le moyen de paiement FPX
Lorsque vous créez une session Checkout, vous devez :
- Ajouter
fpx
à la liste depayment_method_types
- Veillez à ce que tous vos
line_items
utilisent la devisemyr
Traiter vos commandes
Après l’acceptation de paiements, découvrez comment traiter les commandes.
Page de confirmation
FPX nécessite de montrer à votre client ses informations de transaction après qu’il a terminé son paiement. Pour personnaliser votre page de confirmation de paiement, consultez le guide dédié à ce sujet.
Lors de la personnalisation, vous devrez récupérer l’objet Paiement directement depuis l’objet PaymentIntent en utilisant l’ID PaymentIntent de votre session Checkout et afficher les informations suivantes sur votre page success_url
.
Informations | Source d’informations |
---|---|
Date et heure de la transaction | created à partir de l’objet Charge . |
Montant | amount à partir de l’objet Charge . |
Numéro de commande du vendeur | statement_descriptor à partir de l’objet Charge . |
ID de transaction FPX | payment_method_details[fpx][transaction_id] à partir de l’objet Charge . |
Nom de la banque de l’acheteur | payment_method_details[fpx][bank] à partir de l’objet Charge |
État de la transaction | status à partir de l’objet Charge |
Tester votre intégration
Lors du test de votre intégration Checkout, sélectionnez le moyen de paiement FPX, puis cliquez sur le bouton Payer.
Gérez les litiges et les remboursements
La période de remboursement pour FPX est limitée à 60 jours après le paiement d’origine.
Il n’existe pas de processus de litige, car les clients s’authentifient auprès de leur banque.