Passer à des moyens de paiement dynamiques
Ce guide explique comment intégrer des moyens de paiement dynamiques à des plateformes existantes. Si vous avez besoin d’aide pour configurer une nouvelle plateforme, consultez le guide Encaisser des paiements et effectuer des virements ou le guide Permettre à d’autres entreprises d’accepter directement des paiements.
Instructions relatives à l’intégration des moyens de paiement dynamiques
Sélectionnez votre intégration dans le formulaire suivant. Si vous avez besoin d’aide pour déterminer la configuration adaptée à votre plateforme (solution de paiement, types de comptes connectés, types de paiements, etc.), consultez la page Créer un paiement.
Activer les moyens de paiement pour les comptes connectésRecommandé
Au besoin, consultez les ressources suivantes pour en savoir plus sur les moyens de paiement :
- Un guide des moyens de paiement pour vous aider à choisir les moyens de paiement adaptés à votre plateforme.
- Les pays pris en charge par moyen de paiement pour connaître la liste des moyens de paiement et les pays dans lesquels ils sont disponibles.
- Le tableau des moyens de paiement pris en charge par produit pour vérifier que les moyens de paiement que vous avez choisis sont compatibles avec vos produits et tunnels de paiement Stripe.
Consultez la page Gérer les moyens de paiement pour vos comptes connectés de votre Dashboard pour configurer les moyens de paiement acceptés par vos comptes connectés. Les modifications apportées aux paramètres par défaut s’appliqueront à tous les comptes connectés, nouveaux et existants.
Pour chaque moyen de paiement, vous pouvez sélectionner l’une des options suivantes de la liste déroulante :
Activé par défaut | Vos comptes connectés acceptent ce moyen de paiement lors du paiement. Si certains moyens de paiement peuvent uniquement être désactivés ou bloqués, cela signifie que vos comptes connectés doivent les activer depuis la page des paramètres de leur Dashboard. |
Désactivé par défaut | Vos comptes connectés n’acceptent pas ce moyen de paiement au cours du paiement. Si vous autorisez les propriétaires des comptes connectés de votre plateforme à gérer leurs propres moyens de paiement dans leur Dashboard, ils ont cependant la possibilité de l’activer. |
Bloqué | Vos comptes connectés n’acceptent pas ce moyen de paiement au cours du paiement. Si vous autorisez les propriétaires des comptes connectés de votre plateforme à gérer leurs propres moyens de paiement dans leur Dashboard, ils ne pourront pas l’activer. |
Options des moyens de paiement
Si vous apportez une modification à un moyen de paiement, vous devez cliquer sur Vérifier les modifications dans la barre au bas de l’écran, puis sur Enregistrer et appliquer pour mettre à jour vos comptes connectés.
Boîte de dialogue d’enregistrement
Autoriser vos comptes connectés à gérer leurs moyens de paiementRecommandé
Stripe recommande d’autoriser les propriétaires des comptes connectés de votre plateforme à personnaliser eux-mêmes leurs moyens de paiement depuis le Dashboard. Si vous activez cette option, chaque compte connecté ayant accès au Dashboard Stripe peut accéder à son Dashboard et à sa page Moyens de paiement. Le Dashboard affiche l’ensemble des moyens de paiement par défaut que vous avez appliqués à tous les comptes connectés, nouveaux et existants. Les propriétaires des comptes connectés de votre plateforme peuvent remplacer ces paramètres par défaut, à l’exception des moyens de paiement que vous avez bloqués.
Cochez la case Personnalisation de compte pour activer cette option. Vous devez cliquer sur Vérifier les modifications dans la barre au bas de l’écran, puis sélectionner Enregistrer et appliquer pour mettre à jour ce paramètre.
Case à cocher Personnalisation de compte
Intégrer Checkout à l'aide de moyens de paiement dynamiquesObligatoire
Auparavant, vous utilisiez peut-être le paramètre payment_method_types
lorsque vous définissiez votre session Checkout pour accepter différents moyens de paiement. Pour commencer à gérer vos moyens de paiement dans le Dashboard, supprimez ce paramètre de votre intégration.
Une fois que vous avez supprimé le paramètre payment_method_types
de votre intégration, certains moyens de paiement sont activés automatiquement, notamment les cartes et les portefeuilles. Le paramètre currency
limite les moyens de paiement présentés au client pendant la session Checkout.
Stripe::Checkout::Session.create({ mode: 'payment', # Remove the payment_method_types parameter # to manage payment methods in the Dashboard payment_method_types: ['card'], line_items: [{ price_data: { # The currency parameter determines which # payment methods are used in the Checkout Session. currency: 'eur', product_data: { name: 'T-shirt', }, unit_amount: 2000, }, quantity: 1, }], success_url: 'https://example.com/success', cancel_url: 'https://example.com/cancel', })
Activer la collecte de l'adresse de livraison dans CheckoutRecommandé
Si vous collectez des adresses de livraison, vous devez définir les pays vers lesquels vous pouvez effectuer des envois lors de la création de la session Checkout. Pour ce faire, indiquez les codes de pays ISO à deux lettres dans le paramètre du pays shipping_address_collection.allowed_countries
.
Vous pouvez éventuellement ajouter des frais de livraison avec le paramètre shipping_options
.
Si vous utilisez Afterpay ou Clearpay, vous devez collecter les adresses de livraison, mais vous n’avez pas besoin de spécifier de frais de livraison pour ces moyens de paiement.
Note
Pour utiliser Afterpay ou Clearpay comme moyen de paiement dans Checkout, vous devez collecter l’adresse de livraison (mais vous n’êtes pas obligé d’appliquer des frais de livraison).
Gérer les moyens de paiement à notification différée, le cas échéantRecommandé
Suivez la procédure décrite dans notre guide consacré à la gestion des moyens de paiement dans le Dashboard pour savoir comment gérer les moyens de paiement à notification différée.
Tester votre intégrationRecommandé
Testez votre intégration pour vérifier qu’elle fonctionne comme prévu. Si vous voulez tester vos paramètres de moyen de paiement pour vos comptes connectés, connectez-vous à l’un de vos comptes test et accédez aux dits paramètres. Testez votre tunnel de paiement à l’aide de votre clé API et d’un compte test. Si, contre toute attente, un moyen de paiement n’est pas disponible, consultez le tableau des moyens de paiement pris en charge pour vous assurer que vos produits et marchands utilisent une devise et un pays compatibles.
Demander à vos comptes connectés ayant accès au Dashboard Stripe d'activer les moyens de paiement qui requièrent des étapes de configurationFacultatif
Vos comptes connecté ayant accès au Dashboard Stripe peuvent utiliser la plupart des moyens de paiement par défaut. Toutefois, pour certains moyens de paiement (comme Alipay et WeChat Pay), vos utilisateurs doivent procéder à une activation manuelle depuis leur Dashboard. Les moyens de paiement qui requièrent une telle action de la part de vos utilisateurs sont ceux dont la colonne Disponible par défaut du tableau des fonctionnalités des moyens de paiement indique Non.
Si vous autorisez les propriétaires des comptes connectés de votre plateforme à gérer leurs moyens de paiement, informez-les qu’ils doivent activer ces moyens de paiement dans leur Dashboard.
Personnalisation des moyens de paiement
Si vous n’autorisez pas les propriétaires des comptes connectés de votre plateforme à personnaliser leurs moyens de paiement, demandez-leur de consulter la page des paramètres des moyens de paiement.
Paramètres manuels pour les moyens de paiement
Bêta
Le composant intégré des paramètres de moyens de paiement permet aux comptes connectés de configurer les moyens de paiement qu’ils proposent sans avoir besoin d’accéder au Dashboard Stripe. Demandez un accès et découvrez comment l’intégrer avec Payment Method Configurations.