Exemples de cas d'utilisation

Améliorer les pages de facture numériques avec Twikey

Dans de nombreux flux de facturation, un cadre de facturation etabli est probablement deja en place. Cela peut inclure une page de detail de facture existante, un portail client ou une experience de facturation pilotee par un ERP que les clients connaissent deja. Dans de tels scenarios, introduire une page de paiement separee et complete uniquement pour accommoder des methodes de paiement supplementaires ajoute souvent une complexite inutile, tant sur le plan technique que du point de vue de l'experience utilisateur.

Twikey est concu pour s'integrer de maniere transparente dans ces flux existants. Au lieu de forcer un remplacement complet de la page d'accueil de facture actuelle, Twikey permet d'integrer et d'orchestrer des capacites de paiement individuelles a la demande. Cela rend possible l'extension de l'experience de facturation actuelle avec la prise en charge des paiements automatiques (tels que le prelevement automatique ou les paiements recurrents par carte) ainsi que des transactions ponctuelles, tout en gardant le client dans l'interface existante autant que possible.

Les sections ci-dessous decrivent un cas d'utilisation courant ou un client recoit une facture, accede a une page de facture existante et se voit proposer l'option d'activer les paiements automatiques via Twikey ou de faciliter un paiement ponctuel. Les diagrammes de sequence illustrent comment cette interaction se reflete au niveau de l'API.

Le paiement automatique

Lorsqu'un client decide d'activer les paiements automatiques, que ce soit par prelevement automatique ou par carte de credit recurrente, un nouvel accord doit etre cree dans Twikey. La creation de cet accord genere une URL de signature vers laquelle le client peut etre redirige depuis la page de facture ou le portail client. Le client complete le processus de signature en utilisant les mecanismes de signature heberges par Twikey, qui sont adaptes a la methode de paiement selectionnee et conformes au schema de paiement applicable et aux exigences reglementaires.

Apres la fin du flux de signature, Twikey redirige le client vers une URL de retour qui reflete le resultat de la signature. Cela permet de guider le client vers une page de confirmation, la vue de facture originale ou un apercu general du compte. Un webhook notifie le systeme lorsque la signature est terminee, permettant ainsi de mettre a jour le statut de la facture en consequence.

Une fois qu'un accord a ete signe avec succes, il peut etre utilise pour encaisser toutes les factures en cours ou futures pour ce client. Le systeme reste en controle des factures eligibles a l'encaissement et du moment ou elles doivent etre encaissees. Tout ce qui est necessaire pour initier l'encaissement est l'identifiant de l'accord, le montant et le message pour le client.

Si un paiement echoue ou est rejete, Twikey poursuit automatiquement le processus d'encaissement selon le schema de relance, qui peut etre configure dans le tableau de bord Twikey. Tout au long de ce processus, l'etat actuel de la transaction est expose via le feed de transactions, permettant aux systemes de rester synchronises.

Le paiement ponctuel

Outre les paiements automatiques, il est egalement possible de prendre en charge les paiements immediats et ponctuels en generant un lien de paiement via Twikey. Cela permet aux clients de regler une facture directement sans creer d'accord, tout en gardant l'integration decouplee du PSP sous-jacent et en permettant des changements de PSP sans impact sur l'API ou le flux metier.

Du point de vue de l'implementation, le systeme demande un lien de paiement via l'API Twikey et redirige le client vers la page de paiement hebergee. Une fois le paiement effectue, annule ou echoue, Twikey redirige le client vers une URL de retour controlee, comme une page de confirmation, la vue de facture originale ou un apercu general du compte, en fonction du resultat. Un webhook notifie le systeme du resultat du paiement, permettant de mettre a jour le statut de la facture en temps reel.

Voir le diagramme de sequence complet

Plus de cas d'utilisation

Des cas d'utilisation supplementaires sont en cours de developpement. En attendant, la reference API couvre tous les endpoints disponibles, et les guides detaillent chaque domaine de produit.