{ "code": "NOT_FOUND", "status": false, "message": "No se pudo localizar la suscripción solicitada con UUID: 550e8400-e29b-41d4-a716-446655440000"}
{ "code": "INVALID_STATE", "status": false, "message": "El pago no puede ser autorizado porque la suscripción no es válida."}
{ "code": "PAYMENT_AUTHORIZATION_FAILED", "status": false, "message": "La autorización de pago falló. Por favor, verifique la información proporcionada."}
{ "code": "SERVICE_ERROR", "status": false, "message": "Ocurrió un error. Por favor, intente nuevamente."}
Card Payment API
POST Preauthorize Transaction
Preauthorizes a configured amount for a subscription.
{ "code": "NOT_FOUND", "status": false, "message": "No se pudo localizar la suscripción solicitada con UUID: 550e8400-e29b-41d4-a716-446655440000"}
{ "code": "INVALID_STATE", "status": false, "message": "El pago no puede ser autorizado porque la suscripción no es válida."}
{ "code": "PAYMENT_AUTHORIZATION_FAILED", "status": false, "message": "La autorización de pago falló. Por favor, verifique la información proporcionada."}
{ "code": "SERVICE_ERROR", "status": false, "message": "Ocurrió un error. Por favor, intente nuevamente."}
Preauthorize an amount for a subscription without making the actual charge to the card. Preauthorization reserves funds and verifies that the card has sufficient availability.
{ "code": "NOT_FOUND", "status": false, "message": "No se pudo localizar la suscripción solicitada con UUID: 550e8400-e29b-41d4-a716-446655440000"}
{ "code": "INVALID_STATE", "status": false, "message": "El pago no puede ser autorizado porque la suscripción no es válida."}
{ "code": "PAYMENT_AUTHORIZATION_FAILED", "status": false, "message": "La autorización de pago falló. Por favor, verifique la información proporcionada."}
{ "code": "SERVICE_ERROR", "status": false, "message": "Ocurrió un error. Por favor, intente nuevamente."}
Required Headers
string
required
Merchant authentication token
string
required
Basic authentication (Basic Auth)
string
required
Unique identifier of the merchant invoking Card Payment services
string
required
Unique tracking identifier for the request
string
required
Must be “application/json”
Request Body Parameters
string
required
Identifier of the subscription for which the payment is preauthorized
string
Unique transaction identifier provided by the client. If not provided, the system generates one automatically.
string
required
Currency code for transaction processing (e.g., “COP”, “PEN”, “USD”)
number
required
Amount to preauthorize. Must be a positive value.
number
required
Processing tax associated with the transaction. If no tax will be charged, send 0.
Validation Rules
Required Fields
Field
Type
Rules
Description
subscription_id
string
required, max:36
Subscription UUID
reference_id
string
required, max:36
Unique payment reference identifier
currency
string
required, max:3
ISO 4217 currency code
amount
numeric
required, min:0
Payment amount (must be greater than or equal to 0)
tax
numeric
required, min:0
Payment tax (must be greater than or equal to 0)
Allowed Values
currency
COP - Colombian Peso
Common Validation Error Messages
The following are common validation error messages returned by the API (in Spanish):
:attribute es obligatorio. - Required field missing
:attribute debe ser una cadena de texto. - Invalid data type (expected string)
:attribute debe ser un número. - Invalid data type (expected numeric)
:attribute no puede tener más de :max caracteres. - Maximum length exceeded
:attribute debe ser mayor o igual a :min. - Minimum value not met
:attribute no es válido. - Invalid value
Response Fields
Success Response (200 OK)
string
required
Response code. Value: "AUTHORIZED" when authorization is successful
boolean
required
Operation status. true when successful, false when there is an error
string
required
Descriptive message about the authorization result
object
required
Show Transaction data
string
required
Unique identifier of the created preauthorization transaction. This ID will be used to capture the transaction later.
string
required
Transaction processing date and time in ISO 8601 format with UTC timezone (format: Y-m-d\TH:i:s\Z)
string
required
Transaction status. Value: "APPROVED" when authorization is successful
string
required
Transaction type. Value: "PRE_AUTH_TRANSACTION" for preauthorization transactions
string
Transaction identifier provided by the client
number
required
Preauthorized amount
string
required
Transaction currency code (e.g., “COP”)
HTTP Status Codes
Status Code
Description
Response Body
200 OK
Successful authorization
status: true, code: "AUTHORIZED"
400 Bad Request
Missing required header (X-Merchant-ID or X-Request-ID)
Simple error message
401 Unauthorized
Authentication failed (invalid Token-Top or Authorization)
code: "UNAUTHORIZED"
404 Not Found
Subscription not found
code: "NOT_FOUND"
422 Unprocessable Entity
Validation error, invalid subscription state, or provider authorization failure
code: "VALIDATION_ERROR", "INVALID_STATE" or "PAYMENT_AUTHORIZATION_FAILED"
500 Internal Server Error
Internal server error
code: "SERVICE_ERROR"
Response Codes
Code
Description
AUTHORIZED
Successful authorization
VALIDATION_ERROR
Validation error in sent data (missing fields, incorrect types, invalid currency, etc.)
UNAUTHORIZED
Authentication error
NOT_FOUND
Subscription not found
INVALID_STATE
The subscription is not in ACTIVE state (cannot authorize payments)
PAYMENT_AUTHORIZATION_FAILED
Authorization failed at the payment provider
SERVICE_ERROR
Internal server error
Transaction Types
Pre-Authorization (PRE_AUTH_TRANSACTION)
Type: PRE_AUTH_TRANSACTION
Status: APPROVED (success) or DECLINED/ERROR (failure)
Purpose: Reserve funds without capturing them
Next Step: Requires an additional capture step to charge the funds
Supported Currencies
The currency field must be one of the allowed values according to the Currency enum. Example:
COP: Colombian Peso
Headers
X-Merchant-ID
string
required
Unique identifier of the Merchant invoking Card Payment services. Should not be used to authenticate end users.
X-Request-ID
string
required
Tracking identifier associated with the request, used to establish a correlation_id between ecosystem components.
Token-Top
string
required
Token for authentication.
Authorization
string
required
Basic authentication.
Body
application/json
reference_id
string<uuid>
required
Example:
"ORDER-123456"
subscription_id
string<uuid>
required
Example:
"550e8400-e29b-41d4-a716-446655440000"
currency
string
required
Example:
"COP"
amount
number
required
Required range: x >= 0
Example:
1500
tax
number
required
Required range: x >= 0
Example:
0
Response
Successful authorization. A new transaction of type PRE_AUTH_TRANSACTION is created.
Preauthorization response. Creates a new transaction of type PRE_AUTH_TRANSACTION.
code
string
required
Response code. Value: 'AUTHORIZED' when authorization is successful
Example:
"AUTHORIZED"
status
boolean
required
Operation status. true when successful, false when there is an error
Example:
true
message
string
required
Descriptive message about the authorization result
Example:
"Pago autorizado exitosamente"
data
object
required
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":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/card-payment/post-authorize","slug":"/api-reference/card-payment/post-authorize","pageMetadata":{"title":"POST Preauthorize Transaction","openapi":"post /api/subscription/card/authorize","description":"Preauthorizes a configured amount for a subscription.","href":"/api-reference/card-payment/post-authorize"},"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: \"Preauthorizes a configured amount for a subscription.\"\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`,strong:`strong`,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:`Preauthorize an amount for a subscription without making the actual charge to the card. Preauthorization reserves funds and verifies that the card has sufficient availability.`}),`\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:`subscription_id`,type:`string`,required:true,id:`param-subscription-id`,children:_jsx(_components.p,{children:`Identifier of the subscription for which the payment is preauthorized`})}),`\n`,_jsx(ParamField,{body:`reference_id`,type:`string`,id:`param-reference-id`,children:_jsx(_components.p,{children:`Unique transaction identifier provided by the client. If not provided, the system generates one automatically.`})}),`\n`,_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency`,children:_jsx(_components.p,{children:`Currency code for transaction processing (e.g., “COP”, “PEN”, “USD”)`})}),`\n`,_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount`,children:_jsx(_components.p,{children:`Amount to preauthorize. Must be a positive value.`})}),`\n`,_jsx(ParamField,{body:`tax`,type:`number`,required:true,id:`param-tax`,children:_jsxs(_components.p,{children:[`Processing tax associated with the transaction. If no tax will be charged, send `,_jsx(_components.code,{children:`0`}),`.`]})}),`\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:`subscription_id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`required, max:36`}),_jsx(_components.td,{children:`Subscription UUID`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`reference_id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`required, max:36`}),_jsx(_components.td,{children:`Unique payment reference identifier`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`currency`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`required, max:3`}),_jsx(_components.td,{children:`ISO 4217 currency code`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`amount`})}),_jsx(_components.td,{children:`numeric`}),_jsx(_components.td,{children:`required, min:0`}),_jsx(_components.td,{children:`Payment amount (must be greater than or equal to 0)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`tax`})}),_jsx(_components.td,{children:`numeric`}),_jsx(_components.td,{children:`required, min:0`}),_jsx(_components.td,{children:`Payment tax (must be greater than or equal to 0)`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`allowed-values`,children:`Allowed Values`}),`\n`,_jsx(Heading,{level:`4`,id:`currency`,children:`currency`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`COP`}),` - Colombian Peso`]}),`\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 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 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:`\"AUTHORIZED\"`}),` when authorization is successful`]})}),`\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 authorization result`})}),`\n`,_jsx(ResponseField,{name:`data`,type:`object`,required:true,id:`param-data`,children:_jsxs(Expandable,{title:`Transaction data`,children:[_jsx(ResponseField,{name:`transaction_id`,type:`string`,format:`uuid`,required:true,id:`param-transaction-id`,children:_jsx(_components.p,{children:`Unique identifier of the created preauthorization transaction. This ID will be used to capture the transaction later.`})}),_jsx(ResponseField,{name:`transaction_date`,type:`string`,format:`date-time`,required:true,id:`param-transaction-date`,children:_jsxs(_components.p,{children:[`Transaction processing date and time in ISO 8601 format with UTC timezone (format: `,_jsx(_components.code,{children:`Y-m-d\\\\TH:i:s\\\\Z`}),`)`]})}),_jsx(ResponseField,{name:`transaction_status`,type:`string`,required:true,id:`param-transaction-status`,children:_jsxs(_components.p,{children:[`Transaction status. Value: `,_jsx(_components.code,{children:`\"APPROVED\"`}),` when authorization is successful`]})}),_jsx(ResponseField,{name:`transaction_type`,type:`string`,required:true,id:`param-transaction-type`,children:_jsxs(_components.p,{children:[`Transaction type. Value: `,_jsx(_components.code,{children:`\"PRE_AUTH_TRANSACTION\"`}),` for preauthorization transactions`]})}),_jsx(ResponseField,{name:`reference_id`,type:`string`,id:`param-reference-id-1`,children:_jsx(_components.p,{children:`Transaction identifier provided by the client`})}),_jsx(ResponseField,{name:`amount`,type:`number`,required:true,id:`param-amount-1`,children:_jsx(_components.p,{children:`Preauthorized amount`})}),_jsx(ResponseField,{name:`currency`,type:`string`,required:true,id:`param-currency-1`,children:_jsx(_components.p,{children:`Transaction currency code (e.g., “COP”)`})})]})}),`\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 authorization`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`status: true`}),`, `,_jsx(_components.code,{children:`code: \"AUTHORIZED\"`})]})]}),_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:`404 Not Found`})}),_jsx(_components.td,{children:`Subscription 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, invalid subscription state, or provider authorization failure`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`code: \"VALIDATION_ERROR\"`}),`, `,_jsx(_components.code,{children:`\"INVALID_STATE\"`}),` or `,_jsx(_components.code,{children:`\"PAYMENT_AUTHORIZATION_FAILED\"`})]})]}),_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:`AUTHORIZED`})}),_jsx(_components.td,{children:`Successful authorization`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`VALIDATION_ERROR`})}),_jsx(_components.td,{children:`Validation error in sent data (missing fields, incorrect types, invalid currency, etc.)`})]}),_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:`Subscription not found`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_STATE`})}),_jsxs(_components.td,{children:[`The subscription is not in `,_jsx(_components.code,{children:`ACTIVE`}),` state (cannot authorize payments)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`PAYMENT_AUTHORIZATION_FAILED`})}),_jsx(_components.td,{children:`Authorization failed at the payment provider`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`SERVICE_ERROR`})}),_jsx(_components.td,{children:`Internal server error`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`transaction-types`,children:`Transaction Types`}),`\n`,_jsx(Heading,{level:`3`,id:`pre-authorization-pre_auth_transaction`,children:`Pre-Authorization (PRE_AUTH_TRANSACTION)`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Type`}),`: `,_jsx(_components.code,{children:`PRE_AUTH_TRANSACTION`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Status`}),`: `,_jsx(_components.code,{children:`APPROVED`}),` (success) or `,_jsx(_components.code,{children:`DECLINED`}),`/`,_jsx(_components.code,{children:`ERROR`}),` (failure)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Purpose`}),`: Reserve funds without capturing them`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Next Step`}),`: Requires an additional capture step to charge the funds`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`supported-currencies`,children:`Supported Currencies`}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`currency`}),` field must be one of the allowed values according to the `,_jsx(_components.code,{children:`Currency`}),` enum. Example:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`COP`}),`: Colombian Peso`]}),`\n`]})]})}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 Preauthorize Transaction","openapi":"post /api/subscription/card/authorize","description":"Preauthorizes a configured amount for a subscription.","href":"/api-reference/card-payment/post-authorize"}}},"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`,strong:`strong`,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:`Preauthorize an amount for a subscription without making the actual charge to the card. Preauthorization reserves funds and verifies that the card has sufficient availability.`}),`\n`,_jsx(RequestExample,{children:_jsx(CodeBlock,{filename:``,numberOfLines:`13`,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:`13`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --request`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://tumipay-card-payments.uat.topup.com.co/production/api/v1/subscription/card/authorize'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},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:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},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:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},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:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},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:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},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:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},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:` \"subscription_id\": \"sub_93af8f63-97d1-4be0-9e0d-f6fd8c2d92a0\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"reference_id\": \"ref_2025_001\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"currency\": \"COP\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"amount\": 400000,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"tax\": 0`})}),`\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 - Payment Authorized (200)`,numberOfLines:`14`,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:`14`,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:`\"AUTHORIZED\"`}),_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:`\"Pago autorizado 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:` \"transaction_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\"`}),_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:` \"transaction_date\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2025-12-23T10:30:45Z\"`}),_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:` \"transaction_status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"APPROVED\"`}),_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:` \"transaction_type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"PRE_AUTH_TRANSACTION\"`}),_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:` \"reference_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"reference-uuid-123\"`}),_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:` \"amount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`100.0`}),_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:` \"currency\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"COP\"`})]}),`\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:`\"reference_id is required.\"`})]}),`\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:`Subscription 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:`\"No se pudo localizar la suscripción solicitada con UUID: 550e8400-e29b-41d4-a716-446655440000\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Invalid Subscription State - Not Active (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:`\"INVALID_STATE\"`}),_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 pago no puede ser autorizado porque la suscripción no es válida.\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Payment Authorization Failed (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:`\"PAYMENT_AUTHORIZATION_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:`\"La autorización de pago falló. Por favor, verifique la información proporcionada.\"`})]}),`\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. Por favor, intente nuevamente.\"`})]}),`\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:`subscription_id`,type:`string`,required:true,id:`param-subscription-id`,children:_jsx(_components.p,{children:`Identifier of the subscription for which the payment is preauthorized`})}),`\n`,_jsx(ParamField,{body:`reference_id`,type:`string`,id:`param-reference-id`,children:_jsx(_components.p,{children:`Unique transaction identifier provided by the client. If not provided, the system generates one automatically.`})}),`\n`,_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency`,children:_jsx(_components.p,{children:`Currency code for transaction processing (e.g., “COP”, “PEN”, “USD”)`})}),`\n`,_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount`,children:_jsx(_components.p,{children:`Amount to preauthorize. Must be a positive value.`})}),`\n`,_jsx(ParamField,{body:`tax`,type:`number`,required:true,id:`param-tax`,children:_jsxs(_components.p,{children:[`Processing tax associated with the transaction. If no tax will be charged, send `,_jsx(_components.code,{children:`0`}),`.`]})}),`\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:`subscription_id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`required, max:36`}),_jsx(_components.td,{children:`Subscription UUID`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`reference_id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`required, max:36`}),_jsx(_components.td,{children:`Unique payment reference identifier`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`currency`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`required, max:3`}),_jsx(_components.td,{children:`ISO 4217 currency code`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`amount`})}),_jsx(_components.td,{children:`numeric`}),_jsx(_components.td,{children:`required, min:0`}),_jsx(_components.td,{children:`Payment amount (must be greater than or equal to 0)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`tax`})}),_jsx(_components.td,{children:`numeric`}),_jsx(_components.td,{children:`required, min:0`}),_jsx(_components.td,{children:`Payment tax (must be greater than or equal to 0)`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`allowed-values`,children:`Allowed Values`}),`\n`,_jsx(Heading,{level:`4`,id:`currency`,children:`currency`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`COP`}),` - Colombian Peso`]}),`\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 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 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:`\"AUTHORIZED\"`}),` when authorization is successful`]})}),`\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 authorization result`})}),`\n`,_jsx(ResponseField,{name:`data`,type:`object`,required:true,id:`param-data`,children:_jsxs(Expandable,{title:`Transaction data`,children:[_jsx(ResponseField,{name:`transaction_id`,type:`string`,format:`uuid`,required:true,id:`param-transaction-id`,children:_jsx(_components.p,{children:`Unique identifier of the created preauthorization transaction. This ID will be used to capture the transaction later.`})}),_jsx(ResponseField,{name:`transaction_date`,type:`string`,format:`date-time`,required:true,id:`param-transaction-date`,children:_jsxs(_components.p,{children:[`Transaction processing date and time in ISO 8601 format with UTC timezone (format: `,_jsx(_components.code,{children:`Y-m-d\\\\TH:i:s\\\\Z`}),`)`]})}),_jsx(ResponseField,{name:`transaction_status`,type:`string`,required:true,id:`param-transaction-status`,children:_jsxs(_components.p,{children:[`Transaction status. Value: `,_jsx(_components.code,{children:`\"APPROVED\"`}),` when authorization is successful`]})}),_jsx(ResponseField,{name:`transaction_type`,type:`string`,required:true,id:`param-transaction-type`,children:_jsxs(_components.p,{children:[`Transaction type. Value: `,_jsx(_components.code,{children:`\"PRE_AUTH_TRANSACTION\"`}),` for preauthorization transactions`]})}),_jsx(ResponseField,{name:`reference_id`,type:`string`,id:`param-reference-id-1`,children:_jsx(_components.p,{children:`Transaction identifier provided by the client`})}),_jsx(ResponseField,{name:`amount`,type:`number`,required:true,id:`param-amount-1`,children:_jsx(_components.p,{children:`Preauthorized amount`})}),_jsx(ResponseField,{name:`currency`,type:`string`,required:true,id:`param-currency-1`,children:_jsx(_components.p,{children:`Transaction currency code (e.g., “COP”)`})})]})}),`\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 authorization`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`status: true`}),`, `,_jsx(_components.code,{children:`code: \"AUTHORIZED\"`})]})]}),_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:`404 Not Found`})}),_jsx(_components.td,{children:`Subscription 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, invalid subscription state, or provider authorization failure`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`code: \"VALIDATION_ERROR\"`}),`, `,_jsx(_components.code,{children:`\"INVALID_STATE\"`}),` or `,_jsx(_components.code,{children:`\"PAYMENT_AUTHORIZATION_FAILED\"`})]})]}),_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:`AUTHORIZED`})}),_jsx(_components.td,{children:`Successful authorization`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`VALIDATION_ERROR`})}),_jsx(_components.td,{children:`Validation error in sent data (missing fields, incorrect types, invalid currency, etc.)`})]}),_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:`Subscription not found`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_STATE`})}),_jsxs(_components.td,{children:[`The subscription is not in `,_jsx(_components.code,{children:`ACTIVE`}),` state (cannot authorize payments)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`PAYMENT_AUTHORIZATION_FAILED`})}),_jsx(_components.td,{children:`Authorization failed at the payment provider`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`SERVICE_ERROR`})}),_jsx(_components.td,{children:`Internal server error`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`transaction-types`,children:`Transaction Types`}),`\n`,_jsx(Heading,{level:`3`,id:`pre-authorization-pre_auth_transaction`,children:`Pre-Authorization (PRE_AUTH_TRANSACTION)`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Type`}),`: `,_jsx(_components.code,{children:`PRE_AUTH_TRANSACTION`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Status`}),`: `,_jsx(_components.code,{children:`APPROVED`}),` (success) or `,_jsx(_components.code,{children:`DECLINED`}),`/`,_jsx(_components.code,{children:`ERROR`}),` (failure)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Purpose`}),`: Reserve funds without capturing them`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Next Step`}),`: Requires an additional capture step to charge the funds`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`supported-currencies`,children:`Supported Currencies`}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`currency`}),` field must be one of the allowed values according to the `,_jsx(_components.code,{children:`Currency`}),` enum. Example:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`COP`}),`: Colombian Peso`]}),`\n`]})]})}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 Preauthorize Transaction","openapi":"post /api/subscription/card/authorize","description":"Preauthorizes a configured amount for a subscription.","href":"/api-reference/card-payment/post-authorize"}}}},"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":"currency","slug":"currency","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":[]},{"title":"Transaction Types","slug":"transaction-types","depth":2,"children":[{"title":"Pre-Authorization (PRE_AUTH_TRANSACTION)","slug":"pre-authorization-pre_auth_transaction","depth":3,"children":[]}]},{"title":"Supported Currencies","slug":"supported-currencies","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=\"13\">\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --request\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> POST\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'https://tumipay-card-payments.uat.topup.com.co/production/api/v1/subscription/card/authorize'\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\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:#CF222E;--shiki-dark:#D7BA7D\"> \\\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:#CF222E;--shiki-dark:#D7BA7D\"> \\\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:#CF222E;--shiki-dark:#D7BA7D\"> \\\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:#CF222E;--shiki-dark:#D7BA7D\"> \\\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:#CF222E;--shiki-dark:#D7BA7D\"> \\\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\"> \"subscription_id\": \"sub_93af8f63-97d1-4be0-9e0d-f6fd8c2d92a0\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"reference_id\": \"ref_2025_001\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"currency\": \"COP\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"amount\": 400000,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"tax\": 0\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 - Payment Authorized (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=\"14\">\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\">\"AUTHORIZED\"\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\">\"Pago autorizado 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\"> \"transaction_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>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"transaction_date\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2025-12-23T10:30:45Z\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"transaction_status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"APPROVED\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"transaction_type\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"PRE_AUTH_TRANSACTION\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"reference_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"reference-uuid-123\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"amount\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">100.0\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"currency\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"COP\"\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\">\"reference_id is required.\"\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":"Subscription 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\">\"No se pudo localizar la suscripción solicitada con UUID: 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\u003c/code>\u003c/pre>"},{"filename":"Invalid Subscription State - Not Active (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\">\"INVALID_STATE\"\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 pago no puede ser autorizado porque la suscripción no es válida.\"\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":"Payment Authorization Failed (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\">\"PAYMENT_AUTHORIZATION_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\">\"La autorización de pago falló. Por favor, verifique la información proporcionada.\"\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. Por favor, intente nuevamente.\"\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":"Preauthorize a Transaction","description":"Preauthorizes a configured amount for a subscription.","operationId":"preAuthorizeCardPayment","parameters":["c9039b73-1534-46f2-b35b-745880410ece","0f0eb774-ba7a-441d-846d-72b7b2ca454f","55bb41ea-25b7-40c4-9e58-6c734d693cf9","b477f9f5-64e8-4533-a07a-395114ba0fbd"],"requestBody":"917ebbc6-6bcf-4a86-b3a3-4bf2c77a7cca","responses":{"200":"2c1693f2-9c56-4a43-8636-01802b9d94b2","400":"4004ef63-5e48-4a33-a47b-a036f8e46a59","401":"5e0fab6f-9f2a-4165-8f75-e34868f9c155","404":"1e37445a-2614-4c18-9bbc-37b9d176019b","422":"673ecda4-c450-44a1-8865-9c335f946db8","500":"f3160199-72a4-4a2c-bcf6-1462db85aa3e"},"method":"post","type":"path","servers":["f847c058-083c-482e-847c-1e542c64ab1f"],"security":[],"path":"/api/subscription/card/authorize","baseUrlOptions":["https://tumipay-card-payments.uat.topup.com.co/production"],"title":"Preauthorize a Transaction","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":"13","children":[{"type":"span","key":"0","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#953800","--shiki-dark":"#DCDCAA"},"children":"curl"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#0550AE","--shiki-dark":"#569CD6"},"children":" --request"}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" POST"}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" 'https://tumipay-card-payments.uat.topup.com.co/production/api/v1/subscription/card/authorize'"}},{"type":"span","key":"4","ref":null,"props":{"style":{"color":"#CF222E","--shiki-dark":"#D7BA7D"},"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":"#CF222E","--shiki-dark":"#D7BA7D"},"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":"#CF222E","--shiki-dark":"#D7BA7D"},"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":"#CF222E","--shiki-dark":"#D7BA7D"},"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":"#CF222E","--shiki-dark":"#D7BA7D"},"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":"#CF222E","--shiki-dark":"#D7BA7D"},"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":" \"subscription_id\": \"sub_93af8f63-97d1-4be0-9e0d-f6fd8c2d92a0\","}}}},"\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":" \"reference_id\": \"ref_2025_001\","}}}},"\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":" \"currency\": \"COP\","}}}},"\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":" \"amount\": 400000,"}}}},"\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":" \"tax\": 0"}}}},"\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":"}'"}}}},"\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":"14","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":"\"AUTHORIZED\""}},{"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":"\"Pago autorizado 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":" \"transaction_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\""}},{"type":"span","key":"3","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":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"transaction_date\""}},{"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":"\"2025-12-23T10:30:45Z\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"14","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"transaction_status\""}},{"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":"\"APPROVED\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"16","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"transaction_type\""}},{"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":"\"PRE_AUTH_TRANSACTION\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"18","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"reference_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":"\"reference-uuid-123\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"20","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"amount\""}},{"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":"#B5CEA8"},"children":"100.0"}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"22","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"currency\""}},{"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":"\"COP\""}}]}},"\n",{"type":"span","key":"24","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":" }"}}}},"\n",{"type":"span","key":"26","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"}"}}}},"\n"]}}}},"filename":"Success - Payment Authorized (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":"\"reference_id is required.\""}}]}},"\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":"\"No se pudo localizar la suscripción solicitada con UUID: 550e8400-e29b-41d4-a716-446655440000\""}}]}},"\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 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":"\"INVALID_STATE\""}},{"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 pago no puede ser autorizado porque la suscripción no es válida.\""}}]}},"\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":"Invalid Subscription State - Not Active (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":"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":"\"PAYMENT_AUTHORIZATION_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":"\"La autorización de pago falló. Por favor, verifique la información proporcionada.\""}}]}},"\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":"Payment Authorization Failed (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":"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. Por favor, intente nuevamente.\""}}]}},"\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":{"c9039b73-1534-46f2-b35b-745880410ece":{"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"}},"0f0eb774-ba7a-441d-846d-72b7b2ca454f":{"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"}},"55bb41ea-25b7-40c4-9e58-6c734d693cf9":{"name":"Token-Top","in":"header","required":true,"description":"Token for authentication.","schema":{"type":"string","isRequired":true,"description":"Token for authentication.","uniqueKey":"","typeLabel":"string"}},"b477f9f5-64e8-4533-a07a-395114ba0fbd":{"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":["reference_id","subscription_id","currency","amount","tax"],"properties":{"reference_id":{"type":"string","format":"uuid","example":"ORDER-123456","isRequired":true,"uniqueKey":"reference_id","typeLabel":"string\u003cuuid>"},"subscription_id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000","isRequired":true,"uniqueKey":"subscription_id","typeLabel":"string\u003cuuid>"},"currency":{"type":"string","example":"COP","isRequired":true,"uniqueKey":"currency","typeLabel":"string"},"amount":{"type":"number","minimum":0,"example":1500,"isRequired":true,"uniqueKey":"amount","typeLabel":"number"},"tax":{"type":"number","minimum":0,"example":0,"isRequired":true,"uniqueKey":"tax","typeLabel":"number"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"reference_id":"ORDER-123456","subscription_id":"550e8400-e29b-41d4-a716-446655440000","currency":"COP","amount":1500,"tax":0}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"2c1693f2-9c56-4a43-8636-01802b9d94b2":{"description":"Successful authorization. A new transaction of type PRE_AUTH_TRANSACTION is created.","content":{"application/json":{"schema":{"type":"object","description":"Preauthorization response. Creates a new transaction of type PRE_AUTH_TRANSACTION.","required":["code","status","message","data"],"properties":{"code":{"type":"string","description":"Response code. Value: 'AUTHORIZED' when authorization is successful","example":"AUTHORIZED","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"status":{"type":"boolean","description":"Operation status. true when successful, false when there is an error","example":true,"isRequired":true,"uniqueKey":"status","typeLabel":"boolean"},"message":{"type":"string","description":"Descriptive message about the authorization result","example":"Pago autorizado exitosamente","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"data":{"type":"object","properties":{"transaction_id":{"type":"string","format":"uuid","description":"Unique identifier of the created preauthorization transaction. This ID will be used to capture the transaction later.","example":"550e8400-e29b-41d4-a716-446655440000","isRequired":true,"uniqueKey":"data.transaction_id","typeLabel":"string\u003cuuid>"},"transaction_date":{"type":"string","format":"date-time","description":"Transaction processing date and time in ISO 8601 format with UTC timezone (format: Y-m-d\\TH:i:s\\Z)","example":"2025-12-23T10:30:45Z","isRequired":true,"uniqueKey":"data.transaction_date","typeLabel":"string\u003cdate-time>"},"transaction_status":{"type":"string","description":"Transaction status. Value: 'APPROVED' when authorization is successful","example":"APPROVED","isRequired":true,"uniqueKey":"data.transaction_status","typeLabel":"string"},"transaction_type":{"type":"string","description":"Transaction type. Value: 'PRE_AUTH_TRANSACTION' for preauthorization transactions","example":"PRE_AUTH_TRANSACTION","isRequired":true,"uniqueKey":"data.transaction_type","typeLabel":"string"},"amount":{"type":"number","description":"Preauthorized amount","example":100,"isRequired":true,"uniqueKey":"data.amount","typeLabel":"number"},"currency":{"type":"string","description":"Transaction currency code (e.g., 'COP')","example":"COP","isRequired":true,"uniqueKey":"data.currency","typeLabel":"string"},"reference_id":{"type":"string","description":"Transaction identifier provided by the client","example":"reference-uuid-123","uniqueKey":"data.reference_id","typeLabel":"string"}},"required":["transaction_id","transaction_date","transaction_status","transaction_type","amount","currency"],"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"success":{"title":"success","summary":"Authorization successful","value":{"code":"AUTHORIZED","status":true,"message":"Pago autorizado exitosamente","data":{"transaction_id":"550e8400-e29b-41d4-a716-446655440000","transaction_date":"2025-12-23T10:30:45Z","transaction_status":"APPROVED","transaction_type":"PRE_AUTH_TRANSACTION","reference_id":"reference-uuid-123","amount":100,"currency":"COP"}}}},"exampleType":"examples"}},"exampleType":"examples"},"4004ef63-5e48-4a33-a47b-a036f8e46a59":{"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"},"5e0fab6f-9f2a-4165-8f75-e34868f9c155":{"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"},"1e37445a-2614-4c18-9bbc-37b9d176019b":{"description":"Subscription 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"},"673ecda4-c450-44a1-8865-9c335f946db8":{"description":"Validation error, invalid subscription state, or payment provider authorization failure.","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"},"f3160199-72a4-4a2c-bcf6-1462db85aa3e":{"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 Preauthorize Transaction - Tumipay API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-12T14:55:29.778Z","originalFileLocation":"api-reference/card-payment/post-authorize.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=\"Preauthorizes a configured amount for a subscription.\">\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 Preauthorize Transaction - Tumipay API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Preauthorizes a configured amount for a subscription.\">\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-authorize\">\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+Preauthorize+Transaction\u0026amp;description=Preauthorizes+a+configured+amount+for+a+subscription.\u0026amp;theme=2402adaf66664b56ab7f2981\u0026amp;signature=47e0fcbd051b877497ca02de28c5c18389461fec94930eff3b125be1fbe6efe9\">\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 Preauthorize Transaction - Tumipay API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Preauthorizes a configured amount for a subscription.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://tumipay-f61949a2.mintlify.site/_mintlify/api/og/v2?division=Card+Payment+API\u0026amp;title=POST+Preauthorize+Transaction\u0026amp;description=Preauthorizes+a+configured+amount+for+a+subscription.\u0026amp;theme=2402adaf66664b56ab7f2981\u0026amp;signature=47e0fcbd051b877497ca02de28c5c18389461fec94930eff3b125be1fbe6efe9\">\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-authorize\">\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-authorize.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-authorize#webpage\",\"url\":\"https://docs.v2.topup.com.co/api-reference/card-payment/post-authorize\",\"name\":\"POST Preauthorize Transaction\",\"description\":\"Preauthorizes a configured amount for a subscription.\",\"dateModified\":\"2026-11-12T14:55:29.778Z\",\"isPartOf\":{\"@id\":\"https://docs.v2.topup.com.co#website\"},\"breadcrumb\":{\"@id\":\"https://docs.v2.topup.com.co/api-reference/card-payment/post-authorize#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.v2.topup.com.co/api-reference/card-payment/post-authorize#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 Preauthorize Transaction\",\"item\":\"https://docs.v2.topup.com.co/api-reference/card-payment/post-authorize\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.v2.topup.com.co/api-reference/card-payment/post-authorize#apireference\",\"headline\":\"POST Preauthorize Transaction\",\"name\":\"POST Preauthorize Transaction\",\"description\":\"Preauthorizes a configured amount for a subscription.\",\"url\":\"https://docs.v2.topup.com.co/api-reference/card-payment/post-authorize\",\"mainEntityOfPage\":{\"@id\":\"https://docs.v2.topup.com.co/api-reference/card-payment/post-authorize#webpage\"},\"dateModified\":\"2026-11-12T14:55:29.778Z\",\"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-authorize.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","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","description":"Preauthorizes a configured amount for a subscription in a renewal cycle.","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 Preauthorize Transaction - 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"]}