{
"message": "Cette clé API n'est pas autorisée pour les opérations payin (scope actuel : Payout).",
"code": "api_key_scope_forbidden"
}
Idempotency-Key n’est pas pris en charge sur cet endpoint — un double-clic ou un retry réseau peut créer deux liens distincts. Sans conséquence financière : un lien en double se supprime depuis votre dashboard.
Aucune validation croisée serveur entre amount_type et amount : rien n’empêche de créer un lien FIXED sans amount. Vérifiez cette cohérence côté intégrateur.
redirect_url devient obligatoire (400 sinon) dès que show_confirmation_page vaut false — bascule exclusive : soit le client voit la page de confirmation AlphaPay après paiement, soit il est redirigé directement vers redirect_url, jamais les deux.
Chaque entrée de custom_fields doit avoir au minimum key et label (400 sinon), et les key doivent être uniques au sein d’un même lien. Ce sont des définitions de champs — les valeurs saisies par le client sont collectées au checkout (custom_field_values) et atterrissent dans Transaction.metadata, jamais sur PaymentLink lui-même.
Requis si show_confirmation_page=false (400 sinon).
Response
Lien créé
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"AlphaPay","colors":{"primary":"#2563eb","light":"#2563eb","dark":"#2563eb"},"logo":{"light":"https://mintcdn.com/alphapay/Tw2HIGYSgf2WV5ej/logo/light.svg?fit=max\u0026auto=format\u0026n=Tw2HIGYSgf2WV5ej\u0026q=85\u0026s=646197078fcc38abde555ee1414140a1","dark":"https://mintcdn.com/alphapay/Tw2HIGYSgf2WV5ej/logo/dark.svg?fit=max\u0026auto=format\u0026n=Tw2HIGYSgf2WV5ej\u0026q=85\u0026s=3472578099a35f138fe8060f6296f7bd"},"favicon":"https://mintcdn.com/alphapay/pS32XZxYxKvhmus0/favicon.svg?fit=max\u0026auto=format\u0026n=pS32XZxYxKvhmus0\u0026q=85\u0026s=22355448471cc154a08a9e6f87a5e37c","navbar":{"links":[{"href":"https://app.alphapay.me/support","label":"Support"}],"primary":{"type":"button","label":"Tableau de bord","href":"https://app.alphapay.me"}},"footer":{"socials":{}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Tableau de bord","icon":"browser","href":"https://app.alphapay.me"},{"anchor":"Support","icon":"headset","href":"https://app.alphapay.me/support"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"alphapay","hasAudioNarration":false,"actualSubdomain":"alphapay","customDomains":["docs.alphapay.me"],"gitSource":{"type":"github","owner":"alphaconnect-technology","repo":"alphapaydocs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6addf0feb128bc39b5e5fc1e","collectionId":"088b103b-ca6a-4e15-ac7c-977b354bc337","liveDeploymentHistoryId":"6addf0feb128bc39b5e5fc1e","schemaVersion":"v3"},"entitlements":{},"buildId":"6addf0feb128bc39b5e5fc1e","clientVersion":"0.0.4006","searchFilterCounts":[{"language":"default","tag":"API","count":51},{"language":"default","tag":"Encaisser","count":10},{"language":"default","tag":"Guides","count":9},{"language":"default","tag":"Transactions","count":9},{"language":"default","tag":"Liens de paiement","count":7},{"language":"default","tag":"Référentiels","count":7},{"language":"default","tag":"Solde \u0026 taux de change","count":7},{"language":"default","tag":"Webhooks","count":7},{"language":"default","tag":"SDKs \u0026 Intégration","count":6},{"language":"default","tag":"Prise en main","count":3}]},"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":"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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/payment-links/create","slug":"/api-reference/payment-links/create","pageMetadata":{"title":"Créer un lien de paiement","description":"Crée un lien de paiement réutilisable","openapi":"api-reference/openapi.json POST /payment-links/","href":"/api-reference/payment-links/create"},"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ée un lien de paiement réutilisable\"\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={code:`code`,em:`em`,p:`p`,..._provideComponents(),...props.components},{Note,Warning}=_components;if(!Note)_missingMdxReference(`Note`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`Idempotency-Key`}),` n’est pas pris en charge sur cet endpoint — un double-clic ou un retry réseau peut créer deux liens distincts. Sans conséquence financière : un lien en double se supprime depuis votre dashboard.`]})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Aucune validation croisée serveur entre `,_jsx(_components.code,{children:`amount_type`}),` et `,_jsx(_components.code,{children:`amount`}),` : rien n’empêche de créer un lien `,_jsx(_components.code,{children:`FIXED`}),` sans `,_jsx(_components.code,{children:`amount`}),`. Vérifiez cette cohérence côté intégrateur.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`redirect_url`}),` devient obligatoire (400 sinon) dès que `,_jsx(_components.code,{children:`show_confirmation_page`}),` vaut `,_jsx(_components.code,{children:`false`}),` — bascule exclusive : soit le client voit la page de confirmation AlphaPay après paiement, soit il est redirigé directement vers `,_jsx(_components.code,{children:`redirect_url`}),`, jamais les deux.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Chaque entrée de `,_jsx(_components.code,{children:`custom_fields`}),` doit avoir au minimum `,_jsx(_components.code,{children:`key`}),` et `,_jsx(_components.code,{children:`label`}),` (400 sinon), et les `,_jsx(_components.code,{children:`key`}),` doivent être uniques au sein d’un même lien. Ce sont des définitions de champs — les `,_jsx(_components.em,{children:`valeurs`}),` saisies par le client sont collectées au checkout (`,_jsx(_components.code,{children:`custom_field_values`}),`) et atterrissent dans `,_jsx(_components.code,{children:`Transaction.metadata`}),`, jamais sur `,_jsx(_components.code,{children:`PaymentLink`}),` lui-même.`]})})]})}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":{"config":{},"pageMetadata":{"title":"Créer un lien de paiement","description":"Crée un lien de paiement réutilisable","openapi":"api-reference/openapi.json POST /payment-links/","href":"/api-reference/payment-links/create"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Liens de paiement"],"summary":"Créer un lien de paiement","description":"Crée un lien de paiement réutilisable","requestBody":"7c8df8fa-0bb1-44e4-80f1-d1ea875c5607","responses":{"201":"7c5a3a22-5f43-40ec-9522-db4852bb52f2","403":"fdab92ef-bb85-4077-a6a7-b64f4e460112"},"method":"post","type":"path","servers":["b19353dd-21f2-40ba-aea5-aa89c55a0b6e"],"security":["c148d465-63f6-4b9f-9fe1-4b1089306f66"],"path":"/payment-links/","baseUrlOptions":["https://api.alphapay.me/api/v1"],"title":"Créer un lien de paiement","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name","currency"],"properties":{"name":{"type":"string","maxLength":150,"example":"Facture boutique","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"currency":{"type":"string","minLength":3,"maxLength":3,"example":"XOF","isRequired":true,"uniqueKey":"currency","typeLabel":"string"},"description":{"type":"string","maxLength":255,"example":"Paiement en ligne","uniqueKey":"description","typeLabel":"string"},"amount_type":{"type":"string","enum":["FIXED","FREE"],"default":"FIXED","description":"FIXED : montant imposé (amount). FREE : le client choisit (min_amount optionnel comme plancher). Aucune validation croisée serveur — un lien FIXED sans amount est accepté.","uniqueKey":"amount_type","typeLabel":"enum\u003cstring>"},"amount":{"type":"string","format":"decimal","example":"15000.00","uniqueKey":"amount","typeLabel":"string\u003cdecimal>"},"min_amount":{"type":"string","format":"decimal","description":"Pertinent si amount_type=FREE","uniqueKey":"min_amount","typeLabel":"string\u003cdecimal>"},"is_active":{"type":"boolean","default":true,"uniqueKey":"is_active","typeLabel":"boolean"},"expires_at":{"type":"string","format":"date-time","uniqueKey":"expires_at","typeLabel":"string\u003cdate-time>"},"usage_limit":{"type":"integer","minimum":1,"example":100,"uniqueKey":"usage_limit","typeLabel":"integer"},"require_phone":{"type":"boolean","default":false,"description":"Rend customer.phone obligatoire au checkout depuis ce lien — même pour card/crypto, qui ne le demandent pas par défaut.","uniqueKey":"require_phone","typeLabel":"boolean"},"facebook_pixel_id":{"type":"string","maxLength":32,"uniqueKey":"facebook_pixel_id","typeLabel":"string"},"google_ads_id":{"type":"string","maxLength":32,"uniqueKey":"google_ads_id","typeLabel":"string"},"custom_fields":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","description":"Dérivée du label, jamais saisie directement.","uniqueKey":"custom_fields.items.[INDEX].key","typeLabel":"string"},"label":{"type":"string","uniqueKey":"custom_fields.items.[INDEX].label","typeLabel":"string"},"required":{"type":"boolean","uniqueKey":"custom_fields.items.[INDEX].required","typeLabel":"boolean"}},"uniqueKey":"custom_fields.items.[INDEX]","typeLabel":"object"},"description":"Champs additionnels demandés au client au moment du paiement — les VALEURS saisies atterrissent dans Transaction.metadata, jamais un nouveau modèle.","uniqueKey":"custom_fields","typeLabel":"object[]"},"show_confirmation_page":{"type":"boolean","default":true,"uniqueKey":"show_confirmation_page","typeLabel":"boolean"},"redirect_url":{"type":"string","format":"uri","description":"Requis si show_confirmation_page=false (400 sinon).","uniqueKey":"redirect_url","typeLabel":"string\u003curi>"}},"uniqueKey":"","typeLabel":"object"},"example":{"name":"Facture boutique","description":"Paiement en ligne","amount_type":"FIXED","amount":"15000.00","currency":"XOF","usage_limit":100},"examples":{"Example":{"title":"Example","value":{"name":"Facture boutique","description":"Paiement en ligne","amount_type":"FIXED","amount":"15000.00","currency":"XOF","usage_limit":100}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"7c5a3a22-5f43-40ec-9522-db4852bb52f2":{"description":"Lien créé","content":{"application/json":{"example":{"id":"d2e3f4a5-6b7c-4d8e-9f0a-1b2c3d4e5f6a","merchant":"6f1e2b3a-8c4d-4a2f-9e1b-2d3c4f5a6b7c","created_by_member":"4a5b6c7d-8e9f-4a0b-9c1d-2e3f4a5b6c7d","name":"Facture boutique","description":"Paiement en ligne","amount_type":"FIXED","amount":"15000.00","min_amount":null,"currency":"XOF","slug":"kx7f2q1a","is_active":true,"expires_at":null,"usage_limit":100,"require_phone":false,"facebook_pixel_id":"","google_ads_id":"","custom_fields":[],"show_confirmation_page":true,"redirect_url":"","usage_count":0,"created_at":"2026-08-12T09:00:00Z","updated_at":"2026-08-12T09:00:00Z"},"examples":{"Example":{"title":"Example","value":{"id":"d2e3f4a5-6b7c-4d8e-9f0a-1b2c3d4e5f6a","merchant":"6f1e2b3a-8c4d-4a2f-9e1b-2d3c4f5a6b7c","created_by_member":"4a5b6c7d-8e9f-4a0b-9c1d-2e3f4a5b6c7d","name":"Facture boutique","description":"Paiement en ligne","amount_type":"FIXED","amount":"15000.00","min_amount":null,"currency":"XOF","slug":"kx7f2q1a","is_active":true,"expires_at":null,"usage_limit":100,"require_phone":false,"facebook_pixel_id":"","google_ads_id":"","custom_fields":[],"show_confirmation_page":true,"redirect_url":"","usage_count":0,"created_at":"2026-08-12T09:00:00Z","updated_at":"2026-08-12T09:00:00Z"}}},"exampleType":"examples"}},"exampleType":"examples"},"fdab92ef-bb85-4077-a6a7-b64f4e460112":{"description":"Scope de clé API insuffisant (PAYIN requis)","content":{"application/json":{"example":{"message":"Cette clé API n'est pas autorisée pour les opérations payin (scope actuel : Payout).","code":"api_key_scope_forbidden"},"examples":{"Example":{"title":"Example","value":{"message":"Cette clé API n'est pas autorisée pour les opérations payin (scope actuel : Payout).","code":"api_key_scope_forbidden"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"c148d465-63f6-4b9f-9fe1-4b1089306f66":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"sk_live_... / sk_test_...","description":"Clé API secrète du marchand — header Authorization: Bearer sk_live_xxx (ou sk_test_xxx en environnement de test).","scopes":[]}}},"servers":{"b19353dd-21f2-40ba-aea5-aa89c55a0b6e":{"url":"https://api.alphapay.me/api/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"sk_live_... / sk_test_...","description":"Clé API secrète du marchand — header Authorization: Bearer sk_live_xxx (ou sk_test_xxx en environnement de test).","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Clé API secrète du marchand — header Authorization: Bearer sk_live_xxx (ou sk_test_xxx en environnement de test).","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"alphapay","siteName":"AlphaPay","title":"Créer un lien de paiement - AlphaPay","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-11T16:51:58.214Z","originalFileLocation":"api-reference/payment-links/create.mdx"},"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ée un lien de paiement réutilisable\">\u003cmeta data-mint-head name=\"application-name\" content=\"AlphaPay\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/alphapay/Th8-_sq5pGXezoVi/_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/alphapay/Th8-_sq5pGXezoVi/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/alphapay/Th8-_sq5pGXezoVi/_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/alphapay/Th8-_sq5pGXezoVi/_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/alphapay/Th8-_sq5pGXezoVi/_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/alphapay/Th8-_sq5pGXezoVi/_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/alphapay/Th8-_sq5pGXezoVi/_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/alphapay/Th8-_sq5pGXezoVi/_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/alphapay/Th8-_sq5pGXezoVi/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Créer un lien de paiement - AlphaPay\">\u003cmeta data-mint-head property=\"og:description\" content=\"Crée un lien de paiement réutilisable\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"AlphaPay\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.alphapay.me/api-reference/payment-links/create\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://alphapay.mintlify.app/_mintlify/api/og/v2?division=Liens+de+paiement\u0026amp;title=Cr%C3%A9er+un+lien+de+paiement\u0026amp;description=Cr%C3%A9e+un+lien+de+paiement+r%C3%A9utilisable\u0026amp;theme=7b414481c8ca8eb6796b104f\u0026amp;signature=3f86409679cdb02ffc719df0dc83cef464f9d732a0b76a2a0b8b87467ac080d3\">\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 - AlphaPay\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Crée un lien de paiement réutilisable\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://alphapay.mintlify.app/_mintlify/api/og/v2?division=Liens+de+paiement\u0026amp;title=Cr%C3%A9er+un+lien+de+paiement\u0026amp;description=Cr%C3%A9e+un+lien+de+paiement+r%C3%A9utilisable\u0026amp;theme=7b414481c8ca8eb6796b104f\u0026amp;signature=3f86409679cdb02ffc719df0dc83cef464f9d732a0b76a2a0b8b87467ac080d3\">\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/alphapay/Th8-_sq5pGXezoVi/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"AlphaPay\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2563eb\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.alphapay.me/api-reference/payment-links/create\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/payment-links/create.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.alphapay.me/#organization\",\"name\":\"AlphaPay\",\"url\":\"https://docs.alphapay.me\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/alphapay/Tw2HIGYSgf2WV5ej/logo/light.svg?fit=max\u0026auto=format\u0026n=Tw2HIGYSgf2WV5ej\u0026q=85\u0026s=646197078fcc38abde555ee1414140a1\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.alphapay.me#website\",\"name\":\"AlphaPay\",\"url\":\"https://docs.alphapay.me\",\"publisher\":{\"@id\":\"https://docs.alphapay.me/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.alphapay.me/api-reference/payment-links/create#webpage\",\"url\":\"https://docs.alphapay.me/api-reference/payment-links/create\",\"name\":\"Créer un lien de paiement\",\"description\":\"Crée un lien de paiement réutilisable\",\"dateModified\":\"2026-09-11T16:51:58.214Z\",\"isPartOf\":{\"@id\":\"https://docs.alphapay.me#website\"},\"breadcrumb\":{\"@id\":\"https://docs.alphapay.me/api-reference/payment-links/create#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.alphapay.me/api-reference/payment-links/create#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Liens de paiement\",\"item\":\"https://docs.alphapay.me/api-reference/payment-links\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Créer un lien de paiement\",\"item\":\"https://docs.alphapay.me/api-reference/payment-links/create\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.alphapay.me/api-reference/payment-links/create#apireference\",\"headline\":\"Créer un lien de paiement\",\"name\":\"Créer un lien de paiement\",\"description\":\"Crée un lien de paiement réutilisable\",\"url\":\"https://docs.alphapay.me/api-reference/payment-links/create\",\"mainEntityOfPage\":{\"@id\":\"https://docs.alphapay.me/api-reference/payment-links/create#webpage\"},\"dateModified\":\"2026-09-11T16:51:58.214Z\",\"publisher\":{\"@id\":\"https://docs.alphapay.me/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.alphapay.me#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"AlphaPay\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"AlphaPay","nav":{"global":{"anchors":[{"anchor":"Tableau de bord","icon":"browser","href":"https://app.alphapay.me"},{"anchor":"Support","icon":"headset","href":"https://app.alphapay.me/support"}]},"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API","groups":[{"group":"Vue d'ensemble","pages":[{"title":"Référence API","icon":"terminal","href":"/api-reference/introduction"}]},{"group":"Encaisser","pages":[{"title":"Paiements","icon":"credit-card","href":"/api-reference/payments"},{"title":"Initier un paiement softpay","openapi":"api-reference/openapi.json POST /payments/softpay/","href":"/api-reference/payments/softpay"},{"title":"Créer une session de checkout","openapi":"api-reference/openapi.json POST /checkout-sessions/","href":"/api-reference/payments/checkout-create"},{"title":"Lister ses sessions de checkout","openapi":"api-reference/openapi.json GET /checkout-sessions/","href":"/api-reference/payments/checkout-list"},{"title":"Détail d'une session de checkout","openapi":"api-reference/openapi.json GET /checkout-sessions/{id}/","href":"/api-reference/payments/checkout-get"},{"title":"Statut d'une session de checkout","openapi":"api-reference/openapi.json GET /checkout-sessions/{id}/status/","href":"/api-reference/payments/checkout-status"},{"title":"Annuler une session de checkout","openapi":"api-reference/openapi.json POST /checkout-sessions/{id}/cancel/","href":"/api-reference/payments/checkout-cancel"},{"title":"Vérifier le statut d'un paiement","openapi":"api-reference/openapi.json GET /payments/{payment_id}/verify/","href":"/api-reference/payments/verify"},{"title":"Confirmer un paiement par OTP","openapi":"api-reference/openapi.json POST /payments/{payment_id}/confirm-otp/","href":"/api-reference/payments/confirm-otp"},{"title":"Relancer un paiement échoué","openapi":"api-reference/openapi.json POST /payments/{payment_id}/retry/","href":"/api-reference/payments/retry"}]},{"group":"Transactions","pages":[{"title":"Transactions","icon":"receipt","href":"/api-reference/transactions"},{"title":"Lister ses transactions","openapi":"api-reference/openapi.json GET /transactions/","href":"/api-reference/transactions/list"},{"title":"Détail d'une transaction","openapi":"api-reference/openapi.json GET /transactions/{id}/","href":"/api-reference/transactions/get"},{"title":"Export CSV","openapi":"api-reference/openapi.json GET /transactions/export/","href":"/api-reference/transactions/export"},{"title":"Facture PDF","openapi":"api-reference/openapi.json GET /transactions/{id}/invoice/","href":"/api-reference/transactions/invoice"},{"title":"Lister les tentatives","openapi":"api-reference/openapi.json GET /transaction-attempts/","href":"/api-reference/transactions/attempts-list"},{"title":"Détail d'une tentative","openapi":"api-reference/openapi.json GET /transaction-attempts/{id}/","href":"/api-reference/transactions/attempts-get"},{"title":"Lister les changements de statut","openapi":"api-reference/openapi.json GET /transaction-status-logs/","href":"/api-reference/transactions/status-logs-list"},{"title":"Détail d'un changement de statut","openapi":"api-reference/openapi.json GET /transaction-status-logs/{id}/","href":"/api-reference/transactions/status-logs-get"}]},{"group":"Liens de paiement","pages":[{"title":"Liens de paiement","description":"Créez un lien de paiement réutilisable, à partager par email, SMS ou sur votre site.","icon":"link","href":"/api-reference/payment-links"},{"title":"Créer un lien de paiement","openapi":"api-reference/openapi.json POST /payment-links/","href":"/api-reference/payment-links/create"},{"title":"Lister ses liens","description":"Liste paginée, filtrable par marchand ou statut actif","openapi":"api-reference/openapi.json GET /payment-links/","href":"/api-reference/payment-links/list"},{"title":"Détail d'un lien","openapi":"api-reference/openapi.json GET /payment-links/{id}/","href":"/api-reference/payment-links/get"},{"title":"Modifier un lien","openapi":"api-reference/openapi.json PATCH /payment-links/{id}/","href":"/api-reference/payment-links/update"},{"title":"Supprimer un lien","openapi":"api-reference/openapi.json DELETE /payment-links/{id}/","href":"/api-reference/payment-links/delete"},{"title":"Transactions issues d'un lien","openapi":"api-reference/openapi.json GET /payment-links/{id}/transactions/","href":"/api-reference/payment-links/transactions"}]},{"group":"Décaissements","pages":[{"title":"Retraits","icon":"paper-plane","href":"/api-reference/payouts"},{"title":"Initier un payout","openapi":"api-reference/openapi.json POST /payouts/initialize/","href":"/api-reference/payouts/initialize"},{"title":"Vérifier le statut d'un payout","openapi":"api-reference/openapi.json GET /payouts/{payout_id}/verify/","href":"/api-reference/payouts/verify"}]},{"group":"Solde \u0026 taux de change","pages":[{"title":"Wallet","icon":"wallet","href":"/api-reference/wallet"},{"title":"Lister les soldes","openapi":"api-reference/openapi.json GET /merchant-balances/","href":"/api-reference/wallet/balances-list"},{"title":"Récupérer un solde","openapi":"api-reference/openapi.json GET /merchant-balances/{id}/","href":"/api-reference/wallet/balances-get"},{"title":"Lister les taux de change","openapi":"api-reference/openapi.json GET /exchange-rates/","href":"/api-reference/wallet/exchange-rates-list"},{"title":"Lister les transferts interwallet","openapi":"api-reference/openapi.json GET /wallet-transfers/","href":"/api-reference/wallet/wallet-transfers-list"},{"title":"Initier un transfert interwallet","openapi":"api-reference/openapi.json POST /wallet-transfers/","href":"/api-reference/wallet/wallet-transfers-create"},{"title":"Récupérer un transfert interwallet","openapi":"api-reference/openapi.json GET /wallet-transfers/{id}/","href":"/api-reference/wallet/wallet-transfers-get"}]},{"group":"Webhooks","pages":[{"title":"Webhooks","icon":"webhook","href":"/api-reference/webhooks"},{"title":"Lister vos points de réception","openapi":"api-reference/openapi.json GET /merchant-webhooks/","href":"/api-reference/webhooks/list"},{"title":"Récupérer un point de réception","openapi":"api-reference/openapi.json GET /merchant-webhooks/{id}/","href":"/api-reference/webhooks/get"},{"title":"Lister vos abonnements","openapi":"api-reference/openapi.json GET /merchant-webhook-subscriptions/","href":"/api-reference/webhooks/subscriptions-list"},{"title":"Récupérer un abonnement","openapi":"api-reference/openapi.json GET /merchant-webhook-subscriptions/{id}/","href":"/api-reference/webhooks/subscriptions-get"},{"title":"Lister l'historique de livraison","openapi":"api-reference/openapi.json GET /webhook-logs/","href":"/api-reference/webhooks/logs-list"},{"title":"Récupérer une livraison","openapi":"api-reference/openapi.json GET /webhook-logs/{id}/","href":"/api-reference/webhooks/logs-get"}]},{"group":"Référentiels","pages":[{"title":"Introduction","icon":"globe","href":"/api-reference/reference"},{"title":"Pays, réseaux et format du téléphone","icon":"table","href":"/api-reference/reference/formats"},{"title":"Lister les pays","openapi":"api-reference/openapi.json GET /countries/","href":"/api-reference/reference/countries"},{"title":"Détail d'un pays","openapi":"api-reference/openapi.json GET /countries/{id}/","href":"/api-reference/reference/country-get"},{"title":"Lister les réseaux","openapi":"api-reference/openapi.json GET /networks/","href":"/api-reference/reference/networks"},{"title":"Détail d'un réseau","openapi":"api-reference/openapi.json GET /networks/{id}/","href":"/api-reference/reference/network-get"},{"title":"Consulter mes tarifs","openapi":"api-reference/openapi.json GET /pricing/my-rates/","href":"/api-reference/reference/my-rates"}]}]}]},"title":"Créer un lien de paiement - AlphaPay","buildId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","deploymentId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DmVyH30O.js","utils-BHQqGGOd.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CD-E4BIt.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp5Lq9Ds.js","snippetPresets-C4xAVCFP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CgXVLxUC.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BF8I5oUf.js","shallow-Byd0lWnC.js","getApiPlaygroundDisplay-BGOZG1OK.js","CodeSnippet-CpvQL0CY.js","CodeSnippets-B8wkBKXa.js","Page-CBCH2P7b.js","getPastedJson-Ry3scI3Y.js","icon-D7a9HcdD.js","MethodPill-CJ8pmHhz.js","DuplicateIcon-rh1HJF0t.js","createIcon-DvGznqYs.js","DynamicMarkdown-Cc6AuSHS.js","SectionHeading-B4A0S-ep.js","axios-vUo_bRtp.js","Markdown-Cc16CX65.js","clsx-Cs6nMGht.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-zbf22OZA.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-C_fs-y5n.js"]}