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 | — | — | — |
Asynchrone | Prélèvement SEPA (obsolète) | Prélèvements ACH avec authentification | Prélèvements ACH avec microversements | — | |
Virer | Synchrone |
| — | — | Multibanco (obsolète) |
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.
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_
, 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 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) oufailed
(é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 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 paiement est initialement défini commepending
(en attente), jusqu’à ce que la réussite ou l’échec du paiement soit confirmé. 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.