{
"error": {
"type": "authentication_error",
"code": "invalid_api_secret",
"message": "A chave de API informada é inválida."
}
}
{
"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."
}
}
{
"error": {
"type": "invalid_request_error",
"code": "api_rate_limited",
"message": "Muitas requisições em pouco tempo. Tente novamente em alguns instantes."
}
}
Cartões
Consultar cartão
Consulta um cartão salvo pelo id. Use para acompanhar o tokenization_status.
{
"error": {
"type": "authentication_error",
"code": "invalid_api_secret",
"message": "A chave de API informada é inválida."
}
}
{
"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."
}
}
{
"error": {
"type": "invalid_request_error",
"code": "api_rate_limited",
"message": "Muitas requisições em pouco tempo. Tente novamente em alguns instantes."
}
}
Use esta rota para acompanhar o tokenization_status depois de salvar o cartão.
O id precisa ser o UUID do cartão. Um cartão de outra conta, ou inexistente, retorna 404 (resource_missing).
A resposta nunca traz o número completo do cartão nem o código de segurança.
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.
pending: tokenização em andamento. tokenized: concluída. failed: nenhuma adquirente conseguiu tokenizar. Um cartão com failed ainda pode ser usado em compras.
{"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/cartoes/get","slug":"/pages/v2/cartoes/get","pageMetadata":{"title":"Consultar cartão","openapi":"GET /v2/cards/{id}","description":"Consulta um cartão salvo pelo `id`. Use para acompanhar o `tokenization_status`.\n","href":"/pages/v2/cartoes/get"},"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: [\"Consulta um cartão salvo pelo \", _jsx(_components.code, {\n children: \"id\"\n }), \". Use para acompanhar o \", _jsx(_components.code, {\n children: \"tokenization_status\"\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`,..._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:[`Use esta rota para acompanhar o `,_jsx(_components.code,{children:`tokenization_status`}),` depois de salvar o cartão.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`O `,_jsx(_components.code,{children:`id`}),` precisa ser o UUID do cartão. Um cartão de outra conta, ou inexistente, retorna `,_jsx(_components.code,{children:`404`}),` (`,_jsx(_components.code,{children:`resource_missing`}),`).`]})}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`A resposta nunca traz o número completo do cartão nem o código de segurança.`})})]})}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":"Consultar cartão","openapi":"GET /v2/cards/{id}","description":"Consulta um cartão salvo pelo `id`. Use para acompanhar o `tokenization_status`.\n","href":"/pages/v2/cartoes/get"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Cartões (v2)"],"summary":"Consultar cartão","description":"Consulta um cartão salvo pelo `id`. Use para acompanhar o `tokenization_status`.\n","operationId":"v2RetrieveCard","security":["508cf00c-81d4-40a0-8a08-457c6925dcbd"],"parameters":["a6a5c79a-c4ad-4869-8780-c9fa8f1014ad"],"responses":{"200":"034164d3-38dc-4ccb-a4b0-70f8125fc054","401":"f41c58f2-fa3d-445f-ad83-f0a4e0de3905","403":"24acfcb3-d0c9-41a7-abe5-2c30a928dea2","404":"5e74a6bb-21ee-4bdd-949a-9c7d9dea9c45","429":"c0b5dc1e-cfda-43bd-a341-ba83b2f85310"},"method":"get","type":"path","servers":["4c3dfa86-2ed5-4f58-9a07-b7d334d46949"],"path":"/v2/cards/{id}","baseUrlOptions":["https://sandbox.4seletpay.com.br/api"],"title":"Consultar cartão","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"a6a5c79a-c4ad-4869-8780-c9fa8f1014ad":{"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"}}},"responses":{"034164d3-38dc-4ccb-a4b0-70f8125fc054":{"description":"Cartão encontrado","content":{"application/json":{"schema":{"type":"object","description":"Cartão salvo. O número completo e o código de segurança nunca são devolvidos","properties":{"id":{"type":"string","format":"uuid","description":"Use este valor como `card.token` em pedidos, assinaturas e faturas","example":"9b2f5c8e-3a1d-4f7b-8c6e-2d9a1b4c5e6f","uniqueKey":"id","typeLabel":"string\u003cuuid>"},"object":{"type":"string","enum":["card"],"uniqueKey":"object","typeLabel":"enum\u003cstring>"},"brand":{"type":"string","example":"visa","uniqueKey":"brand","typeLabel":"string"},"first_six":{"type":"string","example":"411111","uniqueKey":"first_six","typeLabel":"string"},"last_four":{"type":"string","example":"1111","uniqueKey":"last_four","typeLabel":"string"},"holder_name":{"type":"string","example":"João Silva","uniqueKey":"holder_name","typeLabel":"string"},"exp_month":{"type":"integer","example":12,"uniqueKey":"exp_month","typeLabel":"integer"},"exp_year":{"type":"integer","example":2030,"uniqueKey":"exp_year","typeLabel":"integer"},"type":{"oneOf":[{"type":"string","enum":["credit","debit"],"uniqueKey":"type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["credit","debit"],"uniqueKey":"type.oneOf.1","typeLabel":"null"}],"uniqueKey":"type","typeLabel":"enum\u003cstring> | null"},"tokenization_status":{"type":"string","enum":["pending","tokenized","failed"],"description":"`pending`: tokenização em andamento. `tokenized`: concluída. `failed`: nenhuma adquirente conseguiu tokenizar. Um cartão com `failed` ainda pode ser usado em compras.\n","uniqueKey":"tokenization_status","typeLabel":"enum\u003cstring>"},"customer":{"type":"object","properties":{"name":{"type":"string","example":"João Silva","uniqueKey":"customer.name","typeLabel":"string"},"email":{"type":"string","example":"joao@exemplo.com.br","uniqueKey":"customer.email","typeLabel":"string"}},"uniqueKey":"customer","typeLabel":"object"},"created_at":{"type":"string","example":"2026-09-14T12:00:00-03:00","uniqueKey":"created_at","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"id":"9b2f5c8e-3a1d-4f7b-8c6e-2d9a1b4c5e6f","object":"card","brand":"visa","first_six":"411111","last_four":"1111","holder_name":"João Silva","exp_month":12,"exp_year":2030,"type":"credit","tokenization_status":"tokenized","customer":{"name":"João Silva","email":"joao@exemplo.com.br"},"created_at":"2026-09-14T12:00:00-03:00"},"examples":{"Example":{"title":"Example","value":{"id":"9b2f5c8e-3a1d-4f7b-8c6e-2d9a1b4c5e6f","object":"card","brand":"visa","first_six":"411111","last_four":"1111","holder_name":"João Silva","exp_month":12,"exp_year":2030,"type":"credit","tokenization_status":"tokenized","customer":{"name":"João Silva","email":"joao@exemplo.com.br"},"created_at":"2026-09-14T12:00:00-03:00"}}},"exampleType":"examples"}},"exampleType":"examples"},"f41c58f2-fa3d-445f-ad83-f0a4e0de3905":{"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"},"24acfcb3-d0c9-41a7-abe5-2c30a928dea2":{"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"},"5e74a6bb-21ee-4bdd-949a-9c7d9dea9c45":{"description":"Cartão não encontrado 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 \"card\" não encontrado."}},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_request_error","code":"resource_missing","message":"Recurso \"card\" não encontrado."}}}},"exampleType":"examples"}},"exampleType":"examples"},"c0b5dc1e-cfda-43bd-a341-ba83b2f85310":{"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"}},"security":{"508cf00c-81d4-40a0-8a08-457c6925dcbd":{"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":"Consultar cartão - 4SeletPay","navMaps":{"firstHrefInVersion":{"v2":{"href":"/pages/v2/cartoes/get","matchLevel":0},"v1":{"href":"/pages/cartoes/reference","matchLevel":2}},"firstHrefInLanguage":{}},"lastModified":"2026-09-14T14:02:53.732Z","originalFileLocation":"pages/v2/cartoes/get.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=\"Consulta um cartão salvo pelo id. Use para acompanhar o tokenization_status.\">\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=\"Consultar cartão - 4SeletPay\">\u003cmeta data-mint-head property=\"og:description\" content=\"Consulta um cartão salvo pelo id. Use para acompanhar o tokenization_status.\">\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/cartoes/get\">\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=Cart%C3%B5es\u0026amp;title=Consultar+cart%C3%A3o\u0026amp;description=Consulta+um+cart%C3%A3o+salvo+pelo+%60id%60.+Use+para+acompanhar+o+%60tokenization_status%60.%0A\u0026amp;theme=e946cf76f4ab5d90a4344f4d\u0026amp;signature=304ffbd35a983cfebb6944a8dcd9a7e7bd1bcdb6caa83fbb8640684f25d46ec3\">\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=\"Consultar cartão - 4SeletPay\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Consulta um cartão salvo pelo id. Use para acompanhar o tokenization_status.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://4selet-1a9bfa9b.mintlify.site/_mintlify/api/og/v2?division=Cart%C3%B5es\u0026amp;title=Consultar+cart%C3%A3o\u0026amp;description=Consulta+um+cart%C3%A3o+salvo+pelo+%60id%60.+Use+para+acompanhar+o+%60tokenization_status%60.%0A\u0026amp;theme=e946cf76f4ab5d90a4344f4d\u0026amp;signature=304ffbd35a983cfebb6944a8dcd9a7e7bd1bcdb6caa83fbb8640684f25d46ec3\">\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/cartoes/get\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/pages/v2/cartoes/get.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/cartoes/get#webpage\",\"url\":\"https://docs.4seletpay.com.br/pages/v2/cartoes/get\",\"name\":\"Consultar cartão\",\"description\":\"Consulta um cartão salvo pelo id. Use para acompanhar o tokenization_status.\",\"dateModified\":\"2026-09-14T14:02:53.732Z\",\"isPartOf\":{\"@id\":\"https://docs.4seletpay.com.br#website\"},\"breadcrumb\":{\"@id\":\"https://docs.4seletpay.com.br/pages/v2/cartoes/get#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.4seletpay.com.br/pages/v2/cartoes/get#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Cartões\",\"item\":\"https://docs.4seletpay.com.br/pages/v2/cartoes/reference\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Consultar cartão\",\"item\":\"https://docs.4seletpay.com.br/pages/v2/cartoes/get\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.4seletpay.com.br/pages/v2/cartoes/get#apireference\",\"headline\":\"Consultar cartão\",\"name\":\"Consultar cartão\",\"description\":\"Consulta um cartão salvo pelo id. Use para acompanhar o tokenization_status.\",\"url\":\"https://docs.4seletpay.com.br/pages/v2/cartoes/get\",\"mainEntityOfPage\":{\"@id\":\"https://docs.4seletpay.com.br/pages/v2/cartoes/get#webpage\"},\"dateModified\":\"2026-09-14T14:02:53.732Z\",\"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/cartoes/get.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","description":"Salva um cartão do comprador e inicia a tokenização nas adquirentes da conta. A resposta é sempre 202: use o `id` devolvido como `card.token` em pedidos, assinaturas e faturas. O número completo e o código de segurança nunca são devolvidos.\n\n**A tokenização é assíncrona.** `tokenization_status` vem `pending` quando a tokenização foi iniciada, ou `failed` na hora quando nenhuma adquirente da conta consegue tokenizar. Um cartão com `failed` ainda pode ser usado em compras. O resultado final chega pelos webhooks `card.token_created` e `card.token_failed`, que existem só no formato v1. Limite de 10 cartões por minuto por conta.\n","href":"/pages/v2/cartoes/create"},{"title":"Consultar cartão","openapi":"GET /v2/cards/{id}","href":"/pages/v2/cartoes/get"}]},{"group":"Assinaturas","pages":[{"title":"Assinaturas","description":"Cobranças recorrentes com cartão ou PIX na API v2.","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","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","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/cartoes/reference"}]}]},"basePath":"","title":"Consultar cartão - 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"]}