[{"data":1,"prerenderedAt":132},["ShallowReactive",2],{"page:\u002Fintegration-partenaires":3},{"id":4,"title":5,"body":6,"cta":108,"description":109,"extension":110,"eyebrow":111,"faq":112,"h1":122,"key":123,"lead":124,"meta":125,"navigation":126,"path":127,"rawbody":128,"schemaType":108,"seo":129,"stem":123,"updated":130,"__hash__":131},"pages\u002Fintegration-partenaires.md","Intégration API : accepter le paiement par virement",{"type":7,"value":8,"toc":98},"minimark",[9,25,30,33,37,51,55,63,67,70,74,77,86],[10,11,12],"callout",{},[13,14,15,19,20,24],"p",{},[16,17,18],"strong",{},"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 ",[21,22,23],"em",{},"engagée",". Vous la libérez à la réception du webhook, pas avant.",[26,27,29],"h2",{"id":28},"le-parcours-acheteur","Le parcours acheteur",[31,32],"integration-flow",{},[26,34,36],{"id":35},"prérequis","Prérequis",[38,39,40,44],"ul",{},[41,42,43],"li",{},"Un compte marchand virement.tn actif.",[41,45,46,47,50],{},"Un ",[16,48,49],{},"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).",[26,52,54],{"id":53},"principe-dauthentification","Principe d'authentification",[13,56,57,58,62],{},"Chaque requête porte une clé API dans un en-tête ",[59,60,61],"code",{},"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.",[26,64,66],{"id":65},"le-code-de-validation","Le code de validation",[13,68,69],{},"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.",[26,71,73],{"id":72},"webhook-de-confirmation","Webhook de confirmation",[13,75,76],{},"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é.",[13,78,79,80,85],{},"Pour le fonctionnement général de la plateforme, voir ",[81,82,84],"a",{"href":83},"\u002Fcomment-ca-marche","comment ça marche",".",[13,87,88,89,93,94,85],{},"Pour obtenir la référence technique et l'accès sandbox, ",[81,90,92],{"href":91},"\u002Fcontact","contactez-nous",". Guide pas à pas : ",[81,95,97],{"href":96},"\u002Fblog\u002Faccepter-le-paiement-par-virement-sur-votre-site","accepter le paiement par virement sur votre site e-commerce",{"title":99,"searchDepth":100,"depth":100,"links":101},"",3,[102,104,105,106,107],{"id":28,"depth":103,"text":29},2,{"id":35,"depth":103,"text":36},{"id":53,"depth":103,"text":54},{"id":65,"depth":103,"text":66},{"id":72,"depth":103,"text":73},null,"Proposez virement.tn comme moyen de paiement : virement bancaire direct, code de validation, webhook signé — sans passerelle carte ni redirection.","md","Pour les développeurs",[113,116,119],{"q":114,"a":115},"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.",{"q":117,"a":118},"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.",{"q":120,"a":121},"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.","Intégrez virement.tn comme moyen de paiement","integration-partenaires","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.",{},true,"\u002Fintegration-partenaires","---\nkey: \"integration-partenaires\"\ntitle: \"Intégration API : accepter le paiement par virement\"\ndescription: \"Proposez virement.tn comme moyen de paiement : virement bancaire direct, code de validation, webhook signé — sans passerelle carte ni redirection.\"\neyebrow: \"Pour les développeurs\"\nh1: \"Intégrez virement.tn comme moyen de paiement\"\nlead: \"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.\"\nupdated: \"2026-09-19\"\nfaq:\n  - q: \"L'appel API de création de facture confirme-t-il le paiement ?\"\n    a: \"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.\"\n  - q: \"Comment l'appel est-il authentifié ?\"\n    a: \"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.\"\n  - q: \"Où trouver la référence technique complète ?\"\n    a: \"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.\"\n---\n\n::callout\n**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.\n::\n\n## Le parcours acheteur\n\n::integration-flow\n::\n\n## Prérequis\n\n- Un compte marchand virement.tn actif.\n- 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).\n\n## Principe d'authentification\n\nChaque 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.\n\n## Le code de validation\n\nPiè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.\n\n## Webhook de confirmation\n\nDè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é.\n\nPour le fonctionnement général de la plateforme, voir [comment ça marche](\u002Fcomment-ca-marche).\n\nPour obtenir la référence technique et l'accès sandbox, [contactez-nous](\u002Fcontact). Guide pas à pas : [accepter le paiement par virement sur votre site e-commerce](\u002Fblog\u002Faccepter-le-paiement-par-virement-sur-votre-site).\n",{"title":5,"description":109},"2026-09-19","ueMe9HVceSsDIf-dB40iSBoihP-VyiPk3X1CbFsspyQ",1789922120269]