Rapprochement automatique
Laissez Stripe gérer le rapprochement de trésorerie pour les moyens de paiement par virement bancaire.
Obsolète
Ce guide présente l’implémentation des virements dans l’ancienne API Sources. Si votre intégration utilise actuellement les virements, vous devez migrer vers l’API Payment Methods. Nous vous enverrons plus d’informations par e-mail sur la fin de la prise en charge de l’API Sources.
Les entreprises ont souvent recours aux paiements par virement bancaire pour les contrats importants ou leurs nouvelles relations commerciales. Ces paiements par virement bancaire peuvent générer une grande quantité de tâches manuelles pour votre équipe. Stripe facilite ce processus en acceptant les virements qui règlent les factures en cours.
Pour chacun de vos clients, Stripe génère automatiquement un numéro de compte bancaire virtuel américain qui peut être payé en USD par virement ACH ou par virement bancaire. Lorsque votre client voit une facture avec ce compte bancaire virtuel, il peut envoyer un paiement à ce compte. Stripe rapproche automatiquement le paiement incluant le compte bancaire virtuel avec la facture, puis marque la facture comme payée.
Virements et prélèvements
Grâce au rapprochement automatique, vous n’avez pas besoin d’exposer vos coordonnées bancaires sensibles aux utilisateurs ou de rapprocher manuellement les factures en cours avec votre banque. Avec le rapprochement automatique des factures, Stripe peut :
- Faire correspondre les paiements entrants avec les montants des factures.
- Gérer les trop-perçus ou les paiements insuffisants, lorsque le montant payé ne correspond pas à la facture.
- Réduire le nombre d’appels à l’API nécessaires pour transférer des fonds dans Stripe.
- Gérer les tentatives de paiement sur les factures en cours.
Régler une facture
Stripe crée un sous-hachage ach_credit_transfer pour chaque facture si le client n’en possède pas déjà un. Toutes les factures contiennent des instructions sur l’endroit où envoyer le paiement. De plus, chaque client possède une adresse de paiement unique qui est partagée par toutes ses factures. Grâce au sous-hachage ach_, il peut transférer des fonds par le biais du système ACH américain ou d’un virement aux États-Unis, en indiquant le numéro de la facture dans le champ mémo.
Remarque
Les virements bancaires ACH ne sont pris en charge qu’en dollars (USD).
Dès qu’un client effectue un virement, Stripe fait correspondre le paiement avec une facture en vérifiant qu’un numéro de facture figure dans le champ mémo du virement. Toutes les factures pour lesquelles une correspondance est trouvée sont réglées. Si aucune correspondance n’est trouvée, la facture impayée la plus ancienne du même montant est réglée. Si aucune facture impayée de ce montant n’est trouvée, toutes les factures impayées pouvant être réglées avec le montant du transfert le seront, en commençant par la plus ancienne. Lorsqu’une facture est réglée, un événement invoice. se produit (vous pouvez recevoir cet événement à l’aide de webhooks).
Vous pouvez vérifier l’état d’un virement bancaire ACH en consultant la liste des moyens de paiement du client, dans le Dashboard ou en consultant les sources du client dans l’API :
curl https://api.stripe.com/v1/customers/cus_9jWC3097MQwYwF/sources \ -u:sk_test_BQokikJOvBiI2HlWgH4olfQ2
Stripe renvoie une liste des sources associées à ce client. Le type de source pour le virement bancaire ACH possède une valeur ach_. L’exemple de réponse suivant indique que le destinataire du virement bancaire ACH attend le paiement de la part du client.
{ "object": "list", "data": [ { "id": "src_19Q3AILlRB0eXbMt81RVDnM9", "object": "source", "amount": null, "client_secret": "src_client_secret_Z0zPIgnR0BVafiMLaJcxI3HS", "created": 1481585102, "currency": "usd", "customer": "cus_9jWC3097MQwYwF", "flow": "receiver", "livemode": false, "metadata": {}, "owner": { "address": null, "email": "jenny.rosen@example.com", "name": null, "phone": null, "verified_address": null,
Il peut arriver que les clients souhaitent utiliser des moyens de paiement autres que Stripe, par exemple, avec des chèques papier. Dans ce cas, Stripe vous permet de suivre l’état du paiement de vos factures. Après avoir reçu le paiement d’une facture d’un client en dehors de Stripe, vous pouvez marquer manuellement cette facture comme payée.
Gérer les exceptions
Si votre client règle un montant qui ne correspond pas à celui de la facture, les fonds ne sont pas débités et restent dans l’objet Source. Si vous voulez utiliser ces fonds pour régler votre facture, vous pouvez faire usage des quelques options suivantes :
- Trop-perçu : si un utilisateur envoie plus de fonds que la somme indiquée dans la facture, Stripe marque automatiquement la facture comme payée, en utilisant les fonds qui correspondent à la facture en cours. Les fonds restants sont conservés dans le récepteur
Source. Vous pouvez appliquer manuellement ces fonds à une facture. Si plusieurs factures impayées correspondent, Stripe applique les fonds à la facture la plus ancienne. - Paiement insuffisant : dans vos paramètres d’abonnement et d’e-mail, dans la section Paiements partiels, vous pouvez définir des règles en cas de paiements insuffisants. Vous pouvez spécifier que, dans les limites d’une certaine marge d’erreur, Stripe doit rapprocher automatiquement les factures et créditer la différence.
Un scénario typique de paiement insuffisant est que la banque d’un client prélève des fonds sur le montant total envoyé. Par exemple, si le client envoie 100 USD pour régler une facture de 100 USD, la banque du client peut prélever 20 USD, laissant ainsi 80 USD. Si cette différence (qui est généralement de l’ordre de 20 USD) est acceptable, vous pouvez minimiser l’effort manuel en spécifiant cette marge à l’avance.
Pour les autres exceptions :
- Si le destinataire dispose de fonds suffisants pour payer votre facture, vous pouvez réclamer la somme concernée dans le Dashboard en cliquant sur le bouton Débiter le client présent sur la facture, ou en appelant l’endpoint Pay invoice et en spécifiant l’objet de virement bancaire ACH comme source.
- Si les fonds pour payer la facture sont insuffisants et que vous n’annulez pas la différence, vous pouvez demander à votre client d’envoyer le montant restant. Vous pouvez également annuler l’ancienne facture, en ouvrir une nouvelle pour le montant le moins élevé et cliquer immédiatement sur Débiter le client.
Si votre client dispose d’une source de virement bancaire ACH avec des fonds suffisants, ou d’un compte bancaire ou d’une carte de crédit enregistré(e), vous pouvez utiliser ces sources pour le paiement de la facture en appelant l’endpoint Pay invoice avec la source que vous souhaitez utiliser.
Rembourser des paiements
Vous pouvez rembourser les paiements par virement bancaire ACH et par chèque via le Dashboard ou l’API. Toutefois, le client doit indiquer le compte sur lequel il souhaite que les fonds soient remboursés. Stripe contacte automatiquement le client à l’adresse e-mail fournie. Le remboursement est traité automatiquement dès que le client a fourni les informations relatives à son compte.
L’état initial d’un remboursement est pending. Si le remboursement échoue, vous recevez l’événement refund. et l’état du remboursement passe à failed. Cela signifie que Stripe ne peut pas traiter le remboursement et que vous devez renvoyer les fonds à votre client en dehors de Stripe. C’est rare, mais cela peut se produire si le compte bénéficiaire est bloqué. Les remboursements terminés sont à l’état succeeded.
Tester un paiement
Si vous êtes dans un environnement de test, vous pouvez simuler un transfert de fonds vers le destinataire en définissant l’adresse e-mail du propriétaire apparaissant sur la source sur amount_, où XXXXcorrespond à la somme du transfert vous souhaitez simuler. Le paiement ne sera pas associé à la facture, sauf si Stripe a bloqué la modification de la facture. Cette opération a lieu soit une heure après l’envoi de webhooks, soit lorsque vous envoyez un e-mail au client pour la facture. Dans le Dashboard, vous pouvez immédiatement envoyer un e-mail en cliquant sur le bouton Envoyer la facture.
Quelques instants après la demande de mise à jour, vous pouvez récupérer le paramètre receiver :
Si la demande de mise à jour a abouti, l’attribut receiver affiche les fonds :
{ "object": "list", "data": [ { "id": "src_19Q3AILlRB0eXbMt81RVDnM9", "object": "source", "amount": null, "client_secret": "src_client_secret_Z0zPIgnR0BVafiMLaJcxI3HS", "created": 1481585102, "currency": "usd", "customer": "cus_4fdAW5ftNQow1a", "flow": "receiver", "livemode": false, "metadata": {}, "owner": { "address": null, "email": "amount_1000@test.com", "name": null, "phone": null, "verified_address": null,
Dans ce cas, la facture ouverte du client (du même montant) apparaît comme payée, avec un objet de paiement correspondant qui affiche les détails du paiement.