{ "id": "ord_Xc4Vb7Nm2As5Df8G", "object": "invoice", "subscription": "sub_4Hn8Qw2Rt6Yp1Zx3", "number": 1, "status": "processing", "currency": "brl", "original_amount": 10000, "original_currency": "brl", "exchange_rate": null, "amount": 9000, "attempts": 123, "items": [ { "code": "SKU-SUB", "description": "Assinatura", "quantity": 1, "amount": 10000, "amount_total": 10000 } ], "discounts": [ { "type": "fixed", "value": 1000, "invoice_number": 1, "amount_applied": 1000 } ], "increments": [ { "type": "fixed", "value": 1000, "invoice_number": 1, "amount_applied": 1000 } ], "payments": [ { "id": "cha_8Kq2Lm9XvB3nT7pZ", "object": "payment_intent", "status": "requires_action", "amount": 10000, "amount_refunded": 0, "currency": "brl", "original_amount": 10000, "original_currency": "brl", "exchange_rate": null, "payment_method_details": { "type": "card", "card": { "brand": "visa", "first_six": "411111", "last_four": "1111", "holder_name": "João Silva", "exp_month": 12, "exp_year": 2030 }, "pix": { "qr_code": "00020126580014br.gov.bcb.pix0136a1b2c3d4-e5f6-7890-abcd-ef1234567890", "qr_code_url": "https://pix.exemplo.com.br/qr/cha_8Kq2Lm9XvB3nT7pZ", "expires_at": "2026-09-14 16:00:00" } } } ], "next_action": { "type": "pix_display_qr_code", "pix": { "qr_code": "00020126580014br.gov.bcb.pix0136a1b2c3d4-e5f6-7890-abcd-ef1234567890", "qr_code_url": "https://pix.exemplo.com.br/qr/cha_8Kq2Lm9XvB3nT7pZ", "expires_at": "2026-09-14 16:00:00" }, "otp": { "confirmation_id": "5f1c2a9e-7b3d-4e8f-9a6c-1d2e3f4a5b6c", "expires_at": "2026-09-14T12:15:00.000000Z" } }, "created_at": "<string>", "failure_reason": { "code": "card_declined", "message": "O cartão não possui saldo suficiente para concluir o pagamento.", "customer_message": "Não foi possível concluir o pagamento. Revise os dados informados ou tente outro meio de pagamento.", "merchant_message": "O pagamento não foi concluído. Oriente o comprador a revisar os dados informados ou tentar outro meio de pagamento." }}
Faturas
Confirmar código de verificação da fatura
Envia o código de verificação recebido pelo pagador quando a fatura está em requires_action com next_action.type: otp_confirmation. Nada é cobrado até a confirmação. Se o pagamento for recusado, a resposta é 402 com failure_reason.
{ "id": "ord_Xc4Vb7Nm2As5Df8G", "object": "invoice", "subscription": "sub_4Hn8Qw2Rt6Yp1Zx3", "number": 1, "status": "processing", "currency": "brl", "original_amount": 10000, "original_currency": "brl", "exchange_rate": null, "amount": 9000, "attempts": 123, "items": [ { "code": "SKU-SUB", "description": "Assinatura", "quantity": 1, "amount": 10000, "amount_total": 10000 } ], "discounts": [ { "type": "fixed", "value": 1000, "invoice_number": 1, "amount_applied": 1000 } ], "increments": [ { "type": "fixed", "value": 1000, "invoice_number": 1, "amount_applied": 1000 } ], "payments": [ { "id": "cha_8Kq2Lm9XvB3nT7pZ", "object": "payment_intent", "status": "requires_action", "amount": 10000, "amount_refunded": 0, "currency": "brl", "original_amount": 10000, "original_currency": "brl", "exchange_rate": null, "payment_method_details": { "type": "card", "card": { "brand": "visa", "first_six": "411111", "last_four": "1111", "holder_name": "João Silva", "exp_month": 12, "exp_year": 2030 }, "pix": { "qr_code": "00020126580014br.gov.bcb.pix0136a1b2c3d4-e5f6-7890-abcd-ef1234567890", "qr_code_url": "https://pix.exemplo.com.br/qr/cha_8Kq2Lm9XvB3nT7pZ", "expires_at": "2026-09-14 16:00:00" } } } ], "next_action": { "type": "pix_display_qr_code", "pix": { "qr_code": "00020126580014br.gov.bcb.pix0136a1b2c3d4-e5f6-7890-abcd-ef1234567890", "qr_code_url": "https://pix.exemplo.com.br/qr/cha_8Kq2Lm9XvB3nT7pZ", "expires_at": "2026-09-14 16:00:00" }, "otp": { "confirmation_id": "5f1c2a9e-7b3d-4e8f-9a6c-1d2e3f4a5b6c", "expires_at": "2026-09-14T12:15:00.000000Z" } }, "created_at": "<string>", "failure_reason": { "code": "card_declined", "message": "O cartão não possui saldo suficiente para concluir o pagamento.", "customer_message": "Não foi possível concluir o pagamento. Revise os dados informados ou tente outro meio de pagamento.", "merchant_message": "O pagamento não foi concluído. Oriente o comprador a revisar os dados informados ou tentar outro meio de pagamento." }}
Quando a análise de fraude pede verificação, a fatura fica em requires_action com next_action.type = "otp_confirmation" e nada é cobrado até a confirmação. Envie em code o código que o comprador recebeu.
Com o código válido, a cobrança da fatura é retomada. A resposta é 200 com a fatura atualizada (em geral processing), ou 402 se a cobrança for recusada.
Erros possíveis: 422parameter_missing (sem code), 422confirmation_code_invalid (código inválido ou expirado) e 422order_not_confirmable (a fatura não está aguardando código).
Chave de API (secret key) da conta, no formato sk_live_... (produção) ou sk_test_... (Ambiente de Sandbox). Envie no header Authorization: Bearer <chave>. Autentica todas as rotas da API v2 e as rotas de Análise de Fraude. A chave identifica a conta, então a API v2 não usa o header account. Uma chave só é aceita no ambiente em que foi criada. Gere a sua no dashboard em Configurações → Chaves de API.
Chave de idempotência opcional e recomendada. Tem até 128 caracteres e vale por 24 horas, por conta. A mesma chave com o mesmo corpo devolve a resposta original (mesmo status e mesmo corpo), sem processar de novo. Só respostas 2xx ficam guardadas: depois de um erro, a mesma chave pode ser reutilizada. A mesma chave com um corpo diferente retorna 422 (idempotency_key_conflict), uma requisição original ainda em andamento retorna 409 (idempotency_key_in_use) e uma chave com mais de 128 caracteres retorna 400 (idempotency_key_invalid).
Fatura de um ciclo da assinatura. processing: em processamento. requires_action: PIX aguardando pagamento ou verificação por código (veja next_action). paid: paga. failed: recusada (veja failure_reason). canceled: cancelada. refunded e partially_refunded: estornada. chargeback: contestada.
Cotação usada: 1 unidade da moeda original = exchange_rate reais. null quando a moeda é BRL. Única por fatura: uma nova tentativa reaproveita a cotação da primeira cobrança.
Valor cobrado, em centavos de real, já com descontos e acréscimos. Fecha ao centavo com Σ items[].amount_total − Σ discounts[].amount_applied + Σ increments[].amount_applied. Somar items[].amount × quantity não tem essa garantia.
Itens da fatura. amount é o valor unitário, em centavos de real, convertido pela exchange_rate. amount_total é o total bruto da linha, em centavos de real, conciliado com o amount da fatura.
Descontos da fatura. value é o valor declarado: em fixed, centavos de real convertidos pela exchange_rate; em percentage, o percentual, sem conversão. amount_applied é o valor efetivamente descontado, em centavos de real.
Acréscimos da fatura, com os mesmos campos de discounts. amount_applied é o valor efetivamente acrescido, em centavos de real. Acréscimos não têm limite.
O que precisa acontecer para o pagamento seguir. pix_display_qr_code: exiba o QR Code para o pagador. otp_confirmation: a análise de fraude pediu verificação — nada é cobrado até o código ser confirmado na rota /confirm.
Motivo da recusa. Presente só quando o status é failed
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"4SeletPay","colors":{"primary":"#007AFF","light":"#0A84FF","dark":"#0056B3"},"logo":{"light":"https://mintcdn.com/4selet-1a9bfa9b/AoymSTBvUJFLYdIf/logo/logo.png?fit=max\u0026auto=format\u0026n=AoymSTBvUJFLYdIf\u0026q=85\u0026s=16da9497a7389abca443032d35b63e76","dark":"https://mintcdn.com/4selet-1a9bfa9b/AoymSTBvUJFLYdIf/logo/logo.png?fit=max\u0026auto=format\u0026n=AoymSTBvUJFLYdIf\u0026q=85\u0026s=16da9497a7389abca443032d35b63e76"},"favicon":"https://mintcdn.com/4selet-1a9bfa9b/AoymSTBvUJFLYdIf/favicon.ico?fit=max\u0026auto=format\u0026n=AoymSTBvUJFLYdIf\u0026q=85\u0026s=7c1498fab479f449a80d48e59dab01aa","api":{},"appearance":{"default":"dark","strict":false},"navbar":{"links":[{"href":"https://docs.4seletpay.com.br/llms.txt","label":"llms.txt"},{"href":"mailto:suporte@4selet.com.br","label":"Suporte"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.4seletpay.com.br"}},"footer":{"socials":{"website":"https://4seletpay.com.br"}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"4selet-1a9bfa9b","hasAudioNarration":false,"actualSubdomain":"4selet-1a9bfa9b","customDomains":["docs.4seletpay.com.br"],"gitSource":{"type":"github","owner":"4st-cardoso","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6ac8f95ee8838694528cec2c","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"Referência","count":72},{"language":"default","tag":"Webhooks","count":19},{"language":"default","tag":"Comece aqui","count":18},{"language":"default","tag":"Assinaturas","count":17},{"language":"default","tag":"Pedidos","count":11},{"language":"default","tag":"Eventos","count":10},{"language":"default","tag":"Cartões","count":9},{"language":"default","tag":"Cobranças","count":9},{"language":"default","tag":"Faturas","count":7},{"language":"default","tag":"Links de Pagamento","count":6}]},"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":"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}],"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":"button[class*=\"try-it\"],button[aria-label*=\"Try it\"],button:has-text(\"Try it\"){background-color:#007AFF!important;color:#FFFFFF!important}button[data-testid=\"try-it-button\"],.mintlify-code-block button[class*=\"try\"],pre button[class*=\"try\"],.mintlify-code button{background-color:#007AFF!important;color:#FFFFFF!important}button[class*=\"try-it\"]:hover,button[aria-label*=\"Try it\"]:hover{background-color:#0056B3!important}[class*=\"TryIt\"] button,[class*=\"try-it\"] button,button:contains(\"Try it\"){background-color:#007AFF!important;color:#FFFFFF!important}"}],"page":{"pagePath":"pages/v2/faturas/confirm","slug":"/pages/v2/faturas/confirm","pageMetadata":{"title":"Confirmar código de verificação da fatura","openapi":"POST /v2/invoices/{id}/confirm","description":"Envia o código de verificação recebido pelo pagador quando a fatura está em `requires_action` com `next_action.type: otp_confirmation`. Nada é cobrado até a confirmação. Se o pagamento for recusado, a resposta é 402 com `failure_reason`.\n","href":"/pages/v2/faturas/confirm"},"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: [\"Envia o código de verificação recebido pelo pagador quando a fatura está em \", _jsx(_components.code, {\n children: \"requires_action\"\n }), \" com \", _jsx(_components.code, {\n children: \"next_action.type: otp_confirmation\"\n }), \". Nada é cobrado até a confirmação. Se o pagamento for recusado, a resposta é 402 com \", _jsx(_components.code, {\n children: \"failure_reason\"\n }), \".\"]\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`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Info,Note,Warning}=_components;if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Info,{children:_jsxs(_components.p,{children:[`Quando a análise de fraude pede verificação, a fatura fica em `,_jsx(_components.code,{children:`requires_action`}),` com `,_jsx(_components.code,{children:`next_action.type = \"otp_confirmation\"`}),` e `,_jsx(_components.strong,{children:`nada é cobrado`}),` até a confirmação. Envie em `,_jsx(_components.code,{children:`code`}),` o código que o comprador recebeu.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Com o código válido, a cobrança da fatura é retomada. A resposta é `,_jsx(_components.code,{children:`200`}),` com a fatura atualizada (em geral `,_jsx(_components.code,{children:`processing`}),`), ou `,_jsx(_components.code,{children:`402`}),` se a cobrança for recusada.`]})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Erros possíveis: `,_jsx(_components.code,{children:`422`}),` `,_jsx(_components.code,{children:`parameter_missing`}),` (sem `,_jsx(_components.code,{children:`code`}),`), `,_jsx(_components.code,{children:`422`}),` `,_jsx(_components.code,{children:`confirmation_code_invalid`}),` (código inválido ou expirado) e `,_jsx(_components.code,{children:`422`}),` `,_jsx(_components.code,{children:`order_not_confirmable`}),` (a fatura não está aguardando código).`]})})]})}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":"Confirmar código de verificação da fatura","openapi":"POST /v2/invoices/{id}/confirm","description":"Envia o código de verificação recebido pelo pagador quando a fatura está em `requires_action` com `next_action.type: otp_confirmation`. Nada é cobrado até a confirmação. Se o pagamento for recusado, a resposta é 402 com `failure_reason`.\n","href":"/pages/v2/faturas/confirm"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Faturas (v2)"],"summary":"Confirmar código de verificação da fatura","description":"Envia o código de verificação recebido pelo pagador quando a fatura está em `requires_action` com `next_action.type: otp_confirmation`. Nada é cobrado até a confirmação. Se o pagamento for recusado, a resposta é 402 com `failure_reason`.\n","operationId":"v2ConfirmInvoice","security":["d4d4c830-1e30-4a82-991c-71e6762f44c0"],"parameters":["58d4fe43-cbc1-4e95-b7b6-194c8c70462a","2f4f8dc9-9dc3-4c69-819a-889525afd505"],"requestBody":"e7ca0d7d-192d-4392-9496-acb0c41c78ff","responses":{"200":"4fc758a4-3ff4-4ac7-9bec-d96a30e29e31","400":"59e9ba5f-43df-437b-b65d-55de51bbeb39","401":"44275e35-f238-436a-9573-fff1acb6eabb","402":"185bb9bc-4025-4041-803c-9821f3ab1610","403":"37d2d18d-8f6b-4783-bc31-c403f91c2e4e","404":"c769db75-a6c0-4641-be5c-34330cbc5c00","409":"a97c4f39-98a0-408b-991e-87814c3044b3","422":"ea82eab2-83ea-45da-b1c6-e338796359a4","429":"d6cd28ca-9e67-4cf1-bda6-bb9352a53781","500":"2226fce3-e340-480c-ab16-7a32b5f4ab66"},"method":"post","type":"path","servers":["4c3dfa86-2ed5-4f58-9a07-b7d334d46949"],"path":"/v2/invoices/{id}/confirm","baseUrlOptions":["https://sandbox.4seletpay.com.br/api"],"title":"Confirmar código de verificação da fatura","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"58d4fe43-cbc1-4e95-b7b6-194c8c70462a":{"name":"id","in":"path","required":true,"description":"Identificador do recurso (o campo `id` devolvido pela API)","schema":{"type":"string","isRequired":true,"description":"Identificador do recurso (o campo `id` devolvido pela API)","uniqueKey":"","typeLabel":"string"}},"2f4f8dc9-9dc3-4c69-819a-889525afd505":{"name":"Idempotency-Key","in":"header","required":false,"description":"Chave de idempotência opcional e recomendada. Tem até 128 caracteres e vale por 24 horas, por conta. A mesma chave com o mesmo corpo devolve a resposta original (mesmo status e mesmo corpo), sem processar de novo. Só respostas 2xx ficam guardadas: depois de um erro, a mesma chave pode ser reutilizada. A mesma chave com um corpo diferente retorna 422 (`idempotency_key_conflict`), uma requisição original ainda em andamento retorna 409 (`idempotency_key_in_use`) e uma chave com mais de 128 caracteres retorna 400 (`idempotency_key_invalid`).\n","schema":{"type":"string","maxLength":128,"example":"pedido-1024-tentativa-1","isRequired":false,"description":"Chave de idempotência opcional e recomendada. Tem até 128 caracteres e vale por 24 horas, por conta. A mesma chave com o mesmo corpo devolve a resposta original (mesmo status e mesmo corpo), sem processar de novo. Só respostas 2xx ficam guardadas: depois de um erro, a mesma chave pode ser reutilizada. A mesma chave com um corpo diferente retorna 422 (`idempotency_key_conflict`), uma requisição original ainda em andamento retorna 409 (`idempotency_key_in_use`) e uma chave com mais de 128 caracteres retorna 400 (`idempotency_key_invalid`).\n","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"Código de verificação recebido pelo pagador","example":"482019","isRequired":true,"uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"482019"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"4fc758a4-3ff4-4ac7-9bec-d96a30e29e31":{"description":"Código confirmado. Confira o `status` da fatura","content":{"application/json":{"schema":{"type":"object","description":"Fatura de um ciclo da assinatura. `processing`: em processamento. `requires_action`: PIX aguardando pagamento ou verificação por código (veja `next_action`). `paid`: paga. `failed`: recusada (veja `failure_reason`). `canceled`: cancelada. `refunded` e `partially_refunded`: estornada. `chargeback`: contestada.\n","properties":{"id":{"type":"string","example":"ord_Xc4Vb7Nm2As5Df8G","uniqueKey":"id","typeLabel":"string"},"object":{"type":"string","enum":["invoice"],"uniqueKey":"object","typeLabel":"enum\u003cstring>"},"subscription":{"type":"string","example":"sub_4Hn8Qw2Rt6Yp1Zx3","uniqueKey":"subscription","typeLabel":"string"},"number":{"type":"integer","description":"Número da fatura na assinatura","example":1,"uniqueKey":"number","typeLabel":"integer"},"status":{"type":"string","enum":["processing","requires_action","paid","failed","canceled","refunded","partially_refunded","chargeback"],"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"currency":{"type":"string","enum":["brl"],"description":"Sempre `brl`","example":"brl","uniqueKey":"currency","typeLabel":"enum\u003cstring>"},"original_amount":{"type":"integer","description":"Valor da fatura na moeda da assinatura, em centavos. Igual a `amount` em BRL","example":10000,"uniqueKey":"original_amount","typeLabel":"integer"},"original_currency":{"type":"string","description":"Moeda enviada, em minúsculas","example":"brl","uniqueKey":"original_currency","typeLabel":"string"},"exchange_rate":{"oneOf":[{"type":"number","description":"Cotação usada: 1 unidade da moeda original = `exchange_rate` reais. `null` quando a moeda é BRL. Única por fatura: uma nova tentativa reaproveita a cotação da primeira cobrança.\n","example":null,"uniqueKey":"exchange_rate.oneOf.0","typeLabel":"number"},{"type":"null","description":"Cotação usada: 1 unidade da moeda original = `exchange_rate` reais. `null` quando a moeda é BRL. Única por fatura: uma nova tentativa reaproveita a cotação da primeira cobrança.\n","example":null,"uniqueKey":"exchange_rate.oneOf.1","typeLabel":"null"}],"uniqueKey":"exchange_rate","typeLabel":"number | null"},"amount":{"type":"integer","description":"Valor cobrado, em centavos de real, já com descontos e acréscimos. Fecha ao centavo com Σ `items[].amount_total` − Σ `discounts[].amount_applied` + Σ `increments[].amount_applied`. Somar `items[].amount × quantity` não tem essa garantia.\n","example":9000,"uniqueKey":"amount","typeLabel":"integer"},"attempts":{"type":"integer","description":"Tentativas de cobrança","uniqueKey":"attempts","typeLabel":"integer"},"items":{"type":"array","description":"Itens da fatura. `amount` é o valor unitário, em centavos de real, convertido pela `exchange_rate`. `amount_total` é o total bruto da linha, em centavos de real, conciliado com o `amount` da fatura.\n","items":{"type":"object","required":["code","description","quantity","amount"],"properties":{"code":{"type":"string","maxLength":255,"example":"SKU-SUB","isRequired":true,"uniqueKey":"\\items.items.[INDEX].code","typeLabel":"string"},"description":{"type":"string","maxLength":255,"example":"Assinatura","isRequired":true,"uniqueKey":"\\items.items.[INDEX].description","typeLabel":"string"},"quantity":{"type":"integer","minimum":1,"example":1,"isRequired":true,"uniqueKey":"\\items.items.[INDEX].quantity","typeLabel":"integer"},"amount":{"type":"integer","minimum":1,"description":"Valor unitário, em centavos","example":10000,"isRequired":true,"uniqueKey":"\\items.items.[INDEX].amount","typeLabel":"integer"},"amount_total":{"type":"integer","description":"Total bruto da linha (valor unitário × quantidade), em centavos de real, conciliado com o `amount` da fatura","example":10000,"uniqueKey":"\\items.items.[INDEX].amount_total","typeLabel":"integer"}},"uniqueKey":"\\items.items.[INDEX]","typeLabel":"object"},"uniqueKey":"\\items","typeLabel":"object[]"},"discounts":{"type":"array","description":"Descontos da fatura. `value` é o valor declarado: em `fixed`, centavos de real convertidos pela `exchange_rate`; em `percentage`, o percentual, sem conversão. `amount_applied` é o valor efetivamente descontado, em centavos de real.\n","items":{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["fixed","percentage"],"isRequired":true,"uniqueKey":"discounts.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"value":{"type":"number","exclusiveMinimum":0,"description":"Em `fixed`, valor inteiro em centavos. Em `percentage`, percentual (em descontos, no máximo 100).\n","example":1000,"isRequired":true,"uniqueKey":"discounts.items.[INDEX].value","typeLabel":"number"},"invoice_number":{"oneOf":[{"type":"integer","minimum":1,"description":"Número da fatura a que o ajuste se aplica. Sem valor, vale para todas as faturas","example":1,"uniqueKey":"discounts.items.[INDEX].invoice_number.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":1,"description":"Número da fatura a que o ajuste se aplica. Sem valor, vale para todas as faturas","example":1,"uniqueKey":"discounts.items.[INDEX].invoice_number.oneOf.1","typeLabel":"null"}],"uniqueKey":"discounts.items.[INDEX].invoice_number","typeLabel":"integer | null"},"amount_applied":{"type":"integer","description":"Valor efetivamente aplicado, em centavos de real, inclusive em `percentage`. Nos descontos, o total aplicado é limitado ao valor dos itens e repartido na proporção do valor declarado de cada desconto; por isso pode ser menor que `value`. Nos acréscimos, não há limite.\n","example":1000,"uniqueKey":"discounts.items.[INDEX].amount_applied","typeLabel":"integer"}},"uniqueKey":"discounts.items.[INDEX]","typeLabel":"object"},"uniqueKey":"discounts","typeLabel":"object[]"},"increments":{"type":"array","description":"Acréscimos da fatura, com os mesmos campos de `discounts`. `amount_applied` é o valor efetivamente acrescido, em centavos de real. Acréscimos não têm limite.\n","items":{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["fixed","percentage"],"isRequired":true,"uniqueKey":"increments.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"value":{"type":"number","exclusiveMinimum":0,"description":"Em `fixed`, valor inteiro em centavos. Em `percentage`, percentual (em descontos, no máximo 100).\n","example":1000,"isRequired":true,"uniqueKey":"increments.items.[INDEX].value","typeLabel":"number"},"invoice_number":{"oneOf":[{"type":"integer","minimum":1,"description":"Número da fatura a que o ajuste se aplica. Sem valor, vale para todas as faturas","example":1,"uniqueKey":"increments.items.[INDEX].invoice_number.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":1,"description":"Número da fatura a que o ajuste se aplica. Sem valor, vale para todas as faturas","example":1,"uniqueKey":"increments.items.[INDEX].invoice_number.oneOf.1","typeLabel":"null"}],"uniqueKey":"increments.items.[INDEX].invoice_number","typeLabel":"integer | null"},"amount_applied":{"type":"integer","description":"Valor efetivamente aplicado, em centavos de real, inclusive em `percentage`. Nos descontos, o total aplicado é limitado ao valor dos itens e repartido na proporção do valor declarado de cada desconto; por isso pode ser menor que `value`. Nos acréscimos, não há limite.\n","example":1000,"uniqueKey":"increments.items.[INDEX].amount_applied","typeLabel":"integer"}},"uniqueKey":"increments.items.[INDEX]","typeLabel":"object"},"uniqueKey":"increments","typeLabel":"object[]"},"payments":{"type":"array","items":{"type":"object","description":"Um meio de pagamento dentro de um pedido ou fatura. O `id` é o mesmo da cobrança (`GET /v2/charges/{id}`).\n","properties":{"id":{"type":"string","example":"cha_8Kq2Lm9XvB3nT7pZ","uniqueKey":"payments.items.[INDEX].id","typeLabel":"string"},"object":{"type":"string","enum":["payment_intent"],"uniqueKey":"payments.items.[INDEX].object","typeLabel":"enum\u003cstring>"},"status":{"type":"string","enum":["requires_action","requires_capture","processing","paid","failed","canceled","refund_processing","partially_refunded","refunded","chargeback"],"description":"`requires_action`: PIX aguardando pagamento ou verificação por código. `requires_capture`: cartão autorizado, aguardando captura. `processing`: em processamento. `paid`: pago. `failed`: recusado. `canceled`: cancelado. `refund_processing`: estorno em processamento. `partially_refunded` e `refunded`: estornado em parte ou totalmente. `chargeback`: contestado pelo portador.\n","uniqueKey":"payments.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"amount":{"type":"integer","description":"Valor cobrado, em centavos de real","example":10000,"uniqueKey":"payments.items.[INDEX].amount","typeLabel":"integer"},"amount_refunded":{"type":"integer","description":"Valor estornado, em centavos","example":0,"uniqueKey":"payments.items.[INDEX].amount_refunded","typeLabel":"integer"},"currency":{"type":"string","enum":["brl"],"description":"Sempre `brl`","example":"brl","uniqueKey":"payments.items.[INDEX].currency","typeLabel":"enum\u003cstring>"},"original_amount":{"type":"integer","description":"Valor na moeda enviada, em centavos. Igual a `amount` em BRL","example":10000,"uniqueKey":"payments.items.[INDEX].original_amount","typeLabel":"integer"},"original_currency":{"type":"string","description":"Moeda enviada, em minúsculas","example":"brl","uniqueKey":"payments.items.[INDEX].original_currency","typeLabel":"string"},"exchange_rate":{"oneOf":[{"type":"number","description":"Cotação usada: 1 unidade da moeda original = `exchange_rate` reais. `null` quando a moeda é BRL.\n","example":null,"uniqueKey":"payments.items.[INDEX].exchange_rate.oneOf.0","typeLabel":"number"},{"type":"null","description":"Cotação usada: 1 unidade da moeda original = `exchange_rate` reais. `null` quando a moeda é BRL.\n","example":null,"uniqueKey":"payments.items.[INDEX].exchange_rate.oneOf.1","typeLabel":"null"}],"uniqueKey":"payments.items.[INDEX].exchange_rate","typeLabel":"number | null"},"payment_method_details":{"type":"object","properties":{"type":{"type":"string","enum":["card","pix","boleto"],"uniqueKey":"payments.items.[INDEX].payment_method_details.type","typeLabel":"enum\u003cstring>"},"card":{"type":"object","description":"Cartão vinculado à cobrança. Só aparece quando a cobrança tem um cartão vinculado: sem cartão, a chave `card` não é enviada (ela não vem com `null`). O `id` do cartão não é devolvido em pedidos nem em cobranças. O número completo e o código de segurança nunca são devolvidos.\n","properties":{"brand":{"type":"string","example":"visa","uniqueKey":"payments.items.[INDEX].payment_method_details.card.brand","typeLabel":"string"},"first_six":{"oneOf":[{"type":"string","example":"411111","uniqueKey":"payments.items.[INDEX].payment_method_details.card.first_six.oneOf.0","typeLabel":"string"},{"type":"null","example":"411111","uniqueKey":"payments.items.[INDEX].payment_method_details.card.first_six.oneOf.1","typeLabel":"null"}],"uniqueKey":"payments.items.[INDEX].payment_method_details.card.first_six","typeLabel":"string | null"},"last_four":{"oneOf":[{"type":"string","example":"1111","uniqueKey":"payments.items.[INDEX].payment_method_details.card.last_four.oneOf.0","typeLabel":"string"},{"type":"null","example":"1111","uniqueKey":"payments.items.[INDEX].payment_method_details.card.last_four.oneOf.1","typeLabel":"null"}],"uniqueKey":"payments.items.[INDEX].payment_method_details.card.last_four","typeLabel":"string | null"},"holder_name":{"type":"string","example":"João Silva","uniqueKey":"payments.items.[INDEX].payment_method_details.card.holder_name","typeLabel":"string"},"exp_month":{"oneOf":[{"type":"integer","example":12,"uniqueKey":"payments.items.[INDEX].payment_method_details.card.exp_month.oneOf.0","typeLabel":"integer"},{"type":"null","example":12,"uniqueKey":"payments.items.[INDEX].payment_method_details.card.exp_month.oneOf.1","typeLabel":"null"}],"uniqueKey":"payments.items.[INDEX].payment_method_details.card.exp_month","typeLabel":"integer | null"},"exp_year":{"oneOf":[{"type":"integer","example":2030,"uniqueKey":"payments.items.[INDEX].payment_method_details.card.exp_year.oneOf.0","typeLabel":"integer"},{"type":"null","example":2030,"uniqueKey":"payments.items.[INDEX].payment_method_details.card.exp_year.oneOf.1","typeLabel":"null"}],"uniqueKey":"payments.items.[INDEX].payment_method_details.card.exp_year","typeLabel":"integer | null"}},"uniqueKey":"payments.items.[INDEX].payment_method_details.card","typeLabel":"object"},"pix":{"type":"object","properties":{"qr_code":{"type":"string","description":"Código PIX copia e cola","example":"00020126580014br.gov.bcb.pix0136a1b2c3d4-e5f6-7890-abcd-ef1234567890","uniqueKey":"payments.items.[INDEX].payment_method_details.pix.qr_code","typeLabel":"string"},"qr_code_url":{"type":"string","description":"Link do QR Code","example":"https://pix.exemplo.com.br/qr/cha_8Kq2Lm9XvB3nT7pZ","uniqueKey":"payments.items.[INDEX].payment_method_details.pix.qr_code_url","typeLabel":"string"},"expires_at":{"type":"string","description":"Data e hora de expiração do QR Code, no formato `AAAA-MM-DD HH:MM:SS`, sem indicação de fuso","example":"2026-09-14 16:00:00","uniqueKey":"payments.items.[INDEX].payment_method_details.pix.expires_at","typeLabel":"string"}},"uniqueKey":"payments.items.[INDEX].payment_method_details.pix","typeLabel":"object"}},"uniqueKey":"payments.items.[INDEX].payment_method_details","typeLabel":"object"}},"uniqueKey":"payments.items.[INDEX]","typeLabel":"object"},"uniqueKey":"payments","typeLabel":"object[]"},"next_action":{"oneOf":[{"type":"object","description":"O que precisa acontecer para o pagamento seguir. `pix_display_qr_code`: exiba o QR Code para o pagador. `otp_confirmation`: a análise de fraude pediu verificação — nada é cobrado até o código ser confirmado na rota `/confirm`.\n","properties":{"type":{"type":"string","enum":["pix_display_qr_code","otp_confirmation"],"uniqueKey":"next_action.oneOf.0.type","typeLabel":"enum\u003cstring>"},"pix":{"type":"object","properties":{"qr_code":{"type":"string","description":"Código PIX copia e cola","example":"00020126580014br.gov.bcb.pix0136a1b2c3d4-e5f6-7890-abcd-ef1234567890","uniqueKey":"next_action.oneOf.0.pix.qr_code","typeLabel":"string"},"qr_code_url":{"type":"string","description":"Link do QR Code","example":"https://pix.exemplo.com.br/qr/cha_8Kq2Lm9XvB3nT7pZ","uniqueKey":"next_action.oneOf.0.pix.qr_code_url","typeLabel":"string"},"expires_at":{"type":"string","description":"Data e hora de expiração do QR Code, no formato `AAAA-MM-DD HH:MM:SS`, sem indicação de fuso","example":"2026-09-14 16:00:00","uniqueKey":"next_action.oneOf.0.pix.expires_at","typeLabel":"string"}},"uniqueKey":"next_action.oneOf.0.pix","typeLabel":"object"},"otp":{"type":"object","description":"Presente quando `type` é `otp_confirmation`","properties":{"confirmation_id":{"type":"string","example":"5f1c2a9e-7b3d-4e8f-9a6c-1d2e3f4a5b6c","uniqueKey":"next_action.oneOf.0.otp.confirmation_id","typeLabel":"string"},"expires_at":{"type":"string","description":"Data e hora de expiração do código, em UTC (ISO 8601)","example":"2026-09-14T12:15:00.000000Z","uniqueKey":"next_action.oneOf.0.otp.expires_at","typeLabel":"string"}},"uniqueKey":"next_action.oneOf.0.otp","typeLabel":"object"}},"uniqueKey":"next_action.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"next_action.oneOf.1","typeLabel":"null"}],"uniqueKey":"next_action","typeLabel":"object | null"},"created_at":{"type":"string","uniqueKey":"created_at","typeLabel":"string"},"failure_reason":{"type":"object","description":"Motivo da recusa. Presente só quando o status é `failed`","required":["code","message","customer_message","merchant_message"],"properties":{"code":{"type":"string","enum":["card_declined","insufficient_funds","expired_card","incorrect_cvc","incorrect_number","card_not_supported","fraud_suspected","invalid_request","acquirer_error","processing_error"],"isRequired":true,"uniqueKey":"failure_reason.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Texto técnico. Não exiba ao pagador","example":"O cartão não possui saldo suficiente para concluir o pagamento.","isRequired":true,"uniqueKey":"failure_reason.message","typeLabel":"string"},"customer_message":{"type":"string","description":"Texto para exibir ao pagador","example":"Não foi possível concluir o pagamento. Revise os dados informados ou tente outro meio de pagamento.","isRequired":true,"uniqueKey":"failure_reason.customer_message","typeLabel":"string"},"merchant_message":{"type":"string","description":"Texto para você ou a sua equipe de atendimento","example":"O pagamento não foi concluído. Oriente o comprador a revisar os dados informados ou tentar outro meio de pagamento.","isRequired":true,"uniqueKey":"failure_reason.merchant_message","typeLabel":"string"}},"uniqueKey":"failure_reason","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"ord_Xc4Vb7Nm2As5Df8G","object":"invoice","subscription":"sub_4Hn8Qw2Rt6Yp1Zx3","number":1,"status":"processing","currency":"brl","original_amount":10000,"original_currency":"brl","exchange_rate":null,"amount":9000,"attempts":123,"items":[{"code":"SKU-SUB","description":"Assinatura","quantity":1,"amount":10000,"amount_total":10000}],"discounts":[{"type":"fixed","value":1000,"invoice_number":1,"amount_applied":1000}],"increments":[{"type":"fixed","value":1000,"invoice_number":1,"amount_applied":1000}],"payments":[{"id":"cha_8Kq2Lm9XvB3nT7pZ","object":"payment_intent","status":"requires_action","amount":10000,"amount_refunded":0,"currency":"brl","original_amount":10000,"original_currency":"brl","exchange_rate":null,"payment_method_details":{"type":"card","card":{"brand":"visa","first_six":"411111","last_four":"1111","holder_name":"João Silva","exp_month":12,"exp_year":2030},"pix":{"qr_code":"00020126580014br.gov.bcb.pix0136a1b2c3d4-e5f6-7890-abcd-ef1234567890","qr_code_url":"https://pix.exemplo.com.br/qr/cha_8Kq2Lm9XvB3nT7pZ","expires_at":"2026-09-14 16:00:00"}}}],"next_action":{"type":"pix_display_qr_code","pix":{"qr_code":"00020126580014br.gov.bcb.pix0136a1b2c3d4-e5f6-7890-abcd-ef1234567890","qr_code_url":"https://pix.exemplo.com.br/qr/cha_8Kq2Lm9XvB3nT7pZ","expires_at":"2026-09-14 16:00:00"},"otp":{"confirmation_id":"5f1c2a9e-7b3d-4e8f-9a6c-1d2e3f4a5b6c","expires_at":"2026-09-14T12:15:00.000000Z"}},"created_at":"\u003cstring>","failure_reason":{"code":"card_declined","message":"O cartão não possui saldo suficiente para concluir o pagamento.","customer_message":"Não foi possível concluir o pagamento. Revise os dados informados ou tente outro meio de pagamento.","merchant_message":"O pagamento não foi concluído. Oriente o comprador a revisar os dados informados ou tentar outro meio de pagamento."}}}},"exampleType":"generated"}},"exampleType":"generated"},"59e9ba5f-43df-437b-b65d-55de51bbeb39":{"description":"O header `Idempotency-Key` tem mais de 128 caracteres","content":{"application/json":{"schema":{"type":"object","description":"Envelope de erro da API v2","required":["error"],"properties":{"error":{"type":"object","required":["type","code","message"],"properties":{"type":{"type":"string","enum":["invalid_request_error","idempotency_error","authentication_error","api_error"],"description":"Categoria do erro","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","description":"Código estável do erro. Use este campo na sua lógica","example":"validation_error","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Texto técnico, para log e depuração. Não exiba ao pagador","example":"The payments field is required.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"type":"string","description":"Campo que causou o erro, em notação de ponto. Presente só quando se aplica","example":"payments","uniqueKey":"error.param","typeLabel":"string"},"customer_message":{"type":"string","description":"Texto para exibir ao pagador. Presente só quando se aplica","uniqueKey":"error.customer_message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"type":"invalid_request_error","code":"idempotency_key_invalid","message":"A Idempotency-Key deve ter no máximo 128 caracteres."}},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_request_error","code":"idempotency_key_invalid","message":"A Idempotency-Key deve ter no máximo 128 caracteres."}}}},"exampleType":"examples"}},"exampleType":"examples"},"44275e35-f238-436a-9573-fff1acb6eabb":{"description":"Chave de API ausente, inválida, revogada ou de outro ambiente","content":{"application/json":{"schema":{"type":"object","description":"Envelope de erro da API v2","required":["error"],"properties":{"error":{"type":"object","required":["type","code","message"],"properties":{"type":{"type":"string","enum":["invalid_request_error","idempotency_error","authentication_error","api_error"],"description":"Categoria do erro","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","description":"Código estável do erro. Use este campo na sua lógica","example":"validation_error","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Texto técnico, para log e depuração. Não exiba ao pagador","example":"The payments field is required.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"type":"string","description":"Campo que causou o erro, em notação de ponto. Presente só quando se aplica","example":"payments","uniqueKey":"error.param","typeLabel":"string"},"customer_message":{"type":"string","description":"Texto para exibir ao pagador. Presente só quando se aplica","uniqueKey":"error.customer_message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"type":"authentication_error","code":"invalid_api_secret","message":"A chave de API informada é inválida."}},"examples":{"Example":{"title":"Example","value":{"error":{"type":"authentication_error","code":"invalid_api_secret","message":"A chave de API informada é inválida."}}}},"exampleType":"examples"}},"exampleType":"examples"},"185bb9bc-4025-4041-803c-9821f3ab1610":{"description":"Pagamento da fatura recusado. Não é erro de requisição: o corpo traz a fatura completa com `status: failed` e o motivo em `failure_reason`. Exiba ao pagador o `customer_message`, nunca o `message`.\n","content":{"application/json":{"schema":{"type":"object","description":"Fatura de um ciclo da assinatura. `processing`: em processamento. `requires_action`: PIX aguardando pagamento ou verificação por código (veja `next_action`). `paid`: paga. `failed`: recusada (veja `failure_reason`). `canceled`: cancelada. `refunded` e `partially_refunded`: estornada. `chargeback`: contestada.\n","properties":{"id":{"type":"string","example":"ord_Xc4Vb7Nm2As5Df8G","uniqueKey":"id","typeLabel":"string"},"object":{"type":"string","enum":["invoice"],"uniqueKey":"object","typeLabel":"enum\u003cstring>"},"subscription":{"type":"string","example":"sub_4Hn8Qw2Rt6Yp1Zx3","uniqueKey":"subscription","typeLabel":"string"},"number":{"type":"integer","description":"Número da fatura na assinatura","example":1,"uniqueKey":"number","typeLabel":"integer"},"status":{"type":"string","enum":["processing","requires_action","paid","failed","canceled","refunded","partially_refunded","chargeback"],"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"currency":{"type":"string","enum":["brl"],"description":"Sempre `brl`","example":"brl","uniqueKey":"currency","typeLabel":"enum\u003cstring>"},"original_amount":{"type":"integer","description":"Valor da fatura na moeda da assinatura, em centavos. Igual a `amount` em BRL","example":10000,"uniqueKey":"original_amount","typeLabel":"integer"},"original_currency":{"type":"string","description":"Moeda enviada, em minúsculas","example":"brl","uniqueKey":"original_currency","typeLabel":"string"},"exchange_rate":{"oneOf":[{"type":"number","description":"Cotação usada: 1 unidade da moeda original = `exchange_rate` reais. `null` quando a moeda é BRL. Única por fatura: uma nova tentativa reaproveita a cotação da primeira cobrança.\n","example":null,"uniqueKey":"exchange_rate.oneOf.0","typeLabel":"number"},{"type":"null","description":"Cotação usada: 1 unidade da moeda original = `exchange_rate` reais. `null` quando a moeda é BRL. Única por fatura: uma nova tentativa reaproveita a cotação da primeira cobrança.\n","example":null,"uniqueKey":"exchange_rate.oneOf.1","typeLabel":"null"}],"uniqueKey":"exchange_rate","typeLabel":"number | null"},"amount":{"type":"integer","description":"Valor cobrado, em centavos de real, já com descontos e acréscimos. Fecha ao centavo com Σ `items[].amount_total` − Σ `discounts[].amount_applied` + Σ `increments[].amount_applied`. Somar `items[].amount × quantity` não tem essa garantia.\n","example":9000,"uniqueKey":"amount","typeLabel":"integer"},"attempts":{"type":"integer","description":"Tentativas de cobrança","uniqueKey":"attempts","typeLabel":"integer"},"items":{"type":"array","description":"Itens da fatura. `amount` é o valor unitário, em centavos de real, convertido pela `exchange_rate`. `amount_total` é o total bruto da linha, em centavos de real, conciliado com o `amount` da fatura.\n","items":{"type":"object","required":["code","description","quantity","amount"],"properties":{"code":{"type":"string","maxLength":255,"example":"SKU-SUB","isRequired":true,"uniqueKey":"\\items.items.[INDEX].code","typeLabel":"string"},"description":{"type":"string","maxLength":255,"example":"Assinatura","isRequired":true,"uniqueKey":"\\items.items.[INDEX].description","typeLabel":"string"},"quantity":{"type":"integer","minimum":1,"example":1,"isRequired":true,"uniqueKey":"\\items.items.[INDEX].quantity","typeLabel":"integer"},"amount":{"type":"integer","minimum":1,"description":"Valor unitário, em centavos","example":10000,"isRequired":true,"uniqueKey":"\\items.items.[INDEX].amount","typeLabel":"integer"},"amount_total":{"type":"integer","description":"Total bruto da linha (valor unitário × quantidade), em centavos de real, conciliado com o `amount` da fatura","example":10000,"uniqueKey":"\\items.items.[INDEX].amount_total","typeLabel":"integer"}},"uniqueKey":"\\items.items.[INDEX]","typeLabel":"object"},"uniqueKey":"\\items","typeLabel":"object[]"},"discounts":{"type":"array","description":"Descontos da fatura. `value` é o valor declarado: em `fixed`, centavos de real convertidos pela `exchange_rate`; em `percentage`, o percentual, sem conversão. `amount_applied` é o valor efetivamente descontado, em centavos de real.\n","items":{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["fixed","percentage"],"isRequired":true,"uniqueKey":"discounts.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"value":{"type":"number","exclusiveMinimum":0,"description":"Em `fixed`, valor inteiro em centavos. Em `percentage`, percentual (em descontos, no máximo 100).\n","example":1000,"isRequired":true,"uniqueKey":"discounts.items.[INDEX].value","typeLabel":"number"},"invoice_number":{"oneOf":[{"type":"integer","minimum":1,"description":"Número da fatura a que o ajuste se aplica. Sem valor, vale para todas as faturas","example":1,"uniqueKey":"discounts.items.[INDEX].invoice_number.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":1,"description":"Número da fatura a que o ajuste se aplica. Sem valor, vale para todas as faturas","example":1,"uniqueKey":"discounts.items.[INDEX].invoice_number.oneOf.1","typeLabel":"null"}],"uniqueKey":"discounts.items.[INDEX].invoice_number","typeLabel":"integer | null"},"amount_applied":{"type":"integer","description":"Valor efetivamente aplicado, em centavos de real, inclusive em `percentage`. Nos descontos, o total aplicado é limitado ao valor dos itens e repartido na proporção do valor declarado de cada desconto; por isso pode ser menor que `value`. Nos acréscimos, não há limite.\n","example":1000,"uniqueKey":"discounts.items.[INDEX].amount_applied","typeLabel":"integer"}},"uniqueKey":"discounts.items.[INDEX]","typeLabel":"object"},"uniqueKey":"discounts","typeLabel":"object[]"},"increments":{"type":"array","description":"Acréscimos da fatura, com os mesmos campos de `discounts`. `amount_applied` é o valor efetivamente acrescido, em centavos de real. Acréscimos não têm limite.\n","items":{"type":"object","required":["type","value"],"properties":{"type":{"type":"string","enum":["fixed","percentage"],"isRequired":true,"uniqueKey":"increments.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"value":{"type":"number","exclusiveMinimum":0,"description":"Em `fixed`, valor inteiro em centavos. Em `percentage`, percentual (em descontos, no máximo 100).\n","example":1000,"isRequired":true,"uniqueKey":"increments.items.[INDEX].value","typeLabel":"number"},"invoice_number":{"oneOf":[{"type":"integer","minimum":1,"description":"Número da fatura a que o ajuste se aplica. Sem valor, vale para todas as faturas","example":1,"uniqueKey":"increments.items.[INDEX].invoice_number.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":1,"description":"Número da fatura a que o ajuste se aplica. Sem valor, vale para todas as faturas","example":1,"uniqueKey":"increments.items.[INDEX].invoice_number.oneOf.1","typeLabel":"null"}],"uniqueKey":"increments.items.[INDEX].invoice_number","typeLabel":"integer | null"},"amount_applied":{"type":"integer","description":"Valor efetivamente aplicado, em centavos de real, inclusive em `percentage`. Nos descontos, o total aplicado é limitado ao valor dos itens e repartido na proporção do valor declarado de cada desconto; por isso pode ser menor que `value`. Nos acréscimos, não há limite.\n","example":1000,"uniqueKey":"increments.items.[INDEX].amount_applied","typeLabel":"integer"}},"uniqueKey":"increments.items.[INDEX]","typeLabel":"object"},"uniqueKey":"increments","typeLabel":"object[]"},"payments":{"type":"array","items":{"type":"object","description":"Um meio de pagamento dentro de um pedido ou fatura. O `id` é o mesmo da cobrança (`GET /v2/charges/{id}`).\n","properties":{"id":{"type":"string","example":"cha_8Kq2Lm9XvB3nT7pZ","uniqueKey":"payments.items.[INDEX].id","typeLabel":"string"},"object":{"type":"string","enum":["payment_intent"],"uniqueKey":"payments.items.[INDEX].object","typeLabel":"enum\u003cstring>"},"status":{"type":"string","enum":["requires_action","requires_capture","processing","paid","failed","canceled","refund_processing","partially_refunded","refunded","chargeback"],"description":"`requires_action`: PIX aguardando pagamento ou verificação por código. `requires_capture`: cartão autorizado, aguardando captura. `processing`: em processamento. `paid`: pago. `failed`: recusado. `canceled`: cancelado. `refund_processing`: estorno em processamento. `partially_refunded` e `refunded`: estornado em parte ou totalmente. `chargeback`: contestado pelo portador.\n","uniqueKey":"payments.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"amount":{"type":"integer","description":"Valor cobrado, em centavos de real","example":10000,"uniqueKey":"payments.items.[INDEX].amount","typeLabel":"integer"},"amount_refunded":{"type":"integer","description":"Valor estornado, em centavos","example":0,"uniqueKey":"payments.items.[INDEX].amount_refunded","typeLabel":"integer"},"currency":{"type":"string","enum":["brl"],"description":"Sempre `brl`","example":"brl","uniqueKey":"payments.items.[INDEX].currency","typeLabel":"enum\u003cstring>"},"original_amount":{"type":"integer","description":"Valor na moeda enviada, em centavos. Igual a `amount` em BRL","example":10000,"uniqueKey":"payments.items.[INDEX].original_amount","typeLabel":"integer"},"original_currency":{"type":"string","description":"Moeda enviada, em minúsculas","example":"brl","uniqueKey":"payments.items.[INDEX].original_currency","typeLabel":"string"},"exchange_rate":{"oneOf":[{"type":"number","description":"Cotação usada: 1 unidade da moeda original = `exchange_rate` reais. `null` quando a moeda é BRL.\n","example":null,"uniqueKey":"payments.items.[INDEX].exchange_rate.oneOf.0","typeLabel":"number"},{"type":"null","description":"Cotação usada: 1 unidade da moeda original = `exchange_rate` reais. `null` quando a moeda é BRL.\n","example":null,"uniqueKey":"payments.items.[INDEX].exchange_rate.oneOf.1","typeLabel":"null"}],"uniqueKey":"payments.items.[INDEX].exchange_rate","typeLabel":"number | null"},"payment_method_details":{"type":"object","properties":{"type":{"type":"string","enum":["card","pix","boleto"],"uniqueKey":"payments.items.[INDEX].payment_method_details.type","typeLabel":"enum\u003cstring>"},"card":{"type":"object","description":"Cartão vinculado à cobrança. Só aparece quando a cobrança tem um cartão vinculado: sem cartão, a chave `card` não é enviada (ela não vem com `null`). O `id` do cartão não é devolvido em pedidos nem em cobranças. O número completo e o código de segurança nunca são devolvidos.\n","properties":{"brand":{"type":"string","example":"visa","uniqueKey":"payments.items.[INDEX].payment_method_details.card.brand","typeLabel":"string"},"first_six":{"oneOf":[{"type":"string","example":"411111","uniqueKey":"payments.items.[INDEX].payment_method_details.card.first_six.oneOf.0","typeLabel":"string"},{"type":"null","example":"411111","uniqueKey":"payments.items.[INDEX].payment_method_details.card.first_six.oneOf.1","typeLabel":"null"}],"uniqueKey":"payments.items.[INDEX].payment_method_details.card.first_six","typeLabel":"string | null"},"last_four":{"oneOf":[{"type":"string","example":"1111","uniqueKey":"payments.items.[INDEX].payment_method_details.card.last_four.oneOf.0","typeLabel":"string"},{"type":"null","example":"1111","uniqueKey":"payments.items.[INDEX].payment_method_details.card.last_four.oneOf.1","typeLabel":"null"}],"uniqueKey":"payments.items.[INDEX].payment_method_details.card.last_four","typeLabel":"string | null"},"holder_name":{"type":"string","example":"João Silva","uniqueKey":"payments.items.[INDEX].payment_method_details.card.holder_name","typeLabel":"string"},"exp_month":{"oneOf":[{"type":"integer","example":12,"uniqueKey":"payments.items.[INDEX].payment_method_details.card.exp_month.oneOf.0","typeLabel":"integer"},{"type":"null","example":12,"uniqueKey":"payments.items.[INDEX].payment_method_details.card.exp_month.oneOf.1","typeLabel":"null"}],"uniqueKey":"payments.items.[INDEX].payment_method_details.card.exp_month","typeLabel":"integer | null"},"exp_year":{"oneOf":[{"type":"integer","example":2030,"uniqueKey":"payments.items.[INDEX].payment_method_details.card.exp_year.oneOf.0","typeLabel":"integer"},{"type":"null","example":2030,"uniqueKey":"payments.items.[INDEX].payment_method_details.card.exp_year.oneOf.1","typeLabel":"null"}],"uniqueKey":"payments.items.[INDEX].payment_method_details.card.exp_year","typeLabel":"integer | null"}},"uniqueKey":"payments.items.[INDEX].payment_method_details.card","typeLabel":"object"},"pix":{"type":"object","properties":{"qr_code":{"type":"string","description":"Código PIX copia e cola","example":"00020126580014br.gov.bcb.pix0136a1b2c3d4-e5f6-7890-abcd-ef1234567890","uniqueKey":"payments.items.[INDEX].payment_method_details.pix.qr_code","typeLabel":"string"},"qr_code_url":{"type":"string","description":"Link do QR Code","example":"https://pix.exemplo.com.br/qr/cha_8Kq2Lm9XvB3nT7pZ","uniqueKey":"payments.items.[INDEX].payment_method_details.pix.qr_code_url","typeLabel":"string"},"expires_at":{"type":"string","description":"Data e hora de expiração do QR Code, no formato `AAAA-MM-DD HH:MM:SS`, sem indicação de fuso","example":"2026-09-14 16:00:00","uniqueKey":"payments.items.[INDEX].payment_method_details.pix.expires_at","typeLabel":"string"}},"uniqueKey":"payments.items.[INDEX].payment_method_details.pix","typeLabel":"object"}},"uniqueKey":"payments.items.[INDEX].payment_method_details","typeLabel":"object"}},"uniqueKey":"payments.items.[INDEX]","typeLabel":"object"},"uniqueKey":"payments","typeLabel":"object[]"},"next_action":{"oneOf":[{"type":"object","description":"O que precisa acontecer para o pagamento seguir. `pix_display_qr_code`: exiba o QR Code para o pagador. `otp_confirmation`: a análise de fraude pediu verificação — nada é cobrado até o código ser confirmado na rota `/confirm`.\n","properties":{"type":{"type":"string","enum":["pix_display_qr_code","otp_confirmation"],"uniqueKey":"next_action.oneOf.0.type","typeLabel":"enum\u003cstring>"},"pix":{"type":"object","properties":{"qr_code":{"type":"string","description":"Código PIX copia e cola","example":"00020126580014br.gov.bcb.pix0136a1b2c3d4-e5f6-7890-abcd-ef1234567890","uniqueKey":"next_action.oneOf.0.pix.qr_code","typeLabel":"string"},"qr_code_url":{"type":"string","description":"Link do QR Code","example":"https://pix.exemplo.com.br/qr/cha_8Kq2Lm9XvB3nT7pZ","uniqueKey":"next_action.oneOf.0.pix.qr_code_url","typeLabel":"string"},"expires_at":{"type":"string","description":"Data e hora de expiração do QR Code, no formato `AAAA-MM-DD HH:MM:SS`, sem indicação de fuso","example":"2026-09-14 16:00:00","uniqueKey":"next_action.oneOf.0.pix.expires_at","typeLabel":"string"}},"uniqueKey":"next_action.oneOf.0.pix","typeLabel":"object"},"otp":{"type":"object","description":"Presente quando `type` é `otp_confirmation`","properties":{"confirmation_id":{"type":"string","example":"5f1c2a9e-7b3d-4e8f-9a6c-1d2e3f4a5b6c","uniqueKey":"next_action.oneOf.0.otp.confirmation_id","typeLabel":"string"},"expires_at":{"type":"string","description":"Data e hora de expiração do código, em UTC (ISO 8601)","example":"2026-09-14T12:15:00.000000Z","uniqueKey":"next_action.oneOf.0.otp.expires_at","typeLabel":"string"}},"uniqueKey":"next_action.oneOf.0.otp","typeLabel":"object"}},"uniqueKey":"next_action.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"next_action.oneOf.1","typeLabel":"null"}],"uniqueKey":"next_action","typeLabel":"object | null"},"created_at":{"type":"string","uniqueKey":"created_at","typeLabel":"string"},"failure_reason":{"type":"object","description":"Motivo da recusa. Presente só quando o status é `failed`","required":["code","message","customer_message","merchant_message"],"properties":{"code":{"type":"string","enum":["card_declined","insufficient_funds","expired_card","incorrect_cvc","incorrect_number","card_not_supported","fraud_suspected","invalid_request","acquirer_error","processing_error"],"isRequired":true,"uniqueKey":"failure_reason.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Texto técnico. Não exiba ao pagador","example":"O cartão não possui saldo suficiente para concluir o pagamento.","isRequired":true,"uniqueKey":"failure_reason.message","typeLabel":"string"},"customer_message":{"type":"string","description":"Texto para exibir ao pagador","example":"Não foi possível concluir o pagamento. Revise os dados informados ou tente outro meio de pagamento.","isRequired":true,"uniqueKey":"failure_reason.customer_message","typeLabel":"string"},"merchant_message":{"type":"string","description":"Texto para você ou a sua equipe de atendimento","example":"O pagamento não foi concluído. Oriente o comprador a revisar os dados informados ou tentar outro meio de pagamento.","isRequired":true,"uniqueKey":"failure_reason.merchant_message","typeLabel":"string"}},"uniqueKey":"failure_reason","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"id":"ord_Xc4Vb7Nm2As5Df8G","object":"invoice","subscription":"sub_4Hn8Qw2Rt6Yp1Zx3","number":2,"status":"failed","currency":"brl","amount":10000,"original_amount":10000,"original_currency":"brl","exchange_rate":null,"attempts":1,"items":[{"code":"SKU-SUB","description":"Assinatura","quantity":1,"amount":10000,"amount_total":10000}],"discounts":[],"increments":[],"payments":[{"id":"cha_Ry5Wc1Hd7Nf3Jk9A","object":"payment_intent","status":"failed","amount":10000,"amount_refunded":0,"currency":"brl","original_amount":10000,"original_currency":"brl","exchange_rate":null,"payment_method_details":{"type":"card","card":{"brand":"visa","first_six":"411111","last_four":"1111","holder_name":"João Silva","exp_month":12,"exp_year":2030}}}],"next_action":null,"created_at":"2026-09-14T12:00:00-03:00","failure_reason":{"code":"card_declined","message":"O cartão foi recusado pelo emissor.","customer_message":"Não foi possível concluir o pagamento. Revise os dados informados ou tente outro meio de pagamento.","merchant_message":"O pagamento não foi concluído. Oriente o comprador a revisar os dados informados ou tentar outro meio de pagamento."}},"examples":{"Example":{"title":"Example","value":{"id":"ord_Xc4Vb7Nm2As5Df8G","object":"invoice","subscription":"sub_4Hn8Qw2Rt6Yp1Zx3","number":2,"status":"failed","currency":"brl","amount":10000,"original_amount":10000,"original_currency":"brl","exchange_rate":null,"attempts":1,"items":[{"code":"SKU-SUB","description":"Assinatura","quantity":1,"amount":10000,"amount_total":10000}],"discounts":[],"increments":[],"payments":[{"id":"cha_Ry5Wc1Hd7Nf3Jk9A","object":"payment_intent","status":"failed","amount":10000,"amount_refunded":0,"currency":"brl","original_amount":10000,"original_currency":"brl","exchange_rate":null,"payment_method_details":{"type":"card","card":{"brand":"visa","first_six":"411111","last_four":"1111","holder_name":"João Silva","exp_month":12,"exp_year":2030}}}],"next_action":null,"created_at":"2026-09-14T12:00:00-03:00","failure_reason":{"code":"card_declined","message":"O cartão foi recusado pelo emissor.","customer_message":"Não foi possível concluir o pagamento. Revise os dados informados ou tente outro meio de pagamento.","merchant_message":"O pagamento não foi concluído. Oriente o comprador a revisar os dados informados ou tentar outro meio de pagamento."}}}},"exampleType":"examples"}},"exampleType":"examples"},"37d2d18d-8f6b-4783-bc31-c403f91c2e4e":{"description":"As requisições da conta estão bloqueadas. A resposta traz `customer_message`","content":{"application/json":{"schema":{"type":"object","description":"Envelope de erro da API v2","required":["error"],"properties":{"error":{"type":"object","required":["type","code","message"],"properties":{"type":{"type":"string","enum":["invalid_request_error","idempotency_error","authentication_error","api_error"],"description":"Categoria do erro","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","description":"Código estável do erro. Use este campo na sua lógica","example":"validation_error","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Texto técnico, para log e depuração. Não exiba ao pagador","example":"The payments field is required.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"type":"string","description":"Campo que causou o erro, em notação de ponto. Presente só quando se aplica","example":"payments","uniqueKey":"error.param","typeLabel":"string"},"customer_message":{"type":"string","description":"Texto para exibir ao pagador. Presente só quando se aplica","uniqueKey":"error.customer_message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"type":"invalid_request_error","code":"account_requests_blocked","message":"As requisições desta conta estão bloqueadas.","customer_message":"Não foi possível concluir sua transação. Tente novamente mais tarde."}},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_request_error","code":"account_requests_blocked","message":"As requisições desta conta estão bloqueadas.","customer_message":"Não foi possível concluir sua transação. Tente novamente mais tarde."}}}},"exampleType":"examples"}},"exampleType":"examples"},"c769db75-a6c0-4641-be5c-34330cbc5c00":{"description":"Fatura não encontrada nesta conta","content":{"application/json":{"schema":{"type":"object","description":"Envelope de erro da API v2","required":["error"],"properties":{"error":{"type":"object","required":["type","code","message"],"properties":{"type":{"type":"string","enum":["invalid_request_error","idempotency_error","authentication_error","api_error"],"description":"Categoria do erro","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","description":"Código estável do erro. Use este campo na sua lógica","example":"validation_error","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Texto técnico, para log e depuração. Não exiba ao pagador","example":"The payments field is required.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"type":"string","description":"Campo que causou o erro, em notação de ponto. Presente só quando se aplica","example":"payments","uniqueKey":"error.param","typeLabel":"string"},"customer_message":{"type":"string","description":"Texto para exibir ao pagador. Presente só quando se aplica","uniqueKey":"error.customer_message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"type":"invalid_request_error","code":"resource_missing","message":"Recurso \"invoice\" não encontrado."}},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_request_error","code":"resource_missing","message":"Recurso \"invoice\" não encontrado."}}}},"exampleType":"examples"}},"exampleType":"examples"},"a97c4f39-98a0-408b-991e-87814c3044b3":{"description":"Uma requisição com a mesma `Idempotency-Key` ainda está em andamento. Tente novamente em instantes","content":{"application/json":{"schema":{"type":"object","description":"Envelope de erro da API v2","required":["error"],"properties":{"error":{"type":"object","required":["type","code","message"],"properties":{"type":{"type":"string","enum":["invalid_request_error","idempotency_error","authentication_error","api_error"],"description":"Categoria do erro","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","description":"Código estável do erro. Use este campo na sua lógica","example":"validation_error","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Texto técnico, para log e depuração. Não exiba ao pagador","example":"The payments field is required.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"type":"string","description":"Campo que causou o erro, em notação de ponto. Presente só quando se aplica","example":"payments","uniqueKey":"error.param","typeLabel":"string"},"customer_message":{"type":"string","description":"Texto para exibir ao pagador. Presente só quando se aplica","uniqueKey":"error.customer_message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"type":"idempotency_error","code":"idempotency_key_in_use","message":"Uma requisição com esta Idempotency-Key ainda está em processamento. Tente novamente em instantes."}},"examples":{"Example":{"title":"Example","value":{"error":{"type":"idempotency_error","code":"idempotency_key_in_use","message":"Uma requisição com esta Idempotency-Key ainda está em processamento. Tente novamente em instantes."}}}},"exampleType":"examples"}},"exampleType":"examples"},"ea82eab2-83ea-45da-b1c6-e338796359a4":{"description":"Código ausente, inválido ou fatura sem verificação pendente","content":{"application/json":{"schema":{"type":"object","description":"Envelope de erro da API v2","required":["error"],"properties":{"error":{"type":"object","required":["type","code","message"],"properties":{"type":{"type":"string","enum":["invalid_request_error","idempotency_error","authentication_error","api_error"],"description":"Categoria do erro","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","description":"Código estável do erro. Use este campo na sua lógica","example":"validation_error","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Texto técnico, para log e depuração. Não exiba ao pagador","example":"The payments field is required.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"type":"string","description":"Campo que causou o erro, em notação de ponto. Presente só quando se aplica","example":"payments","uniqueKey":"error.param","typeLabel":"string"},"customer_message":{"type":"string","description":"Texto para exibir ao pagador. Presente só quando se aplica","uniqueKey":"error.customer_message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"parameter_missing":{"title":"parameter_missing","value":{"error":{"type":"invalid_request_error","code":"parameter_missing","message":"O parâmetro \"code\" é obrigatório.","param":"code"}}},"confirmation_code_invalid":{"title":"confirmation_code_invalid","value":{"error":{"type":"invalid_request_error","code":"confirmation_code_invalid","message":"O código de confirmação é inválido ou expirou."}}},"order_not_confirmable":{"title":"order_not_confirmable","value":{"error":{"type":"invalid_request_error","code":"order_not_confirmable","message":"Este pedido não está aguardando um código de confirmação."}}},"idempotency_key_conflict":{"title":"idempotency_key_conflict","value":{"error":{"type":"idempotency_error","code":"idempotency_key_conflict","message":"Esta Idempotency-Key já foi usada com um corpo de requisição diferente."}}}},"exampleType":"examples"}},"exampleType":"examples"},"d6cd28ca-9e67-4cf1-bda6-bb9352a53781":{"description":"Limite geral de requisições excedido (120 por minuto por chave de API e por conta). Usa o envelope `error` da API v2, com `code` `api_rate_limited`. O `type` é `invalid_request_error`, como em outros erros de requisição: identifique o estrangulamento pelo `code`, não pelo `type`.\n","headers":{"X-RateLimit-Limit":{"description":"Limite de requisições da janela","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requisições restantes na janela","schema":{"type":"integer"}},"Retry-After":{"description":"Segundos até a próxima tentativa","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","description":"Envelope de erro da API v2","required":["error"],"properties":{"error":{"type":"object","required":["type","code","message"],"properties":{"type":{"type":"string","enum":["invalid_request_error","idempotency_error","authentication_error","api_error"],"description":"Categoria do erro","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","description":"Código estável do erro. Use este campo na sua lógica","example":"validation_error","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Texto técnico, para log e depuração. Não exiba ao pagador","example":"The payments field is required.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"type":"string","description":"Campo que causou o erro, em notação de ponto. Presente só quando se aplica","example":"payments","uniqueKey":"error.param","typeLabel":"string"},"customer_message":{"type":"string","description":"Texto para exibir ao pagador. Presente só quando se aplica","uniqueKey":"error.customer_message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"type":"invalid_request_error","code":"api_rate_limited","message":"Muitas requisições em pouco tempo. Tente novamente em alguns instantes."}},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_request_error","code":"api_rate_limited","message":"Muitas requisições em pouco tempo. Tente novamente em alguns instantes."}}}},"exampleType":"examples"}},"exampleType":"examples"},"2226fce3-e340-480c-ab16-7a32b5f4ab66":{"description":"Erro inesperado ao processar a requisição","content":{"application/json":{"schema":{"type":"object","description":"Envelope de erro da API v2","required":["error"],"properties":{"error":{"type":"object","required":["type","code","message"],"properties":{"type":{"type":"string","enum":["invalid_request_error","idempotency_error","authentication_error","api_error"],"description":"Categoria do erro","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","description":"Código estável do erro. Use este campo na sua lógica","example":"validation_error","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Texto técnico, para log e depuração. Não exiba ao pagador","example":"The payments field is required.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"type":"string","description":"Campo que causou o erro, em notação de ponto. Presente só quando se aplica","example":"payments","uniqueKey":"error.param","typeLabel":"string"},"customer_message":{"type":"string","description":"Texto para exibir ao pagador. Presente só quando se aplica","uniqueKey":"error.customer_message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"type":"api_error","code":"internal_error","message":"Ocorreu um erro inesperado ao processar a requisição."}},"examples":{"Example":{"title":"Example","value":{"error":{"type":"api_error","code":"internal_error","message":"Ocorreu um erro inesperado ao processar a requisição."}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"d4d4c830-1e30-4a82-991c-71e6762f44c0":{"secretKeyAuth":{"type":"http","scheme":"bearer","description":"Chave de API (secret key) da conta, no formato `sk_live_...` (produção) ou `sk_test_...` (Ambiente de Sandbox). Envie no header `Authorization: Bearer \u003cchave>`. Autentica todas as rotas da API v2 e as rotas de Análise de Fraude. A chave identifica a conta, então a API v2 não usa o header `account`. Uma chave só é aceita no ambiente em que foi criada. Gere a sua no dashboard em Configurações → Chaves de API.\n","scopes":[],"schemeName":"secretKeyAuth"}}},"servers":{"4c3dfa86-2ed5-4f58-9a07-b7d334d46949":{"url":"https://sandbox.4seletpay.com.br/api","description":"Servidor de Sandbox"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Chave de API (secret key) da conta, no formato `sk_live_...` (produção) ou `sk_test_...` (Ambiente de Sandbox). Envie no header `Authorization: Bearer \u003cchave>`. Autentica todas as rotas da API v2 e as rotas de Análise de Fraude. A chave identifica a conta, então a API v2 não usa o header `account`. Uma chave só é aceita no ambiente em que foi criada. Gere a sua no dashboard em Configurações → Chaves de API.\n","scopes":[],"schemeName":"secretKeyAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Chave de API (secret key) da conta, no formato `sk_live_...` (produção) ou `sk_test_...` (Ambiente de Sandbox). Envie no header `Authorization: Bearer \u003cchave>`. Autentica todas as rotas da API v2 e as rotas de Análise de Fraude. A chave identifica a conta, então a API v2 não usa o header `account`. Uma chave só é aceita no ambiente em que foi criada. Gere a sua no dashboard em Configurações → Chaves de API.\n","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"secretKeyAuth","name":"Authorization"}],"title":"secretKeyAuth"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"4selet-1a9bfa9b","siteName":"4SeletPay","title":"Confirmar código de verificação da fatura - 4SeletPay","navMaps":{"firstHrefInVersion":{"v2":{"href":"/pages/v2/faturas/confirm","matchLevel":0},"v1":{"href":"/pages/faturas/reference","matchLevel":2}},"firstHrefInLanguage":{}},"lastModified":"2026-09-14T14:02:53.728Z","originalFileLocation":"pages/v2/faturas/confirm.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=\"dark\"}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=\"Envia o código de verificação recebido pelo pagador quando a fatura está em requires_action com next_action.type: otp_confirmation. Nada é cobrado até a confirmação. Se o pagamento for recusado, a resposta é 402 com failure_reason.\">\u003cmeta data-mint-head name=\"application-name\" content=\"4SeletPay\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/4selet-1a9bfa9b/Cx20MerxjKZBNPbF/_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/4selet-1a9bfa9b/Cx20MerxjKZBNPbF/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/4selet-1a9bfa9b/Cx20MerxjKZBNPbF/_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/4selet-1a9bfa9b/Cx20MerxjKZBNPbF/_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/4selet-1a9bfa9b/Cx20MerxjKZBNPbF/_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/4selet-1a9bfa9b/Cx20MerxjKZBNPbF/_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/4selet-1a9bfa9b/Cx20MerxjKZBNPbF/_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/4selet-1a9bfa9b/Cx20MerxjKZBNPbF/_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/4selet-1a9bfa9b/Cx20MerxjKZBNPbF/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Confirmar código de verificação da fatura - 4SeletPay\">\u003cmeta data-mint-head property=\"og:description\" content=\"Envia o código de verificação recebido pelo pagador quando a fatura está em requires_action com next_action.type: otp_confirmation. Nada é cobrado até a confirmação. Se o pagamento for recusado, a resposta é 402 com failure_reason.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"4SeletPay\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.4seletpay.com.br/pages/v2/faturas/confirm\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://4selet-1a9bfa9b.mintlify.site/_mintlify/api/og/v2?division=Faturas\u0026amp;title=Confirmar+c%C3%B3digo+de+verifica%C3%A7%C3%A3o+da+fatura\u0026amp;description=Envia+o+c%C3%B3digo+de+verifica%C3%A7%C3%A3o+recebido+pelo+pagador+quando+a+fatura+est%C3%A1+em+%60requires_action%60+com+%60next_action.type%3A+otp_confirmation%60.+Nada+%C3%A9+cobrado+at%C3%A9+a+con\u0026amp;theme=e946cf76f4ab5d90a4344f4d\u0026amp;signature=afafcfa01a24fe4af97fe9e0a657ac0a69f9400e91d9a641d0185898d7148bce\">\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=\"Confirmar código de verificação da fatura - 4SeletPay\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Envia o código de verificação recebido pelo pagador quando a fatura está em requires_action com next_action.type: otp_confirmation. Nada é cobrado até a confirmação. Se o pagamento for recusado, a resposta é 402 com failure_reason.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://4selet-1a9bfa9b.mintlify.site/_mintlify/api/og/v2?division=Faturas\u0026amp;title=Confirmar+c%C3%B3digo+de+verifica%C3%A7%C3%A3o+da+fatura\u0026amp;description=Envia+o+c%C3%B3digo+de+verifica%C3%A7%C3%A3o+recebido+pelo+pagador+quando+a+fatura+est%C3%A1+em+%60requires_action%60+com+%60next_action.type%3A+otp_confirmation%60.+Nada+%C3%A9+cobrado+at%C3%A9+a+con\u0026amp;theme=e946cf76f4ab5d90a4344f4d\u0026amp;signature=afafcfa01a24fe4af97fe9e0a657ac0a69f9400e91d9a641d0185898d7148bce\">\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/4selet-1a9bfa9b/Cx20MerxjKZBNPbF/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"4SeletPay\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#007AFF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.4seletpay.com.br/pages/v2/faturas/confirm\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/pages/v2/faturas/confirm.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.4seletpay.com.br/#organization\",\"name\":\"4SeletPay\",\"url\":\"https://docs.4seletpay.com.br\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/4selet-1a9bfa9b/AoymSTBvUJFLYdIf/logo/logo.png?fit=max\u0026auto=format\u0026n=AoymSTBvUJFLYdIf\u0026q=85\u0026s=16da9497a7389abca443032d35b63e76\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.4seletpay.com.br#website\",\"name\":\"4SeletPay\",\"url\":\"https://docs.4seletpay.com.br\",\"publisher\":{\"@id\":\"https://docs.4seletpay.com.br/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.4seletpay.com.br/pages/v2/faturas/confirm#webpage\",\"url\":\"https://docs.4seletpay.com.br/pages/v2/faturas/confirm\",\"name\":\"Confirmar código de verificação da fatura\",\"description\":\"Envia o código de verificação recebido pelo pagador quando a fatura está em requires_action com next_action.type: otp_confirmation. Nada é cobrado até a confirmação. Se o pagamento for recusado, a resposta é 402 com failure_reason.\",\"dateModified\":\"2026-09-14T14:02:53.728Z\",\"isPartOf\":{\"@id\":\"https://docs.4seletpay.com.br#website\"},\"breadcrumb\":{\"@id\":\"https://docs.4seletpay.com.br/pages/v2/faturas/confirm#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.4seletpay.com.br/pages/v2/faturas/confirm#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Faturas\",\"item\":\"https://docs.4seletpay.com.br/pages/v2/faturas/reference\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Confirmar código de verificação da fatura\",\"item\":\"https://docs.4seletpay.com.br/pages/v2/faturas/confirm\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.4seletpay.com.br/pages/v2/faturas/confirm#apireference\",\"headline\":\"Confirmar código de verificação da fatura\",\"name\":\"Confirmar código de verificação da fatura\",\"description\":\"Envia o código de verificação recebido pelo pagador quando a fatura está em requires_action com next_action.type: otp_confirmation. Nada é cobrado até a confirmação. Se o pagamento for recusado, a resposta é 402 com failure_reason.\",\"url\":\"https://docs.4seletpay.com.br/pages/v2/faturas/confirm\",\"mainEntityOfPage\":{\"@id\":\"https://docs.4seletpay.com.br/pages/v2/faturas/confirm#webpage\"},\"dateModified\":\"2026-09-14T14:02:53.728Z\",\"publisher\":{\"@id\":\"https://docs.4seletpay.com.br/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.4seletpay.com.br#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"4SeletPay\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"4SeletPay\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/pages/v2/faturas/confirm.md","siteName":"4SeletPay","nav":{"global":null,"versions":[{"version":"v2","tag":"Atual","tabs":[{"tab":"Comece aqui","pages":[{"title":"Comece aqui","href":"/pages/v2/start/home"}]},{"tab":"Referência","groups":[{"group":"Pedidos","pages":[{"title":"Pedidos","icon":"receipt","href":"/pages/v2/pedidos/reference"},{"title":"Criar pedido","openapi":"POST /v2/orders","href":"/pages/v2/pedidos/create"},{"title":"Consultar pedido","openapi":"GET /v2/orders/{id}","href":"/pages/v2/pedidos/get"},{"title":"Capturar pedido","openapi":"POST /v2/orders/{id}/capture","href":"/pages/v2/pedidos/capture"},{"title":"Cancelar pedido","openapi":"POST /v2/orders/{id}/cancel","href":"/pages/v2/pedidos/cancel"},{"title":"Confirmar pedido","openapi":"POST /v2/orders/{id}/confirm","href":"/pages/v2/pedidos/confirm"},{"title":"Reenviar código de verificação","openapi":"POST /v2/orders/{id}/confirm/resend","href":"/pages/v2/pedidos/resend-confirmation"}]},{"group":"Cobranças","pages":[{"title":"Cobranças","icon":"money-bill","href":"/pages/v2/cobrancas/reference"},{"title":"Consultar cobrança","openapi":"GET /v2/charges/{id}","href":"/pages/v2/cobrancas/get"},{"title":"Estornar cobrança","openapi":"POST /v2/charges/{id}/refund","href":"/pages/v2/cobrancas/refund"}]},{"group":"Cartões","pages":[{"title":"Cartões","icon":"wallet","href":"/pages/v2/cartoes/reference"},{"title":"Salvar cartão","openapi":"POST /v2/cards","href":"/pages/v2/cartoes/create"},{"title":"Consultar cartão","openapi":"GET /v2/cards/{id}","href":"/pages/v2/cartoes/get"}]},{"group":"Assinaturas","pages":[{"title":"Assinaturas","icon":"arrows-rotate","href":"/pages/v2/assinaturas/reference"},{"title":"Criar assinatura","openapi":"POST /v2/subscriptions","href":"/pages/v2/assinaturas/create"},{"title":"Consultar assinatura","openapi":"GET /v2/subscriptions/{id}","href":"/pages/v2/assinaturas/get"},{"title":"Cancelar assinatura","openapi":"POST /v2/subscriptions/{id}/cancel","href":"/pages/v2/assinaturas/cancel"},{"title":"Alterar meio de pagamento","openapi":"PUT /v2/subscriptions/{id}/payment-method","href":"/pages/v2/assinaturas/payment-method"},{"title":"Atualizar item da assinatura","openapi":"PATCH /v2/subscriptions/{id}/items/{code}","href":"/pages/v2/assinaturas/update-item"},{"title":"Alterar data da próxima cobrança","openapi":"PUT /v2/subscriptions/{id}/next-billing-date","href":"/pages/v2/assinaturas/next-billing-date"},{"title":"Listar faturas da assinatura","openapi":"GET /v2/subscriptions/{id}/invoices","href":"/pages/v2/assinaturas/invoices"}]},{"group":"Faturas","pages":[{"title":"Faturas","icon":"file-invoice","href":"/pages/v2/faturas/reference"},{"title":"Consultar fatura","openapi":"GET /v2/invoices/{id}","href":"/pages/v2/faturas/get"},{"title":"Pagar fatura","openapi":"POST /v2/invoices/{id}/pay","description":"Cobra uma fatura que ainda não foi paga, por exemplo uma fatura recusada ou em atraso, com um cartão novo, um cartão salvo ou PIX. Se o pagamento for recusado, a resposta é 402 com `failure_reason`.\n\n**PayPal.** O PayPal processa apenas cobranças em `BRL`: uma fatura com `currency` diferente de `BRL` cobrada por ele é recusada, mesmo com a conversão para real, com 402 e `failure_reason`, não com erro de requisição.\n","href":"/pages/v2/faturas/pay"},{"title":"Confirmar código de verificação da fatura","openapi":"POST /v2/invoices/{id}/confirm","href":"/pages/v2/faturas/confirm"},{"title":"Reenviar código de verificação da fatura","openapi":"POST /v2/invoices/{id}/confirm/resend","description":"Reenvia o código de verificação ao pagador de uma fatura aguardando verificação. Limite de 5 requisições por minuto, contadas por IP de origem: uma plataforma que atende várias contas a partir do mesmo servidor divide esse limite entre todas elas.\n","href":"/pages/v2/faturas/resend-confirmation"}]},{"group":"Contestações","pages":[{"title":"Contestações","icon":"shield-halved","tag":"Em breve","href":"/pages/v2/contestacoes/reference"}]},{"group":"Links de pagamento","pages":[{"title":"Links de Pagamento","icon":"link","tag":"Em breve","href":"/pages/links-de-pagamento/reference"},{"title":"Criar Link de Pagamento","openapi":"POST /v1/payment-links","tag":"Em breve","href":"/pages/links-de-pagamento/create"},{"title":"Listar Links de Pagamento","openapi":"GET /v1/payment-links","tag":"Em breve","href":"/pages/links-de-pagamento/list"},{"title":"Consultar Link de Pagamento","openapi":"GET /v1/payment-links/{code}","tag":"Em breve","href":"/pages/links-de-pagamento/get"},{"title":"Cancelar Link de Pagamento","openapi":"POST /v1/payment-links/{code}/cancel","tag":"Em breve","href":"/pages/links-de-pagamento/cancel"},{"title":"Excluir Link de Pagamento","openapi":"DELETE /v1/payment-links/{code}","tag":"Em breve","href":"/pages/links-de-pagamento/delete"}]},{"group":"Análise de fraude","pages":[{"title":"Análise de Fraude","icon":"shield-check","href":"/pages/analise-de-fraude/reference"},{"title":"Analisar risco","openapi":"POST /v1/fraud/risk-analyses","href":"/pages/analise-de-fraude/create"},{"title":"Dados de teste","icon":"flask","tag":"Em breve","href":"/pages/analise-de-fraude/dados-de-teste"}]}]},{"tab":"Webhooks","pages":[{"title":"Webhooks","href":"/pages/v2/webhooks/reference"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/pages/changelog"}]}]},{"version":"v1","tag":"Legado","pages":[{"title":"v1","href":"/pages/faturas/reference"}]}]},"basePath":"","title":"Confirmar código de verificação da fatura - 4SeletPay","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CybtLBIt.js","utils-BMLj2fvV.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B6In562Y.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dr8Mfhp9.js","snippetPresets-2rmQvMVl.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-WMqJYdZj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CJ-MlPHu.js","shallow-dY3TMRCk.js","getApiPlaygroundDisplay-v-1B2bKm.js","CodeSnippet-BDhiTB7U.js","CodeSnippets-D9hnzQcS.js","Page-C4GwDT3_.js","getPastedJson-Th2V45jI.js","icon-BQXch1W9.js","MethodPill-BCqUneP3.js","DuplicateIcon-Q_-bhurZ.js","createIcon-DUjLHRqp.js","DynamicMarkdown-B-f2cqXQ.js","SectionHeading-Da5NsV4v.js","axios-vUo_bRtp.js","Markdown-D13FWkIM.js","clsx-D3Isdib3.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-C-XZBk9h.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink--qIqmmVG.js"]}