Pour les développeurs
Intégrez virement.tn comme moyen de paiement
Vos clients vous payent par virement bancaire, depuis leur propre application bancaire — sans numéro de carte à saisir, et sans frais de carte pour vous.
Ce que virement.tn n'est pas : une passerelle de paiement par carte. Il n'y a ni page de paiement hébergée, ni redirection, ni réponse « payé » à la fin de l'appel API. Au retour de l'appel, la commande n'est pas payée — elle est engagée. Vous la libérez à la réception du webhook, pas avant.
Le parcours acheteur
Prérequis
- Un compte marchand virement.tn actif.
- Un RIB vérifié rattaché à ce compte — sans lui, la création de facture est refusée. La vérification se fait depuis votre espace virement.tn (Paramètres → RIB).
Principe d'authentification
Chaque requête porte une clé API dans un en-tête X-Api-Key. La clé se génère depuis votre espace virement.tn (Paramètres → Clés API → Créer une clé, rôle Gérant requis) et est rattachée à votre compte : vous ne pouvez facturer que pour vous-même. La clé et le secret de signature du webhook ne sont affichés qu'une seule fois, à la création — une clé peut être révoquée à tout moment.
Le code de validation
Pièce centrale du parcours : il prouve le consentement de l'acheteur et remplace la saisie d'un numéro de carte. L'acheteur le consulte dans son propre espace virement.tn (« Mon code de validation ») — votre formulaire de paiement lui demande donc deux champs : son numéro de téléphone et ce code. Le code est à usage unique et expire après 24 heures.
Webhook de confirmation
Dès que la banque de l'acheteur confirme l'exécution du virement, virement.tn notifie votre URL de webhook (configurée à la création de la clé) avec une charge utile signée — c'est ce signal, et lui seul, qui doit déclencher la livraison du bien ou du service commandé.
Pour le fonctionnement général de la plateforme, voir comment ça marche.
Pour obtenir la référence technique et l'accès sandbox, contactez-nous. Guide pas à pas : accepter le paiement par virement sur votre site e-commerce.
Questions fréquentes
L'appel API de création de facture confirme-t-il le paiement ?
Non. À la réponse de l'appel, la commande est engagée, pas payée. Elle ne doit être libérée qu'à la réception du webhook de confirmation, qui signale que la banque a confirmé le virement.
Comment l'appel est-il authentifié ?
Par une clé API transmise dans l'en-tête X-Api-Key, générée depuis l'espace virement.tn (Paramètres, Clés API). Elle est rattachée à votre compte : vous ne pouvez facturer que pour vous-même.
Où trouver la référence technique complète ?
Elle est fournie directement aux partenaires en cours d'intégration, avec les endpoints, les formats et l'environnement sandbox. Écrivez-nous depuis la page Contact pour l'obtenir.
Prêt à essayer virement.tn ?
Le pack Gratuit permet d'émettre jusqu'à 10 factures par mois sans engagement, pour tester le parcours de bout en bout.
Créer un compte gratuit