Processes payment for an existing payment order that was created with pending: true. This is the second step of the two-step payment flow. The order must be in PENDING status. Provide the payment method and optional billing/device information to process the charge. The persist flag on payment methods is not supported for this endpoint. This is an internal endpoint.
Cumulative sum of captured amounts on this order. On split-tender orders that get partially refunded and re-paid, this can grow beyond amount because it is a historical ledger; use amountPending (or compute amountPaid - amountRefunded) to know the live balance.
Cumulative sum of refunded amounts across the order's Payments. Like amountPaid, this is a historical ledger and is bounded per Payment by module-payment.
All Payments associated with this order, ordered by creation time (oldest first), including the one in the payment field. Useful for split-tender clients that need to enumerate every Payment.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Cheqpay","colors":{"primary":"#16A34A","light":"#07C983","dark":"#15803D"},"logo":{"light":"https://mintcdn.com/cheqpay/WjCfb-k6AR5eUe0H/logo/logo.svg?fit=max\u0026auto=format\u0026n=WjCfb-k6AR5eUe0H\u0026q=85\u0026s=6e22e4768984a8158b3094e120aaf1ff","dark":"https://mintcdn.com/cheqpay/WjCfb-k6AR5eUe0H/logo/logo.svg?fit=max\u0026auto=format\u0026n=WjCfb-k6AR5eUe0H\u0026q=85\u0026s=6e22e4768984a8158b3094e120aaf1ff","href":"https://www.cheqpay.mx/"},"favicon":"https://mintlify.s3.us-west-1.amazonaws.com/cheqpay/logo/logo.avif","navbar":{},"footer":{"socials":{"x":"https://x.com/cheqpay","github":"https://github.com/cheqpay","linkedin":"https://linkedin.com/company/cheqpay"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cheqpay","hasAudioNarration":false,"actualSubdomain":"cheqpay","customDomains":["docs.cheqpay.mx"],"gitSource":{"type":"github","owner":"cheqpay","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6aac66185343956ba6628a63","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"default","tag":"Payment Orchestrator API","count":37},{"language":"default","tag":"Features","count":14},{"language":"default","tag":"Link Product API","count":13},{"language":"default","tag":"Payment Order","count":9},{"language":"default","tag":"Products","count":6},{"language":"default","tag":"Subscription","count":6},{"language":"default","tag":"Customer V2","count":5},{"language":"default","tag":"Payment Method","count":5},{"language":"default","tag":"Subscription Plan","count":5},{"language":"default","tag":"Guides","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":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":"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":"llms-txt-v2","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":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/payment-order/charge-a-pending-payment-order","slug":"/api-reference/payment-order/charge-a-pending-payment-order","pageMetadata":{"title":"Charge a pending payment order","description":"Processes payment for an existing payment order that was created with `pending: true`. This is the second step of the two-step payment flow. The order must be in PENDING status. Provide the payment method and optional billing/device information to process the charge. The persist flag on payment methods is not supported for this endpoint. This is an internal endpoint.","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json post /v2/payment-orders/{id}/charge","href":"/api-reference/payment-order/charge-a-pending-payment-order","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Processes payment for an existing payment order that was created with \", _jsx(_components.code, {\n children: \"pending: true\"\n }), \". This is the second step of the two-step payment flow. The order must be in PENDING status. Provide the payment method and optional billing/device information to process the charge. The persist flag on payment methods is not supported for this endpoint. This is an internal endpoint.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Charge a pending payment order","description":"Processes payment for an existing payment order that was created with `pending: true`. This is the second step of the two-step payment flow. The order must be in PENDING status. Provide the payment method and optional billing/device information to process the charge. The persist flag on payment methods is not supported for this endpoint. This is an internal endpoint.","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json post /v2/payment-orders/{id}/charge","href":"/api-reference/payment-order/charge-a-pending-payment-order","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/cheqpay/bdac4afbee45d6cc/scripts/sync-openapi.js"],"openApiReferenceData":{"operation":{"tags":["Payment Order"],"summary":"Charge a pending payment order","description":"Processes payment for an existing payment order that was created with `pending: true`. This is the second step of the two-step payment flow. The order must be in PENDING status. Provide the payment method and optional billing/device information to process the charge. The persist flag on payment methods is not supported for this endpoint. This is an internal endpoint.","parameters":["dadee7f4-b19c-44c7-a393-c50915507212"],"requestBody":"c15cbdde-e7a5-4d47-b523-1ef5fb67e198","responses":{"200":"660426fe-4a6b-4325-9270-7523539e3cc1","400":"f1db2e36-0055-461c-820b-e97661dcfc55","401":"10f5eb62-952d-4156-9e83-f181df477186","404":"8f2b165c-12f3-4b96-aa86-de12a14e5149","500":"01e3ebc0-e2c2-4aaf-8906-b3ac325f7390"},"method":"post","type":"path","servers":["6182b33a-254e-4891-b1a5-d7816dd9a3d5","a5b2f960-aba9-4c0c-92f6-0448d75e6592"],"security":["c1b7f425-f23b-463f-b717-1ede7de2843d"],"path":"/v2/payment-orders/{id}/charge","baseUrlOptions":["https://api.sandbox.cheqpay.mx/pos","https://prod.cheqpay.mx/pos"],"title":"Charge a pending payment order","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"dadee7f4-b19c-44c7-a393-c50915507212":{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"description":"Payment order ID","uniqueKey":"","typeLabel":"string\u003cuuid>"},"description":"Payment order ID"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["paymentMethod"],"description":"Request body for charging a pending payment order. The persist flag is not supported when charging a pending order.","properties":{"paymentMethod":{"oneOf":[{"type":"object","required":["type","cardDetails"],"properties":{"type":{"type":"string","enum":["card"],"description":"Payment method type","isRequired":true,"uniqueKey":"paymentMethod.oneOf.0.type","typeLabel":"enum\u003cstring>"},"cardDetails":{"type":"object","required":["number","expiryMonth","expiryYear","cvc"],"properties":{"number":{"type":"string","minLength":1,"description":"Card number","example":"4111111111111111","isRequired":true,"uniqueKey":"paymentMethod.oneOf.0.cardDetails.number","typeLabel":"string"},"expiryMonth":{"type":"string","minLength":2,"maxLength":2,"pattern":"^(0[1-9]|1[0-2])$","description":"Two-digit expiry month (01-12)","example":"12","isRequired":true,"uniqueKey":"paymentMethod.oneOf.0.cardDetails.expiryMonth","typeLabel":"string"},"expiryYear":{"type":"string","minLength":2,"maxLength":2,"description":"Two-digit expiry year","example":"25","isRequired":true,"uniqueKey":"paymentMethod.oneOf.0.cardDetails.expiryYear","typeLabel":"string"},"cvc":{"type":"string","minLength":1,"description":"Card CVC/CVV","example":"123","isRequired":true,"uniqueKey":"paymentMethod.oneOf.0.cardDetails.cvc","typeLabel":"string"}},"isRequired":true,"uniqueKey":"paymentMethod.oneOf.0.cardDetails","typeLabel":"object"}},"isRequired":true,"uniqueKey":"paymentMethod.oneOf.0","typeLabel":"object"},{"type":"object","required":["type","paymentMethodId"],"properties":{"type":{"type":"string","enum":["payment_method_id"],"description":"Use existing payment method","isRequired":true,"uniqueKey":"paymentMethod.oneOf.1.type","typeLabel":"enum\u003cstring>"},"paymentMethodId":{"type":"string","minLength":1,"description":"ID of the saved payment method","example":"pm_123456789","isRequired":true,"uniqueKey":"paymentMethod.oneOf.1.paymentMethodId","typeLabel":"string"}},"isRequired":true,"uniqueKey":"paymentMethod.oneOf.1","typeLabel":"object"},{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["spei"],"description":"SPEI transfer payment method","isRequired":true,"uniqueKey":"paymentMethod.oneOf.2.type","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"paymentMethod.oneOf.2","typeLabel":"object"},{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["cie_cash_net"],"description":"CIE Cash Net payment method for cash payments at convenience stores","isRequired":true,"uniqueKey":"paymentMethod.oneOf.3.type","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"paymentMethod.oneOf.3","typeLabel":"object"}],"isRequired":true,"uniqueKey":"paymentMethod","typeLabel":"object"},"billingAddress":{"type":"object","description":"Billing address (required when paymentMethod.type is 'card')","properties":{"address":{"type":"string","description":"Street address","example":"123 Main St","uniqueKey":"billingAddress.address","typeLabel":"string"},"city":{"type":"string","description":"City name","example":"Mexico City","uniqueKey":"billingAddress.city","typeLabel":"string"},"state":{"type":"string","description":"State or province","example":"CDMX","uniqueKey":"billingAddress.state","typeLabel":"string"},"postalCode":{"type":"string","description":"Postal or ZIP code","example":"01000","uniqueKey":"billingAddress.postalCode","typeLabel":"string"},"country":{"type":"string","pattern":"^[A-Z]{2}$","description":"Two-letter country code (ISO 3166-1 alpha-2)","example":"MX","uniqueKey":"billingAddress.country","typeLabel":"string"}},"uniqueKey":"billingAddress","typeLabel":"object"},"deviceInformation":{"type":"object","description":"Device and browser information for fraud detection","properties":{"ipAddress":{"type":"string","description":"IP address of the device","example":"192.168.1.1","uniqueKey":"deviceInformation.ipAddress","typeLabel":"string"},"userAgent":{"type":"string","description":"User agent string","example":"Mozilla/5.0...","uniqueKey":"deviceInformation.userAgent","typeLabel":"string"},"userAgentBrowserValue":{"type":"string","description":"Browser type from user agent","uniqueKey":"deviceInformation.userAgentBrowserValue","typeLabel":"string"},"httpAcceptBrowserValue":{"type":"string","description":"HTTP Accept header value","uniqueKey":"deviceInformation.httpAcceptBrowserValue","typeLabel":"string"},"httpAcceptContent":{"type":"string","description":"HTTP Accept-Content header value","uniqueKey":"deviceInformation.httpAcceptContent","typeLabel":"string"},"fingerprintSessionId":{"type":"string","description":"Fingerprint session identifier","uniqueKey":"deviceInformation.fingerprintSessionId","typeLabel":"string"},"httpBrowserColorDepth":{"type":"string","description":"Browser color depth","example":"24","uniqueKey":"deviceInformation.httpBrowserColorDepth","typeLabel":"string"},"httpBrowserJavaEnabled":{"type":"boolean","description":"Whether Java is enabled in browser","uniqueKey":"deviceInformation.httpBrowserJavaEnabled","typeLabel":"boolean"},"httpBrowserJavaScriptEnabled":{"type":"boolean","description":"Whether JavaScript is enabled in browser","uniqueKey":"deviceInformation.httpBrowserJavaScriptEnabled","typeLabel":"boolean"},"httpBrowserLanguage":{"type":"string","description":"Browser language","example":"en-US","uniqueKey":"deviceInformation.httpBrowserLanguage","typeLabel":"string"},"httpBrowserScreenHeight":{"type":"string","description":"Browser screen height in pixels","example":"1080","uniqueKey":"deviceInformation.httpBrowserScreenHeight","typeLabel":"string"},"httpBrowserScreenWidth":{"type":"string","description":"Browser screen width in pixels","example":"1920","uniqueKey":"deviceInformation.httpBrowserScreenWidth","typeLabel":"string"},"httpBrowserTimeDifference":{"type":"string","description":"Browser time difference from UTC in minutes","uniqueKey":"deviceInformation.httpBrowserTimeDifference","typeLabel":"string"},"hostName":{"type":"string","description":"Hostname of the device","uniqueKey":"deviceInformation.hostName","typeLabel":"string"},"cookiesAccepted":{"type":"string","description":"Whether cookies are accepted","uniqueKey":"deviceInformation.cookiesAccepted","typeLabel":"string"},"httpBrowserEmail":{"type":"string","description":"Email from browser settings","uniqueKey":"deviceInformation.httpBrowserEmail","typeLabel":"string"}},"uniqueKey":"deviceInformation","typeLabel":"object"},"isVirtualTerminal":{"type":"boolean","default":false,"description":"Whether the payment originates from a Virtual Terminal. When true, the 3DS flow is skipped in the Decision Manager.","uniqueKey":"isVirtualTerminal","typeLabel":"boolean"}},"example":{"paymentMethod":{"type":"card","cardDetails":{"number":"4111111111111111","expiryMonth":"12","expiryYear":"25","cvc":"123"}},"billingAddress":{"address":"Av. Reforma 123","city":"Mexico City","state":"CDMX","postalCode":"01000","country":"MX"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"paymentMethod":{"type":"card","cardDetails":{"number":"4111111111111111","expiryMonth":"12","expiryYear":"25","cvc":"123"}},"billingAddress":{"address":"Av. Reforma 123","city":"Mexico City","state":"CDMX","postalCode":"01000","country":"MX"}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"660426fe-4a6b-4325-9270-7523539e3cc1":{"description":"Payment order charged successfully","content":{"application/json":{"schema":{"type":"object","required":["id","amount","currency","status"],"properties":{"id":{"type":"string","format":"uuid","description":"Payment order unique identifier","example":"123e4567-e89b-12d3-a456-426614174000","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"amount":{"type":"number","description":"Total amount charged to the customer (subtotalAmount + surchargeAmount).","example":257.5,"isRequired":true,"uniqueKey":"amount","typeLabel":"number"},"currency":{"type":"string","description":"Currency code","example":"MXN","isRequired":true,"uniqueKey":"currency","typeLabel":"string"},"status":{"type":"string","enum":["PENDING","PROCESSING","REFERENCE_GENERATED","AUTHORIZED","PARTIALLY_AUTHORIZED","ACTION_REQUIRED","COMPLETED","PARTIALLY_PAID","CANCELLATION_REQUESTED","CANCELLED","FAILED","REFUND_PROCESSING","PARTIALLY_REFUNDED","REFUNDED"],"description":"Payment order status","example":"PENDING","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"externalMerchantReference":{"type":"string","description":"External merchant reference ID","example":"ORDER-12345","uniqueKey":"externalMerchantReference","typeLabel":"string"},"subtotalAmount":{"type":"number","description":"Merchandise subtotal — the amount agreed before any surcharge. Immutable after order creation.","example":250,"uniqueKey":"subtotalAmount","typeLabel":"number"},"surchargeAmount":{"oneOf":[{"type":"number","description":"Surcharge applied on top of subtotalAmount. Null when no surcharge applies.","example":7.5,"uniqueKey":"surchargeAmount.oneOf.0","typeLabel":"number"},{"type":"null","description":"Surcharge applied on top of subtotalAmount. Null when no surcharge applies.","example":7.5,"uniqueKey":"surchargeAmount.oneOf.1","typeLabel":"null"}],"uniqueKey":"surchargeAmount","typeLabel":"number | null"},"surchargeRate":{"oneOf":[{"type":"number","description":"Snapshot of the merchant's surcharge rate (percent) at charge time. Null when no surcharge applies.","example":3,"uniqueKey":"surchargeRate.oneOf.0","typeLabel":"number"},{"type":"null","description":"Snapshot of the merchant's surcharge rate (percent) at charge time. Null when no surcharge applies.","example":3,"uniqueKey":"surchargeRate.oneOf.1","typeLabel":"null"}],"uniqueKey":"surchargeRate","typeLabel":"number | null"},"orderNumber":{"type":"string","description":"System-generated order number","example":"C25123101","uniqueKey":"orderNumber","typeLabel":"string"},"description":{"type":"string","description":"Payment order description","example":"Payment for order #12345","uniqueKey":"description","typeLabel":"string"},"metadata":{"oneOf":[{"type":"object","description":"Arbitrary JSON metadata stored with the payment order","additionalProperties":true,"example":{"orderId":"ORD-123","source":"web"},"uniqueKey":"metadata.oneOf.0","typeLabel":"object"},{"type":"null","description":"Arbitrary JSON metadata stored with the payment order","additionalProperties":true,"example":{"orderId":"ORD-123","source":"web"},"uniqueKey":"metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"metadata","typeLabel":"object | null"},"dueDate":{"oneOf":[{"type":"string","format":"date-time","description":"Due date for the payment order","example":"2026-04-15T00:00:00.000Z","uniqueKey":"dueDate.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Due date for the payment order","example":"2026-04-15T00:00:00.000Z","uniqueKey":"dueDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"dueDate","typeLabel":"string\u003cdate-time> | null"},"paidOn":{"oneOf":[{"type":"string","format":"date-time","description":"Timestamp when the payment order first reached COMPLETED (actual payment date, not creation).","example":"2025-10-20T10:05:00.000Z","uniqueKey":"paidOn.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Timestamp when the payment order first reached COMPLETED (actual payment date, not creation).","example":"2025-10-20T10:05:00.000Z","uniqueKey":"paidOn.oneOf.1","typeLabel":"null"}],"uniqueKey":"paidOn","typeLabel":"string\u003cdate-time> | null"},"refundedOn":{"oneOf":[{"type":"string","format":"date-time","description":"Timestamp when the payment order was first refunded.","example":"2025-10-21T09:00:00.000Z","uniqueKey":"refundedOn.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Timestamp when the payment order was first refunded.","example":"2025-10-21T09:00:00.000Z","uniqueKey":"refundedOn.oneOf.1","typeLabel":"null"}],"uniqueKey":"refundedOn","typeLabel":"string\u003cdate-time> | null"},"createdAt":{"type":"string","format":"date-time","description":"Creation timestamp","example":"2025-10-20T10:00:00.000Z","uniqueKey":"createdAt","typeLabel":"string\u003cdate-time>"},"paymentMethod":{"type":"object","properties":{"type":{"type":"string","description":"Payment method type","example":"card","uniqueKey":"paymentMethod.type","typeLabel":"string"},"id":{"type":"string","description":"Payment method ID (if persisted)","example":"pm_123456789","uniqueKey":"paymentMethod.id","typeLabel":"string"},"cardDetails":{"type":"object","description":"Card details (present when payment method type is 'card')","properties":{"id":{"type":"string","description":"Card ID","uniqueKey":"paymentMethod.cardDetails.id","typeLabel":"string"},"type":{"type":"string","description":"Card type","example":"CREDIT","uniqueKey":"paymentMethod.cardDetails.type","typeLabel":"string"},"bin":{"type":"string","description":"Bank identification number (first 6 digits)","example":"411111","uniqueKey":"paymentMethod.cardDetails.bin","typeLabel":"string"},"last4":{"type":"string","description":"Last 4 digits of card","example":"1111","uniqueKey":"paymentMethod.cardDetails.last4","typeLabel":"string"},"brand":{"type":"string","description":"Card brand","example":"VISA","uniqueKey":"paymentMethod.cardDetails.brand","typeLabel":"string"},"country":{"type":"string","description":"Card issuing country","example":"US","uniqueKey":"paymentMethod.cardDetails.country","typeLabel":"string"},"issuerBank":{"type":"string","description":"Card issuing bank","example":"CHASE","uniqueKey":"paymentMethod.cardDetails.issuerBank","typeLabel":"string"},"expiryMonth":{"type":"string","description":"Card expiry month","example":"12","uniqueKey":"paymentMethod.cardDetails.expiryMonth","typeLabel":"string"},"expiryYear":{"type":"string","description":"Card expiry year","example":"25","uniqueKey":"paymentMethod.cardDetails.expiryYear","typeLabel":"string"}},"uniqueKey":"paymentMethod.cardDetails","typeLabel":"object"},"speiDetails":{"type":"object","description":"SPEI details (present when payment method type is 'spei')","properties":{"clabe":{"type":"string","description":"CLABE account number for SPEI transfer (18 digits)","example":"123456789012345678","uniqueKey":"paymentMethod.speiDetails.clabe","typeLabel":"string"}},"uniqueKey":"paymentMethod.speiDetails","typeLabel":"object"},"cieDetails":{"type":"object","description":"CIE Cash Net details (present when payment method type is 'cie_cash_net')","properties":{"reference":{"type":"string","description":"CIE reference number for cash payment at convenience stores","example":"CIE0000000001","uniqueKey":"paymentMethod.cieDetails.reference","typeLabel":"string"},"convenio":{"type":"string","description":"BBVA account number for same-bank payments","example":"0123456789","uniqueKey":"paymentMethod.cieDetails.convenio","typeLabel":"string"},"clabe":{"type":"string","description":"Interbank account number (CLABE) for transfers from other banks","example":"012345678901234567","uniqueKey":"paymentMethod.cieDetails.clabe","typeLabel":"string"}},"uniqueKey":"paymentMethod.cieDetails","typeLabel":"object"},"paycashDetails":{"type":"object","description":"PayCash details (present when payment method type is 'paycash'). The reference is generated by the external PayCash API and used by the payer to deposit cash at affiliated convenience stores.","properties":{"reference":{"type":"string","description":"PayCash reference for cash payment at affiliated stores","example":"9318500000999888777","uniqueKey":"paymentMethod.paycashDetails.reference","typeLabel":"string"}},"uniqueKey":"paymentMethod.paycashDetails","typeLabel":"object"}},"uniqueKey":"paymentMethod","typeLabel":"object"},"allowPartials":{"type":"boolean","description":"Echoes the `allowPartials` flag from creation. When true, the order accepts additional Payments via the addPayment endpoint until it is fully covered.","example":true,"uniqueKey":"allowPartials","typeLabel":"boolean"},"amountPaid":{"type":"number","description":"Cumulative sum of captured amounts on this order. On split-tender orders that get partially refunded and re-paid, this can grow beyond `amount` because it is a historical ledger; use `amountPending` (or compute `amountPaid - amountRefunded`) to know the live balance.","example":200,"uniqueKey":"amountPaid","typeLabel":"number"},"amountPending":{"type":"number","description":"Outstanding amount left to cover, derived as `max(0, amount - (amountPaid - amountRefunded))`. Reaches 0 when the order is fully paid net of refunds.","example":50,"uniqueKey":"amountPending","typeLabel":"number"},"amountRefunded":{"type":"number","description":"Cumulative sum of refunded amounts across the order's Payments. Like `amountPaid`, this is a historical ledger and is bounded per Payment by module-payment.","example":50,"uniqueKey":"amountRefunded","typeLabel":"number"},"payment":{"type":"object","description":"The Payment that triggered this response (the one just created for the addPayment / charge call, or the original Payment for a regular create).","properties":{"id":{"type":"string","format":"uuid","example":"a0b0c9d4-6ce9-40e4-873a-e234c1d93639","uniqueKey":"payment.id","typeLabel":"string\u003cuuid>"},"amount":{"type":"string","example":"1000","uniqueKey":"payment.amount","typeLabel":"string"},"status":{"type":"string","description":"Payment status as reported by module-payment.","example":"CAPTURED","uniqueKey":"payment.status","typeLabel":"string"},"paymentMethodType":{"type":"string","example":"CARD","uniqueKey":"payment.paymentMethodType","typeLabel":"string"}},"uniqueKey":"payment","typeLabel":"object"},"payments":{"type":"array","description":"All Payments associated with this order, ordered by creation time (oldest first), including the one in the `payment` field. Useful for split-tender clients that need to enumerate every Payment.","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","uniqueKey":"payments.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"amount":{"type":"string","uniqueKey":"payments.items.[INDEX].amount","typeLabel":"string"},"status":{"type":"string","uniqueKey":"payments.items.[INDEX].status","typeLabel":"string"},"paymentMethodType":{"type":"string","uniqueKey":"payments.items.[INDEX].paymentMethodType","typeLabel":"string"},"createdAt":{"type":"string","format":"date-time","uniqueKey":"payments.items.[INDEX].createdAt","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"payments.items.[INDEX]","typeLabel":"object"},"uniqueKey":"payments","typeLabel":"object[]"},"customer":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Customer ID","example":"123e4567-e89b-12d3-a456-426614174000","uniqueKey":"customer.id","typeLabel":"string\u003cuuid>"},"firstName":{"type":"string","description":"Customer's first name","example":"John","uniqueKey":"customer.firstName","typeLabel":"string"},"lastName":{"type":"string","description":"Customer's last name","example":"Doe","uniqueKey":"customer.lastName","typeLabel":"string"},"email":{"type":"string","format":"email","description":"Customer's email","example":"john.doe@example.com","uniqueKey":"customer.email","typeLabel":"string\u003cemail>"},"phoneNumber":{"type":"string","description":"Customer's phone number","example":"+525512345678","uniqueKey":"customer.phoneNumber","typeLabel":"string"}},"uniqueKey":"customer","typeLabel":"object"},"payerAuthentication":{"type":"object","description":"3DS authentication details (when required)","properties":{"id":{"type":"string","description":"Authentication session ID","uniqueKey":"payerAuthentication.id","typeLabel":"string"},"url":{"type":"string","format":"uri-reference","description":"3DS authentication URL","uniqueKey":"payerAuthentication.url","typeLabel":"string\u003curi-reference>"},"jwt":{"type":"string","description":"JWT token for authentication","uniqueKey":"payerAuthentication.jwt","typeLabel":"string"},"stepUpUrl":{"type":"string","format":"uri-reference","description":"Step-up authentication URL","uniqueKey":"payerAuthentication.stepUpUrl","typeLabel":"string\u003curi-reference>"},"accessToken":{"type":"string","description":"Access token for authentication","uniqueKey":"payerAuthentication.accessToken","typeLabel":"string"}},"uniqueKey":"payerAuthentication","typeLabel":"object"}},"example":{"id":"123e4567-e89b-12d3-a456-426614174000","externalMerchantReference":"ORDER-12345","amount":250,"orderNumber":"C25123101","currency":"MXN","status":"PENDING","description":"Payment for order #12345","metadata":{"orderId":"ORD-123","source":"web"},"createdAt":"2025-10-20T10:00:00.000Z","paymentMethod":{"type":"card","cardDetails":{"last4":"1111","brand":"VISA","country":"US","expiryMonth":"12","expiryYear":"25"}},"customer":{"id":"123e4567-e89b-12d3-a456-426614174000","firstName":"John","lastName":"Doe","email":"john.doe@example.com","phoneNumber":"+525512345678"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"123e4567-e89b-12d3-a456-426614174000","externalMerchantReference":"ORDER-12345","amount":250,"orderNumber":"C25123101","currency":"MXN","status":"PENDING","description":"Payment for order #12345","metadata":{"orderId":"ORD-123","source":"web"},"createdAt":"2025-10-20T10:00:00.000Z","paymentMethod":{"type":"card","cardDetails":{"last4":"1111","brand":"VISA","country":"US","expiryMonth":"12","expiryYear":"25"}},"customer":{"id":"123e4567-e89b-12d3-a456-426614174000","firstName":"John","lastName":"Doe","email":"john.doe@example.com","phoneNumber":"+525512345678"}}}},"exampleType":"generated"}},"exampleType":"generated"},"f1db2e36-0055-461c-820b-e97661dcfc55":{"description":"Validation failed - missing required fields, invalid payment method, or order is not in PENDING status","content":{"application/json":{"schema":{"oneOf":[{"type":"object","description":"Validation error response","required":["message","errors"],"example":{"message":"Validation failed","errors":[{"field":"name","message":"Required"}]},"properties":{"message":{"type":"string","description":"Error message","example":"Validation failed","isRequired":true,"uniqueKey":"oneOf.0.message","typeLabel":"string"},"errors":{"type":"array","description":"List of validation errors","items":{"type":"object","properties":{"field":{"type":"string","description":"Field that failed validation","example":"name","uniqueKey":"oneOf.0.errors.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","description":"Validation error message","example":"Required","uniqueKey":"oneOf.0.errors.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"oneOf.0.errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"oneOf.0.errors","typeLabel":"object[]"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","properties":{"message":{"type":"string","example":"x-merchant-id header is required","uniqueKey":"oneOf.1.message","typeLabel":"string"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"missingHeader":{"title":"missingHeader","value":{"message":"x-merchant-id header is required"}},"persistNotSupported":{"title":"persistNotSupported","value":{"message":"persist is not supported when charging a pending order"}},"speiNotEnabled":{"title":"speiNotEnabled","value":{"message":"SPEI payment method is not enabled for merchant"}},"cieCashNetNotEnabled":{"title":"cieCashNetNotEnabled","value":{"message":"CIE Cash Net payment method is not enabled for merchant"}},"virtualTerminalNotEnabled":{"title":"virtualTerminalNotEnabled","value":{"message":"Virtual Terminal is not enabled for this merchant"}}},"exampleType":"examples"}},"exampleType":"examples"},"10f5eb62-952d-4156-9e83-f181df477186":{"description":"Unauthorized - invalid or missing API key","content":{"application/json":{"schema":{"type":"object","description":"Unauthorized error response","properties":{"message":{"type":"string","description":"Error message","example":"Invalid api key","uniqueKey":"message","typeLabel":"string"}},"example":{"message":"Invalid api key"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Invalid api key"}}},"exampleType":"generated"}},"exampleType":"generated"},"8f2b165c-12f3-4b96-aa86-de12a14e5149":{"description":"Payment order not found","content":{"application/json":{"schema":{"type":"object","description":"Not found error response","properties":{"message":{"type":"string","description":"Error message","example":"Merchant not found","uniqueKey":"message","typeLabel":"string"}},"example":{"message":"Merchant not found"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Merchant not found"}}},"exampleType":"generated"}},"exampleType":"generated"},"01e3ebc0-e2c2-4aaf-8906-b3ac325f7390":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","description":"Error response","properties":{"message":{"type":"string","description":"Error message","example":"Error message","uniqueKey":"message","typeLabel":"string"}},"example":{"message":"Error message"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Error message"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"c1b7f425-f23b-463f-b717-1ede7de2843d":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key for authentication (required)","scopes":[]},"MerchantIdAuth":{"type":"apiKey","in":"header","name":"x-merchant-id","description":"Merchant ID for identifying the merchant (required)","scopes":[]}}},"servers":{"6182b33a-254e-4891-b1a5-d7816dd9a3d5":{"url":"https://api.sandbox.cheqpay.mx/pos","description":"Sandbox environment"},"a5b2f960-aba9-4c0c-92f6-0448d75e6592":{"url":"https://prod.cheqpay.mx/pos","description":"Production environment"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key for authentication (required)","scopes":[]},"schema":{"title":"x-api-key","type":"string","description":"API key for authentication (required)","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"x-api-key"},{"scheme":{"type":"apiKey","in":"header","name":"x-merchant-id","description":"Merchant ID for identifying the merchant (required)","scopes":[]},"schema":{"title":"x-merchant-id","type":"string","description":"Merchant ID for identifying the merchant (required)","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"MerchantIdAuth","name":"x-merchant-id"}],"title":"ApiKeyAuth \u0026 MerchantIdAuth"}]},"originalFileLocation":"api-reference/orchestrator-openapi.json"},"subdomain":"cheqpay","siteName":"Cheqpay","title":"Charge a pending payment order - Cheqpay","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-17T22:15:37.169Z","originalFileLocation":"api-reference/payment-order/charge-a-pending-payment-order.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Processes payment for an existing payment order that was created with pending: true. This is the second step of the two-step payment flow. The order must be in PENDING status. Provide the payment method and optional billing/device information to process the charge. The persist flag on payment methods is not supported for this endpoint. This is an internal endpoint.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Cheqpay\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/cheqpay/logo/logo.avif\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/cheqpay/logo/logo.avif\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/cheqpay/logo/logo.avif\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/png\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/cheqpay/logo/logo.avif\">\u003cmeta data-mint-head property=\"og:title\" content=\"Charge a pending payment order - Cheqpay\">\u003cmeta data-mint-head property=\"og:description\" content=\"Processes payment for an existing payment order that was created with pending: true. This is the second step of the two-step payment flow. The order must be in PENDING status. Provide the payment method and optional billing/device information to process the charge. The persist flag on payment methods is not supported for this endpoint. This is an internal endpoint.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cheqpay\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cheqpay.mx/api-reference/payment-order/charge-a-pending-payment-order\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cheqpay.mintlify.site/_mintlify/api/og/v2?division=Payment+Order\u0026amp;title=Charge+a+pending+payment+order\u0026amp;description=Processes+payment+for+an+existing+payment+order+that+was+created+with+%60pending%3A+true%60.+This+is+the+second+step+of+the+two-step+payment+flow.+The+order+must+be+i\u0026amp;theme=6e0753f2de9f986dbda32f79\u0026amp;signature=6a99f8e6d932fcbb482deeb81982a39fd4c7b380e7a7d06e9566b57a53271f68\">\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=\"Charge a pending payment order - Cheqpay\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Processes payment for an existing payment order that was created with pending: true. This is the second step of the two-step payment flow. The order must be in PENDING status. Provide the payment method and optional billing/device information to process the charge. The persist flag on payment methods is not supported for this endpoint. This is an internal endpoint.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cheqpay.mintlify.site/_mintlify/api/og/v2?division=Payment+Order\u0026amp;title=Charge+a+pending+payment+order\u0026amp;description=Processes+payment+for+an+existing+payment+order+that+was+created+with+%60pending%3A+true%60.+This+is+the+second+step+of+the+two-step+payment+flow.+The+order+must+be+i\u0026amp;theme=6e0753f2de9f986dbda32f79\u0026amp;signature=6a99f8e6d932fcbb482deeb81982a39fd4c7b380e7a7d06e9566b57a53271f68\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"https://mintlify.s3.us-west-1.amazonaws.com/cheqpay/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cheqpay\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cheqpay.mx/api-reference/payment-order/charge-a-pending-payment-order\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/payment-order/charge-a-pending-payment-order.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.cheqpay.mx/#organization\",\"name\":\"Cheqpay\",\"url\":\"https://docs.cheqpay.mx\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cheqpay/WjCfb-k6AR5eUe0H/logo/logo.svg?fit=max\u0026auto=format\u0026n=WjCfb-k6AR5eUe0H\u0026q=85\u0026s=6e22e4768984a8158b3094e120aaf1ff\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cheqpay.mx#website\",\"name\":\"Cheqpay\",\"url\":\"https://docs.cheqpay.mx\",\"publisher\":{\"@id\":\"https://docs.cheqpay.mx/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cheqpay.mx/api-reference/payment-order/charge-a-pending-payment-order#webpage\",\"url\":\"https://docs.cheqpay.mx/api-reference/payment-order/charge-a-pending-payment-order\",\"name\":\"Charge a pending payment order\",\"description\":\"Processes payment for an existing payment order that was created with pending: true. This is the second step of the two-step payment flow. The order must be in PENDING status. Provide the payment method and optional billing/device information to process the charge. The persist flag on payment methods is not supported for this endpoint. This is an internal endpoint.\",\"dateModified\":\"2026-09-17T22:15:37.169Z\",\"isPartOf\":{\"@id\":\"https://docs.cheqpay.mx#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cheqpay.mx/api-reference/payment-order/charge-a-pending-payment-order#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cheqpay.mx/api-reference/payment-order/charge-a-pending-payment-order#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Payment Orchestrator API\",\"item\":\"https://docs.cheqpay.mx/api-reference/customer/get-customer-by-external-id\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Payment Order\",\"item\":\"https://docs.cheqpay.mx/api-reference/payment-order/list-all-payment-orders\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Charge a pending payment order\",\"item\":\"https://docs.cheqpay.mx/api-reference/payment-order/charge-a-pending-payment-order\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.cheqpay.mx/api-reference/payment-order/charge-a-pending-payment-order#apireference\",\"headline\":\"Charge a pending payment order\",\"name\":\"Charge a pending payment order\",\"description\":\"Processes payment for an existing payment order that was created with pending: true. This is the second step of the two-step payment flow. The order must be in PENDING status. Provide the payment method and optional billing/device information to process the charge. The persist flag on payment methods is not supported for this endpoint. This is an internal endpoint.\",\"url\":\"https://docs.cheqpay.mx/api-reference/payment-order/charge-a-pending-payment-order\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cheqpay.mx/api-reference/payment-order/charge-a-pending-payment-order#webpage\"},\"dateModified\":\"2026-09-17T22:15:37.169Z\",\"publisher\":{\"@id\":\"https://docs.cheqpay.mx/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cheqpay.mx#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Cheqpay\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Cheqpay","nav":{"global":{"anchors":[]},"groups":[{"group":"Getting Started","pages":[{"title":"Welcome to Cheqpay","href":"/index"}]},{"group":"Essentials","pages":[{"title":"Authentication","href":"/essentials/authentication"},{"title":"Environments","href":"/essentials/environments"},{"title":"Quickstart","href":"/essentials/quickstart"}]},{"group":"Features","pages":[{"title":"Customers","href":"/features/customers"},{"title":"Payment Methods","href":"/features/payment-methods"},{"title":"Payment Orders","href":"/features/payment-orders"},{"title":"Pending Orders","href":"/features/pending-orders"},{"title":"Card Payments","href":"/features/card-payments"},{"title":"SPEI Transfers","href":"/features/spei-transfers"},{"title":"PayCash Payments","href":"/features/paycash-payments"},{"title":"CIE Cash Net Payments","href":"/features/cie-cash-net-payments"},{"title":"Hosted Payment Page","href":"/features/hosted-payment-page"},{"title":"Integrate via SDK","href":"/features/integrate-via-sdk"},{"title":"3D Secure","href":"/features/3d-secure"},{"title":"Refunds","href":"/features/refunds"},{"title":"Subscriptions","href":"/features/subscriptions"},{"title":"Webhooks","href":"/features/webhooks"}]},{"group":"Testing","pages":[{"title":"Webhook Simulators","href":"/testing/webhook-simulators"}]},{"group":"Guides","pages":[{"title":"Testing Guide","href":"/guides/testing"},{"title":"Error Handling","href":"/guides/error-handling"},{"title":"Best Practices","href":"/guides/best-practices"},{"title":"Going Live","href":"/guides/going-live"}]},{"group":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/introduction"},{"title":"API Endpoints","href":"/api-reference/endpoints"},{"title":"Error Codes","href":"/api-reference/errors"}]},{"group":"Payment Orchestrator API","pages":[{"group":"Customer","pages":[{"title":"Get customer by external ID","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json get /customers/{id}","href":"/api-reference/customer/get-customer-by-external-id"}]},{"group":"Customer V2","pages":[{"title":"List customers with pagination and filtering (v2)","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json get /v2/customers","href":"/api-reference/customer-v2/list-customers-with-pagination-and-filtering-v2"},{"title":"Create a new customer (v2)","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json post /v2/customers","href":"/api-reference/customer-v2/create-a-new-customer-v2"},{"title":"Get customer by ID (v2)","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json get /v2/customers/{id}","href":"/api-reference/customer-v2/get-customer-by-id-v2"},{"title":"Update customer (v2)","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json put /v2/customers/{id}","href":"/api-reference/customer-v2/update-customer-v2"},{"title":"Delete customer (v2)","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json delete /v2/customers/{id}","href":"/api-reference/customer-v2/delete-customer-v2"}]},{"group":"Checkout","pages":[{"title":"Pay with card, spei, or cie cash net","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json post /checkout/pay","href":"/api-reference/checkout/pay-with-card-spei-or-cie-cash-net"},{"title":"Pay with transfer batch","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json post /checkout/pay-batch","href":"/api-reference/checkout/pay-with-transfer-batch"}]},{"group":"Payment Order","pages":[{"title":"List all payment orders","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json get /v2/payment-orders","href":"/api-reference/payment-order/list-all-payment-orders"},{"title":"Create a payment order (v2)","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json post /v2/payment-orders","href":"/api-reference/payment-order/create-a-payment-order-v2"},{"title":"Get payment order by ID or external ID","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json get /v2/payment-orders/{id}","href":"/api-reference/payment-order/get-payment-order-by-id-or-external-id"},{"title":"Soft delete a payment order","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json delete /v2/payment-orders/{id}","href":"/api-reference/payment-order/soft-delete-a-payment-order"},{"title":"Update a pending payment order","description":"Updates an existing payment order, identified by its unique ID or external ID. Only allowed while the order is in PENDING status; otherwise a 422 is returned. All body fields are optional, but at least one must be provided. Provided fields overwrite the stored values; omitted fields are left unchanged.","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json patch /v2/payment-orders/{id}","href":"/api-reference/payment-order/update-a-pending-payment-order"},{"title":"Charge a pending payment order","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json post /v2/payment-orders/{id}/charge","href":"/api-reference/payment-order/charge-a-pending-payment-order"},{"title":"Refund a Payment of a payment order (v2)","description":"Refunds one of the Payments under a payment order. For legacy single-Payment orders (`allowPartials=false`), `paymentId` is optional and the sole Payment is refunded. For split-tender orders (`allowPartials=true`), `paymentId` is required — the caller must say which Payment to refund. The action does NOT update the order's `status` directly: the orchestrator consumer recomputes the aggregate status from the resulting PaymentEvent. After a full refund of every Payment, the order transitions to REFUNDED (terminal). After a partial refund, it transitions back to PARTIALLY_PAID and accepts new Payments via the addPayment endpoint. This is an internal endpoint.","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json post /v2/payment-orders/{id}/refund","href":"/api-reference/payment-order/refund-a-payment-of-a-payment-order-v2"},{"title":"Initiate 3DS payer authentication","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json post /v2/payment-orders/{id}/payer-authentication","href":"/api-reference/payment-order/initiate-3ds-payer-authentication"},{"title":"Validate 3DS payer authentication","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json post /v2/payment-orders/{id}/payer-authentication/validate","href":"/api-reference/payment-order/validate-3ds-payer-authentication"}]},{"group":"Payment Method","pages":[{"title":"Create a payment method","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json post /payment-methods","href":"/api-reference/payment-method/create-a-payment-method"},{"title":"Get a payment method by ID","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json get /payment-methods/{id}","href":"/api-reference/payment-method/get-a-payment-method-by-id"},{"title":"Update a payment method","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json put /payment-methods/{id}","href":"/api-reference/payment-method/update-a-payment-method"},{"title":"Delete a payment method","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json delete /payment-methods/{id}","href":"/api-reference/payment-method/delete-a-payment-method"},{"title":"List payment methods for a customer","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json get /v2/customers/{customerId}/payment-methods","href":"/api-reference/payment-method/list-payment-methods-for-a-customer"}]},{"group":"Subscription Plan","pages":[{"title":"List subscription plans","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json get /v1/plans","href":"/api-reference/subscription-plan/list-subscription-plans"},{"title":"Create a subscription plan","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json post /v1/plans","href":"/api-reference/subscription-plan/create-a-subscription-plan"},{"title":"Get a subscription plan by ID","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json get /v1/plans/{id}","href":"/api-reference/subscription-plan/get-a-subscription-plan-by-id"},{"title":"Archive a subscription plan","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json delete /v1/plans/{id}","href":"/api-reference/subscription-plan/archive-a-subscription-plan"},{"title":"Update a subscription plan","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json patch /v1/plans/{id}","href":"/api-reference/subscription-plan/update-a-subscription-plan"}]},{"group":"Subscription","pages":[{"title":"List subscriptions","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json get /v1/subscriptions","href":"/api-reference/subscription/list-subscriptions"},{"title":"Create a subscription","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json post /v1/subscriptions","href":"/api-reference/subscription/create-a-subscription"},{"title":"Get a subscription by ID","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json get /v1/subscriptions/{id}","href":"/api-reference/subscription/get-a-subscription-by-id"},{"title":"Update a subscription","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json patch /v1/subscriptions/{id}","href":"/api-reference/subscription/update-a-subscription"},{"title":"Change subscription plan","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json patch /v1/subscriptions/{id}/plan","href":"/api-reference/subscription/change-subscription-plan"},{"title":"Cancel a subscription","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json post /v1/subscriptions/{id}/cancel","href":"/api-reference/subscription/cancel-a-subscription"}]},{"group":"Subscription Invoice","pages":[{"title":"List invoices for a subscription","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json get /v1/subscriptions/{id}/invoices","href":"/api-reference/subscription-invoice/list-invoices-for-a-subscription"},{"title":"Get an invoice by ID","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json get /v1/subscription-invoices/{id}","href":"/api-reference/subscription-invoice/get-an-invoice-by-id"},{"title":"Process payment for an invoice","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json post /v1/subscription-invoices/{id}/pay","href":"/api-reference/subscription-invoice/process-payment-for-an-invoice"},{"title":"Void an invoice","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json post /v1/subscription-invoices/{id}/void","href":"/api-reference/subscription-invoice/void-an-invoice"}]}]},{"group":"Link Product API","pages":[{"group":"Payment Links","pages":[{"title":"Create payment link","deprecated":null,"version":null,"openapi":"/api-reference/link-product-openapi.json post /payment-links","href":"/api-reference/payment-links/create-payment-link"},{"title":"List payment links","deprecated":null,"version":null,"openapi":"/api-reference/link-product-openapi.json post /payment-links/list","href":"/api-reference/payment-links/list-payment-links"},{"title":"Get payment link","deprecated":null,"version":null,"openapi":"/api-reference/link-product-openapi.json get /payment-links/{id}","href":"/api-reference/payment-links/get-payment-link"},{"title":"Update payment link","deprecated":null,"version":null,"openapi":"/api-reference/link-product-openapi.json put /payment-links/{id}","href":"/api-reference/payment-links/update-payment-link"}]},{"group":"Products","pages":[{"title":"Create product","deprecated":null,"version":null,"openapi":"/api-reference/link-product-openapi.json post /products","href":"/api-reference/products/create-product"},{"title":"Get product","deprecated":null,"version":null,"openapi":"/api-reference/link-product-openapi.json get /products/{id}","href":"/api-reference/products/get-product"},{"title":"Update product","deprecated":null,"version":null,"openapi":"/api-reference/link-product-openapi.json put /products/{id}","href":"/api-reference/products/update-product"},{"title":"Delete product","deprecated":null,"version":null,"openapi":"/api-reference/link-product-openapi.json delete /products/{id}","href":"/api-reference/products/delete-product"},{"title":"List products","deprecated":null,"version":null,"openapi":"/api-reference/link-product-openapi.json post /products/list","href":"/api-reference/products/list-products"},{"title":"Bulk import products","deprecated":null,"version":null,"openapi":"/api-reference/link-product-openapi.json post /products/bulk-import","href":"/api-reference/products/bulk-import-products"}]},{"group":"Invoices","pages":[{"title":"List invoices","deprecated":null,"version":null,"openapi":"/api-reference/link-product-openapi.json get /invoices","href":"/api-reference/invoices/list-invoices"},{"title":"Get invoice","deprecated":null,"version":null,"openapi":"/api-reference/link-product-openapi.json get /invoices/{id}","href":"/api-reference/invoices/get-invoice"},{"title":"Refund invoice","deprecated":null,"version":null,"openapi":"/api-reference/link-product-openapi.json post /invoices/{id}/refund","href":"/api-reference/invoices/refund-invoice"}]}]}]},"basePath":"","title":"Charge a pending payment order - Cheqpay","buildId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","deploymentId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CBsVopKK.js","utils-DZAk68jJ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D32AYZrP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D_A5_cny.js","snippetPresets-xNRfS9th.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BIB25-tq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CydJ4w4j.js","shallow-CYPBeQSG.js","getApiPlaygroundDisplay-A5xJVBOu.js","CodeSnippet-BVRTgi3m.js","CodeSnippets-DjD6BSlt.js","Page-Dr40SSJq.js","getPastedJson-D4V4JyrR.js","icon-uhcnG22T.js","MethodPill-CM-ZQdGH.js","DuplicateIcon-B_WnOiNf.js","createIcon-CJsb8utt.js","DynamicMarkdown-D-2HDKEp.js","SectionHeading-KP5xmMgQ.js","axios-vUo_bRtp.js","Markdown-D_k0dg6k.js","clsx-DK3K4Z1S.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DE3EVdvd.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-fN9H9n9g.js"]}