Purchase an eSIM plan. Your wallet is debited at price_ngn. When plan_status is 0 the eSIM is still provisioning — poll My eSIMs (or wait for the webhook) until it becomes 1. plan_status: 0 processing, 1 success, 2 failed (auto-refunded).
Purchases an eSIM plan and debits your wallet at price_ngn.
Provisioning & status
eSIMs provision asynchronously, so read data.plan_status:
plan_status
Meaning
What to do
1
Provisioned
iccid, ac and qr_code are ready — install now
0
Still provisioning
Poll My eSIMs (or wait for the webhook) until it turns 1
2
Failed
Wallet is auto-refunded
Installing the eSIM
Give the customer the qr_code image to scan, or the ac (an LPA:1$... activation string) to install manually.
Send a unique request-id to make retries safe — the same id returns the original purchase instead of charging again.
Authorizations
Authorization
string
header
required
Send your API key as Token <your_api_key>.
Use your live key for real transactions, or your sandbox key (sk_test_…) to test — sandbox calls return a realistic simulated result and never touch your wallet. Add "sandbox_status": "fail" to any sandbox request to simulate a failure.
Body
application/json
plan_id
integer
required
eSIM plan ID from List eSIM Plans
pin
string
4-digit transaction PIN (WEBSITE only, when enabled)
request-id
string
Optional unique idempotency key
Response
200 - application/json
Success
status
string
message
string
data
object
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Bilalsadasub","description":"Bilalsadasub developer API — buy data, airtime, cable, electricity, bulk SMS, exam pins, airtime-to-cash and flights, funded from your wallet.","colors":{"primary":"#1D4ED8","light":"#3B82F6","dark":"#1E3A8A"},"logo":{"light":"https://bilalsadasub.com/brand_lockup.webp","dark":"https://bilalsadasub.com/brand_lockup.webp"},"favicon":"https://bilalsadasub.com/logo_icon.png","api":{"openapi":"https://bilalsadasub.com/openapi.json","playground":{"display":"interactive"}},"navbar":{"primary":{"type":"button","label":"Dashboard","href":"https://app.bilalsadasub.com"}},"footer":{"socials":{"website":"https://bilalsadasub.com"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"bilalsadasub-com","hasAudioNarration":false,"actualSubdomain":"bilalsadasub-com","customDomains":["docs.bilalsadasub.com"],"gitSource":{"type":"github","owner":"mintlify-community","repo":"docs-ade-2121daa2-25fd5941","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6ada85aa3650fcdd2dd1d391","clientVersion":"0.0.4271","searchFilterCounts":[{"language":"default","tag":"API Reference","count":37},{"language":"default","tag":"Flights","count":9},{"language":"default","tag":"Purchases","count":8},{"language":"default","tag":"Guides","count":6},{"language":"default","tag":"Catalogs","count":4},{"language":"default","tag":"eSIM","count":4},{"language":"default","tag":"Smile / Alpha / Kirani","count":4},{"language":"default","tag":"Get Started","count":3},{"language":"default","tag":"Resources","count":3},{"language":"default","tag":"Recharge \u0026 Data Cards","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":"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":"site-roles","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":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"reference/esim-buy","slug":"/reference/esim-buy","pageMetadata":{"title":"Buy eSIM","openapi":"POST /api/esim/buy","description":"Purchase an eSIM plan. Your wallet is debited at `price_ngn`. When `plan_status` is `0` the eSIM is still provisioning — poll My eSIMs (or wait for the webhook) until it becomes `1`. plan_status: 0 processing, 1 success, 2 failed (auto-refunded).","href":"/reference/esim-buy"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Purchase an eSIM plan. Your wallet is debited at \", _jsx(_components.code, {\n children: \"price_ngn\"\n }), \". When \", _jsx(_components.code, {\n children: \"plan_status\"\n }), \" is \", _jsx(_components.code, {\n children: \"0\"\n }), \" the eSIM is still provisioning — poll My eSIMs (or wait for the webhook) until it becomes \", _jsx(_components.code, {\n children: \"1\"\n }), \". plan_status: 0 processing, 1 success, 2 failed (auto-refunded).\"]\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`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Heading,Note,Table}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Purchases an eSIM plan and debits your wallet at `,_jsx(_components.code,{children:`price_ngn`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`provisioning-\u0026-status`,children:`Provisioning \u0026 status`}),`\n`,_jsxs(_components.p,{children:[`eSIMs provision asynchronously, so read `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`data.plan_status`})}),`:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:_jsx(_components.code,{children:`plan_status`})}),_jsx(_components.th,{children:`Meaning`}),_jsx(_components.th,{children:`What to do`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`1`})}),_jsx(_components.td,{children:`Provisioned`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`iccid`}),`, `,_jsx(_components.code,{children:`ac`}),` and `,_jsx(_components.code,{children:`qr_code`}),` are ready — install now`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`0`})}),_jsx(_components.td,{children:`Still provisioning`}),_jsxs(_components.td,{children:[`Poll `,_jsx(_components.a,{href:`/reference/esim-my`,children:`My eSIMs`}),` (or wait for the webhook) until it turns `,_jsx(_components.code,{children:`1`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`2`})}),_jsx(_components.td,{children:`Failed`}),_jsxs(_components.td,{children:[`Wallet is `,_jsx(_components.strong,{children:`auto-refunded`})]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`installing-the-esim`,children:`Installing the eSIM`}),`\n`,_jsxs(_components.p,{children:[`Give the customer the `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`qr_code`})}),` image to scan, or the `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`ac`})}),` (an `,_jsx(_components.code,{children:`LPA:1$...`}),` activation string) to install manually.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Send a unique `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`request-id`})}),` to make retries safe — the same id returns the original purchase instead of charging again.`]})})]})}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":"Buy eSIM","openapi":"POST /api/esim/buy","description":"Purchase an eSIM plan. Your wallet is debited at `price_ngn`. When `plan_status` is `0` the eSIM is still provisioning — poll My eSIMs (or wait for the webhook) until it becomes `1`. plan_status: 0 processing, 1 success, 2 failed (auto-refunded).","href":"/reference/esim-buy"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Provisioning \u0026 status","slug":"provisioning-\u0026-status","depth":2,"children":[]},{"title":"Installing the eSIM","slug":"installing-the-esim","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Buy eSIM","tags":["eSIM"],"description":"Purchase an eSIM plan. Your wallet is debited at `price_ngn`. When `plan_status` is `0` the eSIM is still provisioning — poll My eSIMs (or wait for the webhook) until it becomes `1`. plan_status: 0 processing, 1 success, 2 failed (auto-refunded).","requestBody":"602376a6-f7b9-46a6-8008-016882700aea","responses":{"200":"132a3648-584d-4cb2-8aaa-510f84e8d5ef"},"method":"post","type":"path","servers":["3dadd86c-1cfa-4bb6-91ab-b7863ea294dd"],"security":["78ecb7a6-a02e-4043-9444-ae47de4933eb"],"path":"/api/esim/buy","baseUrlOptions":["https://bilalsadasub.com"],"title":"Buy eSIM","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"plan_id":{"type":"integer","description":"eSIM plan ID from List eSIM Plans","isRequired":true,"uniqueKey":"plan_id","typeLabel":"integer"},"pin":{"type":"string","description":"4-digit transaction PIN (WEBSITE only, when enabled)","uniqueKey":"pin","typeLabel":"string"},"request-id":{"type":"string","description":"Optional unique idempotency key","uniqueKey":"request-id","typeLabel":"string"}},"required":["plan_id"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"plan_id":123,"pin":"\u003cstring>","request-id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"132a3648-584d-4cb2-8aaa-510f84e8d5ef":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","uniqueKey":"status","typeLabel":"string"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"data":{"type":"object","properties":{"transid":{"type":"string","description":"Transaction reference (use with Requery)","uniqueKey":"data.transid","typeLabel":"string"},"order_no":{"type":"string","description":"Provider order number (may be null until provisioned)","uniqueKey":"data.order_no","typeLabel":"string"},"iccid":{"type":"string","description":"eSIM ICCID (null until provisioned)","uniqueKey":"data.iccid","typeLabel":"string"},"ac":{"type":"string","description":"Activation code / LPA string","uniqueKey":"data.ac","typeLabel":"string"},"qr_code":{"type":"string","description":"QR code image URL for installation","uniqueKey":"data.qr_code","typeLabel":"string"},"newbal":{"type":"number","description":"Wallet balance after the debit","uniqueKey":"data.newbal","typeLabel":"number"},"plan_status":{"type":"integer","description":"0 processing, 1 success, 2 failed","uniqueKey":"data.plan_status","typeLabel":"integer"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"status":"success","message":"USA 5GB / 30 Days purchased.","data":{"transid":"ES_1a2b3c","order_no":"B24101700001","iccid":"8910300000000123456","ac":"LPA:1$rsp.truphone.com$QR-G4-XXXX","qr_code":"https://bilalsadasub.com/storage/esim/qr/ES_1a2b3c.png","newbal":110225.5,"plan_status":1}},"examples":{"Example":{"title":"Example","value":{"status":"success","message":"USA 5GB / 30 Days purchased.","data":{"transid":"ES_1a2b3c","order_no":"B24101700001","iccid":"8910300000000123456","ac":"LPA:1$rsp.truphone.com$QR-G4-XXXX","qr_code":"https://bilalsadasub.com/storage/esim/qr/ES_1a2b3c.png","newbal":110225.5,"plan_status":1}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"78ecb7a6-a02e-4043-9444-ae47de4933eb":{"TokenAuth":{"type":"apiKey","in":"header","name":"Authorization","description":"Send your API key as `Token \u003cyour_api_key>`.\n\nUse your **live key** for real transactions, or your **sandbox key** (`sk_test_…`) to test — sandbox calls return a realistic simulated result and never touch your wallet. Add `\"sandbox_status\": \"fail\"` to any sandbox request to simulate a failure.","scopes":[],"schemeName":"TokenAuth"}}},"servers":{"3dadd86c-1cfa-4bb6-91ab-b7863ea294dd":{"url":"https://bilalsadasub.com","description":"Production (live — charges your wallet)"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"Authorization","description":"Send your API key as `Token \u003cyour_api_key>`.\n\nUse your **live key** for real transactions, or your **sandbox key** (`sk_test_…`) to test — sandbox calls return a realistic simulated result and never touch your wallet. Add `\"sandbox_status\": \"fail\"` to any sandbox request to simulate a failure.","scopes":[],"schemeName":"TokenAuth"},"schema":{"title":"Authorization","type":"string","description":"Send your API key as `Token \u003cyour_api_key>`.\n\nUse your **live key** for real transactions, or your **sandbox key** (`sk_test_…`) to test — sandbox calls return a realistic simulated result and never touch your wallet. Add `\"sandbox_status\": \"fail\"` to any sandbox request to simulate a failure.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"TokenAuth","name":"Authorization"}],"title":"TokenAuth"}]},"originalFileLocation":"https://bilalsadasub.com/openapi.json"},"subdomain":"bilalsadasub-com","siteName":"Bilalsadasub","title":"Buy eSIM - Bilalsadasub","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-22T21:27:18.454Z","originalFileLocation":"reference/esim-buy.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=\"Purchase an eSIM plan. Your wallet is debited at price_ngn. When plan_status is 0 the eSIM is still provisioning — poll My eSIMs (or wait for the webhook) until it becomes 1. plan_status: 0 processing, 1 success, 2 failed (auto-refunded).\">\u003cmeta data-mint-head name=\"application-name\" content=\"Bilalsadasub\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://bilalsadasub.com/logo_icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://bilalsadasub.com/logo_icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://bilalsadasub.com/logo_icon.png\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/png\" href=\"https://bilalsadasub.com/logo_icon.png\">\u003cmeta data-mint-head property=\"og:title\" content=\"Buy eSIM - Bilalsadasub\">\u003cmeta data-mint-head property=\"og:description\" content=\"Purchase an eSIM plan. Your wallet is debited at price_ngn. When plan_status is 0 the eSIM is still provisioning — poll My eSIMs (or wait for the webhook) until it becomes 1. plan_status: 0 processing, 1 success, 2 failed (auto-refunded).\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Bilalsadasub\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.bilalsadasub.com/reference/esim-buy\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://bilalsadasub-com.mintlify.site/_mintlify/api/og/v2?division=eSIM\u0026amp;title=Buy+eSIM\u0026amp;description=Purchase+an+eSIM+plan.+Your+wallet+is+debited+at+%60price_ngn%60.+When+%60plan_status%60+is+%600%60+the+eSIM+is+still+provisioning+%E2%80%94+poll+My+eSIMs+%28or+wait+for+the+webhook%29\u0026amp;theme=8b20832f109be403953f6a8c\u0026amp;signature=d56f757e880414d98534a6f2d32bd3b4e47cca8a633794124dee4a12d3c3184f\">\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=\"Buy eSIM - Bilalsadasub\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Purchase an eSIM plan. Your wallet is debited at price_ngn. When plan_status is 0 the eSIM is still provisioning — poll My eSIMs (or wait for the webhook) until it becomes 1. plan_status: 0 processing, 1 success, 2 failed (auto-refunded).\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://bilalsadasub-com.mintlify.site/_mintlify/api/og/v2?division=eSIM\u0026amp;title=Buy+eSIM\u0026amp;description=Purchase+an+eSIM+plan.+Your+wallet+is+debited+at+%60price_ngn%60.+When+%60plan_status%60+is+%600%60+the+eSIM+is+still+provisioning+%E2%80%94+poll+My+eSIMs+%28or+wait+for+the+webhook%29\u0026amp;theme=8b20832f109be403953f6a8c\u0026amp;signature=d56f757e880414d98534a6f2d32bd3b4e47cca8a633794124dee4a12d3c3184f\">\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=\"https://mintlify.s3.us-west-1.amazonaws.com/bilalsadasub-com/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Bilalsadasub\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1D4ED8\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.bilalsadasub.com/reference/esim-buy\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/reference/esim-buy.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.bilalsadasub.com/#organization\",\"name\":\"Bilalsadasub\",\"url\":\"https://docs.bilalsadasub.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://bilalsadasub.com/brand_lockup.webp\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.bilalsadasub.com#website\",\"name\":\"Bilalsadasub\",\"url\":\"https://docs.bilalsadasub.com\",\"publisher\":{\"@id\":\"https://docs.bilalsadasub.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.bilalsadasub.com/reference/esim-buy#webpage\",\"url\":\"https://docs.bilalsadasub.com/reference/esim-buy\",\"name\":\"Buy eSIM\",\"description\":\"Purchase an eSIM plan. Your wallet is debited at price_ngn. When plan_status is 0 the eSIM is still provisioning — poll My eSIMs (or wait for the webhook) until it becomes 1. plan_status: 0 processing, 1 success, 2 failed (auto-refunded).\",\"dateModified\":\"2026-10-22T21:27:18.454Z\",\"isPartOf\":{\"@id\":\"https://docs.bilalsadasub.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.bilalsadasub.com/reference/esim-buy#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.bilalsadasub.com/reference/esim-buy#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"eSIM\",\"item\":\"https://docs.bilalsadasub.com/reference/esim-plans\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Buy eSIM\",\"item\":\"https://docs.bilalsadasub.com/reference/esim-buy\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.bilalsadasub.com/reference/esim-buy#apireference\",\"headline\":\"Buy eSIM\",\"name\":\"Buy eSIM\",\"description\":\"Purchase an eSIM plan. Your wallet is debited at price_ngn. When plan_status is 0 the eSIM is still provisioning — poll My eSIMs (or wait for the webhook) until it becomes 1. plan_status: 0 processing, 1 success, 2 failed (auto-refunded).\",\"url\":\"https://docs.bilalsadasub.com/reference/esim-buy\",\"mainEntityOfPage\":{\"@id\":\"https://docs.bilalsadasub.com/reference/esim-buy#webpage\"},\"dateModified\":\"2026-10-22T21:27:18.454Z\",\"publisher\":{\"@id\":\"https://docs.bilalsadasub.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.bilalsadasub.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Bilalsadasub\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Bilalsadasub\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/reference/esim-buy.md","siteName":"Bilalsadasub","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API Reference","groups":[{"group":"Authentication","pages":[{"title":"Generate Access Token","openapi":"POST /api/user","href":"/reference/generate-token"}]},{"group":"Purchases","pages":[{"title":"Buy Data","openapi":"POST /api/data","href":"/reference/data"},{"title":"Buy Airtime","openapi":"POST /api/topup","href":"/reference/airtime"},{"title":"Cable Subscription","openapi":"POST /api/cable","href":"/reference/cable"},{"title":"Pay Electricity Bill","openapi":"POST /api/bill","href":"/reference/electricity"},{"title":"Send Bulk SMS","openapi":"POST /api/bulksms","href":"/reference/bulksms"},{"title":"Buy Exam Pins","openapi":"POST /api/exam","href":"/reference/exam"},{"title":"Requery Transaction","openapi":"GET /api/requery/{reference}","href":"/reference/requery"},{"title":"List Transactions","openapi":"GET /api/v1/transactions","href":"/reference/transactions"}]},{"group":"Verification","pages":[{"title":"Verify Smartcard","openapi":"GET /api/cable/cable-validation","href":"/reference/verify-smartcard"},{"title":"Verify Meter","openapi":"GET /api/bill/bill-validation","href":"/reference/verify-meter"}]},{"group":"Catalogs","pages":[{"title":"List Data Plans","openapi":"GET /api/v1/plans/data","href":"/reference/data-plans"},{"title":"List Networks","openapi":"GET /api/v1/plans/networks","href":"/reference/networks"},{"title":"List Cable Plans","openapi":"GET /api/v1/plans/cable","href":"/reference/cable-plans"},{"title":"List DISCOs","openapi":"GET /api/v1/plans/discos","href":"/reference/discos"}]},{"group":"Wallet","pages":[{"title":"Airtime to Cash","openapi":"POST /api/cash","href":"/reference/airtime-to-cash"}]},{"group":"eSIM","pages":[{"title":"List eSIM Plans","openapi":"GET /api/esim/plans","description":"Catalogue of travel eSIM data plans, grouped by location. Requires your API key. Each plan id is the plan_id for Buy eSIM; price_ngn is what your wallet is charged.","href":"/reference/esim-plans"},{"title":"Buy eSIM","openapi":"POST /api/esim/buy","href":"/reference/esim-buy"},{"title":"Top up eSIM","openapi":"POST /api/esim/topup","description":"Add another data plan to an eSIM you already own. Only plans where topup_supported is true can be used. Wallet is debited; a failed top-up auto-refunds.","href":"/reference/esim-topup"},{"title":"My eSIMs","openapi":"GET /api/esim/my-esims","href":"/reference/esim-my"}]},{"group":"Smile / Alpha / Kirani","pages":[{"title":"List SAK Plans","openapi":"GET /api/sak/plans","href":"/reference/sak-plans"},{"title":"Buy SAK Bundle","openapi":"POST /api/sak","href":"/reference/sak-buy"},{"title":"List SAK Numbers","openapi":"GET /api/sak/sim","href":"/reference/sak-sim"},{"title":"Buy SAK Numbers","openapi":"POST /api/sak/sim/buy","href":"/reference/sak-sim-buy"}]},{"group":"Flights","pages":[{"title":"Search Flights","openapi":"GET /api/flight/search","href":"/reference/flight-search"},{"title":"Search Airports","openapi":"GET /api/flight/airports","href":"/reference/flight-airports"},{"title":"List Airlines","openapi":"GET /api/flight/airlines","href":"/reference/flight-airlines"},{"title":"Add-on Pricing","openapi":"GET /api/flight/addons","href":"/reference/flight-addons"},{"title":"Book Flight","openapi":"POST /api/flight/book","href":"/reference/flight-book"},{"title":"My Flight Bookings","openapi":"GET /api/flight/bookings","href":"/reference/flight-bookings"},{"title":"Get Flight Booking","openapi":"GET /api/flight/booking/{reference}","href":"/reference/flight-booking"},{"title":"Download Ticket","openapi":"GET /api/flight/booking/{reference}/ticket","href":"/reference/flight-ticket"},{"title":"Cancel Flight Booking","openapi":"POST /api/flight/booking/{reference}/cancel","href":"/reference/flight-cancel"}]},{"group":"Gift Cards","pages":[{"title":"List Gift Cards","openapi":"GET /api/giftcard/plans","href":"/reference/giftcard-plans"},{"title":"Buy Gift Card","openapi":"POST /api/giftcard/buy","href":"/reference/giftcard-buy"}]},{"group":"Recharge \u0026 Data Cards","pages":[{"title":"Buy Data Card","openapi":"POST /api/data_card","href":"/reference/data-card"},{"title":"Buy Recharge Card","openapi":"POST /api/recharge_card","href":"/reference/recharge-card"}]}]}]},"basePath":"","title":"Buy eSIM - Bilalsadasub","deploymentId":"dpl_Em2U4NQQ2N2DE3HPbPUJVZLnAtvc","buildId":"dpl_Em2U4NQQ2N2DE3HPbPUJVZLnAtvc","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-_HcdDqS2.js","snippetPresets-CXnm-WO6.js","utils-Dg59J__o.js","style-to-object-BY3JEAdk.js","utils-D8TRpdk7.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-B6QaxWc5.js","conditional-requirements-CFM0id0Q.js","cloneDeep-DeMZ-lcM.js","_Uint8Array-BjA2mcVW.js","isObject-FP1Yky1u.js","ApiExamples-cjPyMv63.js","usePlaygroundInputsStore-D7BWoaw4.js","shallow-Z1ceDNSG.js","isEqual-BObTuQrO.js","CodeSnippets-D1UZ1AE-.js","CodeSnippet-B373COAT.js","getApiPlaygroundDisplay-CfL-UuDS.js","Page-DuqezyvM.js","DynamicMarkdown-5yMTCLas.js","SectionHeading-BxT1HYfP.js","icon-DYJTTD3g.js","MethodPill-4AyycJeu.js","getPastedJson-Bp3WV6cN.js","Check2Icon-PhZu6Gry.js","axios-CsQoIw0U.js","Markdown-Dy9a8hT8.js","AssistantPageLink-87tSPwGm.js","dist-CXMB3QQU.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}