Welcome to the Fenan Pay API Reference and Playground. This section provides detailed information about the available API endpoints, request and response formats, and other essential details to help you integrate Fenan Pay into your application.
Base URL
The base URL for all API requests is:
https://api.fenanpay.com
Authentication
All API requests require authentication. Authentication is done using an API key, which is passed in the header of the request.
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"FenanPay | Ethiopian payment gateway","colors":{"primary":"#6B3BFF","light":"#EEE9FB","dark":"#1A1D3E"},"favicon":"/fenan-favicon.svg","logo":{"light":"https://mintcdn.com/aquilaict/tBPG3wBNdA5C1BHy/logo/light.svg?fit=max\u0026auto=format\u0026n=tBPG3wBNdA5C1BHy\u0026q=85\u0026s=6e79226ef8e4afc381ab71ebfb00796e","dark":"https://mintcdn.com/aquilaict/tBPG3wBNdA5C1BHy/logo/dark.svg?fit=max\u0026auto=format\u0026n=tBPG3wBNdA5C1BHy\u0026q=85\u0026s=a84d2615ed93fd89e021717ce60c65c1"},"navbar":{"links":[{"label":"Support","href":"mailto:support@fenanpay.com"}],"primary":{"type":"button","label":"Dashboard","href":"https://dashboard.fenanpay.com"}},"footer":{"socials":{"x":"https://x.com/fenanapay","github":"https://github.com/fenanpay","linkedin":"https://www.linkedin.com/company/fenanpay"}},"navigation":{"global":{"anchors":[{"anchor":"Documentation","href":"https://docs.fenanpay.com/","icon":"book-open-cover"},{"anchor":"Community","href":"https://t.me/fenandev","icon":"slack"},{"anchor":"Website","href":"https://landing.fenanpay.com/","icon":"globe"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"aquilaict","hasAudioNarration":false,"actualSubdomain":"aquilaict","customDomains":["docs.fenanpay.com"],"gitSource":{"type":"github","owner":"aquilaict","repo":"fenanpay-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6ae92203cc4e66da6acfbde8:success","clientVersion":"0.0.4160","searchFilterCounts":[{"language":"default","tag":"Documentation","count":12},{"language":"default","tag":"API Reference","count":7},{"language":"default","tag":"Payment","count":4},{"language":"default","tag":"Webhook","count":4},{"language":"default","tag":"Production API","count":3},{"language":"default","tag":"Sandbox API","count":3},{"language":"default","tag":"Get Started","count":2},{"language":"default","tag":"Transaction","count":2},{"language":"default","tag":"API Documentation","count":1}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/introduction","slug":"/api-reference/introduction","pageMetadata":{"title":"Introduction","description":"API endpoints Playground","href":"/api-reference/introduction"},"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: \"API endpoints Playground\"\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`,p:`p`,pre:`pre`,span:`span`,..._provideComponents(),...props.components},{CodeBlock,Heading}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`api-reference`,children:`API Reference`}),`\n`,_jsx(_components.p,{children:`Welcome to the Fenan Pay API Reference and Playground. This section provides detailed information about the available API endpoints, request and response formats, and other essential details to help you integrate Fenan Pay into your application.`}),`\n`,_jsx(Heading,{level:`3`,id:`base-url`,children:`Base URL`}),`\n`,_jsx(_components.p,{children:`The base URL for all API requests is:`}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`https://api.fenanpay.com`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`3`,id:`authentication`,children:`Authentication`}),`\n`,_jsx(_components.p,{children:`All API requests require authentication. Authentication is done using an API key, which is passed in the header of the request.`})]})}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":"Introduction","description":"API endpoints Playground","href":"/api-reference/introduction"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"API Reference","slug":"api-reference","depth":2,"children":[{"title":"Base URL","slug":"base-url","depth":3,"children":[]},{"title":"Authentication","slug":"authentication","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":[],"subdomain":"aquilaict","siteName":"FenanPay | Ethiopian payment gateway","title":"Introduction - FenanPay | Ethiopian payment gateway","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-07T03:55:43.998Z","originalFileLocation":"api-reference/introduction.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=\"API endpoints Playground\">\u003cmeta data-mint-head name=\"application-name\" content=\"FenanPay | Ethiopian payment gateway\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/aquilaict/-b8Mz1tyGbB4QR8O/_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/aquilaict/-b8Mz1tyGbB4QR8O/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/aquilaict/-b8Mz1tyGbB4QR8O/_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/aquilaict/-b8Mz1tyGbB4QR8O/_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/aquilaict/-b8Mz1tyGbB4QR8O/_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/aquilaict/-b8Mz1tyGbB4QR8O/_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/aquilaict/-b8Mz1tyGbB4QR8O/_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/aquilaict/-b8Mz1tyGbB4QR8O/_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/aquilaict/-b8Mz1tyGbB4QR8O/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Introduction - FenanPay | Ethiopian payment gateway\">\u003cmeta data-mint-head property=\"og:description\" content=\"API endpoints Playground\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"FenanPay | Ethiopian payment gateway\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.fenanpay.com/api-reference/introduction\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://aquilaict.mintlify.site/_mintlify/api/og/v2?division=API+Documentation\u0026amp;title=Introduction\u0026amp;description=API+endpoints+Playground\u0026amp;theme=f1453ca43a0240204f691ea1\u0026amp;signature=b97a99a4c60b35473cce89ad3c7587bd6780473b5035ce59d43bec83bd4fbf31\">\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=\"Introduction - FenanPay | Ethiopian payment gateway\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"API endpoints Playground\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://aquilaict.mintlify.site/_mintlify/api/og/v2?division=API+Documentation\u0026amp;title=Introduction\u0026amp;description=API+endpoints+Playground\u0026amp;theme=f1453ca43a0240204f691ea1\u0026amp;signature=b97a99a4c60b35473cce89ad3c7587bd6780473b5035ce59d43bec83bd4fbf31\">\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/aquilaict/-b8Mz1tyGbB4QR8O/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"FenanPay | Ethiopian payment gateway\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6B3BFF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.fenanpay.com/api-reference/introduction\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/introduction.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.fenanpay.com/#organization\",\"name\":\"FenanPay | Ethiopian payment gateway\",\"url\":\"https://docs.fenanpay.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/aquilaict/tBPG3wBNdA5C1BHy/logo/light.svg?fit=max\u0026auto=format\u0026n=tBPG3wBNdA5C1BHy\u0026q=85\u0026s=6e79226ef8e4afc381ab71ebfb00796e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.fenanpay.com#website\",\"name\":\"FenanPay | Ethiopian payment gateway\",\"url\":\"https://docs.fenanpay.com\",\"publisher\":{\"@id\":\"https://docs.fenanpay.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.fenanpay.com/api-reference/introduction#webpage\",\"url\":\"https://docs.fenanpay.com/api-reference/introduction\",\"name\":\"Introduction\",\"description\":\"API endpoints Playground\",\"dateModified\":\"2026-01-07T03:55:43.998Z\",\"isPartOf\":{\"@id\":\"https://docs.fenanpay.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.fenanpay.com/api-reference/introduction#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.fenanpay.com/api-reference/introduction#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"FenanPay | Ethiopian payment gateway\",\"item\":\"https://docs.fenanpay.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Introduction\",\"item\":\"https://docs.fenanpay.com/api-reference/introduction\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.fenanpay.com/api-reference/introduction#article\",\"headline\":\"Introduction\",\"name\":\"Introduction\",\"description\":\"API endpoints Playground\",\"url\":\"https://docs.fenanpay.com/api-reference/introduction\",\"mainEntityOfPage\":{\"@id\":\"https://docs.fenanpay.com/api-reference/introduction#webpage\"},\"dateModified\":\"2026-01-07T03:55:43.998Z\",\"publisher\":{\"@id\":\"https://docs.fenanpay.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.fenanpay.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"FenanPay | Ethiopian payment gateway\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"FenanPay | Ethiopian payment gateway\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/introduction.md","siteName":"FenanPay | Ethiopian payment gateway","nav":{"global":{"anchors":[{"anchor":"Documentation","href":"https://docs.fenanpay.com/","icon":"book-open-cover"},{"anchor":"Community","href":"https://t.me/fenandev","icon":"slack"},{"anchor":"Website","href":"https://landing.fenanpay.com/","icon":"globe"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"API Documentation","pages":[{"title":"Introduction","href":"/api-reference/introduction"}]},{"group":"Production API","pages":[{"title":"Express Checkout","openapi":"POST /api/v1/payment/express/pay","description":null,"href":"/api-reference/endpoint/express-pay"},{"title":"Create Payment Intent","openapi":"POST /api/v1/payment/intent","href":"/api-reference/endpoint/create-payment-link"},{"title":"Get Payment Intent","openapi":"GET /api/v1/payment/checkout/{paymentIntentId}","href":"/api-reference/endpoint/get-payment-intent"}]},{"group":"Sandbox API","pages":[{"title":"Express Checkout","openapi":"POST /api/v1/payment/express/sandbox/pay","href":"/api-reference/endpoint/express-pay-sandbox"},{"title":"Create Payment Intent","openapi":"POST /api/v1/payment/sandbox/intent","href":"/api-reference/endpoint/create-payment-link-sandbox"},{"title":"Get Payment Intent","openapi":"GET /api/v1/payment/sandbox/checkout/{paymentIntentId}","href":"/api-reference/endpoint/get-payment-intent-sandbox"}]}]}]},"basePath":"","title":"Introduction - FenanPay | Ethiopian payment gateway","buildId":"dpl_GRSyrvXT6FFTpZZTGz5iZPp3D2zE","deploymentId":"dpl_GRSyrvXT6FFTpZZTGz5iZPp3D2zE","dynamics":[],"chunks":[]}