L'API SourcesObsolète

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

Alerte

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.

While we don’t plan to remove support for card payments, we recommend replacing any use of the Sources API with the PaymentMethods API, which provides access to our latest features and payment method types.

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 débitable et comment elle est utilisée dans une demande de paiement pour effectuer un paiement.

« 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 :

Transférer	Confirmation	Aucun	Virement avec redirection bancaire	Vérification du code	Destinataire
Prélever	Synchrone	Cartes	—	—	—
Prélever	Asynchrone	Prélèvement SEPA (obsolète)	Prélèvements ACH avec authentification	Prélèvements ACH avec microversements	—
Virer	Synchrone	Alipay (obsolète) Bancontact (obsolète) Giropay (obsolète) iDEAL (obsolète) Przelewy24 (obsolète) WeChat Pay (obsolète)	—	—	Multibanco (obsolète)
Virer	Asynchrone	—	Sofort avec Sources (Obsolète)	—	—

Prélèvement (pull) ou virement (pull) 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 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 une méthode push, le client vous envoie les fonds. Les virements ACH sont un exemple de méthode poussée : votre client reçoit les numéros d’acheminement et de compte bancaire auxquels il doit envoyer (pousser) le bon montant. Une fois la confirmation reçue comme quoi votre client vous a envoyé les fonds, la source devient débitable et est prête pour utilisation dans une demande de paiement. D’autres moyens de paiement poussés tels que 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 poussées 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 débitable. 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 (à l’exception de 3 DSecure), 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 débitable, la source doit être utilisée pour faire une demande de paiement pour que le paiement 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.

À usage unique ou réutilisable

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 débitées directement. Elles ne peuvent être débitées qu’une seule fois, et leur état passera à consumed (consommé) une fois débitées.

Les sources réutilisables doivent être associées à un client pour pouvoir les réutiliser. (Si elles sont débitées directement, leur état passera à consumed.) Pour en savoir plus sur l’association 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 paiement 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 sont un exemple de moyen de paiement synchrone : la réussite ou l’échec du paiement est confirmé en temps réel.
Pour les modes 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 pour le paiement est initialement défini à pending, jusqu’à ce que la réussite ou l’échec du paiement soit confirmé. Les prélèvements ACH sont un exemple de mode asynchrone, car 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.