{ "code": "NOT_FOUND", "status": false, "message": "Comerciante no encontrado con UUID: {merchant_uuid}"}
{ "code": "ACCESS_DENIED", "status": false, "message": "El comerciante está inactivo"}
{ "code": "SUBSCRIPTION_CREATION_FAILED", "status": false, "message": "Mensaje de error de excepción de negocio"}
{ "code": "SERVICE_ERROR", "status": false, "message": "Ocurrió un error inesperado"}
Create a new subscription for recurring payments with credit or debit card.This endpoint allows you to associate a card with a subscription plan, defining the periodicity of recurring payments (monthly, yearly, or custom).
Operation status. true for success, false for error
Example:
true
message
string
required
Descriptive message about the result
Example:
"Suscripción creada exitosamente"
data
object
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Tumipay API","colors":{"primary":"#3D0872","light":"#7CB7E6","dark":"#3D0872"},"logo":{"light":"https://mintcdn.com/tumipay-f61949a2/4QwvRJb2RV0KcY-9/logo/light.svg?fit=max\u0026auto=format\u0026n=4QwvRJb2RV0KcY-9\u0026q=85\u0026s=80e8299bbede034c17a27042fd9c574f","dark":"https://mintcdn.com/tumipay-f61949a2/4QwvRJb2RV0KcY-9/logo/dark.svg?fit=max\u0026auto=format\u0026n=4QwvRJb2RV0KcY-9\u0026q=85\u0026s=2dcd96e159e245223cab8ae76bc56096"},"favicon":"https://mintcdn.com/tumipay-f61949a2/4QwvRJb2RV0KcY-9/favicon.png?fit=max\u0026auto=format\u0026n=4QwvRJb2RV0KcY-9\u0026q=85\u0026s=73da1d8a2b7909334ebaa56cb7eff1cf","api":{"playground":{"display":"interactive"}},"appearance":{"default":"light"},"navbar":{"links":[{"href":"mailto:soporte@tumipay.co","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://tumipay.com"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/tumipay"}},"search":{},"contextual":{"options":["copy","view","chatgpt","claude","perplexity"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"tumipay-f61949a2","hasAudioNarration":false,"actualSubdomain":"tumipay-f61949a2","customDomains":["docs.v2.topup.com.co"],"gitSource":{"type":"github","owner":"dixhi","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6af5d357510572438570668d","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"Documentation","count":23},{"language":"default","tag":"API Reference","count":22},{"language":"default","tag":"Country Configuration","count":22},{"language":"default","tag":"🇨🇴 Colombia","count":9},{"language":"default","tag":"Card Payment API","count":7},{"language":"default","tag":"Payin","count":7},{"language":"default","tag":"Payout","count":7},{"language":"default","tag":"🇵🇪 Peru","count":4},{"language":"default","tag":"Getting Started","count":3},{"language":"default","tag":"Merchant API","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/card-payment/post-create-subscription","slug":"/api-reference/card-payment/post-create-subscription","pageMetadata":{"title":"POST Create Subscription","openapi":"post /api/subscription/card","description":"Creates a new subscription for recurring card payments.","href":"/api-reference/card-payment/post-create-subscription"},"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: \"Creates a new subscription for recurring card payments.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Expandable,Heading,ParamField,ResponseField,Table}=_components;if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Create a new subscription for recurring payments with credit or debit card.`}),`\n`,_jsx(_components.p,{children:`This endpoint allows you to associate a card with a subscription plan, defining the periodicity of recurring payments (monthly, yearly, or custom).`}),`\n`,`\n`,`\n`,_jsx(Heading,{level:`2`,id:`required-headers`,children:`Required Headers`}),`\n`,_jsx(ParamField,{header:`Token-Top`,type:`string`,required:true,id:`param-token-top`,children:_jsx(_components.p,{children:`Merchant authentication token`})}),`\n`,_jsx(ParamField,{header:`Authorization`,type:`string`,required:true,id:`param-authorization`,children:_jsx(_components.p,{children:`Basic authentication (Basic Auth)`})}),`\n`,_jsx(ParamField,{header:`X-Merchant-ID`,type:`string`,required:true,id:`param-x-merchant-id`,children:_jsx(_components.p,{children:`Unique identifier of the merchant invoking Card Payment services`})}),`\n`,_jsx(ParamField,{header:`X-Request-ID`,type:`string`,required:true,id:`param-x-request-id`,children:_jsx(_components.p,{children:`Unique tracking identifier for the request`})}),`\n`,_jsx(ParamField,{header:`Content-Type`,type:`string`,required:true,id:`param-content-type`,children:_jsx(_components.p,{children:`Must be “application/json”`})}),`\n`,_jsx(Heading,{level:`2`,id:`request-body-parameters`,children:`Request Body Parameters`}),`\n`,_jsx(ParamField,{body:`token`,type:`string`,required:true,id:`param-token`,children:_jsx(_components.p,{children:`Token of the card associated with the subscription. This token is obtained through the TumiPay SDK.`})}),`\n`,_jsx(ParamField,{body:`plan_name`,type:`string`,required:true,id:`param-plan-name`,children:_jsx(_components.p,{children:`Identifier name of the subscription plan (e.g., “Premium Plan”, “Basic Plan”).`})}),`\n`,_jsxs(ParamField,{body:`periodicity`,type:`string`,required:true,id:`param-periodicity`,children:[_jsx(_components.p,{children:`Periodicity of recurring payments. Possible values:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`monthly`}),`: Monthly payments`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`yearly`}),`: Yearly payments`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`custom`}),`: Custom periodicity according to plan configuration`]}),`\n`]})]}),`\n`,_jsx(ParamField,{body:`customer_data`,type:`object`,required:true,id:`param-customer-data`,children:_jsxs(Expandable,{title:`Customer data`,children:[_jsx(ParamField,{body:`legal_doc`,type:`string`,required:true,id:`param-legal-doc`,children:_jsx(_components.p,{children:`Customer identity document number`})}),_jsx(ParamField,{body:`legal_doc_type`,type:`string`,required:true,id:`param-legal-doc-type`,children:_jsxs(_components.p,{children:[`Document type. Possible values: `,_jsx(_components.code,{children:`CC`}),`, `,_jsx(_components.code,{children:`CE`}),`, `,_jsx(_components.code,{children:`PPN`}),` (Colombia)`]})}),_jsx(ParamField,{body:`phone_code`,type:`string`,required:true,id:`param-phone-code`,children:_jsx(_components.p,{children:`Country phone code (e.g., “+57” for Colombia)`})}),_jsx(ParamField,{body:`phone_number`,type:`string`,required:true,id:`param-phone-number`,children:_jsx(_components.p,{children:`Phone number without country code`})}),_jsx(ParamField,{body:`email`,type:`string`,required:true,id:`param-email`,children:_jsx(_components.p,{children:`Customer email address`})}),_jsx(ParamField,{body:`full_name`,type:`string`,required:true,id:`param-full-name`,children:_jsx(_components.p,{children:`Customer full name`})})]})}),`\n`,_jsx(ParamField,{body:`start_date`,type:`string`,format:`date`,required:true,id:`param-start-date`,children:_jsxs(_components.p,{children:[`Subscription start date in `,_jsx(_components.code,{children:`YYYY-MM-DD`}),` format (e.g., “2026-01-01”).`]})}),`\n`,_jsx(Heading,{level:`2`,id:`validation-rules`,children:`Validation Rules`}),`\n`,_jsx(Heading,{level:`3`,id:`required-fields`,children:`Required Fields`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Rules`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`token`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`required, max:60`}),_jsx(_components.td,{children:`Card subscription token`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`plan_name`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`required, max:20`}),_jsx(_components.td,{children:`Subscription plan name`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`periodicity`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`required`}),_jsx(_components.td,{children:`Subscription periodicity`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`customer_data`})}),_jsx(_components.td,{children:`object`}),_jsx(_components.td,{children:`required`}),_jsx(_components.td,{children:`Customer data`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`customer_data.legal_doc`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`required, max:15`}),_jsx(_components.td,{children:`Customer legal document number`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`customer_data.legal_doc_type`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`required`}),_jsx(_components.td,{children:`Legal document type`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`customer_data.phone_code`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`required, max:4`}),_jsx(_components.td,{children:`Country phone code`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`customer_data.phone_number`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`required, max:20`}),_jsx(_components.td,{children:`Customer phone number`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`customer_data.email`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`required, email, max:255`}),_jsx(_components.td,{children:`Customer email address`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`customer_data.full_name`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`required, max:50`}),_jsx(_components.td,{children:`Customer full name`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`start_date`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`required, date_format:Y-m-d`}),_jsx(_components.td,{children:`Subscription start date (format: YYYY-MM-DD)`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`allowed-values`,children:`Allowed Values`}),`\n`,_jsx(Heading,{level:`4`,id:`periodicity`,children:`periodicity`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`daily`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`weekly`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`biweekly`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`monthly`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`threefortnights`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`bimonthly`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`quarterly`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`fourmonths`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`halfyearly`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`yearly`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`custom`})}),`\n`]}),`\n`,_jsx(Heading,{level:`4`,id:`customer_data-legal_doc_type`,children:`customer_data.legal_doc_type`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`CC`}),` - Cédula de Ciudadanía`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`CE`}),` - Cédula de Extranjería`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`NIT`}),` - Número de Identificación Tributaria`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`TI`}),` - Tarjeta de Identidad`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`PAS`}),` - Pasaporte`]}),`\n`]}),`\n`,_jsx(Heading,{level:`4`,id:`customer_data-phone_code`,children:`customer_data.phone_code`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`+57`}),` - Colombia`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`common-validation-error-messages`,children:`Common Validation Error Messages`}),`\n`,_jsx(_components.p,{children:`The following are common validation error messages returned by the API (in Spanish):`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`:attribute es obligatorio.`}),` - Required field missing`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`:attribute debe ser una cadena de texto.`}),` - Invalid data type (expected string)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`:attribute debe ser un número.`}),` - Invalid data type (expected numeric)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`:attribute debe ser un arreglo.`}),` - Invalid data type (expected array)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`:attribute debe ser una dirección de correo electrónico válida.`}),` - Invalid email format`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`:attribute no puede tener más de :max caracteres.`}),` - Maximum length exceeded`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`:attribute debe ser mayor o igual a :min.`}),` - Minimum value not met`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`:attribute debe tener el formato YYYY-MM-DD.`}),` - Invalid date format`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`:attribute no es válido.`}),` - Invalid value`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`response-fields`,children:`Response Fields`}),`\n`,_jsx(Heading,{level:`3`,id:`success-response-200-ok`,children:`Success Response (200 OK)`}),`\n`,_jsx(ResponseField,{name:`code`,type:`string`,required:true,id:`param-code`,children:_jsxs(_components.p,{children:[`Response code. Value: `,_jsx(_components.code,{children:`\"CREATED\"`}),` when the subscription is created successfully`]})}),`\n`,_jsx(ResponseField,{name:`status`,type:`boolean`,required:true,id:`param-status`,children:_jsxs(_components.p,{children:[`Operation status. `,_jsx(_components.code,{children:`true`}),` when successful, `,_jsx(_components.code,{children:`false`}),` when there is an error`]})}),`\n`,_jsx(ResponseField,{name:`message`,type:`string`,required:true,id:`param-message`,children:_jsx(_components.p,{children:`Descriptive message about the operation result`})}),`\n`,_jsx(ResponseField,{name:`data`,type:`object`,required:true,id:`param-data`,children:_jsx(Expandable,{title:`Subscription data`,children:_jsx(ResponseField,{name:`subscription_id`,type:`string`,format:`uuid`,required:true,id:`param-subscription-id`,children:_jsx(_components.p,{children:`Unique identifier of the created subscription. This ID will be used for subsequent operations (preauthorization, cancellation, etc.)`})})})}),`\n`,_jsx(Heading,{level:`2`,id:`http-status-codes`,children:`HTTP Status Codes`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status Code`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Response Body`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`200 OK`})}),_jsx(_components.td,{children:`Successful operation or business error`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`status: true`}),` for success, `,_jsx(_components.code,{children:`status: false`}),` for business error`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`400 Bad Request`})}),_jsxs(_components.td,{children:[`Missing required header (`,_jsx(_components.code,{children:`X-Merchant-ID`}),` or `,_jsx(_components.code,{children:`X-Request-ID`}),`)`]}),_jsx(_components.td,{children:`Simple error message`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`401 Unauthorized`})}),_jsxs(_components.td,{children:[`Authentication failed (invalid `,_jsx(_components.code,{children:`Token-Top`}),` or `,_jsx(_components.code,{children:`Authorization`}),`)`]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`code: \"UNAUTHORIZED\"`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`403 Forbidden`})}),_jsx(_components.td,{children:`Inactive merchant`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`code: \"ACCESS_DENIED\"`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`404 Not Found`})}),_jsx(_components.td,{children:`Merchant not found`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`code: \"NOT_FOUND\"`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`422 Unprocessable Entity`})}),_jsx(_components.td,{children:`Validation error in request data`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`code: \"VALIDATION_ERROR\"`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`500 Internal Server Error`})}),_jsx(_components.td,{children:`Internal server error`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`code: \"SERVICE_ERROR\"`})})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`response-codes`,children:`Response Codes`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Code`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`CREATED`})}),_jsx(_components.td,{children:`Subscription created successfully`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`VALIDATION_ERROR`})}),_jsx(_components.td,{children:`Validation error in sent data`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`UNAUTHORIZED`})}),_jsx(_components.td,{children:`Authentication error`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`NOT_FOUND`})}),_jsx(_components.td,{children:`Merchant not found`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ACCESS_DENIED`})}),_jsx(_components.td,{children:`Inactive merchant`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`SUBSCRIPTION_CREATION_FAILED`})}),_jsx(_components.td,{children:`Business error when creating subscription (provider, invalid token, etc.)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`SERVICE_ERROR`})}),_jsx(_components.td,{children:`Internal server error`})]})]})]})]})}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":"POST Create Subscription","openapi":"post /api/subscription/card","description":"Creates a new subscription for recurring card payments.","href":"/api-reference/card-payment/post-create-subscription"}}},"mdxSourceWithNoJs":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,ParamField,RequestExample,ResponseExample,ResponseField,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!RequestExample)_missingMdxReference(`RequestExample`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Create a new subscription for recurring payments with credit or debit card.`}),`\n`,_jsx(_components.p,{children:`This endpoint allows you to associate a card with a subscription plan, defining the periodicity of recurring payments (monthly, yearly, or custom).`}),`\n`,_jsx(RequestExample,{children:_jsx(CodeBlock,{filename:``,numberOfLines:`20`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`20`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` --request POST `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'https://tumipay-card-payments.uat.topup.com.co/production/api/subscription/card'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`--header `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Token-Top: your_auth_token'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`--header `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Authorization: Basic your_auth_key'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`--header `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'X-Merchant-ID: your_merchant_id'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`--header `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'X-Request-ID: your-request-id'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`--header `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Content-Type: application/json'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`--data-raw `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"token\": \"card_token_abc123\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"plan_name\": \"Plan Premium\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"periodicity\": \"monthly\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"customer_data\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"legal_doc\": \"1234567890\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"legal_doc_type\": \"CC\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"phone_code\": \"+57\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"phone_number\": \"3121234567\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"email\": \"customer@example.com\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"full_name\": \"John Doe\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"start_date\": \"2026-01-01\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`}'`})}),`\n`]})})})}),`\n`,_jsxs(ResponseExample,{children:[_jsx(CodeBlock,{filename:`Success - Subscription Created (200)`,numberOfLines:`8`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"CREATED\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Suscripción creada exitosamente\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"subscription_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"550e8400-e29b-41d4-a716-446655440000\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Validation Error (422)`,numberOfLines:`5`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"VALIDATION_ERROR\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Los datos proporcionados no son válidos.\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Missing Required Header - X-Merchant-ID (400)`,numberOfLines:`3`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Missing required header: X-Merchant-ID\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Missing Required Header - X-Request-ID (400)`,numberOfLines:`3`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Missing required header: X-Request-ID\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Internal Authentication Failed (401)`,numberOfLines:`5`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"UNAUTHORIZED\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Unauthorized.\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Merchant Not Found (404)`,numberOfLines:`5`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"NOT_FOUND\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Comerciante no encontrado con UUID: {merchant_uuid}\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Merchant Inactive (403)`,numberOfLines:`5`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ACCESS_DENIED\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"El comerciante está inactivo\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Subscription Creation Failed - Business Error (200)`,numberOfLines:`5`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"SUBSCRIPTION_CREATION_FAILED\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Mensaje de error de excepción de negocio\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Service Error (500)`,numberOfLines:`5`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"SERVICE_ERROR\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Ocurrió un error inesperado\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`required-headers`,children:`Required Headers`}),`\n`,_jsx(ParamField,{header:`Token-Top`,type:`string`,required:true,id:`param-token-top`,children:_jsx(_components.p,{children:`Merchant authentication token`})}),`\n`,_jsx(ParamField,{header:`Authorization`,type:`string`,required:true,id:`param-authorization`,children:_jsx(_components.p,{children:`Basic authentication (Basic Auth)`})}),`\n`,_jsx(ParamField,{header:`X-Merchant-ID`,type:`string`,required:true,id:`param-x-merchant-id`,children:_jsx(_components.p,{children:`Unique identifier of the merchant invoking Card Payment services`})}),`\n`,_jsx(ParamField,{header:`X-Request-ID`,type:`string`,required:true,id:`param-x-request-id`,children:_jsx(_components.p,{children:`Unique tracking identifier for the request`})}),`\n`,_jsx(ParamField,{header:`Content-Type`,type:`string`,required:true,id:`param-content-type`,children:_jsx(_components.p,{children:`Must be “application/json”`})}),`\n`,_jsx(Heading,{level:`2`,id:`request-body-parameters`,children:`Request Body Parameters`}),`\n`,_jsx(ParamField,{body:`token`,type:`string`,required:true,id:`param-token`,children:_jsx(_components.p,{children:`Token of the card associated with the subscription. This token is obtained through the TumiPay SDK.`})}),`\n`,_jsx(ParamField,{body:`plan_name`,type:`string`,required:true,id:`param-plan-name`,children:_jsx(_components.p,{children:`Identifier name of the subscription plan (e.g., “Premium Plan”, “Basic Plan”).`})}),`\n`,_jsxs(ParamField,{body:`periodicity`,type:`string`,required:true,id:`param-periodicity`,children:[_jsx(_components.p,{children:`Periodicity of recurring payments. Possible values:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`monthly`}),`: Monthly payments`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`yearly`}),`: Yearly payments`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`custom`}),`: Custom periodicity according to plan configuration`]}),`\n`]})]}),`\n`,_jsx(ParamField,{body:`customer_data`,type:`object`,required:true,id:`param-customer-data`,children:_jsxs(Expandable,{title:`Customer data`,children:[_jsx(ParamField,{body:`legal_doc`,type:`string`,required:true,id:`param-legal-doc`,children:_jsx(_components.p,{children:`Customer identity document number`})}),_jsx(ParamField,{body:`legal_doc_type`,type:`string`,required:true,id:`param-legal-doc-type`,children:_jsxs(_components.p,{children:[`Document type. Possible values: `,_jsx(_components.code,{children:`CC`}),`, `,_jsx(_components.code,{children:`CE`}),`, `,_jsx(_components.code,{children:`PPN`}),` (Colombia)`]})}),_jsx(ParamField,{body:`phone_code`,type:`string`,required:true,id:`param-phone-code`,children:_jsx(_components.p,{children:`Country phone code (e.g., “+57” for Colombia)`})}),_jsx(ParamField,{body:`phone_number`,type:`string`,required:true,id:`param-phone-number`,children:_jsx(_components.p,{children:`Phone number without country code`})}),_jsx(ParamField,{body:`email`,type:`string`,required:true,id:`param-email`,children:_jsx(_components.p,{children:`Customer email address`})}),_jsx(ParamField,{body:`full_name`,type:`string`,required:true,id:`param-full-name`,children:_jsx(_components.p,{children:`Customer full name`})})]})}),`\n`,_jsx(ParamField,{body:`start_date`,type:`string`,format:`date`,required:true,id:`param-start-date`,children:_jsxs(_components.p,{children:[`Subscription start date in `,_jsx(_components.code,{children:`YYYY-MM-DD`}),` format (e.g., “2026-01-01”).`]})}),`\n`,_jsx(Heading,{level:`2`,id:`validation-rules`,children:`Validation Rules`}),`\n`,_jsx(Heading,{level:`3`,id:`required-fields`,children:`Required Fields`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Rules`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`token`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`required, max:60`}),_jsx(_components.td,{children:`Card subscription token`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`plan_name`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`required, max:20`}),_jsx(_components.td,{children:`Subscription plan name`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`periodicity`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`required`}),_jsx(_components.td,{children:`Subscription periodicity`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`customer_data`})}),_jsx(_components.td,{children:`object`}),_jsx(_components.td,{children:`required`}),_jsx(_components.td,{children:`Customer data`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`customer_data.legal_doc`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`required, max:15`}),_jsx(_components.td,{children:`Customer legal document number`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`customer_data.legal_doc_type`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`required`}),_jsx(_components.td,{children:`Legal document type`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`customer_data.phone_code`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`required, max:4`}),_jsx(_components.td,{children:`Country phone code`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`customer_data.phone_number`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`required, max:20`}),_jsx(_components.td,{children:`Customer phone number`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`customer_data.email`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`required, email, max:255`}),_jsx(_components.td,{children:`Customer email address`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`customer_data.full_name`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`required, max:50`}),_jsx(_components.td,{children:`Customer full name`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`start_date`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`required, date_format:Y-m-d`}),_jsx(_components.td,{children:`Subscription start date (format: YYYY-MM-DD)`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`allowed-values`,children:`Allowed Values`}),`\n`,_jsx(Heading,{level:`4`,id:`periodicity`,children:`periodicity`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`daily`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`weekly`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`biweekly`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`monthly`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`threefortnights`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`bimonthly`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`quarterly`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`fourmonths`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`halfyearly`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`yearly`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`custom`})}),`\n`]}),`\n`,_jsx(Heading,{level:`4`,id:`customer_data-legal_doc_type`,children:`customer_data.legal_doc_type`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`CC`}),` - Cédula de Ciudadanía`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`CE`}),` - Cédula de Extranjería`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`NIT`}),` - Número de Identificación Tributaria`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`TI`}),` - Tarjeta de Identidad`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`PAS`}),` - Pasaporte`]}),`\n`]}),`\n`,_jsx(Heading,{level:`4`,id:`customer_data-phone_code`,children:`customer_data.phone_code`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`+57`}),` - Colombia`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`common-validation-error-messages`,children:`Common Validation Error Messages`}),`\n`,_jsx(_components.p,{children:`The following are common validation error messages returned by the API (in Spanish):`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`:attribute es obligatorio.`}),` - Required field missing`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`:attribute debe ser una cadena de texto.`}),` - Invalid data type (expected string)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`:attribute debe ser un número.`}),` - Invalid data type (expected numeric)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`:attribute debe ser un arreglo.`}),` - Invalid data type (expected array)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`:attribute debe ser una dirección de correo electrónico válida.`}),` - Invalid email format`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`:attribute no puede tener más de :max caracteres.`}),` - Maximum length exceeded`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`:attribute debe ser mayor o igual a :min.`}),` - Minimum value not met`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`:attribute debe tener el formato YYYY-MM-DD.`}),` - Invalid date format`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`:attribute no es válido.`}),` - Invalid value`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`response-fields`,children:`Response Fields`}),`\n`,_jsx(Heading,{level:`3`,id:`success-response-200-ok`,children:`Success Response (200 OK)`}),`\n`,_jsx(ResponseField,{name:`code`,type:`string`,required:true,id:`param-code`,children:_jsxs(_components.p,{children:[`Response code. Value: `,_jsx(_components.code,{children:`\"CREATED\"`}),` when the subscription is created successfully`]})}),`\n`,_jsx(ResponseField,{name:`status`,type:`boolean`,required:true,id:`param-status`,children:_jsxs(_components.p,{children:[`Operation status. `,_jsx(_components.code,{children:`true`}),` when successful, `,_jsx(_components.code,{children:`false`}),` when there is an error`]})}),`\n`,_jsx(ResponseField,{name:`message`,type:`string`,required:true,id:`param-message`,children:_jsx(_components.p,{children:`Descriptive message about the operation result`})}),`\n`,_jsx(ResponseField,{name:`data`,type:`object`,required:true,id:`param-data`,children:_jsx(Expandable,{title:`Subscription data`,children:_jsx(ResponseField,{name:`subscription_id`,type:`string`,format:`uuid`,required:true,id:`param-subscription-id`,children:_jsx(_components.p,{children:`Unique identifier of the created subscription. This ID will be used for subsequent operations (preauthorization, cancellation, etc.)`})})})}),`\n`,_jsx(Heading,{level:`2`,id:`http-status-codes`,children:`HTTP Status Codes`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status Code`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Response Body`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`200 OK`})}),_jsx(_components.td,{children:`Successful operation or business error`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`status: true`}),` for success, `,_jsx(_components.code,{children:`status: false`}),` for business error`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`400 Bad Request`})}),_jsxs(_components.td,{children:[`Missing required header (`,_jsx(_components.code,{children:`X-Merchant-ID`}),` or `,_jsx(_components.code,{children:`X-Request-ID`}),`)`]}),_jsx(_components.td,{children:`Simple error message`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`401 Unauthorized`})}),_jsxs(_components.td,{children:[`Authentication failed (invalid `,_jsx(_components.code,{children:`Token-Top`}),` or `,_jsx(_components.code,{children:`Authorization`}),`)`]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`code: \"UNAUTHORIZED\"`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`403 Forbidden`})}),_jsx(_components.td,{children:`Inactive merchant`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`code: \"ACCESS_DENIED\"`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`404 Not Found`})}),_jsx(_components.td,{children:`Merchant not found`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`code: \"NOT_FOUND\"`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`422 Unprocessable Entity`})}),_jsx(_components.td,{children:`Validation error in request data`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`code: \"VALIDATION_ERROR\"`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`500 Internal Server Error`})}),_jsx(_components.td,{children:`Internal server error`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`code: \"SERVICE_ERROR\"`})})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`response-codes`,children:`Response Codes`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Code`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`CREATED`})}),_jsx(_components.td,{children:`Subscription created successfully`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`VALIDATION_ERROR`})}),_jsx(_components.td,{children:`Validation error in sent data`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`UNAUTHORIZED`})}),_jsx(_components.td,{children:`Authentication error`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`NOT_FOUND`})}),_jsx(_components.td,{children:`Merchant not found`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ACCESS_DENIED`})}),_jsx(_components.td,{children:`Inactive merchant`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`SUBSCRIPTION_CREATION_FAILED`})}),_jsx(_components.td,{children:`Business error when creating subscription (provider, invalid token, etc.)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`SERVICE_ERROR`})}),_jsx(_components.td,{children:`Internal server error`})]})]})]})]})}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":"POST Create Subscription","openapi":"post /api/subscription/card","description":"Creates a new subscription for recurring card payments.","href":"/api-reference/card-payment/post-create-subscription"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Required Headers","slug":"required-headers","depth":2,"children":[]},{"title":"Request Body Parameters","slug":"request-body-parameters","depth":2,"children":[]},{"title":"Validation Rules","slug":"validation-rules","depth":2,"children":[{"title":"Required Fields","slug":"required-fields","depth":3,"children":[]},{"title":"Allowed Values","slug":"allowed-values","depth":3,"children":[]},{"title":"periodicity","slug":"periodicity","depth":4,"children":[]},{"title":"customer_data.legal_doc_type","slug":"customer_data-legal_doc_type","depth":4,"children":[]},{"title":"customer_data.phone_code","slug":"customer_data-phone_code","depth":4,"children":[]},{"title":"Common Validation Error Messages","slug":"common-validation-error-messages","depth":3,"children":[]}]},{"title":"Response Fields","slug":"response-fields","depth":2,"children":[{"title":"Success Response (200 OK)","slug":"success-response-200-ok","depth":3,"children":[]}]},{"title":"HTTP Status Codes","slug":"http-status-codes","depth":2,"children":[]},{"title":"Response Codes","slug":"response-codes","depth":2,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"20\">\u003cspan class=\"line\">\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> --request POST \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'https://tumipay-card-payments.uat.topup.com.co/production/api/subscription/card'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">--header \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'Token-Top: your_auth_token'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">--header \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'Authorization: Basic your_auth_key'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">--header \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'X-Merchant-ID: your_merchant_id'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">--header \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'X-Request-ID: your-request-id'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">--header \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'Content-Type: application/json'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">--data-raw \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"token\": \"card_token_abc123\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"plan_name\": \"Plan Premium\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"periodicity\": \"monthly\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"customer_data\": {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"legal_doc\": \"1234567890\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"legal_doc_type\": \"CC\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"phone_code\": \"+57\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"phone_number\": \"3121234567\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"email\": \"customer@example.com\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"full_name\": \"John Doe\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"start_date\": \"2026-01-01\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">}'\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]},"response":{"type":"ResponseExample","children":[{"filename":"Success - Subscription Created (200)","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"8\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"CREATED\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">true\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Suscripción creada exitosamente\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"data\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"subscription_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"550e8400-e29b-41d4-a716-446655440000\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"Validation Error (422)","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"5\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"VALIDATION_ERROR\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">false\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Los datos proporcionados no son válidos.\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"Missing Required Header - X-Merchant-ID (400)","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"3\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Missing required header: X-Merchant-ID\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"Missing Required Header - X-Request-ID (400)","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"3\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Missing required header: X-Request-ID\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"Internal Authentication Failed (401)","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"5\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"UNAUTHORIZED\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">false\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Unauthorized.\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"Merchant Not Found (404)","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"5\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"NOT_FOUND\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">false\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Comerciante no encontrado con UUID: {merchant_uuid}\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"Merchant Inactive (403)","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"5\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"ACCESS_DENIED\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">false\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"El comerciante está inactivo\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"Subscription Creation Failed - Business Error (200)","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"5\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"SUBSCRIPTION_CREATION_FAILED\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">false\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Mensaje de error de excepción de negocio\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"Service Error (500)","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"5\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"SERVICE_ERROR\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">false\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Ocurrió un error inesperado\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["CardPayment"],"summary":"Create subscription","description":"Creates a new subscription for recurring card payments.","operationId":"createCardPayment","parameters":["eb2d02b9-440e-40c2-bff1-4f6e4fb87d3e","0ea47d8c-17a7-4ede-8df7-2fc00c3d5d5b","e8164413-5646-4b51-b502-f426ad2fef50","56822e6d-0106-4a30-8ad7-d48d032666d6"],"requestBody":"1388e1f2-1142-42c8-a87c-834b021603da","responses":{"200":"43286c44-9af0-4e8f-9395-6b878b741d60","400":"8df7012e-8f8c-4b25-a10a-a2febd674c35","401":"8c9dbe0f-9157-4e0e-a16f-3655ca8b83f2","403":"fb7b56e3-5c70-4c20-a674-4758c9089ea6","404":"4e22cfb4-02b1-4ca4-9567-5965d21d200c","422":"cb827c56-4f5e-498b-95b7-145e5344294e","500":"bd00c97f-6520-423b-9f19-aaf013b29172"},"method":"post","type":"path","servers":["f847c058-083c-482e-847c-1e542c64ab1f"],"security":[],"path":"/api/subscription/card","baseUrlOptions":["https://tumipay-card-payments.uat.topup.com.co/production"],"title":"Create subscription","codeSamples":[],"requiredOnlyExamples":false,"requestExamples":[{"dropdown":false,"language":"shellscript","code":{"type":"pre","key":null,"ref":null,"props":{"className":"shiki shiki-themes github-light-default dark-plus","style":{"backgroundColor":"#ffffff","--shiki-dark-bg":"#0B0C0E","color":"#1f2328","--shiki-dark":"#D4D4D4"},"language":"shellscript","children":{"type":"code","key":null,"ref":null,"props":{"language":"shellscript","numberOfLines":"20","children":[{"type":"span","key":"0","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#8250DF","--shiki-dark":"#DCDCAA"},"children":"curl"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":" --request POST "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"'https://tumipay-card-payments.uat.topup.com.co/production/api/subscription/card'"}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":" \\"}}]}},"\n",{"type":"span","key":"2","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"--header "}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"'Token-Top: your_auth_token'"}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":" \\"}}]}},"\n",{"type":"span","key":"4","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"--header "}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"'Authorization: Basic your_auth_key'"}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":" \\"}}]}},"\n",{"type":"span","key":"6","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"--header "}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"'X-Merchant-ID: your_merchant_id'"}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":" \\"}}]}},"\n",{"type":"span","key":"8","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"--header "}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"'X-Request-ID: your-request-id'"}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":" \\"}}]}},"\n",{"type":"span","key":"10","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"--header "}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"'Content-Type: application/json'"}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":" \\"}}]}},"\n",{"type":"span","key":"12","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"--data-raw "}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"'{"}}]}},"\n",{"type":"span","key":"14","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" \"token\": \"card_token_abc123\","}}}},"\n",{"type":"span","key":"16","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" \"plan_name\": \"Plan Premium\","}}}},"\n",{"type":"span","key":"18","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" \"periodicity\": \"monthly\","}}}},"\n",{"type":"span","key":"20","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" \"customer_data\": {"}}}},"\n",{"type":"span","key":"22","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" \"legal_doc\": \"1234567890\","}}}},"\n",{"type":"span","key":"24","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" \"legal_doc_type\": \"CC\","}}}},"\n",{"type":"span","key":"26","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" \"phone_code\": \"+57\","}}}},"\n",{"type":"span","key":"28","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" \"phone_number\": \"3121234567\","}}}},"\n",{"type":"span","key":"30","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" \"email\": \"customer@example.com\","}}}},"\n",{"type":"span","key":"32","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" \"full_name\": \"John Doe\""}}}},"\n",{"type":"span","key":"34","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" },"}}}},"\n",{"type":"span","key":"36","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" \"start_date\": \"2026-01-01\""}}}},"\n",{"type":"span","key":"38","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"}'"}}}},"\n"]}}}},"filename":""}],"requestExampleType":"mdx","responseExamples":[{"dropdown":false,"language":"json","code":{"type":"pre","key":null,"ref":null,"props":{"className":"shiki shiki-themes github-light-default dark-plus","style":{"backgroundColor":"#ffffff","--shiki-dark-bg":"#0B0C0E","color":"#1f2328","--shiki-dark":"#D4D4D4"},"language":"json","children":{"type":"code","key":null,"ref":null,"props":{"language":"json","numberOfLines":"8","children":[{"type":"span","key":"0","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"{"}}}},"\n",{"type":"span","key":"2","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"code\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"CREATED\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"4","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"status\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0550AE","--shiki-dark":"#569CD6"},"children":"true"}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"6","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"message\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"Suscripción creada exitosamente\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"8","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"data\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": {"}}]}},"\n",{"type":"span","key":"10","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"subscription_id\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"550e8400-e29b-41d4-a716-446655440000\""}}]}},"\n",{"type":"span","key":"12","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":" }"}}}},"\n",{"type":"span","key":"14","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"}"}}}},"\n"]}}}},"filename":"Success - Subscription Created (200)"},{"dropdown":false,"language":"json","code":{"type":"pre","key":null,"ref":null,"props":{"className":"shiki shiki-themes github-light-default dark-plus","style":{"backgroundColor":"#ffffff","--shiki-dark-bg":"#0B0C0E","color":"#1f2328","--shiki-dark":"#D4D4D4"},"language":"json","children":{"type":"code","key":null,"ref":null,"props":{"language":"json","numberOfLines":"5","children":[{"type":"span","key":"0","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"{"}}}},"\n",{"type":"span","key":"2","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"code\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"VALIDATION_ERROR\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"4","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"status\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0550AE","--shiki-dark":"#569CD6"},"children":"false"}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"6","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"message\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"Los datos proporcionados no son válidos.\""}}]}},"\n",{"type":"span","key":"8","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"}"}}}},"\n"]}}}},"filename":"Validation Error (422)"},{"dropdown":false,"language":"json","code":{"type":"pre","key":null,"ref":null,"props":{"className":"shiki shiki-themes github-light-default dark-plus","style":{"backgroundColor":"#ffffff","--shiki-dark-bg":"#0B0C0E","color":"#1f2328","--shiki-dark":"#D4D4D4"},"language":"json","children":{"type":"code","key":null,"ref":null,"props":{"language":"json","numberOfLines":"3","children":[{"type":"span","key":"0","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"{"}}}},"\n",{"type":"span","key":"2","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"message\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"Missing required header: X-Merchant-ID\""}}]}},"\n",{"type":"span","key":"4","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"}"}}}},"\n"]}}}},"filename":"Missing Required Header - X-Merchant-ID (400)"},{"dropdown":false,"language":"json","code":{"type":"pre","key":null,"ref":null,"props":{"className":"shiki shiki-themes github-light-default dark-plus","style":{"backgroundColor":"#ffffff","--shiki-dark-bg":"#0B0C0E","color":"#1f2328","--shiki-dark":"#D4D4D4"},"language":"json","children":{"type":"code","key":null,"ref":null,"props":{"language":"json","numberOfLines":"3","children":[{"type":"span","key":"0","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"{"}}}},"\n",{"type":"span","key":"2","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"message\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"Missing required header: X-Request-ID\""}}]}},"\n",{"type":"span","key":"4","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"}"}}}},"\n"]}}}},"filename":"Missing Required Header - X-Request-ID (400)"},{"dropdown":false,"language":"json","code":{"type":"pre","key":null,"ref":null,"props":{"className":"shiki shiki-themes github-light-default dark-plus","style":{"backgroundColor":"#ffffff","--shiki-dark-bg":"#0B0C0E","color":"#1f2328","--shiki-dark":"#D4D4D4"},"language":"json","children":{"type":"code","key":null,"ref":null,"props":{"language":"json","numberOfLines":"5","children":[{"type":"span","key":"0","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"{"}}}},"\n",{"type":"span","key":"2","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"code\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"UNAUTHORIZED\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"4","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"status\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0550AE","--shiki-dark":"#569CD6"},"children":"false"}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"6","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"message\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"Unauthorized.\""}}]}},"\n",{"type":"span","key":"8","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"}"}}}},"\n"]}}}},"filename":"Internal Authentication Failed (401)"},{"dropdown":false,"language":"json","code":{"type":"pre","key":null,"ref":null,"props":{"className":"shiki shiki-themes github-light-default dark-plus","style":{"backgroundColor":"#ffffff","--shiki-dark-bg":"#0B0C0E","color":"#1f2328","--shiki-dark":"#D4D4D4"},"language":"json","children":{"type":"code","key":null,"ref":null,"props":{"language":"json","numberOfLines":"5","children":[{"type":"span","key":"0","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"{"}}}},"\n",{"type":"span","key":"2","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"code\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"NOT_FOUND\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"4","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"status\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0550AE","--shiki-dark":"#569CD6"},"children":"false"}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"6","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"message\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"Comerciante no encontrado con UUID: {merchant_uuid}\""}}]}},"\n",{"type":"span","key":"8","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"}"}}}},"\n"]}}}},"filename":"Merchant Not Found (404)"},{"dropdown":false,"language":"json","code":{"type":"pre","key":null,"ref":null,"props":{"className":"shiki shiki-themes github-light-default dark-plus","style":{"backgroundColor":"#ffffff","--shiki-dark-bg":"#0B0C0E","color":"#1f2328","--shiki-dark":"#D4D4D4"},"language":"json","children":{"type":"code","key":null,"ref":null,"props":{"language":"json","numberOfLines":"5","children":[{"type":"span","key":"0","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"{"}}}},"\n",{"type":"span","key":"2","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"code\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"ACCESS_DENIED\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"4","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"status\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0550AE","--shiki-dark":"#569CD6"},"children":"false"}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"6","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"message\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"El comerciante está inactivo\""}}]}},"\n",{"type":"span","key":"8","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"}"}}}},"\n"]}}}},"filename":"Merchant Inactive (403)"},{"dropdown":false,"language":"json","code":{"type":"pre","key":null,"ref":null,"props":{"className":"shiki shiki-themes github-light-default dark-plus","style":{"backgroundColor":"#ffffff","--shiki-dark-bg":"#0B0C0E","color":"#1f2328","--shiki-dark":"#D4D4D4"},"language":"json","children":{"type":"code","key":null,"ref":null,"props":{"language":"json","numberOfLines":"5","children":[{"type":"span","key":"0","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"{"}}}},"\n",{"type":"span","key":"2","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"code\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"SUBSCRIPTION_CREATION_FAILED\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"4","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"status\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0550AE","--shiki-dark":"#569CD6"},"children":"false"}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"6","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"message\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"Mensaje de error de excepción de negocio\""}}]}},"\n",{"type":"span","key":"8","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"}"}}}},"\n"]}}}},"filename":"Subscription Creation Failed - Business Error (200)"},{"dropdown":false,"language":"json","code":{"type":"pre","key":null,"ref":null,"props":{"className":"shiki shiki-themes github-light-default dark-plus","style":{"backgroundColor":"#ffffff","--shiki-dark-bg":"#0B0C0E","color":"#1f2328","--shiki-dark":"#D4D4D4"},"language":"json","children":{"type":"code","key":null,"ref":null,"props":{"language":"json","numberOfLines":"5","children":[{"type":"span","key":"0","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"{"}}}},"\n",{"type":"span","key":"2","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"code\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"SERVICE_ERROR\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"4","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"status\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0550AE","--shiki-dark":"#569CD6"},"children":"false"}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"6","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"message\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"Ocurrió un error inesperado\""}}]}},"\n",{"type":"span","key":"8","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"}"}}}},"\n"]}}}},"filename":"Service Error (500)"}],"responseExampleType":"mdx"},"dependencies":{"parameters":{"eb2d02b9-440e-40c2-bff1-4f6e4fb87d3e":{"name":"X-Merchant-ID","in":"header","required":true,"description":"Unique identifier of the Merchant invoking Card Payment services. Should not be used to authenticate end users.","schema":{"type":"string","isRequired":true,"description":"Unique identifier of the Merchant invoking Card Payment services. Should not be used to authenticate end users.","uniqueKey":"","typeLabel":"string"}},"0ea47d8c-17a7-4ede-8df7-2fc00c3d5d5b":{"name":"X-Request-ID","in":"header","required":true,"description":"Tracking identifier associated with the request, used to establish a correlation_id between ecosystem components.","schema":{"type":"string","isRequired":true,"description":"Tracking identifier associated with the request, used to establish a correlation_id between ecosystem components.","uniqueKey":"","typeLabel":"string"}},"e8164413-5646-4b51-b502-f426ad2fef50":{"name":"Token-Top","in":"header","required":true,"description":"Token for authentication.","schema":{"type":"string","isRequired":true,"description":"Token for authentication.","uniqueKey":"","typeLabel":"string"}},"56822e6d-0106-4a30-8ad7-d48d032666d6":{"name":"Authorization","in":"header","required":true,"description":"Basic authentication.","schema":{"type":"string","isRequired":true,"description":"Basic authentication.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["token","plan_name","periodicity","customer_data","start_date"],"properties":{"token":{"type":"string","example":"card_token_abc123","isRequired":true,"uniqueKey":"token","typeLabel":"string"},"plan_name":{"type":"string","example":"Plan Premium","isRequired":true,"uniqueKey":"plan_name","typeLabel":"string"},"periodicity":{"type":"string","enum":["daily","weekly","biweekly","monthly","threefortnights","bimonthly","quarterly","fourmonths","halfyearly","yearly","custom"],"example":"monthly","isRequired":true,"uniqueKey":"periodicity","typeLabel":"enum\u003cstring>"},"customer_data":{"type":"object","required":["legal_doc","legal_doc_type","phone_code","phone_number","email","full_name"],"properties":{"legal_doc":{"type":"string","example":"1234567890","isRequired":true,"uniqueKey":"customer_data.legal_doc","typeLabel":"string"},"legal_doc_type":{"type":"string","enum":["CC","CE","NIT","TI","PAS"],"description":"Legal document type. Accepted: CC (Cédula Ciudadanía), CE (Cédula Extranjería), NIT, TI (Tarjeta Identidad), PAS (Pasaporte).","example":"CC","isRequired":true,"uniqueKey":"customer_data.legal_doc_type","typeLabel":"enum\u003cstring>"},"phone_code":{"type":"string","description":"Country phone code with + prefix (e.g. +57 for Colombia).","example":"+57","isRequired":true,"uniqueKey":"customer_data.phone_code","typeLabel":"string"},"phone_number":{"type":"string","example":"3121234567","isRequired":true,"uniqueKey":"customer_data.phone_number","typeLabel":"string"},"email":{"type":"string","example":"customer@example.com","isRequired":true,"uniqueKey":"customer_data.email","typeLabel":"string"},"full_name":{"type":"string","example":"John Doe","isRequired":true,"uniqueKey":"customer_data.full_name","typeLabel":"string"}},"isRequired":true,"uniqueKey":"customer_data","typeLabel":"object"},"start_date":{"type":"string","format":"date","example":"2026-01-01","isRequired":true,"uniqueKey":"start_date","typeLabel":"string\u003cdate>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"token":"card_token_abc123","plan_name":"Plan Premium","periodicity":"monthly","customer_data":{"legal_doc":"1234567890","legal_doc_type":"CC","phone_code":"+57","phone_number":"3121234567","email":"customer@example.com","full_name":"John Doe"},"start_date":"2026-01-01"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"43286c44-9af0-4e8f-9395-6b878b741d60":{"description":"Subscription created successfully or business error. Check 'status' field in the body.","content":{"application/json":{"schema":{"type":"object","description":"Response when creating a subscription. The 'status' field can be true (success) or false (business error) even with HTTP 200.","properties":{"code":{"type":"string","description":"Response code. Values: 'CREATED' (success), 'SUBSCRIPTION_CREATION_FAILED' (business error)","example":"CREATED","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"status":{"type":"boolean","description":"Operation status. true for success, false for error","example":true,"isRequired":true,"uniqueKey":"status","typeLabel":"boolean"},"message":{"type":"string","description":"Descriptive message about the result","example":"Suscripción creada exitosamente","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"data":{"type":"object","properties":{"subscription_id":{"type":"string","format":"uuid","description":"Unique identifier of the created subscription","example":"550e8400-e29b-41d4-a716-446655440000","uniqueKey":"data.subscription_id","typeLabel":"string\u003cuuid>"}},"uniqueKey":"data","typeLabel":"object"}},"required":["code","status","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"success":{"title":"success","summary":"Subscription created successfully","value":{"code":"CREATED","status":true,"message":"Suscripción creada exitosamente","data":{"subscription_id":"550e8400-e29b-41d4-a716-446655440000"}}},"business_error":{"title":"business_error","summary":"Business error (invalid token, etc.)","value":{"code":"SUBSCRIPTION_CREATION_FAILED","status":false,"message":"Token de tarjeta inválido"}}},"exampleType":"examples"}},"exampleType":"examples"},"8df7012e-8f8c-4b25-a10a-a2febd674c35":{"description":"Missing required header (X-Merchant-ID or X-Request-ID).","content":{"application/json":{"schema":{"oneOf":[{"type":"object","description":"Standard structure for error responses. For 400 errors (missing headers), it only contains 'message'.","properties":{"code":{"type":"string","description":"Error code. Possible values: 'VALIDATION_ERROR', 'UNAUTHORIZED', 'NOT_FOUND', 'ACCESS_DENIED', 'SUBSCRIPTION_CREATION_FAILED', 'SERVICE_ERROR'","example":"VALIDATION_ERROR","uniqueKey":"oneOf.0.code","typeLabel":"string"},"status":{"type":"boolean","description":"Always false for error responses","example":false,"uniqueKey":"oneOf.0.status","typeLabel":"boolean"},"message":{"type":"string","description":"Descriptive error message","example":"The given data was invalid.","uniqueKey":"oneOf.0.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Additional error details (optional)","uniqueKey":"oneOf.0.details","typeLabel":"object"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","description":"Standard structure for error responses. For 400 errors (missing headers), it only contains 'message'.","required":["message"],"properties":{"message":{"type":"string","description":"Error message for missing headers","example":"Missing required header: X-Merchant-ID","isRequired":true,"uniqueKey":"oneOf.1.message","typeLabel":"string"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"VALIDATION_ERROR","status":false,"message":"The given data was invalid.","details":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"8c9dbe0f-9157-4e0e-a16f-3655ca8b83f2":{"description":"Authentication failed (invalid Token-Top or Authorization).","content":{"application/json":{"schema":{"oneOf":[{"type":"object","description":"Standard structure for error responses. For 400 errors (missing headers), it only contains 'message'.","properties":{"code":{"type":"string","description":"Error code. Possible values: 'VALIDATION_ERROR', 'UNAUTHORIZED', 'NOT_FOUND', 'ACCESS_DENIED', 'SUBSCRIPTION_CREATION_FAILED', 'SERVICE_ERROR'","example":"VALIDATION_ERROR","uniqueKey":"oneOf.0.code","typeLabel":"string"},"status":{"type":"boolean","description":"Always false for error responses","example":false,"uniqueKey":"oneOf.0.status","typeLabel":"boolean"},"message":{"type":"string","description":"Descriptive error message","example":"The given data was invalid.","uniqueKey":"oneOf.0.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Additional error details (optional)","uniqueKey":"oneOf.0.details","typeLabel":"object"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","description":"Standard structure for error responses. For 400 errors (missing headers), it only contains 'message'.","required":["message"],"properties":{"message":{"type":"string","description":"Error message for missing headers","example":"Missing required header: X-Merchant-ID","isRequired":true,"uniqueKey":"oneOf.1.message","typeLabel":"string"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"VALIDATION_ERROR","status":false,"message":"The given data was invalid.","details":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"fb7b56e3-5c70-4c20-a674-4758c9089ea6":{"description":"Inactive merchant.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","description":"Standard structure for error responses. For 400 errors (missing headers), it only contains 'message'.","properties":{"code":{"type":"string","description":"Error code. Possible values: 'VALIDATION_ERROR', 'UNAUTHORIZED', 'NOT_FOUND', 'ACCESS_DENIED', 'SUBSCRIPTION_CREATION_FAILED', 'SERVICE_ERROR'","example":"VALIDATION_ERROR","uniqueKey":"oneOf.0.code","typeLabel":"string"},"status":{"type":"boolean","description":"Always false for error responses","example":false,"uniqueKey":"oneOf.0.status","typeLabel":"boolean"},"message":{"type":"string","description":"Descriptive error message","example":"The given data was invalid.","uniqueKey":"oneOf.0.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Additional error details (optional)","uniqueKey":"oneOf.0.details","typeLabel":"object"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","description":"Standard structure for error responses. For 400 errors (missing headers), it only contains 'message'.","required":["message"],"properties":{"message":{"type":"string","description":"Error message for missing headers","example":"Missing required header: X-Merchant-ID","isRequired":true,"uniqueKey":"oneOf.1.message","typeLabel":"string"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"VALIDATION_ERROR","status":false,"message":"The given data was invalid.","details":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"4e22cfb4-02b1-4ca4-9567-5965d21d200c":{"description":"Merchant not found.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","description":"Standard structure for error responses. For 400 errors (missing headers), it only contains 'message'.","properties":{"code":{"type":"string","description":"Error code. Possible values: 'VALIDATION_ERROR', 'UNAUTHORIZED', 'NOT_FOUND', 'ACCESS_DENIED', 'SUBSCRIPTION_CREATION_FAILED', 'SERVICE_ERROR'","example":"VALIDATION_ERROR","uniqueKey":"oneOf.0.code","typeLabel":"string"},"status":{"type":"boolean","description":"Always false for error responses","example":false,"uniqueKey":"oneOf.0.status","typeLabel":"boolean"},"message":{"type":"string","description":"Descriptive error message","example":"The given data was invalid.","uniqueKey":"oneOf.0.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Additional error details (optional)","uniqueKey":"oneOf.0.details","typeLabel":"object"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","description":"Standard structure for error responses. For 400 errors (missing headers), it only contains 'message'.","required":["message"],"properties":{"message":{"type":"string","description":"Error message for missing headers","example":"Missing required header: X-Merchant-ID","isRequired":true,"uniqueKey":"oneOf.1.message","typeLabel":"string"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"VALIDATION_ERROR","status":false,"message":"The given data was invalid.","details":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"cb827c56-4f5e-498b-95b7-145e5344294e":{"description":"Validation error in request data.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","description":"Standard structure for error responses. For 400 errors (missing headers), it only contains 'message'.","properties":{"code":{"type":"string","description":"Error code. Possible values: 'VALIDATION_ERROR', 'UNAUTHORIZED', 'NOT_FOUND', 'ACCESS_DENIED', 'SUBSCRIPTION_CREATION_FAILED', 'SERVICE_ERROR'","example":"VALIDATION_ERROR","uniqueKey":"oneOf.0.code","typeLabel":"string"},"status":{"type":"boolean","description":"Always false for error responses","example":false,"uniqueKey":"oneOf.0.status","typeLabel":"boolean"},"message":{"type":"string","description":"Descriptive error message","example":"The given data was invalid.","uniqueKey":"oneOf.0.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Additional error details (optional)","uniqueKey":"oneOf.0.details","typeLabel":"object"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","description":"Standard structure for error responses. For 400 errors (missing headers), it only contains 'message'.","required":["message"],"properties":{"message":{"type":"string","description":"Error message for missing headers","example":"Missing required header: X-Merchant-ID","isRequired":true,"uniqueKey":"oneOf.1.message","typeLabel":"string"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"VALIDATION_ERROR","status":false,"message":"The given data was invalid.","details":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"bd00c97f-6520-423b-9f19-aaf013b29172":{"description":"Internal server error.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","description":"Standard structure for error responses. For 400 errors (missing headers), it only contains 'message'.","properties":{"code":{"type":"string","description":"Error code. Possible values: 'VALIDATION_ERROR', 'UNAUTHORIZED', 'NOT_FOUND', 'ACCESS_DENIED', 'SUBSCRIPTION_CREATION_FAILED', 'SERVICE_ERROR'","example":"VALIDATION_ERROR","uniqueKey":"oneOf.0.code","typeLabel":"string"},"status":{"type":"boolean","description":"Always false for error responses","example":false,"uniqueKey":"oneOf.0.status","typeLabel":"boolean"},"message":{"type":"string","description":"Descriptive error message","example":"The given data was invalid.","uniqueKey":"oneOf.0.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Additional error details (optional)","uniqueKey":"oneOf.0.details","typeLabel":"object"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","description":"Standard structure for error responses. For 400 errors (missing headers), it only contains 'message'.","required":["message"],"properties":{"message":{"type":"string","description":"Error message for missing headers","example":"Missing required header: X-Merchant-ID","isRequired":true,"uniqueKey":"oneOf.1.message","typeLabel":"string"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"VALIDATION_ERROR","status":false,"message":"The given data was invalid.","details":{}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{},"servers":{"f847c058-083c-482e-847c-1e542c64ab1f":{"url":"https://tumipay-card-payments.uat.topup.com.co/production","description":"UAT server"}}},"originalFileLocation":"docs/specs/card-payment-api.json"},"subdomain":"tumipay-f61949a2","siteName":"Tumipay API","title":"POST Create Subscription - Tumipay API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-12T14:55:29.768Z","originalFileLocation":"api-reference/card-payment/post-create-subscription.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=\"light\"}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=\"Creates a new subscription for recurring card payments.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Tumipay API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tumipay-f61949a2/Ilu_M14UyEA5UBGW/_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/tumipay-f61949a2/Ilu_M14UyEA5UBGW/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tumipay-f61949a2/Ilu_M14UyEA5UBGW/_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/tumipay-f61949a2/Ilu_M14UyEA5UBGW/_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/tumipay-f61949a2/Ilu_M14UyEA5UBGW/_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/tumipay-f61949a2/Ilu_M14UyEA5UBGW/_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/tumipay-f61949a2/Ilu_M14UyEA5UBGW/_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/tumipay-f61949a2/Ilu_M14UyEA5UBGW/_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/tumipay-f61949a2/Ilu_M14UyEA5UBGW/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"POST Create Subscription - Tumipay API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates a new subscription for recurring card payments.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Tumipay API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.v2.topup.com.co/api-reference/card-payment/post-create-subscription\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://tumipay-f61949a2.mintlify.site/_mintlify/api/og/v2?division=Card+Payment+API\u0026amp;title=POST+Create+Subscription\u0026amp;description=Creates+a+new+subscription+for+recurring+card+payments.\u0026amp;theme=2402adaf66664b56ab7f2981\u0026amp;signature=0b17656ab8850e7072c5aa2abeb1ebb7a07c0abe67cf68d94cd7df10f66edb47\">\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=\"POST Create Subscription - Tumipay API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates a new subscription for recurring card payments.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://tumipay-f61949a2.mintlify.site/_mintlify/api/og/v2?division=Card+Payment+API\u0026amp;title=POST+Create+Subscription\u0026amp;description=Creates+a+new+subscription+for+recurring+card+payments.\u0026amp;theme=2402adaf66664b56ab7f2981\u0026amp;signature=0b17656ab8850e7072c5aa2abeb1ebb7a07c0abe67cf68d94cd7df10f66edb47\">\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/tumipay-f61949a2/Ilu_M14UyEA5UBGW/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Tumipay API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3D0872\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.v2.topup.com.co/api-reference/card-payment/post-create-subscription\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/card-payment/post-create-subscription.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.v2.topup.com.co/#organization\",\"name\":\"Tumipay API\",\"url\":\"https://docs.v2.topup.com.co\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/tumipay-f61949a2/4QwvRJb2RV0KcY-9/logo/light.svg?fit=max\u0026auto=format\u0026n=4QwvRJb2RV0KcY-9\u0026q=85\u0026s=80e8299bbede034c17a27042fd9c574f\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.v2.topup.com.co#website\",\"name\":\"Tumipay API\",\"url\":\"https://docs.v2.topup.com.co\",\"publisher\":{\"@id\":\"https://docs.v2.topup.com.co/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.v2.topup.com.co/api-reference/card-payment/post-create-subscription#webpage\",\"url\":\"https://docs.v2.topup.com.co/api-reference/card-payment/post-create-subscription\",\"name\":\"POST Create Subscription\",\"description\":\"Creates a new subscription for recurring card payments.\",\"dateModified\":\"2026-11-12T14:55:29.768Z\",\"isPartOf\":{\"@id\":\"https://docs.v2.topup.com.co#website\"},\"breadcrumb\":{\"@id\":\"https://docs.v2.topup.com.co/api-reference/card-payment/post-create-subscription#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.v2.topup.com.co/api-reference/card-payment/post-create-subscription#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Card Payment API\",\"item\":\"https://docs.v2.topup.com.co/api-reference/card-payment\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"POST Create Subscription\",\"item\":\"https://docs.v2.topup.com.co/api-reference/card-payment/post-create-subscription\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.v2.topup.com.co/api-reference/card-payment/post-create-subscription#apireference\",\"headline\":\"POST Create Subscription\",\"name\":\"POST Create Subscription\",\"description\":\"Creates a new subscription for recurring card payments.\",\"url\":\"https://docs.v2.topup.com.co/api-reference/card-payment/post-create-subscription\",\"mainEntityOfPage\":{\"@id\":\"https://docs.v2.topup.com.co/api-reference/card-payment/post-create-subscription#webpage\"},\"dateModified\":\"2026-11-12T14:55:29.768Z\",\"publisher\":{\"@id\":\"https://docs.v2.topup.com.co/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.v2.topup.com.co#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Tumipay API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Tumipay API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/card-payment/post-create-subscription.md","siteName":"Tumipay API","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/docs/introduction"}]},{"tab":"API Reference","groups":[{"group":"Getting Started","icon":"rocket","pages":[{"title":"Introduction","icon":"quote-left","href":"/api-reference/introduction"},{"title":"Authentication","icon":"at","href":"/api-reference/authentication"},{"title":"Testing Environment","icon":"vial","href":"/api-reference/testing"}]},{"group":"Merchant API","icon":"user-tie","pages":[{"title":"Merchant API","icon":"quote-left","mode":"wide","href":"/api-reference/merchant-api"},{"title":"GET Merchant Balance","openapi":"get /merchant/balance","href":"/api-reference/merchant-api/get-retrieve-information"},{"title":"Search Transactions","openapi":"get /transaction/{ticket}","href":"/api-reference/merchant-api/post-search-transactions"}]},{"group":"PayIn API","icon":"money-bill-transfer","pages":[{"title":"PayIn API","icon":"quote-left","mode":"wide","href":"/api-reference/payin"},{"title":"POST Initiate PayIn Transaction (v2)","openapi":"post /api/v2/payin","href":"/api-reference/payin/post-initiate-transaction"},{"title":"POST Initiate PayIn (v1 — deprecated)","openapi":"post /api/v1/payin","href":"/api-reference/payin/v1-deprecated"}]},{"group":"PayOut API","icon":"money-bill-transfer","pages":[{"title":"PayOut API","icon":"quote-left","mode":"wide","href":"/api-reference/payout"},{"title":"POST Initiate PayOut Transaction","openapi":"post /payout","href":"/api-reference/payout/post-initiate-transaction"}]},{"group":"Card Payment API","icon":"credit-card","pages":[{"title":"Card Payment API","description":"API for managing subscriptions with credit and debit cards, including preauthorization and transaction capture.","icon":"credit-card","mode":"wide","href":"/api-reference/card-payment"},{"title":"POST Create Subscription","openapi":"post /api/subscription/card","href":"/api-reference/card-payment/post-create-subscription"},{"title":"POST Cancel Subscription","openapi":"post /api/subscription/card/cancel","description":"Cancels a subscription given its identifier. The operation is idempotent: if the subscription is already cancelled, the system returns the `ALREADY_CANCELLED` status.","href":"/api-reference/card-payment/post-cancel-subscription"},{"title":"POST Preauthorize Transaction","openapi":"post /api/subscription/card/authorize","href":"/api-reference/card-payment/post-authorize"},{"title":"POST Renewal Preauthorize","openapi":"post /api/subscription/card/authorize/renewal","href":"/api-reference/card-payment/post-renewal-authorize"},{"title":"POST Capture Transaction","openapi":"post /api/subscription/card/capture","href":"/api-reference/card-payment/post-capture"},{"title":"Webhooks","icon":"server","href":"/api-reference/card-payment/webhooks"}]},{"group":"Integration","icon":"link","pages":[{"title":"Webhooks","icon":"server","href":"/api-reference/webhooks"}]},{"group":"Sandbox Confirm","icon":"flask-vial","pages":[{"title":"Sandbox Confirm","icon":"quote-left","mode":"wide","href":"/api-reference/sandbox"},{"title":"POST Confirm PayIn","openapi":"post /api/v1/sandbox/payin/confirm","href":"/api-reference/sandbox/post-confirm-payin"},{"title":"POST Confirm PayOut","openapi":"post /api/v1/sandbox/payout/confirm","href":"/api-reference/sandbox/post-confirm-payout"}]}]}]},"basePath":"","title":"POST Create Subscription - Tumipay API","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-B6WFFOBL.js","utils-BN5um1KA.js","cloneDeep-C3md22mN.js","_Uint8Array-DLlL8L26.js","isObject-FP1Yky1u.js","utils-BSmbkXJR.js","addUniqueKeysToSchema-2tqcVnUE.js","snippetPresets-CtWfvr2J.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-DkKHBy30.js","isEqual-O3q7y6pq.js","usePlaygroundInputsStore-Brc5H9UJ.js","shallow-C4L4xvbs.js","getApiPlaygroundDisplay-2bxyq_aI.js","CodeSnippet-BJu8ddd5.js","CodeSnippets-dazWmoqB.js","Page-CnLhKuUV.js","getPastedJson-Chy3Qa1S.js","icon-CyO7h3jh.js","MethodPill-Dle0_91v.js","DuplicateIcon-CVvWAf4a.js","createIcon-Di07A27B.js","DynamicMarkdown-C4w9kavL.js","SectionHeading-XiBebVYC.js","axios-vUo_bRtp.js","Markdown-DTeL0SpS.js","dist-OCScizqf.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-KcneGfMY.js"]}