Use the API key created under your merchant account from the HyperSwitch dashboard. API key is used to authenticate API requests from your merchant server only. Don't expose this key on a website or embed it in a mobile application.
Passing this object creates a new customer or attaches an existing customer to the payment
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"BirrPay","colors":{"primary":"#4F8EFF","light":"#6BA3FF","dark":"#2563EB"},"logo":{"light":"https://mintcdn.com/birrpay/YnpImjYt65LKI-RI/logo/light.svg?fit=max\u0026auto=format\u0026n=YnpImjYt65LKI-RI\u0026q=85\u0026s=410fca5e1e3112fa410bfe0f1bc67731","dark":"https://mintcdn.com/birrpay/541dDB4gOfow0DxB/logo/dark.svg?fit=max\u0026auto=format\u0026n=541dDB4gOfow0DxB\u0026q=85\u0026s=e38313db04f8e480c019afc36f86deed"},"favicon":"/favicon.svg","api":{"openapi":["v1/openapi_spec_v1.json","v2/openapi_spec_v2.json","rust_locker_open_api_spec.yml"]},"background":{"color":{"light":"#FAFBFC","dark":"#1d1d1d"}},"navbar":{"links":[{"href":"https://birrpay.io/contactus","label":"Contact Us"}]},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/birrpay-ethiopia"}},"integrations":{"gtm":{"tagId":"GTM-NQNN2JG5"},"mixpanel":{"projectToken":"b637c4588c180272bf586c5376e524e6"}},"contextual":{"options":["copy","claude","chatgpt","view"]},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"birrpay","hasAudioNarration":false,"actualSubdomain":"birrpay","customDomains":["docs.birrpay.io"],"gitSource":{"type":"gitlab","owner":"birrpay","repo":"hyperswitch","projectId":77700133,"deployBranch":"develop","contentDirectory":"api-reference","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a21eaf12fb2a99bab92c3fd","collectionId":"e126846c-3fdf-4d9b-8ab0-45d072d25e19","schemaVersion":"v2"},"entitlements":{},"buildId":"6a21eaf12fb2a99bab92c3fd:success","clientVersion":"0.0.3965","searchFilterCounts":[{"language":"default","tag":"Documentation","count":183},{"language":"default","tag":"Payments Core APIs","count":53},{"language":"default","tag":"Other APIs","count":35},{"language":"default","tag":"Payments Core APIs [BETA]","count":32},{"language":"default","tag":"Account management APIs","count":28},{"language":"default","tag":"Account management APIs [BETA]","count":27},{"language":"default","tag":"Payments","count":26},{"language":"default","tag":"API Reference","count":24},{"language":"default","tag":"Routing","count":17},{"language":"default","tag":"Payment Methods","count":16}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"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":"editor-v7-file-tree","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":"editor-nav-generations","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":"editor-agent-model-picker","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":"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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"v1/authentication/authentication--create","slug":"/v1/authentication/authentication--create","pageMetadata":{"openapi":"post /authentication","title":"Authentication - Create","description":"Create a new authentication for accessing our APIs from your servers.\n","href":"/v1/authentication/authentication--create","hidden":false},"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: \"Create a new authentication for accessing our APIs from your servers.\"\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"openapi":"post /authentication","title":"Authentication - Create","description":"Create a new authentication for accessing our APIs from your servers.\n","href":"/v1/authentication/authentication--create","hidden":false}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Authentication"],"summary":"Authentication - Create","description":"Create a new authentication for accessing our APIs from your servers.\n","operationId":"Create an Authentication","requestBody":"1e05a924-4d48-454f-89cd-b394b4b9b6ec","responses":{"200":"05f5edab-2536-4b02-a0ca-e6dccc8c2e4c","400":"9f79e55d-c692-4395-abc8-858d9e5c8c44"},"security":["d597c377-e928-4d8f-a03c-e33b04b47785"],"method":"post","type":"path","servers":["792875b0-3b61-48a0-ab23-731c1218999a"],"path":"/authentication","baseUrlOptions":["https://sandbox.birrpay.io"],"title":"Authentication - Create","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["amount","currency"],"properties":{"amount":{"type":"integer","format":"int64","description":"This Unit struct represents MinorUnit in which core amount works","isRequired":true,"uniqueKey":"amount","typeLabel":"integer\u003cint64>"},"currency":{"type":"string","description":"The three-letter ISO 4217 currency code (e.g., \"USD\", \"EUR\") for the payment amount. This field is mandatory for creating a payment.","enum":["AED","AFN","ALL","AMD","ANG","AOA","ARS","AUD","AWG","AZN","BAM","BBD","BDT","BGN","BHD","BIF","BMD","BND","BOB","BRL","BSD","BTN","BWP","BYN","BZD","CAD","CDF","CHF","CLF","CLP","CNY","COP","CRC","CUC","CUP","CVE","CZK","DJF","DKK","DOP","DZD","EGP","ERN","ETB","EUR","FJD","FKP","GBP","GEL","GHS","GIP","GMD","GNF","GTQ","GYD","HKD","HNL","HRK","HTG","HUF","IDR","ILS","INR","IQD","IRR","ISK","JMD","JOD","JPY","KES","KGS","KHR","KMF","KPW","KRW","KWD","KYD","KZT","LAK","LBP","LKR","LRD","LSL","LYD","MAD","MDL","MGA","MKD","MMK","MNT","MOP","MRU","MUR","MVR","MWK","MXN","MYR","MZN","NAD","NGN","NIO","NOK","NPR","NZD","OMR","PAB","PEN","PGK","PHP","PKR","PLN","PYG","QAR","RON","RSD","RUB","RWF","SAR","SBD","SCR","SDG","SEK","SGD","SHP","SLE","SLL","SOS","SRD","SSP","STD","STN","SVC","SYP","SZL","THB","TJS","TMT","TND","TOP","TRY","TTD","TWD","TZS","UAH","UGX","USD","UYU","UZS","VES","VND","VUV","WST","XAF","XCD","XOF","XPF","YER","ZAR","ZMW","ZWL"],"isRequired":true,"uniqueKey":"currency","typeLabel":"enum\u003cstring>"},"authentication_id":{"oneOf":[{"type":"string","description":"The unique identifier for this authentication.","example":"auth_mbabizu24mvu3mela5njyhpit4","uniqueKey":"authentication_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"The unique identifier for this authentication.","example":"auth_mbabizu24mvu3mela5njyhpit4","uniqueKey":"authentication_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication_id","typeLabel":"string | null"},"profile_id":{"oneOf":[{"type":"string","description":"The business profile that is associated with this authentication","uniqueKey":"profile_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"The business profile that is associated with this authentication","uniqueKey":"profile_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"profile_id","typeLabel":"string | null"},"customer":{"oneOf":[{"type":"object","description":"Passing this object creates a new customer or attaches an existing customer to the payment","required":["id"],"properties":{"id":{"type":"string","description":"The identifier for the customer.","example":"cus_y3oqhf46pyzuxjbcn2giaqnb44","maxLength":64,"minLength":1,"isRequired":true,"uniqueKey":"customer.oneOf.0.id","typeLabel":"string"},"name":{"oneOf":[{"type":"string","description":"The customer's name","example":"John Doe","maxLength":255,"uniqueKey":"customer.oneOf.0.name.oneOf.0","typeLabel":"string"},{"type":"null","description":"The customer's name","example":"John Doe","maxLength":255,"uniqueKey":"customer.oneOf.0.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"customer.oneOf.0.name","typeLabel":"string | null"},"email":{"oneOf":[{"type":"string","description":"The customer's email address","example":"[email protected]","maxLength":255,"uniqueKey":"customer.oneOf.0.email.oneOf.0","typeLabel":"string"},{"type":"null","description":"The customer's email address","example":"[email protected]","maxLength":255,"uniqueKey":"customer.oneOf.0.email.oneOf.1","typeLabel":"null"}],"uniqueKey":"customer.oneOf.0.email","typeLabel":"string | null"},"phone":{"oneOf":[{"type":"string","description":"The customer's phone number","example":"9123456789","maxLength":10,"uniqueKey":"customer.oneOf.0.phone.oneOf.0","typeLabel":"string"},{"type":"null","description":"The customer's phone number","example":"9123456789","maxLength":10,"uniqueKey":"customer.oneOf.0.phone.oneOf.1","typeLabel":"null"}],"uniqueKey":"customer.oneOf.0.phone","typeLabel":"string | null"},"phone_country_code":{"oneOf":[{"type":"string","description":"The country code for the customer's phone number","example":"+1","maxLength":2,"uniqueKey":"customer.oneOf.0.phone_country_code.oneOf.0","typeLabel":"string"},{"type":"null","description":"The country code for the customer's phone number","example":"+1","maxLength":2,"uniqueKey":"customer.oneOf.0.phone_country_code.oneOf.1","typeLabel":"null"}],"uniqueKey":"customer.oneOf.0.phone_country_code","typeLabel":"string | null"},"tax_registration_id":{"oneOf":[{"type":"string","description":"The tax registration identifier of the customer.","maxLength":255,"uniqueKey":"customer.oneOf.0.tax_registration_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"The tax registration identifier of the customer.","maxLength":255,"uniqueKey":"customer.oneOf.0.tax_registration_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"customer.oneOf.0.tax_registration_id","typeLabel":"string | null"}},"uniqueKey":"customer.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"customer.oneOf.1","typeLabel":"null"}],"uniqueKey":"customer","typeLabel":"object | null"},"authentication_connector":{"oneOf":[{"type":"string","enum":["threedsecureio","netcetera","gpayments","ctp_mastercard","unified_authentication_service","juspaythreedsserver","ctp_visa","cardinal"],"uniqueKey":"authentication_connector.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"authentication_connector.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication_connector","typeLabel":"enum\u003cstring> | null"},"return_url":{"oneOf":[{"type":"string","description":"The URL to which the user should be redirected after authentication.","example":"https://example.com/redirect","uniqueKey":"return_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"The URL to which the user should be redirected after authentication.","example":"https://example.com/redirect","uniqueKey":"return_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"return_url","typeLabel":"string | null"},"force_3ds_challenge":{"oneOf":[{"type":"boolean","description":"Force 3DS challenge.","uniqueKey":"force_3ds_challenge.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Force 3DS challenge.","uniqueKey":"force_3ds_challenge.oneOf.1","typeLabel":"null"}],"uniqueKey":"force_3ds_challenge","typeLabel":"boolean | null"},"psd2_sca_exemption_type":{"oneOf":[{"type":"string","description":"SCA Exemptions types available for authentication","enum":["low_value","transaction_risk_analysis"],"uniqueKey":"psd2_sca_exemption_type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"psd2_sca_exemption_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"psd2_sca_exemption_type","typeLabel":"enum\u003cstring> | null"},"profile_acquirer_id":{"oneOf":[{"type":"string","description":"Profile Acquirer ID get from profile acquirer configuration","uniqueKey":"profile_acquirer_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Profile Acquirer ID get from profile acquirer configuration","uniqueKey":"profile_acquirer_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"profile_acquirer_id","typeLabel":"string | null"},"acquirer_details":{"oneOf":[{"type":"object","properties":{"acquirer_bin":{"oneOf":[{"type":"string","description":"The bin of the card.","example":"123456","uniqueKey":"acquirer_details.oneOf.0.acquirer_bin.oneOf.0","typeLabel":"string"},{"type":"null","description":"The bin of the card.","example":"123456","uniqueKey":"acquirer_details.oneOf.0.acquirer_bin.oneOf.1","typeLabel":"null"}],"uniqueKey":"acquirer_details.oneOf.0.acquirer_bin","typeLabel":"string | null"},"acquirer_merchant_id":{"oneOf":[{"type":"string","description":"The merchant id of the card.","example":"merchant_abc","uniqueKey":"acquirer_details.oneOf.0.acquirer_merchant_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"The merchant id of the card.","example":"merchant_abc","uniqueKey":"acquirer_details.oneOf.0.acquirer_merchant_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"acquirer_details.oneOf.0.acquirer_merchant_id","typeLabel":"string | null"},"merchant_country_code":{"oneOf":[{"type":"string","description":"The country code of the card.","example":"US/34456","uniqueKey":"acquirer_details.oneOf.0.merchant_country_code.oneOf.0","typeLabel":"string"},{"type":"null","description":"The country code of the card.","example":"US/34456","uniqueKey":"acquirer_details.oneOf.0.merchant_country_code.oneOf.1","typeLabel":"null"}],"uniqueKey":"acquirer_details.oneOf.0.merchant_country_code","typeLabel":"string | null"}},"uniqueKey":"acquirer_details.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"acquirer_details.oneOf.1","typeLabel":"null"}],"uniqueKey":"acquirer_details","typeLabel":"object | null"},"customer_details":{"oneOf":[{"type":"object","description":"Passing this object creates a new customer or attaches an existing customer to the payment","required":["id"],"properties":{"id":{"type":"string","description":"The identifier for the customer.","example":"cus_y3oqhf46pyzuxjbcn2giaqnb44","maxLength":64,"minLength":1,"isRequired":true,"uniqueKey":"customer_details.oneOf.0.id","typeLabel":"string"},"name":{"oneOf":[{"type":"string","description":"The customer's name","example":"John Doe","maxLength":255,"uniqueKey":"customer_details.oneOf.0.name.oneOf.0","typeLabel":"string"},{"type":"null","description":"The customer's name","example":"John Doe","maxLength":255,"uniqueKey":"customer_details.oneOf.0.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"customer_details.oneOf.0.name","typeLabel":"string | null"},"email":{"oneOf":[{"type":"string","description":"The customer's email address","example":"[email protected]","maxLength":255,"uniqueKey":"customer_details.oneOf.0.email.oneOf.0","typeLabel":"string"},{"type":"null","description":"The customer's email address","example":"[email protected]","maxLength":255,"uniqueKey":"customer_details.oneOf.0.email.oneOf.1","typeLabel":"null"}],"uniqueKey":"customer_details.oneOf.0.email","typeLabel":"string | null"},"phone":{"oneOf":[{"type":"string","description":"The customer's phone number","example":"9123456789","maxLength":10,"uniqueKey":"customer_details.oneOf.0.phone.oneOf.0","typeLabel":"string"},{"type":"null","description":"The customer's phone number","example":"9123456789","maxLength":10,"uniqueKey":"customer_details.oneOf.0.phone.oneOf.1","typeLabel":"null"}],"uniqueKey":"customer_details.oneOf.0.phone","typeLabel":"string | null"},"phone_country_code":{"oneOf":[{"type":"string","description":"The country code for the customer's phone number","example":"+1","maxLength":2,"uniqueKey":"customer_details.oneOf.0.phone_country_code.oneOf.0","typeLabel":"string"},{"type":"null","description":"The country code for the customer's phone number","example":"+1","maxLength":2,"uniqueKey":"customer_details.oneOf.0.phone_country_code.oneOf.1","typeLabel":"null"}],"uniqueKey":"customer_details.oneOf.0.phone_country_code","typeLabel":"string | null"},"tax_registration_id":{"oneOf":[{"type":"string","description":"The tax registration identifier of the customer.","maxLength":255,"uniqueKey":"customer_details.oneOf.0.tax_registration_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"The tax registration identifier of the customer.","maxLength":255,"uniqueKey":"customer_details.oneOf.0.tax_registration_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"customer_details.oneOf.0.tax_registration_id","typeLabel":"string | null"}},"uniqueKey":"customer_details.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"customer_details.oneOf.1","typeLabel":"null"}],"uniqueKey":"customer_details","typeLabel":"object | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"amount":123,"authentication_id":"auth_mbabizu24mvu3mela5njyhpit4","profile_id":"\u003cstring>","customer":{"id":"cus_y3oqhf46pyzuxjbcn2giaqnb44","name":"John Doe","email":"[email protected]","phone":"9123456789","phone_country_code":"+1","tax_registration_id":"\u003cstring>"},"return_url":"https://example.com/redirect","force_3ds_challenge":true,"profile_acquirer_id":"\u003cstring>","acquirer_details":{"acquirer_bin":"123456","acquirer_merchant_id":"merchant_abc","merchant_country_code":"US/34456"},"customer_details":{"id":"cus_y3oqhf46pyzuxjbcn2giaqnb44","name":"John Doe","email":"[email protected]","phone":"9123456789","phone_country_code":"+1","tax_registration_id":"\u003cstring>"}}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"05f5edab-2536-4b02-a0ca-e6dccc8c2e4c":{"description":"Authentication created","content":{"application/json":{"schema":{"type":"object","required":["authentication_id","merchant_id","status","amount","currency"],"properties":{"authentication_id":{"type":"string","description":"The unique identifier for this authentication.","example":"auth_mbabizu24mvu3mela5njyhpit4","isRequired":true,"uniqueKey":"authentication_id","typeLabel":"string"},"merchant_id":{"type":"string","description":"This is an identifier for the merchant account. This is inferred from the API key\nprovided during the request","example":"merchant_abc","isRequired":true,"uniqueKey":"merchant_id","typeLabel":"string"},"status":{"type":"string","enum":["started","pending","success","failed"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"amount":{"type":"integer","format":"int64","description":"This Unit struct represents MinorUnit in which core amount works","isRequired":true,"uniqueKey":"amount","typeLabel":"integer\u003cint64>"},"currency":{"type":"string","description":"The three-letter ISO 4217 currency code (e.g., \"USD\", \"EUR\") for the payment amount. This field is mandatory for creating a payment.","enum":["AED","AFN","ALL","AMD","ANG","AOA","ARS","AUD","AWG","AZN","BAM","BBD","BDT","BGN","BHD","BIF","BMD","BND","BOB","BRL","BSD","BTN","BWP","BYN","BZD","CAD","CDF","CHF","CLF","CLP","CNY","COP","CRC","CUC","CUP","CVE","CZK","DJF","DKK","DOP","DZD","EGP","ERN","ETB","EUR","FJD","FKP","GBP","GEL","GHS","GIP","GMD","GNF","GTQ","GYD","HKD","HNL","HRK","HTG","HUF","IDR","ILS","INR","IQD","IRR","ISK","JMD","JOD","JPY","KES","KGS","KHR","KMF","KPW","KRW","KWD","KYD","KZT","LAK","LBP","LKR","LRD","LSL","LYD","MAD","MDL","MGA","MKD","MMK","MNT","MOP","MRU","MUR","MVR","MWK","MXN","MYR","MZN","NAD","NGN","NIO","NOK","NPR","NZD","OMR","PAB","PEN","PGK","PHP","PKR","PLN","PYG","QAR","RON","RSD","RUB","RWF","SAR","SBD","SCR","SDG","SEK","SGD","SHP","SLE","SLL","SOS","SRD","SSP","STD","STN","SVC","SYP","SZL","THB","TJS","TMT","TND","TOP","TRY","TTD","TWD","TZS","UAH","UGX","USD","UYU","UZS","VES","VND","VUV","WST","XAF","XCD","XOF","XPF","YER","ZAR","ZMW","ZWL"],"isRequired":true,"uniqueKey":"currency","typeLabel":"enum\u003cstring>"},"client_secret":{"oneOf":[{"type":"string","description":"The client secret for this authentication, to be used for client-side operations.","example":"auth_mbabizu24mvu3mela5njyhpit4_secret_el9ksDkiB8hi6j9N78yo","uniqueKey":"client_secret.oneOf.0","typeLabel":"string"},{"type":"null","description":"The client secret for this authentication, to be used for client-side operations.","example":"auth_mbabizu24mvu3mela5njyhpit4_secret_el9ksDkiB8hi6j9N78yo","uniqueKey":"client_secret.oneOf.1","typeLabel":"null"}],"uniqueKey":"client_secret","typeLabel":"string | null"},"authentication_connector":{"oneOf":[{"type":"string","enum":["threedsecureio","netcetera","gpayments","ctp_mastercard","unified_authentication_service","juspaythreedsserver","ctp_visa","cardinal"],"uniqueKey":"authentication_connector.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"authentication_connector.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication_connector","typeLabel":"enum\u003cstring> | null"},"force_3ds_challenge":{"oneOf":[{"type":"boolean","description":"Whether 3DS challenge was forced.","uniqueKey":"force_3ds_challenge.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether 3DS challenge was forced.","uniqueKey":"force_3ds_challenge.oneOf.1","typeLabel":"null"}],"uniqueKey":"force_3ds_challenge","typeLabel":"boolean | null"},"return_url":{"oneOf":[{"type":"string","description":"The URL to which the user should be redirected after authentication, if provided.","uniqueKey":"return_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"The URL to which the user should be redirected after authentication, if provided.","uniqueKey":"return_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"return_url","typeLabel":"string | null"},"created_at":{"oneOf":[{"type":"string","format":"date-time","example":"2022-09-10T10:11:12Z","uniqueKey":"created_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","example":"2022-09-10T10:11:12Z","uniqueKey":"created_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"created_at","typeLabel":"string\u003cdate-time> | null"},"error_code":{"oneOf":[{"type":"string","example":"E0001","uniqueKey":"error_code.oneOf.0","typeLabel":"string"},{"type":"null","example":"E0001","uniqueKey":"error_code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error_code","typeLabel":"string | null"},"error_message":{"oneOf":[{"type":"string","description":"If there was an error while calling the connector the error message is received here","example":"Failed while verifying the card","uniqueKey":"error_message.oneOf.0","typeLabel":"string"},{"type":"null","description":"If there was an error while calling the connector the error message is received here","example":"Failed while verifying the card","uniqueKey":"error_message.oneOf.1","typeLabel":"null"}],"uniqueKey":"error_message","typeLabel":"string | null"},"profile_id":{"oneOf":[{"type":"string","description":"The business profile that is associated with this payment","uniqueKey":"profile_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"The business profile that is associated with this payment","uniqueKey":"profile_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"profile_id","typeLabel":"string | null"},"psd2_sca_exemption_type":{"oneOf":[{"type":"string","description":"SCA Exemptions types available for authentication","enum":["low_value","transaction_risk_analysis"],"uniqueKey":"psd2_sca_exemption_type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"psd2_sca_exemption_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"psd2_sca_exemption_type","typeLabel":"enum\u003cstring> | null"},"acquirer_details":{"oneOf":[{"type":"object","properties":{"acquirer_bin":{"oneOf":[{"type":"string","description":"The bin of the card.","example":"123456","uniqueKey":"acquirer_details.oneOf.0.acquirer_bin.oneOf.0","typeLabel":"string"},{"type":"null","description":"The bin of the card.","example":"123456","uniqueKey":"acquirer_details.oneOf.0.acquirer_bin.oneOf.1","typeLabel":"null"}],"uniqueKey":"acquirer_details.oneOf.0.acquirer_bin","typeLabel":"string | null"},"acquirer_merchant_id":{"oneOf":[{"type":"string","description":"The merchant id of the card.","example":"merchant_abc","uniqueKey":"acquirer_details.oneOf.0.acquirer_merchant_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"The merchant id of the card.","example":"merchant_abc","uniqueKey":"acquirer_details.oneOf.0.acquirer_merchant_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"acquirer_details.oneOf.0.acquirer_merchant_id","typeLabel":"string | null"},"merchant_country_code":{"oneOf":[{"type":"string","description":"The country code of the card.","example":"US/34456","uniqueKey":"acquirer_details.oneOf.0.merchant_country_code.oneOf.0","typeLabel":"string"},{"type":"null","description":"The country code of the card.","example":"US/34456","uniqueKey":"acquirer_details.oneOf.0.merchant_country_code.oneOf.1","typeLabel":"null"}],"uniqueKey":"acquirer_details.oneOf.0.merchant_country_code","typeLabel":"string | null"}},"uniqueKey":"acquirer_details.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"acquirer_details.oneOf.1","typeLabel":"null"}],"uniqueKey":"acquirer_details","typeLabel":"object | null"},"profile_acquirer_id":{"oneOf":[{"type":"string","description":"Profile Acquirer ID get from profile acquirer configuration","uniqueKey":"profile_acquirer_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Profile Acquirer ID get from profile acquirer configuration","uniqueKey":"profile_acquirer_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"profile_acquirer_id","typeLabel":"string | null"},"customer_details":{"oneOf":[{"type":"object","description":"Passing this object creates a new customer or attaches an existing customer to the payment","required":["id"],"properties":{"id":{"type":"string","description":"The identifier for the customer.","example":"cus_y3oqhf46pyzuxjbcn2giaqnb44","maxLength":64,"minLength":1,"isRequired":true,"uniqueKey":"customer_details.oneOf.0.id","typeLabel":"string"},"name":{"oneOf":[{"type":"string","description":"The customer's name","example":"John Doe","maxLength":255,"uniqueKey":"customer_details.oneOf.0.name.oneOf.0","typeLabel":"string"},{"type":"null","description":"The customer's name","example":"John Doe","maxLength":255,"uniqueKey":"customer_details.oneOf.0.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"customer_details.oneOf.0.name","typeLabel":"string | null"},"email":{"oneOf":[{"type":"string","description":"The customer's email address","example":"[email protected]","maxLength":255,"uniqueKey":"customer_details.oneOf.0.email.oneOf.0","typeLabel":"string"},{"type":"null","description":"The customer's email address","example":"[email protected]","maxLength":255,"uniqueKey":"customer_details.oneOf.0.email.oneOf.1","typeLabel":"null"}],"uniqueKey":"customer_details.oneOf.0.email","typeLabel":"string | null"},"phone":{"oneOf":[{"type":"string","description":"The customer's phone number","example":"9123456789","maxLength":10,"uniqueKey":"customer_details.oneOf.0.phone.oneOf.0","typeLabel":"string"},{"type":"null","description":"The customer's phone number","example":"9123456789","maxLength":10,"uniqueKey":"customer_details.oneOf.0.phone.oneOf.1","typeLabel":"null"}],"uniqueKey":"customer_details.oneOf.0.phone","typeLabel":"string | null"},"phone_country_code":{"oneOf":[{"type":"string","description":"The country code for the customer's phone number","example":"+1","maxLength":2,"uniqueKey":"customer_details.oneOf.0.phone_country_code.oneOf.0","typeLabel":"string"},{"type":"null","description":"The country code for the customer's phone number","example":"+1","maxLength":2,"uniqueKey":"customer_details.oneOf.0.phone_country_code.oneOf.1","typeLabel":"null"}],"uniqueKey":"customer_details.oneOf.0.phone_country_code","typeLabel":"string | null"},"tax_registration_id":{"oneOf":[{"type":"string","description":"The tax registration identifier of the customer.","maxLength":255,"uniqueKey":"customer_details.oneOf.0.tax_registration_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"The tax registration identifier of the customer.","maxLength":255,"uniqueKey":"customer_details.oneOf.0.tax_registration_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"customer_details.oneOf.0.tax_registration_id","typeLabel":"string | null"}},"uniqueKey":"customer_details.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"customer_details.oneOf.1","typeLabel":"null"}],"uniqueKey":"customer_details","typeLabel":"object | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"authentication_id":"auth_mbabizu24mvu3mela5njyhpit4","merchant_id":"merchant_abc","status":"started","amount":123,"currency":"AED","client_secret":"auth_mbabizu24mvu3mela5njyhpit4_secret_el9ksDkiB8hi6j9N78yo","authentication_connector":"threedsecureio","force_3ds_challenge":true,"return_url":"\u003cstring>","created_at":"2022-09-10T10:11:12Z","error_code":"E0001","error_message":"Failed while verifying the card","profile_id":"\u003cstring>","psd2_sca_exemption_type":"low_value","acquirer_details":{"acquirer_bin":"123456","acquirer_merchant_id":"merchant_abc","merchant_country_code":"US/34456"},"profile_acquirer_id":"\u003cstring>","customer_details":{"id":"cus_y3oqhf46pyzuxjbcn2giaqnb44","name":"John Doe","email":"[email protected]","phone":"9123456789","phone_country_code":"+1","tax_registration_id":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"9f79e55d-c692-4395-abc8-858d9e5c8c44":{"description":"Invalid data","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"d597c377-e928-4d8f-a03c-e33b04b47785":{"api_key":{"type":"apiKey","in":"header","name":"api-key","description":"Use the API key created under your merchant account from the HyperSwitch dashboard. API key is used to authenticate API requests from your merchant server only. Don't expose this key on a website or embed it in a mobile application.","scopes":[]}}},"servers":{"792875b0-3b61-48a0-ab23-731c1218999a":{"url":"https://sandbox.birrpay.io","description":"Sandbox Environment"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"api-key","description":"Use the API key created under your merchant account from the HyperSwitch dashboard. API key is used to authenticate API requests from your merchant server only. Don't expose this key on a website or embed it in a mobile application.","scopes":[]},"schema":{"title":"api-key","type":"string","description":"Use the API key created under your merchant account from the HyperSwitch dashboard. API key is used to authenticate API requests from your merchant server only. Don't expose this key on a website or embed it in a mobile application.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"api_key","name":"api-key"}],"title":"api_key"}]},"originalFileLocation":"v1/openapi_spec_v1.json"},"subdomain":"birrpay","siteName":"BirrPay","title":"Authentication - Create - BirrPay","navMaps":{"firstHrefInVersion":{"1.0.0":{"href":"/v1/authentication/authentication--create","matchLevel":0},"2.0.0 [BETA]":{"href":"/introduction","matchLevel":3}},"firstHrefInLanguage":{}},"lastModified":"2026-01-24T02:55:15.955Z","originalFileLocation":"v1/authentication/authentication--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=\"Create a new authentication for accessing our APIs from your servers.\">\u003cmeta data-mint-head name=\"application-name\" content=\"BirrPay\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/birrpay/UMKKiD5ajm4x882S/_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/birrpay/UMKKiD5ajm4x882S/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/birrpay/UMKKiD5ajm4x882S/_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/birrpay/UMKKiD5ajm4x882S/_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/birrpay/UMKKiD5ajm4x882S/_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/birrpay/UMKKiD5ajm4x882S/_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/birrpay/UMKKiD5ajm4x882S/_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/birrpay/UMKKiD5ajm4x882S/_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/birrpay/UMKKiD5ajm4x882S/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Authentication - Create - BirrPay\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a new authentication for accessing our APIs from your servers.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"BirrPay\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.birrpay.io/v1/authentication/authentication--create\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://birrpay.mintlify.app/_mintlify/api/og/v2?division=Authentication\u0026amp;title=Authentication+-+Create\u0026amp;description=Create+a+new+authentication+for+accessing+our+APIs+from+your+servers.%0A\u0026amp;theme=838cc079bd3fa932cbeee950\u0026amp;signature=8e6e9b7e2c97cf5039727e314c2700ee36ec9053f7c658ab9f24e3ba58863163\">\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=\"Authentication - Create - BirrPay\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a new authentication for accessing our APIs from your servers.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://birrpay.mintlify.app/_mintlify/api/og/v2?division=Authentication\u0026amp;title=Authentication+-+Create\u0026amp;description=Create+a+new+authentication+for+accessing+our+APIs+from+your+servers.%0A\u0026amp;theme=838cc079bd3fa932cbeee950\u0026amp;signature=8e6e9b7e2c97cf5039727e314c2700ee36ec9053f7c658ab9f24e3ba58863163\">\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/birrpay/UMKKiD5ajm4x882S/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"BirrPay\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4F8EFF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.birrpay.io/v1/authentication/authentication--create\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/v1/authentication/authentication--create.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.birrpay.io/#organization\",\"name\":\"BirrPay\",\"url\":\"https://docs.birrpay.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/birrpay/YnpImjYt65LKI-RI/logo/light.svg?fit=max\u0026auto=format\u0026n=YnpImjYt65LKI-RI\u0026q=85\u0026s=410fca5e1e3112fa410bfe0f1bc67731\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.birrpay.io#website\",\"name\":\"BirrPay\",\"url\":\"https://docs.birrpay.io\",\"publisher\":{\"@id\":\"https://docs.birrpay.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.birrpay.io/v1/authentication/authentication--create#webpage\",\"url\":\"https://docs.birrpay.io/v1/authentication/authentication--create\",\"name\":\"Authentication - Create\",\"description\":\"Create a new authentication for accessing our APIs from your servers.\",\"dateModified\":\"2026-01-24T02:55:15.955Z\",\"isPartOf\":{\"@id\":\"https://docs.birrpay.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.birrpay.io/v1/authentication/authentication--create#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.birrpay.io/v1/authentication/authentication--create#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Payments Core APIs\",\"item\":\"https://docs.birrpay.io/v1/payments/setup--instructions\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Authentication - Create\",\"item\":\"https://docs.birrpay.io/v1/authentication/authentication--create\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.birrpay.io/v1/authentication/authentication--create#apireference\",\"headline\":\"Authentication - Create\",\"name\":\"Authentication - Create\",\"description\":\"Create a new authentication for accessing our APIs from your servers.\",\"url\":\"https://docs.birrpay.io/v1/authentication/authentication--create\",\"mainEntityOfPage\":{\"@id\":\"https://docs.birrpay.io/v1/authentication/authentication--create#webpage\"},\"dateModified\":\"2026-01-24T02:55:15.955Z\",\"publisher\":{\"@id\":\"https://docs.birrpay.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.birrpay.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"BirrPay\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"BirrPay","nav":{"global":null,"tabs":[{"tab":"Documentation","versions":[{"version":"1.0.0","groups":[{"group":"Get Started","pages":[{"title":"👋 Welcome to BirrPay API Reference","sidebarTitle":"Introduction","icon":"rectangle-code","iconType":"solid","href":"/introduction","hidden":false}]},{"group":"Essentials","pages":[{"title":"Authentication Types","href":"/essentials/authentication"},{"title":"Error Codes","href":"/essentials/error_codes"},{"title":"Rate Limits","href":"/essentials/rate_limit"},{"title":"Go-live Checklist","href":"/essentials/go-live"}]},{"group":"Payments Core APIs","pages":[{"sidebarTitle":"Setup Instructions","icon":"flag","iconType":"solid","title":null,"href":"/v1/payments/setup--instructions"},{"sidebarTitle":"Payment Flows","icon":"arrows-retweet","iconType":"solid","title":null,"href":"/v1/payments/payment--flows"},{"group":"Payments","pages":[{"openapi":"post /payments","title":"Payments - Create","href":"/v1/payments/payments--create"},{"openapi":"post /payments/{payment_id}","title":"Payments - Update","href":"/v1/payments/payments--update"},{"openapi":"post /payments/{payment_id}/confirm","title":"Payments - Confirm","href":"/v1/payments/payments--confirm"},{"openapi":"get /payments/{payment_id}","title":"Payments - Retrieve","href":"/v1/payments/payments--retrieve"},{"openapi":"post /payments/{payment_id}/cancel","title":"Payments - Cancel","href":"/v1/payments/payments--cancel"},{"openapi":"post /payments/{payment_id}/cancel_post_capture","title":"Payments - Cancel Post Capture","href":"/v1/payments/payments--cancel-post-capture"},{"openapi":"post /payments/{payment_id}/capture","title":"Payments - Capture","href":"/v1/payments/payments--capture"},{"openapi":"post /payments/{payment_id}/incremental_authorization","title":"Payments - Incremental Authorization","href":"/v1/payments/payments--incremental-authorization"},{"openapi":"post /payments/{payment_id}/extend_authorization","title":"Payments - Extended Authorization","href":"/v1/payments/payments--extend-authorization"},{"openapi":"post /payments/session_tokens","title":"Payments - Session token","href":"/v1/payments/payments--session-token"},{"openapi":"get /payment_link/{payment_link_id}","title":"Payments Link - Retrieve","href":"/v1/payments/payments-link--retrieve"},{"openapi":"get /payments/list","title":"Payments - List","href":"/v1/payments/payments--list"},{"openapi":"post /payments/{payment_id}/3ds/authentication","title":"Payments - External 3DS Authentication","href":"/v1/payments/payments--external-3ds-authentication"},{"openapi":"post /{payment_id}/complete_authorize","title":null,"href":"/v1/payments/payments--complete-authorize"},{"openapi":"post /payments/{payment_id}/update_metadata","title":"Payments - Update Metadata","href":"/v1/payments/payments--update-metadata"},{"openapi":"post /payments/{payment_id}/eligibility","title":"Payments - Submit Eligibility Data","href":"/v1/payments/payments--submit-eligibility-data"}]},{"group":"Payment Methods","pages":[{"openapi":"post /payment_methods","title":"PaymentMethods - Create","href":"/v1/payment-methods/paymentmethods--create"},{"openapi":"get /payment_methods/{method_id}","title":"Payment Method - Retrieve","href":"/v1/payment-methods/payment-method--retrieve"},{"openapi":"post /payment_methods/{method_id}/update","title":"Payment Method - Update","href":"/v1/payment-methods/payment-method--update"},{"openapi":"delete /payment_methods/{method_id}","title":"Payment Method - Delete","href":"/v1/payment-methods/payment-method--delete"},{"openapi":"post /{customer_id}/payment_methods/{payment_method_id}/default","title":"Payment Method - Set Default Payment Method for Customer","href":"/v1/payment-methods/payment-method--set-default-payment-method-for-customer"},{"openapi":"get /account/payment_methods","title":"List payment methods for a Merchant","href":"/v1/payment-methods/list-payment-methods-for-a-merchant"},{"openapi":"get /customers/payment_methods","title":"List customer saved payment methods for a Payment","href":"/v1/payment-methods/list-customer-saved-payment-methods-for-a-payment"},{"openapi":"get /customers/{customer_id}/payment_methods","title":"List payment methods for a Customer","href":"/v1/payment-methods/list-payment-methods-for-a-customer"},{"openapi":"post /{customer_id}/payment_methods/{payment_method_id}/default","title":"Payment Method - Set Default Payment Method for Customer","href":"/v1/customer-set-default-payment-method/customers--set-default-payment-method"}]},{"group":"Customers","pages":[{"openapi":"post /customers","title":"Customers - Create","href":"/v1/customers/customers--create"},{"openapi":"get /customers/{customer_id}","title":"Customers - Retrieve","href":"/v1/customers/customers--retrieve"},{"openapi":"post /customers/{customer_id}","title":"Customers - Update","href":"/v1/customers/customers--update"},{"openapi":"delete /customers/{customer_id}","title":"Customers - Delete","href":"/v1/customers/customers--delete"},{"openapi":"get /customers/list","title":"Customers - List","href":"/v1/customers/customers--list"}]},{"group":"Mandates","pages":[{"openapi":"post /mandates/revoke/{mandate_id}","title":"Mandates - Revoke Mandate","href":"/v1/mandates/mandates--revoke-mandate"},{"openapi":"get /mandates/{mandate_id}","title":"Mandates - Retrieve Mandate","href":"/v1/mandates/mandates--retrieve-mandate"},{"openapi":"post /customers/{customer_id}/mandates","title":null,"href":"/v1/mandates/mandates--customer-mandates-list"}]},{"group":"Refunds","pages":[{"openapi":"post /refunds","title":"Refunds - Create","href":"/v1/refunds/refunds--create"},{"openapi":"post /refunds/{refund_id}","title":"Refunds - Update","href":"/v1/refunds/refunds--update"},{"openapi":"get /refunds/{refund_id}","title":"Refunds - Retrieve","href":"/v1/refunds/refunds--retrieve"},{"openapi":"post /refunds/list","title":"Refunds - List","href":"/v1/refunds/refunds--list"}]},{"group":"Disputes","pages":[{"openapi":"get /disputes/{dispute_id}","title":"Disputes - Retrieve Dispute","href":"/v1/disputes/disputes--retrieve"},{"openapi":"get /disputes/list","title":"Disputes - List Disputes","description":"Lists all the Disputes for a merchant","href":"/v1/disputes/disputes--list"}]},{"group":"Authentication","pages":[{"openapi":"post /authentication","title":"Authentication - Create","href":"/v1/authentication/authentication--create"},{"openapi":"post /authentication/{authentication_id}/eligibility-check","title":"Authentication - POST Eligibility Check","description":null,"href":"/v1/authentication/authentication--post-eligibility-check"},{"openapi":"get /authentication/{authentication_id}/eligibility-check","title":"Authentication - GET Eligibility Check","href":"/v1/authentication/authentication--get-eligibility-check"}]},{"group":"Payouts","pages":[{"openapi":"post /payouts/create","title":"Payouts - Create","href":"/v1/payouts/payouts--create"},{"openapi":"post /payouts/{payout_id}","title":"Payouts - Update","href":"/v1/payouts/payouts--update"},{"openapi":"post /payouts/{payout_id}/cancel","title":"Payouts - Cancel","href":"/v1/payouts/payouts--cancel"},{"openapi":"post /payouts/{payout_id}/fulfill","title":"Payouts - Fulfill","href":"/v1/payouts/payouts--fulfill"},{"openapi":"post /payouts/{payout_id}/confirm","title":"Payouts - Confirm","href":"/v1/payouts/payouts--confirm"},{"openapi":"get /payouts/{payout_id}","title":"Payouts - Retrieve","href":"/v1/payouts/payouts--retrieve"},{"openapi":"get /payouts/list","title":"Payouts - List","href":"/v1/payouts/payouts--list"},{"openapi":"post /payouts/filter","title":"Payouts - List available filters","href":"/v1/payouts/payouts--list-filters"},{"openapi":"post /payouts/list","title":"Payouts - List using filters","href":"/v1/payouts/payouts--filter"}]}]},{"group":"Account management APIs","pages":[{"group":"Organization","pages":[{"openapi":"post /organization","title":"Organization - Create","href":"/v1/organization/organization--create"},{"openapi":"get /organization/{id}","title":"Organization - Retrieve","href":"/v1/organization/organization--retrieve"},{"openapi":"put /organization/{id}","title":"Organization - Update","href":"/v1/organization/organization--update"}]},{"group":"Merchant Account","pages":[{"openapi":"post /accounts","title":"Merchant Account - Create","href":"/v1/merchant-account/merchant-account--create"},{"openapi":"get /accounts/{account_id}","title":"Merchant Account - Retrieve","href":"/v1/merchant-account/merchant-account--retrieve"},{"openapi":"post /accounts/{account_id}","title":"Merchant Account - Update","href":"/v1/merchant-account/merchant-account--update"},{"openapi":"delete /accounts/{account_id}","title":"Merchant Account - Delete","href":"/v1/merchant-account/merchant-account--delete"},{"openapi":"post /accounts/{account_id}/kv","title":"Merchant Account - KV Status","href":"/v1/merchant-account/merchant-account--kv-status"}]},{"group":"Business Profile","pages":[{"openapi":"post /account/{account_id}/business_profile","title":"Profile - Create","href":"/v1/business-profile/business-profile--create"},{"openapi":"post /account/{account_id}/business_profile/{profile_id}","title":"Profile - Update","href":"/v1/business-profile/business-profile--update"},{"openapi":"get /account/{account_id}/business_profile/{profile_id}","title":"Profile - Retrieve","href":"/v1/business-profile/business-profile--retrieve"},{"openapi":"delete /account/{account_id}/business_profile/{profile_id}","title":"Profile - Delete","href":"/v1/business-profile/business-profile--delete"},{"openapi":"get /account/{account_id}/business_profile","title":"Profile - List","href":"/v1/business-profile/business-profile--list"}]},{"group":"Platform Account","pages":[{"openapi":"post /user/create_platform","title":"Platform - Create","href":"/v1/platform/platform--create"}]},{"group":"API Key","pages":[{"openapi":"post /api_keys/{merchant_id}","title":"API Key - Create","href":"/v1/api-key/api-key--create"},{"openapi":"get /api_keys/{merchant_id}/{key_id}","title":"API Key - Retrieve","href":"/v1/api-key/api-key--retrieve"},{"openapi":"post /api_keys/{merchant_id}/{key_id}","title":"API Key - Update","href":"/v1/api-key/api-key--update"},{"openapi":"delete /api_keys/{merchant_id}/{key_id}","title":"API Key - Revoke","href":"/v1/api-key/api-key--revoke"},{"openapi":"get /api_keys/{merchant_id}/list","title":"API Key - List","href":"/v1/api-key/api-key--list"}]},{"group":"Merchant Connector Account","pages":[{"openapi":"post /account/{account_id}/connectors","title":"Merchant Connector - Create","href":"/v1/merchant-connector-account/merchant-connector--create"},{"openapi":"get /account/{account_id}/connectors/{merchant_connector_id}","title":"Merchant Connector - Retrieve","href":"/v1/merchant-connector-account/merchant-connector--retrieve"},{"openapi":"post /account/{account_id}/connectors/{merchant_connector_id}","title":"Merchant Connector - Update","href":"/v1/merchant-connector-account/merchant-connector--update"},{"openapi":"delete /account/{account_id}/connectors/{merchant_connector_id}","title":"Merchant Connector - Delete","href":"/v1/merchant-connector-account/merchant-connector--delete"},{"openapi":"get /account/{account_id}/connectors","title":"Merchant Connector - List","href":"/v1/merchant-connector-account/merchant-connector--list"}]},{"group":"GSM (Global Status Mapping)","pages":[{"openapi":"post /gsm","title":"Gsm - Create","href":"/v1/gsm/gsm--create"},{"openapi":"post /gsm/get","title":"Gsm - Get","href":"/v1/gsm/gsm--get"},{"openapi":"post /gsm/update","title":"Gsm - Update","href":"/v1/gsm/gsm--update"},{"openapi":"post /gsm/delete","title":"Gsm - Delete","href":"/v1/gsm/gsm--delete"}]}]},{"group":"Other APIs","pages":[{"group":"Event","pages":[{"openapi":"post /events/{merchant_id}","title":"Events - List","href":"/v1/event/events--list"},{"openapi":"get /events/{merchant_id}/{event_id}/attempts","title":"Events - Delivery Attempt List","href":"/v1/event/events--delivery-attempt-list"},{"openapi":"post /events/{merchant_id}/{event_id}/retry","title":"Events - Manual Retry","href":"/v1/event/events--manual-retry"}]},{"group":"Poll","pages":[{"openapi":"get /poll/status/{poll_id}","title":"Poll - Retrieve Poll Status","href":"/v1/poll/poll--retrieve-poll-status"}]},{"group":"Blocklist","pages":[{"openapi":"get /blocklist","title":null,"href":"/v1/blocklist/get-blocklist"},{"openapi":"post /blocklist","title":null,"href":"/v1/blocklist/post-blocklist"},{"openapi":"delete /blocklist","title":null,"href":"/v1/blocklist/delete-blocklist"},{"openapi":"post /blocklist/toggle","title":null,"href":"/v1/blocklist/post-blocklisttoggle"}]},{"group":"Routing","pages":[{"openapi":"get /routing","title":"Routing - List","href":"/v1/routing/routing--list"},{"openapi":"post /routing","title":"Routing - Create","href":"/v1/routing/routing--create"},{"openapi":"post /account/{account_id}/business_profile/{profile_id}/dynamic_routing/success_based/create","title":"Routing - Auth Rate Based","href":"/v1/routing/routing--success-based"},{"openapi":"post /account/{account_id}/business_profile/{profile_id}/dynamic_routing/elimination/create","title":"Routing - Elimination","href":"/v1/routing/routing--elimination"},{"openapi":"get /routing/active","title":"Routing - Retrieve Config","href":"/v1/routing/routing--retrieve-config"},{"openapi":"post /routing/deactivate","title":"Routing - Deactivate","href":"/v1/routing/routing--deactivate"},{"openapi":"get /routing/default","title":"Routing - Retrieve Default Config","href":"/v1/routing/routing--retrieve-default-config"},{"openapi":"post /routing/default","title":"Routing - Update Default Config","href":"/v1/routing/routing--update-default-config"},{"openapi":"get /routing/default/profile","title":"Routing - Retrieve Default For Profile","href":"/v1/routing/routing--retrieve-default-for-profile"},{"openapi":"post /routing/default/profile/{profile_id}","title":"Routing - Update Default For Profile","href":"/v1/routing/routing--update-default-for-profile"},{"openapi":"get /routing/{routing_algorithm_id}","title":"Routing - Retrieve","href":"/v1/routing/routing--retrieve"},{"openapi":"post /routing/{routing_algorithm_id}/activate","title":"Routing - Activate config","href":"/v1/routing/routing--activate-config"},{"openapi":"post /routing/evaluate","title":"Routing - Evaluate","href":"/v1/routing/routing--evaluate"},{"openapi":"post /routing/feedback","title":"Routing - Feedback","href":"/v1/routing/routing--feedback"},{"openapi":"post /routing/rule/evaluate","title":"Routing - Rule Evaluate","href":"/v1/routing/routing--rule-evaluate"}]},{"group":"Relay","pages":[{"openapi":"post /relay","title":"Relay - Create","href":"/v1/relay/relay"},{"openapi":"get /relay/{relay_id}","title":"Relay - Retrieve","href":"/v1/relay/relay--retrieve"}]},{"group":"Schemas","pages":[{"title":null,"href":"/v1/schemas/outgoing--webhook"}]},{"group":"Subscriptions","pages":[{"openapi":"post /subscriptions/create","title":"Subscription - Create","href":"/v1/subscriptions/create"},{"openapi":"post /subscriptions/{subscription_id}/confirm","title":"Subscription - Confirm","href":"/v1/subscriptions/confirm"},{"openapi":"post /subscriptions","title":"Subscription - Create and Confirm","href":"/v1/subscriptions/create-and-confirm"},{"openapi":"put /subscriptions/{subscription_id}/update","title":"Subscription - Update","href":"/v1/subscriptions/update"},{"openapi":"get /subscriptions/{subscription_id}","title":"Subscription - Retrieve","href":"/v1/subscriptions/get"},{"title":"Get plans","href":"/v1/subscriptions/get-plans"},{"openapi":"get /subscriptions/estimate","title":"Subscription - Get Estimate","href":"/v1/subscriptions/estimate"},{"openapi":"post /subscriptions/{subscription_id}/pause","title":"Subscription - Pause Subscription","href":"/v1/subscriptions/pause"},{"openapi":"post /subscriptions/{subscription_id}/resume","title":"Subscription - Resume Subscription","href":"/v1/subscriptions/resume"},{"openapi":"post /subscriptions/{subscription_id}/cancel","title":"Subscription - Cancel Subscription","href":"/v1/subscriptions/cancel"}]}]}]},{"version":"2.0.0 [BETA]","pages":[{"title":"2.0.0 [BETA]","href":"/introduction"}]}]},{"tab":"Locker API Reference","pages":[{"title":"Locker API Reference","href":"/locker-api-reference/overview"}]},{"tab":"Intelligent Router API Reference","pages":[{"title":"Intelligent Router API Reference","href":"/intelligent-router-api-reference/overview"}]}]},"title":"Authentication - Create - BirrPay","buildId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","deploymentId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Bbp7I60D.js","utils-C3RIvJha.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DqD-vLt8.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B31Loprg.js","snippetPresets-DKpk-b8t.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Cj65AhOR.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BXtn5gcC.js","shallow-RY2b03Cp.js","getApiPlaygroundDisplay-B0jeiPk3.js","CodeSnippet-CYgBjjwn.js","CodeSnippets-DOngDrYB.js","Page-n7I5XbKb.js","getPastedJson-DRQbJx-T.js","icon-CQiQCicY.js","MethodPill-BKTLdNtu.js","DuplicateIcon-B9jpAdat.js","createIcon-DCddRrXv.js","DynamicMarkdown-a8hUKrw6.js","SectionHeading-eECVV2eH.js","axios-vUo_bRtp.js","Markdown--GF7ZIpf.js","clsx-DZLdJUrt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-2LoAhjKH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Zwc0ZncM.js"]}