Un lien de paiement délègue l’interface de paiement à iMoney Encaissement : vous redirigez votre client vers une page de paiement hébergée, où il choisit son moyen de paiement et valide. C’est l’équivalent API du lien créé depuis le tableau de bord. La réponse renvoie page_url, la page à transmettre au payeur (redirection, email, SMS, réseau social).
Ne considérez jamais la redirection du client comme une confirmation de paiement : vérifiez l’état du lien côté serveur, avec Consulter un lien de paiement ou un webhook, avant de livrer une commande.
Authentification. Les clés et le choix Sandbox ou Live suivent les mêmes règles que le reste de l’API : voir Authentification.
reference. Si vous la fournissez plutôt que de laisser l’API la générer, elle devient l’identifiant utilisé pour consulter l’état du lien via Consulter un lien de paiement, une opération non authentifiée. Générez une valeur aléatoire à forte entropie, jamais un identifiant de commande séquentiel ou prévisible. Laisser l’API la générer évite ce risque.
Redirections. Les deux URL de redirection doivent être en HTTPS : une URL en HTTP est rejetée.
Expiration. Un lien créé par l’API expire toujours, trente minutes après sa création, quelle que soit la valeur envoyée dans shouldExpire. Transmettez le lien à votre client tout de suite, et recréez-en un plutôt que de rediffuser un lien ancien.
Doublons. Une seconde création avec la même reference fournie manuellement échoue en validation (422) : la référence doit rester unique sur votre compte. Il n’existe pas de clé d’idempotence ; aucune garantie n’est documentée en cas d’appels concurrents (à confirmer auprès du support). Un compte introuvable ou inactif pour l’environnement ciblé renvoie 404.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"iMoney Encaissement","description":"Documentation développeur officielle iMoney Encaissement","colors":{"primary":"#aac32e","light":"#c7df54","dark":"#7f941e"},"logo":{"light":"https://mintcdn.com/i-futur/BHX1WwpwbqNqmKjO/logo.png?fit=max\u0026auto=format\u0026n=BHX1WwpwbqNqmKjO\u0026q=85\u0026s=b87349c125edeba3ed435b9f0921be9b","dark":"https://mintcdn.com/i-futur/BHX1WwpwbqNqmKjO/logo.png?fit=max\u0026auto=format\u0026n=BHX1WwpwbqNqmKjO\u0026q=85\u0026s=b87349c125edeba3ed435b9f0921be9b"},"favicon":"https://mintcdn.com/i-futur/B4pwgot3NJ9hWojt/favicon.png?fit=max\u0026auto=format\u0026n=B4pwgot3NJ9hWojt\u0026q=85\u0026s=449e5a54e45513db6da435c93e052311","api":{"openapi":["openapi.yaml","en/openapi.yaml"],"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["bash","javascript","python","php","ruby","java"],"prefill":true}},"background":{"color":{"light":"#ffffff","dark":"#0e1110"}},"navbar":{"links":[{"href":"https://i-pay.money","label":"Site iMoney Encaissement"}],"primary":{"type":"button","label":"Se connecter","href":"https://i-pay.money/dashboard"}},"footer":{"socials":{"website":"https://i-pay.money"}},"fonts":{"heading":{"family":"Open Sans","weight":700},"body":{"family":"Open Sans","weight":400}},"styling":{"eyebrows":"breadcrumbs","codeblocks":{"theme":{"light":"github-light","dark":"github-dark"}},"latex":false},"navigation":{"languages":[{"language":"fr","default":true,"href":""},{"language":"en","navbar":{"links":[{"href":"https://i-pay.money","label":"iMoney Encaissement website"}],"primary":{"type":"button","label":"Log in","href":"https://i-pay.money/dashboard"}},"href":"en"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"i-futur","hasAudioNarration":false,"actualSubdomain":"i-futur","customDomains":["docs.i-pay.money"],"gitSource":{"type":"github","owner":"ifuturteam","repo":"ipay-money-documentation","deployBranch":"main","contentDirectory":"docs/mintlify","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae39784e26a02b8d44a54be","clientVersion":"0.0.4088","searchFilterCounts":[{"language":"fr","tag":"Référence API","count":7},{"language":"fr","tag":"Documentation","count":7},{"language":"en","tag":"API reference","count":7},{"language":"en","tag":"Documentation","count":7},{"language":"fr","tag":"SDKs","count":4},{"language":"fr","tag":"SDKs et plugins","count":4},{"language":"en","tag":"SDKs","count":4},{"language":"en","tag":"SDKs and plugins","count":4},{"language":"fr","tag":"Transactions","count":3},{"language":"fr","tag":"Guides","count":3},{"language":"en","tag":"Transactions","count":3},{"language":"en","tag":"Guides","count":3},{"language":"fr","tag":"Introduction","count":2},{"language":"fr","tag":"Liens de paiement","count":2},{"language":"fr","tag":"Démarrer","count":2},{"language":"fr","tag":"Ressources","count":2},{"language":"en","tag":"Introduction","count":2},{"language":"en","tag":"Payment by link","count":2},{"language":"en","tag":"Get started","count":2},{"language":"en","tag":"Resources","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":":root{--ipay-line: #ecece7;--ipay-line-strong: #ddddd6;--ipay-panel: #fafaf8;--ipay-primary: #bbcb44;--ipay-primary-hover: #a3b339;--ipay-primary-soft: #f2f6d6;--ipay-primary-ink: #5e6a1a}.dark{--ipay-line: #2d302b;--ipay-line-strong: #525249;--ipay-panel: #1a1d1f;--ipay-primary-soft: #2d331c;--ipay-primary-ink: #e4ecaa}#search-bar-entry{background:var(--ipay-panel);border:1px solid var(--ipay-line-strong);border-radius:999px;transition:border-color 0.15s ease, box-shadow 0.15s ease}#search-bar-entry:hover{border-color:var(--ipay-primary-hover)}#search-bar-entry:focus-within{border-color:var(--ipay-primary-hover);box-shadow:0 0 0 4px var(--ipay-primary-soft)}.prose a:not([class*=\"card\"]){color:var(--ipay-primary-ink);font-weight:600;text-underline-offset:3px}.prose table{border:1px solid var(--ipay-line);border-collapse:separate;border-radius:10px;border-spacing:0;overflow:hidden}.prose thead th{background:var(--ipay-panel);font-size:12px;letter-spacing:0.04em;text-transform:uppercase}.prose td,.prose th{border-bottom:1px solid var(--ipay-line)}.prose pre,code-block{border:1px solid var(--ipay-line);border-radius:14px}#sidebar a[data-active=\"true\"],#sidebar li[data-active=\"true\"]>a{background:var(--ipay-primary-soft);border-radius:8px;color:var(--ipay-primary-ink)}"}],"page":{"pagePath":"api-reference/liens-de-paiement/creer-un-lien","slug":"/api-reference/liens-de-paiement/creer-un-lien","pageMetadata":{"title":"Créer un lien de paiement hébergé","description":"Créez une page de paiement hébergée par iMoney Encaissement et partagez son URL à votre client.","openapi":"openapi.yaml POST /external_payments","href":"/api-reference/liens-de-paiement/creer-un-lien"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Créez une page de paiement hébergée par iMoney Encaissement et partagez son URL à votre client.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Warning}=_components;if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Un lien de paiement délègue l’interface de paiement à iMoney Encaissement : vous redirigez votre client vers une page de paiement hébergée, où il choisit son `,_jsx(_components.a,{href:`/guides/reversement#frais-par-moyen-de-paiement`,children:`moyen de paiement`}),` et valide. C’est l’équivalent API du lien créé depuis le tableau de bord. La réponse renvoie `,_jsx(_components.code,{children:`page_url`}),`, la page à transmettre au payeur (redirection, email, SMS, réseau social).`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Ne considérez jamais la redirection du client comme une confirmation de paiement : vérifiez l’état du lien côté serveur, avec `,_jsx(_components.a,{href:`/api-reference/liens-de-paiement/consulter-un-lien`,children:`Consulter un lien de paiement`}),` ou un `,_jsx(_components.a,{href:`/guides/webhooks`,children:`webhook`}),`, avant de livrer une commande.`]})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Authentification.`}),` Les clés et le choix Sandbox ou Live suivent les mêmes règles que le reste de l’API : voir `,_jsx(_components.a,{href:`/api-reference/authentification`,children:`Authentification`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`reference`}),`.`]}),` Si vous la fournissez plutôt que de laisser l’API la générer, elle devient l’identifiant utilisé pour consulter l’état du lien via `,_jsx(_components.a,{href:`/api-reference/liens-de-paiement/consulter-un-lien`,children:`Consulter un lien de paiement`}),`, une opération non authentifiée. Générez une valeur aléatoire à forte entropie, jamais un identifiant de commande séquentiel ou prévisible. Laisser l’API la générer évite ce risque.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Redirections.`}),` Les deux URL de redirection doivent être en HTTPS : une URL en HTTP est rejetée.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Expiration.`}),` Un lien créé par l’API expire toujours, trente minutes après sa création, quelle que soit la valeur envoyée dans `,_jsx(_components.code,{children:`shouldExpire`}),`. Transmettez le lien à votre client tout de suite, et recréez-en un plutôt que de rediffuser un lien ancien.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Doublons.`}),` Une seconde création avec la même `,_jsx(_components.code,{children:`reference`}),` fournie manuellement échoue en validation (`,_jsx(_components.code,{children:`422`}),`) : la référence doit rester unique sur votre compte. Il n’existe pas de clé d’idempotence ; aucune garantie n’est documentée en cas d’appels concurrents (à confirmer auprès du support). Un compte introuvable ou inactif pour l’environnement ciblé renvoie `,_jsx(_components.code,{children:`404`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Messages d’erreur communs : `,_jsx(_components.a,{href:`/api-reference/erreurs`,children:`Erreurs`}),`.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"github-light","dark":"github-dark"}},"config":{},"pageMetadata":{"title":"Créer un lien de paiement hébergé","description":"Créez une page de paiement hébergée par iMoney Encaissement et partagez son URL à votre client.","openapi":"openapi.yaml POST /external_payments","href":"/api-reference/liens-de-paiement/creer-un-lien"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Payment links"],"summary":"Créer un lien de paiement hébergé","security":["71dbc82f-f982-4967-a12d-e299ef8325fb"],"parameters":["34adffe3-47e4-4871-bd79-962ab73dde4d","2ec89705-515b-4558-ab06-1fce80545b12"],"requestBody":"fcadd1b0-931d-4ce8-aa9c-256f95fcabcd","responses":{"200":"b3dfedda-42a0-4463-842d-e1f08b581dd4","404":"bf105da8-8780-4f00-966c-88f40d83757a","422":"5fa145c0-10de-4359-bcd7-1eed5f50f4bd"},"method":"post","type":"path","servers":["adde9987-f0bd-4457-ac4a-bc35e6f467d9"],"path":"/external_payments","baseUrlOptions":["https://i-pay.money/api/v1"],"title":"Créer un lien de paiement hébergé","description":"Créez une page de paiement hébergée par iMoney Encaissement et partagez son URL à votre client.","codeSamples":[],"requestExampleLanguages":["bash","javascript","python","php","ruby","java"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.title":"Commande #1001","body.description":"Transaction de la commande #1001","body.amount.oneOf.0":15000,"body.on_success_redirection_url":"https://votre-site.com/commandes/1001/succes","body.on_failed_redirection_url":"https://votre-site.com/commandes/1001/echec"}]},"dependencies":{"parameters":{"34adffe3-47e4-4871-bd79-962ab73dde4d":{"name":"Ipay-Target-Environment","in":"header","required":true,"schema":{"type":"string","enum":["sandbox","live"],"isRequired":true,"uniqueKey":"","typeLabel":"enum\u003cstring>"}},"2ec89705-515b-4558-ab06-1fce80545b12":{"name":"Ipay-Payment-Type","in":"header","required":true,"schema":{"type":"string","const":"external_payment","isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["title"],"properties":{"title":{"type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"description":{"type":"string","uniqueKey":"description","typeLabel":"string"},"amount":{"oneOf":[{"type":"integer","minimum":50,"uniqueKey":"amount.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":50,"uniqueKey":"amount.oneOf.1","typeLabel":"null"}],"uniqueKey":"amount","typeLabel":"integer | null"},"reference":{"type":"string","minLength":32,"description":"Omettre pour génération automatique, ou fournir une valeur aléatoire privée d'au moins 128 bits.","uniqueKey":"reference","typeLabel":"string"},"shouldExpire":{"type":"boolean","const":true,"default":true,"description":"La v1 actuelle crée toujours un lien expirant.","uniqueKey":"shouldExpire","typeLabel":"boolean"},"on_success_redirection_url":{"type":"string","format":"uri","pattern":"^https://","uniqueKey":"on_success_redirection_url","typeLabel":"string\u003curi>"},"on_failed_redirection_url":{"type":"string","format":"uri","pattern":"^https://","uniqueKey":"on_failed_redirection_url","typeLabel":"string\u003curi>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"lienCommande":{"title":"lienCommande","value":{"title":"Commande #1001","description":"Transaction de la commande #1001","amount":15000,"on_success_redirection_url":"https://votre-site.com/commandes/1001/succes","on_failed_redirection_url":"https://votre-site.com/commandes/1001/echec"}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"b3dfedda-42a0-4463-842d-e1f08b581dd4":{"description":"Lien créé","content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","uniqueKey":"title","typeLabel":"string"},"amount":{"oneOf":[{"type":"integer","uniqueKey":"amount.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"amount.oneOf.1","typeLabel":"null"}],"uniqueKey":"amount","typeLabel":"integer | null"},"reference":{"type":"string","uniqueKey":"reference","typeLabel":"string"},"status":{"type":"string","example":"initiated","uniqueKey":"status","typeLabel":"string"},"should_expire":{"type":"boolean","uniqueKey":"should_expire","typeLabel":"boolean"},"page_url":{"type":"string","format":"uri","uniqueKey":"page_url","typeLabel":"string\u003curi>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"title":"\u003cstring>","amount":123,"reference":"\u003cstring>","status":"initiated","should_expire":true,"page_url":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"bf105da8-8780-4f00-966c-88f40d83757a":{"description":"Compte introuvable ou inactif","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"status":{"type":"string","description":"Présent uniquement sur certains échecs applicatifs, ex. paiement dupliqué sur `POST /payments` où `status` vaut toujours `failed`. Absent des autres erreurs de ce contrat (ex. 404 `Payment Not Found`, erreurs d'en-tête/authentification).","x-verified":"Note interne de vérification (non destinée à la documentation publique). Voir `Live::PaymentService#error_response` (app/services/live/payment_service.rb:994-1005).","example":"failed","uniqueKey":"status","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","status":"failed"}}},"exampleType":"generated"}},"exampleType":"generated"},"5fa145c0-10de-4359-bcd7-1eed5f50f4bd":{"description":"Paramètres invalides","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"string","uniqueKey":"errors.items.[INDEX]","typeLabel":"string"},"uniqueKey":"errors","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"71dbc82f-f982-4967-a12d-e299ef8325fb":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Clé secrète du compte Sandbox ou Live","scopes":[]}}},"servers":{"adde9987-f0bd-4457-ac4a-bc35e6f467d9":{"url":"https://i-pay.money/api/v1","description":"Sandbox ou Live selon les en-têtes et la clé utilisée"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Clé secrète du compte Sandbox ou Live","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Clé secrète du compte Sandbox ou Live","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"i-futur","siteName":"iMoney Encaissement","title":"Créer un lien de paiement hébergé - iMoney Encaissement","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"fr":{"href":"/api-reference/liens-de-paiement/creer-un-lien","matchLevel":0},"en":{"href":"/en","matchLevel":4}}},"lastModified":"2026-09-21T19:05:25.147Z","originalFileLocation":"api-reference/liens-de-paiement/creer-un-lien.mdx","locale":"fr"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Créez une page de paiement hébergée par iMoney Encaissement et partagez son URL à votre client.\">\u003cmeta data-mint-head name=\"application-name\" content=\"iMoney Encaissement\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/i-futur/kyXVeG45fkp622Ap/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/i-futur/kyXVeG45fkp622Ap/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/i-futur/kyXVeG45fkp622Ap/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/i-futur/kyXVeG45fkp622Ap/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/i-futur/kyXVeG45fkp622Ap/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/i-futur/kyXVeG45fkp622Ap/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/i-futur/kyXVeG45fkp622Ap/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/i-futur/kyXVeG45fkp622Ap/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/i-futur/kyXVeG45fkp622Ap/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Créer un lien de paiement hébergé - iMoney Encaissement\">\u003cmeta data-mint-head property=\"og:description\" content=\"Créez une page de paiement hébergée par iMoney Encaissement et partagez son URL à votre client.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"iMoney Encaissement\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.i-pay.money/api-reference/liens-de-paiement/creer-un-lien\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://i-futur.mintlify.site/_mintlify/api/og/v2?division=Liens+de+paiement\u0026amp;title=Cr%C3%A9er+un+lien+de+paiement+h%C3%A9berg%C3%A9\u0026amp;description=Cr%C3%A9ez+une+page+de+paiement+h%C3%A9berg%C3%A9e+par+iMoney+Encaissement+et+partagez+son+URL+%C3%A0+votre+client.\u0026amp;theme=4af5335503ff29411be4ba64\u0026amp;signature=187ca4d01874c75dbe7c537f7cbc34726c90b46ac38204070278f1d7a11ebc8d\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Créer un lien de paiement hébergé - iMoney Encaissement\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Créez une page de paiement hébergée par iMoney Encaissement et partagez son URL à votre client.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://i-futur.mintlify.site/_mintlify/api/og/v2?division=Liens+de+paiement\u0026amp;title=Cr%C3%A9er+un+lien+de+paiement+h%C3%A9berg%C3%A9\u0026amp;description=Cr%C3%A9ez+une+page+de+paiement+h%C3%A9berg%C3%A9e+par+iMoney+Encaissement+et+partagez+son+URL+%C3%A0+votre+client.\u0026amp;theme=4af5335503ff29411be4ba64\u0026amp;signature=187ca4d01874c75dbe7c537f7cbc34726c90b46ac38204070278f1d7a11ebc8d\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/i-futur/kyXVeG45fkp622Ap/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"iMoney Encaissement\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#aac32e\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.i-pay.money/api-reference/liens-de-paiement/creer-un-lien\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/liens-de-paiement/creer-un-lien.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.i-pay.money/#organization\",\"name\":\"iMoney Encaissement\",\"url\":\"https://docs.i-pay.money\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/i-futur/BHX1WwpwbqNqmKjO/logo.png?fit=max\u0026auto=format\u0026n=BHX1WwpwbqNqmKjO\u0026q=85\u0026s=b87349c125edeba3ed435b9f0921be9b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.i-pay.money#website\",\"name\":\"iMoney Encaissement\",\"url\":\"https://docs.i-pay.money\",\"publisher\":{\"@id\":\"https://docs.i-pay.money/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.i-pay.money/api-reference/liens-de-paiement/creer-un-lien#webpage\",\"url\":\"https://docs.i-pay.money/api-reference/liens-de-paiement/creer-un-lien\",\"name\":\"Créer un lien de paiement hébergé\",\"description\":\"Créez une page de paiement hébergée par iMoney Encaissement et partagez son URL à votre client.\",\"dateModified\":\"2026-09-21T19:05:25.147Z\",\"isPartOf\":{\"@id\":\"https://docs.i-pay.money#website\"},\"breadcrumb\":{\"@id\":\"https://docs.i-pay.money/api-reference/liens-de-paiement/creer-un-lien#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.i-pay.money/api-reference/liens-de-paiement/creer-un-lien#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"iMoney Encaissement\",\"item\":\"https://docs.i-pay.money\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Créer un lien de paiement hébergé\",\"item\":\"https://docs.i-pay.money/api-reference/liens-de-paiement/creer-un-lien\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.i-pay.money/api-reference/liens-de-paiement/creer-un-lien#apireference\",\"headline\":\"Créer un lien de paiement hébergé\",\"name\":\"Créer un lien de paiement hébergé\",\"description\":\"Créez une page de paiement hébergée par iMoney Encaissement et partagez son URL à votre client.\",\"url\":\"https://docs.i-pay.money/api-reference/liens-de-paiement/creer-un-lien\",\"mainEntityOfPage\":{\"@id\":\"https://docs.i-pay.money/api-reference/liens-de-paiement/creer-un-lien#webpage\"},\"dateModified\":\"2026-09-21T19:05:25.147Z\",\"publisher\":{\"@id\":\"https://docs.i-pay.money/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.i-pay.money#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"iMoney Encaissement\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"iMoney Encaissement","nav":{"global":null,"languages":[{"language":"fr","default":true,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"SDKs","pages":[{"title":"SDKs","href":"/sdks"}]},{"tab":"Référence API","groups":[{"group":"Introduction","pages":[{"title":"Authentification","href":"/api-reference/authentification"},{"title":"Erreurs","href":"/api-reference/erreurs"}]},{"group":"Transactions","pages":[{"title":"Créer une transaction","openapi":"openapi.yaml POST /payments","href":"/api-reference/transactions/creer-un-paiement"},{"title":"Consulter une transaction","openapi":"openapi.yaml GET /payments/{reference}","href":"/api-reference/transactions/consulter-un-paiement"},{"title":"Lister les transactions","description":"Listez les transactions du compte avec des filtres, pour une vue d'ensemble ou une réconciliation.","openapi":"openapi.yaml GET /payments","href":"/api-reference/transactions/lister-les-paiements"}]},{"group":"Liens de paiement","pages":[{"title":"Créer un lien de paiement hébergé","openapi":"openapi.yaml POST /external_payments","href":"/api-reference/liens-de-paiement/creer-un-lien"},{"title":"Consulter un lien de paiement","description":"Lisez l'état d'un lien de paiement à partir de sa référence. Aucune clé n'est requise.","openapi":"openapi.yaml GET /external_payments/{reference}","href":"/api-reference/liens-de-paiement/consulter-un-lien"}]}]}]},{"language":"en","navbar":{"links":[{"href":"https://i-pay.money","label":"iMoney Encaissement website"}],"primary":{"type":"button","label":"Log in","href":"https://i-pay.money/dashboard"}},"pages":[{"title":"en","href":"/en"}]}]},"basePath":"","title":"Créer un lien de paiement hébergé - iMoney Encaissement","buildId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","deploymentId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-5FCzAcfS.js","utils-SLtAG4EZ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-2DZi8ZMu.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D7J3nkzE.js","snippetPresets-D0Alv0AH.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BI4qNJ2c.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BD3uyr8j.js","shallow-D8iEBr5z.js","getApiPlaygroundDisplay-CgNP4lzR.js","CodeSnippet-CX-QHuMs.js","CodeSnippets-VlXE-ZUf.js","Page-D9ithiIZ.js","getPastedJson-DYNQkZ1M.js","icon-CzacdwOi.js","MethodPill-2JVqoYKi.js","DuplicateIcon-_xVXs-U8.js","createIcon-BRHrweLo.js","DynamicMarkdown-mQG_iQiE.js","SectionHeading-DMpJzv8f.js","axios-vUo_bRtp.js","Markdown-5FGIym-8.js","clsx-D-TRO5q5.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CdrJecqK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CHlcWBLM.js"]}