# Intégration API : accepter le paiement par virement

> Proposez virement.tn comme moyen de paiement : virement bancaire direct, code de validation, webhook signé — sans passerelle carte ni redirection.

Source : https://virement.tn/integration-partenaires — dernière mise à jour : 2026-09-19

**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](/comment-ca-marche).

Pour obtenir la référence technique et l'accès sandbox, [contactez-nous](/contact). Guide pas à pas : [accepter le paiement par virement sur votre site e-commerce](/blog/accepter-le-paiement-par-virement-sur-votre-site).

## 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.