API SourcesObsolète

Découvrez les différents moyens et mécanismes de paiement disponibles avec l'API Sources.

Avertissement

We deprecated the Sources API and plan to remove support for local payment methods. If you currently handle any local payment methods using the Sources API, you must migrate them to the Payment Methods API.

Nous ne prévoyons pas de supprimer la prise en charge des paiements par carte, mais nous vous recommandons tout de même de remplacer l’API Sources par l’API PaymentMethods, qui donne accès à nos dernières fonctionnalités et types de moyens de paiement.

Les objets Source vous permettent d’accepter une variété de moyens de paiement avec une seule API. Une source représente un instrument de paiement du client, et peut être utilisée avec l’API de Stripe pour créer des paiements. Les sources peuvent être facturées directement, ou rattachées aux clients pour être réutilisées ultérieurement.

Chaque moyen de paiement pris en charge par l’API Sources est défini par quatre caractéristiques principales. La combinaison de ces caractéristiques détermine comment une source devient facturable et comment elle est utilisée dans une demande de paiement pour effectuer un règlement.

« Pull » ou « Push » : manière dont les fonds provenant de votre client sont transférés pour le moyen de paiement
Flux : le type d’action que votre client doit effectuer pour authentifier le paiement
Utilisation : détermine si la Source est ou non réutilisable
Synchrone ou asynchrone : détermine si le paiement résultant peut être confirmé immédiatement ou seulement après un délai

Pour un exemple complet illustrant comment accepter tous les moyens de paiement avec l’API Sources, consultez cet exemple de boutique en ligne, et parcourez son code source sur GitHub.

Moyens de paiement pris en charge

Vous pouvez activer tout moyen de paiement à votre disposition dans le Dashboard. L’activation est généralement instantanée, et ne nécessite pas de contrat supplémentaire ni de procédure longue. Pour une liste détaillée, consultez les moyens de paiement disponibles associés aux zones géographiques prises en charge.

Le tableau suivant met en correspondance les caractéristiques principales susmentionnées avec les moyens de paiement pris en charge :

Transfert	Confirmation	Aucun	Virement avec redirection bancaire	Vérification du code	Destinataire
Pull	Synchrone	Cartes bancaires	—	—	—
Pull	Asynchrone	Prélèvement automatique SEPA (obsolète)	Prélèvements ACH avec authentification	Prélèvements ACH avec microversements	—
Push	Synchrone	Alipay (obsolète) Bancontact (obsolète) Giropay (obsolète) iDEAL (obsolète) Przelewy24 (obsolète) WeChat Pay (obsolète)	—	—	Multibanco (obsolète)
Push	Asynchrone	—	Sofort avec Sources (obsolète)	—	—

Prélèvement (pull) ou virement (push) des fonds

Chaque moyen de paiement appartient soit à la catégorie des prélèvements (« pull ») ou des virements (« push »), en fonction de la manière dont les fonds sont transférés depuis le moyen de paiement du client.

Avec la méthode pull, vous débitez les fonds du compte du client après avoir obtenu son autorisation. Les paiements par carte bancaire sont un exemple de la méthode « pull » : la carte de votre client est débitée lorsqu’un paiement est effectué, et aucune interaction du client n’est requise pour les débits suivants.
Avec la méthode push, le client vous envoie les fonds. Les transferts de crédit ACH sont un exemple de méthode push : votre client reçoit les numéros d’acheminement et de compte bancaire auxquels il doit envoyer (« push ») le montant correct. Une fois qu’il est confirmé que votre client vous a envoyé les fonds, la source devient facturable et est prête pour utilisation dans une demande de paiement. D’autres moyens de paiement push tels qu’iDEAL ou Sofort, reposent sur un virement avec redirection bancaire permettant à votre client de vous transférer l’argent directement depuis son compte bancaire en ligne. En général, les méthodes push nécessitent une interaction avec le client pour chaque paiement.

Flux des actions du client

Certains moyens de paiement exigent que votre client exécute une action particulière (flux) avant que la source ne devienne facturable. Le type de flux qui s’applique à un moyen de paiement est indiqué dans le paramètre flow de l’objet Source. Chaque moyen se classe dans l’un des types de flux suivants.

Aucune action n’est requise de la part de votre client. Certains moyens de paiement (généralement les méthodes « pull »), telles que les cartes bancaires (à l’exception de 3D Secure), ne nécessitent aucune authentification supplémentaire en dehors de la collecte des informations de paiement auprès des clients. Les sources représentant ce moyen de paiement peuvent être utilisées immédiatement lors des demandes de paiement.

Une fois que le flux requis a été effectué et qu’une source devient facturable, la source doit être utilisée pour faire une demande de paiement pour que le règlement soit effectué. Dans le cas contraire, la source est annulée et le paiement authentifié du client est remboursé automatiquement ; aucune somme n’est transférée sur votre compte.

Moyens de paiement à usage unique ou réutilisables

Certains moyens de paiement permettent la création de sources qui peuvent être réutilisées pour des paiements supplémentaires sans que votre client ait besoin d’effectuer à nouveau le processus de paiement. Le paramètre usage d’une source réutilisable est réglé sur reusable.

Inversement, si une source ne peut être utilisée qu’une seule fois, ce paramètre est réglé sur single_use, et une source doit être créée chaque fois qu’un client effectue un paiement. De telles sources ne doivent pas être rattachées à des clients ; elles doivent plutôt être facturées directement. Elles ne peuvent être facturées qu’une seule fois, et leur état passera à consumed (consommé) une fois facturées.

Les sources réutilisables doivent être rattachées à un Client pour pouvoir les réutiliser. (Si elles sont facturées, leur état passera à consumed (consommé). Pour en savoir plus sur le rattachement des sources aux clients, et la gestion des listes de sources d’un client, consultez le guide Sources et clients.

Confirmation synchrone ou asynchrone

Une fois que vous utilisez un moyen de paiement pour créer un objet Charge, l’état de ce paiement peut être confirmé soit immédiatement (de manière synchrone) ou après un certain laps de temps (de manière asynchrone).

Avec un moyen de paiement synchrone, l’état de la demande de paiement peut être immédiatement confirmé comme succeeded (réussi) ou failed (échoué). Si la demande de paiement réussit, le règlement est effectué ; il est considéré comme garanti que le client a été débité et que vous recevrez les fonds. Les paiements par carte bancaire sont un exemple de moyen de paiement synchrone : la réussite ou l’échec du paiement est confirmé en temps réel.
Pour les moyens de paiement asynchrones, la confirmation de la réussite du paiement peut prendre jusqu’à plusieurs jours. Pendant ce temps, le paiement ne peut être garanti. L’état de l’objet Charge (paiement) pour le règlement est initialement défini comme pending (en attente), jusqu’à confirmation de la réussite ou de l’échec du paiement. Les débits ACH sont un exemple de moyen asynchrone : avec ces débits, il faut quelques jours pour confirmer que le paiement a été effectué.

Stripe envoie un événement webhook dès que l’état d’un paiement a changé. Lorsque vous acceptez un moyen de paiement asynchrone, votre intégration doit pouvoir recevoir des webhooks, afin de recevoir cette notification et de confirmer la réussite ou l’échec du paiement.