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.
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.
A resposta é sempre 202 Accepted: a tokenização roda em segundo plano. Acompanhe o campo tokenization_status (pending, tokenized ou failed) com GET /v2/cards/{id}.
Guarde o id retornado e use-o como card.token em pedidos, assinaturas e faturas. Um cartão com tokenização pending ou failed continua podendo ser usado em compras.
customer.document é obrigatório (cpf, cnpj ou passport), e customer.phone.ddi e customer.phone.ddd são números inteiros. Um cartão vencido retorna 422 com paramcard.exp_year.
Limite de 10 cartões por minuto por conta (429card_tokenization_rate_limited). Cartão, e-mail ou documento bloqueado retorna 403 (customer_blocked).
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).
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/create","slug":"/pages/v2/cartoes/create","pageMetadata":{"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"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Salva um cartão do comprador e inicia a tokenização nas adquirentes da conta. A resposta é sempre 202: use o \", _jsx(_components.code, {\n children: \"id\"\n }), \" devolvido como \", _jsx(_components.code, {\n children: \"card.token\"\n }), \" em pedidos, assinaturas e faturas. O número completo e o código de segurança nunca são devolvidos.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"A tokenização é assíncrona.\"\n }), \" \", _jsx(_components.code, {\n children: \"tokenization_status\"\n }), \" vem \", _jsx(_components.code, {\n children: \"pending\"\n }), \" quando a tokenização foi iniciada, ou \", _jsx(_components.code, {\n children: \"failed\"\n }), \" na hora quando nenhuma adquirente da conta consegue tokenizar. Um cartão com \", _jsx(_components.code, {\n children: \"failed\"\n }), \" ainda pode ser usado em compras. O resultado final chega pelos webhooks \", _jsx(_components.code, {\n children: \"card.token_created\"\n }), \" e \", _jsx(_components.code, {\n children: \"card.token_failed\"\n }), \", que existem só no formato v1. Limite de 10 cartões por minuto por conta.\"]\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={a:`a`,code:`code`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Info,Note,Tip,Warning}=_components;if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Info,{children:_jsxs(_components.p,{children:[`A resposta é sempre `,_jsx(_components.code,{children:`202 Accepted`}),`: a tokenização roda em segundo plano. Acompanhe o campo `,_jsx(_components.code,{children:`tokenization_status`}),` (`,_jsx(_components.code,{children:`pending`}),`, `,_jsx(_components.code,{children:`tokenized`}),` ou `,_jsx(_components.code,{children:`failed`}),`) com `,_jsx(_components.a,{href:`/pages/v2/cartoes/get`,children:_jsx(_components.code,{children:`GET /v2/cards/{id}`})}),`.`]})}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Guarde o `,_jsx(_components.code,{children:`id`}),` retornado e use-o como `,_jsx(_components.code,{children:`card.token`}),` em pedidos, assinaturas e faturas. Um cartão com tokenização `,_jsx(_components.code,{children:`pending`}),` ou `,_jsx(_components.code,{children:`failed`}),` continua podendo ser usado em compras.`]})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`customer.document`}),` é obrigatório (`,_jsx(_components.code,{children:`cpf`}),`, `,_jsx(_components.code,{children:`cnpj`}),` ou `,_jsx(_components.code,{children:`passport`}),`), e `,_jsx(_components.code,{children:`customer.phone.ddi`}),` e `,_jsx(_components.code,{children:`customer.phone.ddd`}),` são números inteiros. Um cartão vencido retorna `,_jsx(_components.code,{children:`422`}),` com `,_jsx(_components.code,{children:`param`}),` `,_jsx(_components.code,{children:`card.exp_year`}),`.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Limite de `,_jsx(_components.strong,{children:`10 cartões por minuto por conta`}),` (`,_jsx(_components.code,{children:`429`}),` `,_jsx(_components.code,{children:`card_tokenization_rate_limited`}),`). Cartão, e-mail ou documento bloqueado retorna `,_jsx(_components.code,{children:`403`}),` (`,_jsx(_components.code,{children:`customer_blocked`}),`).`]})})]})}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":"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"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Cartões (v2)"],"summary":"Salvar cartão","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","operationId":"v2CreateCard","security":["298b9d90-5e48-4fa7-9b7d-255140f19bf8"],"parameters":["f2ea7ff4-9251-4191-8792-0e487f30aba6"],"requestBody":"f992a7cd-35a8-4b43-80ff-5a8dde72cf19","responses":{"202":"128df9a5-bf68-4042-aed0-cca71eb94172","400":"7654e7ca-94c9-4d1f-8659-04001ecfdc3d","401":"9816f1cf-ccf0-4ad6-9828-a2cea58a1281","403":"1e01decd-4f5f-48fd-95bc-3915d01baedf","409":"264f7377-e0ef-43ee-a2b8-29ad869e7223","422":"48d402da-502b-4c0e-98f9-a1e27fb0e777","429":"c7c7a790-0205-4c1a-a199-ddbe627e4732","500":"a764ab97-04a5-4f4c-af34-470545481765"},"method":"post","type":"path","servers":["4c3dfa86-2ed5-4f58-9a07-b7d334d46949"],"path":"/v2/cards","baseUrlOptions":["https://sandbox.4seletpay.com.br/api"],"title":"Salvar cartão","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"f2ea7ff4-9251-4191-8792-0e487f30aba6":{"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":["customer","card"],"properties":{"customer":{"type":"object","description":"Dados do comprador, com documento obrigatório. A API v2 não tem recurso de cliente: envie o comprador em cada requisição.\n","required":["name","email","phone","document"],"properties":{"name":{"type":"string","maxLength":255,"example":"João Silva","isRequired":true,"uniqueKey":"customer.name","typeLabel":"string"},"email":{"type":"string","format":"email","example":"joao@exemplo.com.br","isRequired":true,"uniqueKey":"customer.email","typeLabel":"string\u003cemail>"},"phone":{"type":"object","required":["ddi","ddd","number"],"properties":{"ddi":{"type":"integer","description":"Código do país","example":55,"isRequired":true,"uniqueKey":"customer.phone.ddi","typeLabel":"integer"},"ddd":{"type":"integer","description":"Código de área","example":11,"isRequired":true,"uniqueKey":"customer.phone.ddd","typeLabel":"integer"},"number":{"type":"string","maxLength":20,"example":"999999999","isRequired":true,"uniqueKey":"customer.phone.number","typeLabel":"string"}},"isRequired":true,"uniqueKey":"customer.phone","typeLabel":"object"},"document":{"type":"object","required":["type","number"],"properties":{"type":{"type":"string","enum":["cpf","cnpj","passport"],"example":"cpf","isRequired":true,"uniqueKey":"customer.document.type","typeLabel":"enum\u003cstring>"},"number":{"type":"string","maxLength":50,"example":"12345678909","isRequired":true,"uniqueKey":"customer.document.number","typeLabel":"string"}},"isRequired":true,"uniqueKey":"customer.document","typeLabel":"object"}},"isRequired":true,"uniqueKey":"customer","typeLabel":"object"},"card":{"type":"object","required":["number","holder_name","exp_month","exp_year","cvc"],"properties":{"number":{"type":"string","description":"Número do cartão (validado pelo dígito verificador)","example":"4111111111111111","isRequired":true,"uniqueKey":"card.number","typeLabel":"string"},"holder_name":{"type":"string","maxLength":255,"example":"João Silva","isRequired":true,"uniqueKey":"card.holder_name","typeLabel":"string"},"exp_month":{"type":"integer","minimum":1,"maximum":12,"example":12,"isRequired":true,"uniqueKey":"card.exp_month","typeLabel":"integer"},"exp_year":{"type":"integer","description":"Ano de validade, com 2 ou 4 dígitos. Um cartão vencido retorna 422 com `param` `card.exp_year`","example":2030,"isRequired":true,"uniqueKey":"card.exp_year","typeLabel":"integer"},"cvc":{"type":"string","pattern":"^\\d{3,4}$","example":"123","isRequired":true,"uniqueKey":"card.cvc","typeLabel":"string"},"type":{"type":"string","enum":["credit","debit"],"uniqueKey":"card.type","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"card","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"customer":{"name":"João Silva","email":"joao@exemplo.com.br","phone":{"ddi":55,"ddd":11,"number":"999999999"},"document":{"type":"cpf","number":"12345678909"}},"card":{"number":"4111111111111111","holder_name":"João Silva","exp_month":12,"exp_year":2030,"cvc":"123"}},"examples":{"Example":{"title":"Example","value":{"customer":{"name":"João Silva","email":"joao@exemplo.com.br","phone":{"ddi":55,"ddd":11,"number":"999999999"},"document":{"type":"cpf","number":"12345678909"}},"card":{"number":"4111111111111111","holder_name":"João Silva","exp_month":12,"exp_year":2030,"cvc":"123"}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"128df9a5-bf68-4042-aed0-cca71eb94172":{"description":"Cartão salvo, tokenização iniciada","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":"pending","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":"pending","customer":{"name":"João Silva","email":"joao@exemplo.com.br"},"created_at":"2026-09-14T12:00:00-03:00"}}},"exampleType":"examples"}},"exampleType":"examples"},"7654e7ca-94c9-4d1f-8659-04001ecfdc3d":{"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"},"9816f1cf-ccf0-4ad6-9828-a2cea58a1281":{"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"},"1e01decd-4f5f-48fd-95bc-3915d01baedf":{"description":"Conta ou comprador bloqueado (e-mail, documento ou BIN do cartão). 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"},"examples":{"customer_blocked":{"title":"customer_blocked","value":{"error":{"type":"invalid_request_error","code":"customer_blocked","message":"Este comprador está bloqueado para novos pedidos.","customer_message":"Não foi possível concluir sua transação. Tente novamente mais tarde."}}},"account_requests_blocked":{"title":"account_requests_blocked","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"},"264f7377-e0ef-43ee-a2b8-29ad869e7223":{"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"},"48d402da-502b-4c0e-98f9-a1e27fb0e777":{"description":"Dados inválidos ou cartão vencido","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":{"validation_error":{"title":"validation_error","value":{"error":{"type":"invalid_request_error","code":"validation_error","message":"The card has expired.","param":"card.exp_year"}}},"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"},"c7c7a790-0205-4c1a-a199-ddbe627e4732":{"description":"Muitos cartões salvos pela conta em pouco tempo (10 por minuto por conta), ou limite geral de requisições excedido. As duas respostas usam o envelope `error` e trazem o header `Retry-After`; o `code` distingue os dois casos (`card_tokenization_rate_limited` ou `api_rate_limited`).\n","headers":{"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"},"examples":{"card_tokenization_rate_limited":{"title":"card_tokenization_rate_limited","value":{"error":{"type":"invalid_request_error","code":"card_tokenization_rate_limited","message":"Muitos cartões foram salvos para esta conta em pouco tempo. Tente novamente mais tarde."}}},"api_rate_limited":{"title":"api_rate_limited","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"},"a764ab97-04a5-4f4c-af34-470545481765":{"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":{"298b9d90-5e48-4fa7-9b7d-255140f19bf8":{"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":"Salvar cartão - 4SeletPay","navMaps":{"firstHrefInVersion":{"v2":{"href":"/pages/v2/cartoes/create","matchLevel":0},"v1":{"href":"/pages/cartoes/reference","matchLevel":2}},"firstHrefInLanguage":{}},"lastModified":"2026-09-14T14:02:53.749Z","originalFileLocation":"pages/v2/cartoes/create.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=\"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. 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.\">\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=\"Salvar cartão - 4SeletPay\">\u003cmeta data-mint-head property=\"og:description\" content=\"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. 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.\">\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/create\">\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=Salvar+cart%C3%A3o\u0026amp;description=Salva+um+cart%C3%A3o+do+comprador+e+inicia+a+tokeniza%C3%A7%C3%A3o+nas+adquirentes+da+conta.+A+resposta+%C3%A9+sempre+202%3A+use+o+%60id%60+devolvido+como+%60card.token%60+em+pedidos%2C+assina\u0026amp;theme=e946cf76f4ab5d90a4344f4d\u0026amp;signature=1292f75936f26bd0c8972edbb18e69239ead144e15992b0818c74073acfb16fd\">\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=\"Salvar cartão - 4SeletPay\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"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. 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.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://4selet-1a9bfa9b.mintlify.site/_mintlify/api/og/v2?division=Cart%C3%B5es\u0026amp;title=Salvar+cart%C3%A3o\u0026amp;description=Salva+um+cart%C3%A3o+do+comprador+e+inicia+a+tokeniza%C3%A7%C3%A3o+nas+adquirentes+da+conta.+A+resposta+%C3%A9+sempre+202%3A+use+o+%60id%60+devolvido+como+%60card.token%60+em+pedidos%2C+assina\u0026amp;theme=e946cf76f4ab5d90a4344f4d\u0026amp;signature=1292f75936f26bd0c8972edbb18e69239ead144e15992b0818c74073acfb16fd\">\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/create\">\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/create.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/create#webpage\",\"url\":\"https://docs.4seletpay.com.br/pages/v2/cartoes/create\",\"name\":\"Salvar cartão\",\"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. 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.\",\"dateModified\":\"2026-09-14T14:02:53.749Z\",\"isPartOf\":{\"@id\":\"https://docs.4seletpay.com.br#website\"},\"breadcrumb\":{\"@id\":\"https://docs.4seletpay.com.br/pages/v2/cartoes/create#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.4seletpay.com.br/pages/v2/cartoes/create#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Cartões\",\"item\":\"https://docs.4seletpay.com.br/pages/v2/cartoes/reference\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Salvar cartão\",\"item\":\"https://docs.4seletpay.com.br/pages/v2/cartoes/create\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.4seletpay.com.br/pages/v2/cartoes/create#apireference\",\"headline\":\"Salvar cartão\",\"name\":\"Salvar cartão\",\"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. 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.\",\"url\":\"https://docs.4seletpay.com.br/pages/v2/cartoes/create\",\"mainEntityOfPage\":{\"@id\":\"https://docs.4seletpay.com.br/pages/v2/cartoes/create#webpage\"},\"dateModified\":\"2026-09-14T14:02:53.749Z\",\"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/create.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","description":"Salve cartões de clientes e use o id nas compras da API v2.","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}","description":"Consulta um cartão salvo pelo `id`. Use para acompanhar o `tokenization_status`.\n","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","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":"Salvar 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"]}