Cria uma cobrança Pix (type: "pix") ou de cartão (type: "card"). Pix dinâmico exige customer; cartão exige card (UUID de um cartão tokenizado) e customer.Permissão: charge.write. Apenas chave secreta (sk_…).
Os exemplos usam o sandbox (https://api.upag.dev/v1). Em produção use https://api.upag.io/v1 com sk_live_….
A cobrança de cartão é processada na hora: a resposta já traz o resultado (paid, in_review ou failed). O card precisa pertencer à conta; veja o fluxo completo em Cartão com 3DS.
Parâmetros
Comuns
string
required
pix ou card.
integer
required
Valor em centavos, maior que zero. Em cartão parcelado, é o preço cheio: os juros de parcelamento não entram aqui.
string
1 a 140 caracteres. Uso interno (conciliação); não vai no QR code nem o pagador vê.
object
Até 50 chaves (1 a 40 caracteres), valores string de até 500 caracteres. Devolvido como enviado em respostas e webhooks. Em cartão, session_id é lido pela plataforma como a sessão de dispositivo do pagador (antifraude), veja Antifraude.
array
Até 100 itens informativos (não alteram valor nem taxas):
name (obrigatório, 1 a 255 caracteres)
quantity (obrigatório, inteiro de 1 a 9999)
unitAmount (obrigatório, inteiro ≥ 0, em centavos)
kind: physical, digital, shipping ou other (padrão)
sku (até 64), externalId (até 255), url (HTTP/HTTPS, até 255)
quantity × unitAmount deve caber em inteiro de 32 bits (2.147.483.647). Em cartão, os itens também seguem junto com o pagamento.
array
Repasses para outras contas: { "account": "uuid", "amount": centavos } (amount inteiro maior que zero). A soma dos splits precisa ser menor que o valor líquido da cobrança (amount menos a taxa da plataforma). A conta recebedora precisa estar ativa e não pode ser a sua.
Pix (type: "pix")
object
Configuração do QR code. Padrão: dinâmico, vencendo em 10 minutos.
method: dynamic (padrão) ou static.
dueDate (só dynamic): vencimento, data ISO 8601. Padrão: 10 minutos a partir de agora.
string | object
Obrigatório no Pix dinâmico; opcional no estático. UUID de um cliente existente ou um objeto cliente inline (mesmos campos de Criar cliente). No objeto inline, o document.number identifica o cliente: se já existir na conta, é reutilizado e os demais valores enviados o atualizam; campos omitidos ou null não apagam nada.
UUID do cliente ou objeto cliente inline (aceita também ipAddress, com o mesmo sentido do campo da cobrança; se ambos forem enviados, vale o do cliente, e ele nunca é gravado no cadastro). O cliente precisa ter email e phone.
integer
1 a 12. Padrão 1. Acima de 1 exige parcelamento habilitado na conta, respeitando o máximo configurado. Com sessão 3DS, deve ser igual ao da sessão.
string
UUID de uma sessão 3D Secure concluída para este cartão, valor e parcelas. A sessão é consumida pela cobrança, qualquer que seja o resultado, e o cartão é cobrado no finalAmount da sessão. Sem ela, o cartão é cobrado sem 3DS.
string
IPv4 ou IPv6 público do pagador. Não é aceito em Pix.
object
Localização do pagador resolvida a partir do IP: city (até 50), state (2 letras), country (2 letras), zip (até 9). Usada só para completar o endereço de cobrança exigido pela adquirente; nunca é gravada no cliente.
string
Texto na fatura do pagador, 1 a 13 caracteres. Padrão: o descritivo da conta.
Antifraude
Em cobranças de cartão, envie meta.session_id com o identificador da sessão de dispositivo do pagador e ipAddress com o IP dele. No browser, o upag-js gera o identificador e carrega o coletor de dispositivo:
upag-js
import { UpagJs } from 'upag-js';const upag = new UpagJs('pk_test_your_public_key');// envie ao seu servidor junto com o card e o clientSecret/sessão 3DSconst sessionId = upag.antifraud.sessionId();// antes de uma nova tentativa de pagamentoupag.antifraud.rotate();
Gere um session_id novo a cada tentativa de pagamento: reutilizar reduz a aprovação. Mais detalhes em SDK frontend.
Se a adquirente recusar, a resposta continua 201, com status: "failed" e failureCode preenchido (ver códigos de falha). Campos completos em Referência de cobranças.
Erros
Status
Mensagem / código
Causa
400
Account is not active
Conta ainda não pode receber
400
Splits exceed the charge amount
Splits (mais taxa) não cabem no valor
400
Split recipient cannot be the charged account
Split para a própria conta
400
Split recipient account not found or inactive
Recebedor do split inexistente ou inativo
400
Installments are not enabled for this account
Parcelamento desabilitado
400
Installments exceed the maximum of N for this account
Parcelas acima do máximo da conta
400
Card is not active / Card is expired
Cartão inutilizável
400
Customer is missing fields required for card payments: …
Cliente sem email e/ou phone
404
Customer not found
UUID de cliente inexistente na conta
404
Card not found
Cartão inexistente, removido ou de outra conta
404
Pix key not found
A conta não tem chave Pix para receber
404
session_not_found
Sessão 3DS inexistente na conta
409
invalid_session_state
Sessão 3DS não concluída ou já usada
409
threeds_session_mismatch
Sessão autenticada para outro cartão, valor ou parcelas
410
session_expired
Sessão 3DS expirada
422
VALIDATION_FAILED
Corpo inválido, inclusive Pix dinâmico sem customer
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Upag Documentation","colors":{"primary":"#06AEDD","light":"#13C6F9","dark":"#0583A6"},"logo":{"light":"https://mintcdn.com/upag/J0FSTIds_wQSyfe4/logo/light.svg?fit=max\u0026auto=format\u0026n=J0FSTIds_wQSyfe4\u0026q=85\u0026s=69934217fd5359442c60393a5611af74","dark":"https://mintcdn.com/upag/J0FSTIds_wQSyfe4/logo/dark.svg?fit=max\u0026auto=format\u0026n=J0FSTIds_wQSyfe4\u0026q=85\u0026s=17e82005fbb54288e4d8a5d7918e98ee"},"favicon":"https://mintcdn.com/upag/J0FSTIds_wQSyfe4/favicon.svg?fit=max\u0026auto=format\u0026n=J0FSTIds_wQSyfe4\u0026q=85\u0026s=f25e12f43de622c85348e03828014f7b","api":{"playground":{"display":"interactive","proxy":true},"examples":{"defaults":"required","languages":["curl","javascript","node"],"prefill":false,"autogenerate":true},"url":"full","mdx":{"auth":{"method":"bearer"}}},"navbar":{"links":[{"href":"/llm.txt","label":"llm.txt"}]},"seo":{"metatags":{"canonical":"https://docs.upag.io","og:locale":"pt_BR","language":"pt-BR"},"organization":{"name":"Upag","url":"https://upag.io"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"upag","hasAudioNarration":false,"actualSubdomain":"upag","customDomains":["docs.upag.io"],"gitSource":{"type":"github","owner":"upaghq","repo":"documentation","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6ac77c4fdf14e6603e2e7221","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Referência","count":113},{"language":"default","tag":"Webhooks","count":19},{"language":"default","tag":"Sessões de checkout","count":14},{"language":"default","tag":"Apps","count":11},{"language":"default","tag":"Faturas","count":11},{"language":"default","tag":"Links de pagamento","count":11},{"language":"default","tag":"Assinaturas","count":11},{"language":"default","tag":"Guias","count":10},{"language":"default","tag":"Payloads","count":8},{"language":"default","tag":"Layouts de checkout","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"pages/charges/create","slug":"/pages/charges/create","pageMetadata":{"title":"Criar cobrança","description":"Cria uma cobrança Pix ou de cartão na conta da chave de API","sidebarTitle":"Criar","api":"POST https://api.upag.io/v1/charges","href":"/pages/charges/create"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Cria uma cobrança Pix ou de cartão na conta da chave de API\"\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`,li:`li`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Heading,Note,ParamField,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Cria uma cobrança Pix (`,_jsx(_components.code,{children:`type: \"pix\"`}),`) ou de cartão (`,_jsx(_components.code,{children:`type: \"card\"`}),`). Pix dinâmico exige `,_jsx(_components.code,{children:`customer`}),`; cartão exige `,_jsx(_components.code,{children:`card`}),` (UUID de um `,_jsx(_components.a,{href:`/pages/cards/create`,children:`cartão tokenizado`}),`) e `,_jsx(_components.code,{children:`customer`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Permissão: `,_jsx(_components.code,{children:`charge.write`}),`. Apenas chave secreta (`,_jsx(_components.code,{children:`sk_…`}),`).`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Os exemplos usam o sandbox (`,_jsx(_components.code,{children:`https://api.upag.dev/v1`}),`). Em produção use `,_jsx(_components.code,{children:`https://api.upag.io/v1`}),` com `,_jsx(_components.code,{children:`sk_live_…`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`endpoint`,children:`Endpoint`}),`\n`,_jsx(Heading,{level:`3`,id:`pix`,children:`Pix`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`13`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`13`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.upag.dev/v1/charges`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer sk_test_your_api_key\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"type\": \"pix\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"amount\": 12550,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"description\": \"Pedido #10482\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"pix\": { \"method\": \"dynamic\", \"dueDate\": \"2026-07-28T12:00:00.000Z\" },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"customer\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"name\": \"Maria Pagadora\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"document\": { \"type\": \"cpf\", \"number\": \"39053344705\" }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Node.js SDK`,numberOfLines:`14`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`14`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`Upag`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` } `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'upag'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` upag`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` new`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` Upag`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'sk_test_your_api_key'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` charge`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` upag`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`charges`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`create`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` type:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'pix'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` amount:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 12550`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` description:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Pedido #10482'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` pix:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`method:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'dynamic'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`dueDate:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '2026-07-28T12:00:00.000Z'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` customer:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` name:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Maria Pagadora'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` document:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`type:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'cpf'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`number:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '39053344705'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`3`,id:`cartão`,children:`Cartão`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`13`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`13`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.upag.dev/v1/charges`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer sk_test_your_api_key\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"type\": \"card\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"amount\": 10000,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"installments\": 3,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"card\": \"5f0c3d1a-7b2e-4c9d-8a41-0e6f2b9d7c15\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"customer\": \"8c1f0a26-5d3b-4f1e-9c72-1a4e6b9d0f83\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"threeDSecureSession\": \"9b7c1e52-3f0a-4d86-a1c4-6e2d8f35b790\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"ipAddress\": \"203.0.113.10\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"meta\": { \"session_id\": \"7f3b2a91-5c4d-4e8f-b0a1-2d6c9e1f4a73\" }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Node.js SDK`,numberOfLines:`14`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`14`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`Upag`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` } `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'upag'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` upag`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` new`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` Upag`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'sk_test_your_api_key'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` charge`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` upag`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`charges`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`create`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` type:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'card'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` amount:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 10000`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` installments:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 3`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` card:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '5f0c3d1a-7b2e-4c9d-8a41-0e6f2b9d7c15'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` customer:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '8c1f0a26-5d3b-4f1e-9c72-1a4e6b9d0f83'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` threeDSecureSession:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '9b7c1e52-3f0a-4d86-a1c4-6e2d8f35b790'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` ipAddress:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '203.0.113.10'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` meta:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`session_id:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '7f3b2a91-5c4d-4e8f-b0a1-2d6c9e1f4a73'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`]})})})]}),`\n`,_jsxs(_components.p,{children:[`A cobrança de cartão é processada na hora: a resposta já traz o resultado (`,_jsx(_components.code,{children:`paid`}),`, `,_jsx(_components.code,{children:`in_review`}),` ou `,_jsx(_components.code,{children:`failed`}),`). O `,_jsx(_components.code,{children:`card`}),` precisa pertencer à conta; veja o fluxo completo em `,_jsx(_components.a,{href:`/pages/guides/card-3ds`,children:`Cartão com 3DS`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`parâmetros`,children:`Parâmetros`}),`\n`,_jsx(Heading,{level:`3`,id:`comuns`,children:`Comuns`}),`\n`,_jsx(ParamField,{body:`type`,type:`string`,required:true,id:`param-type`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`pix`}),` ou `,_jsx(_components.code,{children:`card`}),`.`]})}),`\n`,_jsx(ParamField,{body:`amount`,type:`integer`,required:true,id:`param-amount`,children:_jsx(_components.p,{children:`Valor em centavos, maior que zero. Em cartão parcelado, é o preço cheio: os juros de parcelamento não entram aqui.`})}),`\n`,_jsx(ParamField,{body:`description`,type:`string`,id:`param-description`,children:_jsx(_components.p,{children:`1 a 140 caracteres. Uso interno (conciliação); não vai no QR code nem o pagador vê.`})}),`\n`,_jsx(ParamField,{body:`meta`,type:`object`,id:`param-meta`,children:_jsxs(_components.p,{children:[`Até 50 chaves (1 a 40 caracteres), valores string de até 500 caracteres. Devolvido como enviado em respostas e webhooks. Em cartão, `,_jsx(_components.code,{children:`session_id`}),` é lido pela plataforma como a sessão de dispositivo do pagador (antifraude), veja `,_jsx(_components.a,{href:`#antifraude`,children:`Antifraude`}),`.`]})}),`\n`,_jsxs(ParamField,{body:`items`,type:`array`,id:`param-items`,children:[_jsx(_components.p,{children:`Até 100 itens informativos (não alteram valor nem taxas):`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`name`}),` (obrigatório, 1 a 255 caracteres)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`quantity`}),` (obrigatório, inteiro de 1 a 9999)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`unitAmount`}),` (obrigatório, inteiro ≥ 0, em centavos)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`kind`}),`: `,_jsx(_components.code,{children:`physical`}),`, `,_jsx(_components.code,{children:`digital`}),`, `,_jsx(_components.code,{children:`shipping`}),` ou `,_jsx(_components.code,{children:`other`}),` (padrão)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`sku`}),` (até 64), `,_jsx(_components.code,{children:`externalId`}),` (até 255), `,_jsx(_components.code,{children:`url`}),` (HTTP/HTTPS, até 255)`]}),`\n`]}),_jsxs(_components.p,{children:[_jsx(_components.code,{children:`quantity × unitAmount`}),` deve caber em inteiro de 32 bits (2.147.483.647). Em cartão, os itens também seguem junto com o pagamento.`]})]}),`\n`,_jsx(ParamField,{body:`splits`,type:`array`,id:`param-splits`,children:_jsxs(_components.p,{children:[`Repasses para outras contas: `,_jsx(_components.code,{children:`{ \"account\": \"uuid\", \"amount\": centavos }`}),` (`,_jsx(_components.code,{children:`amount`}),` inteiro maior que zero). A soma dos splits precisa ser menor que o valor líquido da cobrança (`,_jsx(_components.code,{children:`amount`}),` menos a taxa da plataforma). A conta recebedora precisa estar ativa e não pode ser a sua.`]})}),`\n`,_jsxs(Heading,{level:`3`,id:`pix-type-pix`,children:[`Pix (`,_jsx(_components.code,{children:`type: \"pix\"`}),`)`]}),`\n`,_jsxs(ParamField,{body:`pix`,type:`object`,id:`param-pix`,children:[_jsx(_components.p,{children:`Configuração do QR code. Padrão: dinâmico, vencendo em 10 minutos.`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`method`}),`: `,_jsx(_components.code,{children:`dynamic`}),` (padrão) ou `,_jsx(_components.code,{children:`static`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`dueDate`}),` (só `,_jsx(_components.code,{children:`dynamic`}),`): vencimento, data ISO 8601. Padrão: 10 minutos a partir de agora.`]}),`\n`]})]}),`\n`,_jsx(ParamField,{body:`customer`,type:`string | object`,id:`param-customer`,children:_jsxs(_components.p,{children:[`Obrigatório no Pix dinâmico; opcional no estático. UUID de um cliente existente ou um objeto cliente inline (mesmos campos de `,_jsx(_components.a,{href:`/pages/customers/create`,children:`Criar cliente`}),`). No objeto inline, o `,_jsx(_components.code,{children:`document.number`}),` identifica o cliente: se já existir na conta, é reutilizado e os demais valores enviados o atualizam; campos omitidos ou `,_jsx(_components.code,{children:`null`}),` não apagam nada.`]})}),`\n`,_jsxs(Heading,{level:`3`,id:`cartão-type-card`,children:[`Cartão (`,_jsx(_components.code,{children:`type: \"card\"`}),`)`]}),`\n`,_jsx(ParamField,{body:`card`,type:`string`,required:true,id:`param-card`,children:_jsxs(_components.p,{children:[`UUID de um `,_jsx(_components.a,{href:`/pages/cards/create`,children:`cartão tokenizado`}),` da conta.`]})}),`\n`,_jsx(ParamField,{body:`customer`,type:`string | object`,required:true,id:`param-customer-1`,children:_jsxs(_components.p,{children:[`UUID do cliente ou objeto cliente inline (aceita também `,_jsx(_components.code,{children:`ipAddress`}),`, com o mesmo sentido do campo da cobrança; se ambos forem enviados, vale o do cliente, e ele nunca é gravado no cadastro). O cliente precisa ter `,_jsx(_components.code,{children:`email`}),` e `,_jsx(_components.code,{children:`phone`}),`.`]})}),`\n`,_jsx(ParamField,{body:`installments`,type:`integer`,id:`param-installments`,children:_jsxs(_components.p,{children:[`1 a 12. Padrão `,_jsx(_components.code,{children:`1`}),`. Acima de 1 exige parcelamento habilitado na conta, respeitando o máximo configurado. Com sessão 3DS, deve ser igual ao da sessão.`]})}),`\n`,_jsx(ParamField,{body:`threeDSecureSession`,type:`string`,id:`param-three-d-secure-session`,children:_jsxs(_components.p,{children:[`UUID de uma `,_jsx(_components.a,{href:`/pages/three-d-secure/reference`,children:`sessão 3D Secure`}),` concluída para este cartão, valor e parcelas. A sessão é consumida pela cobrança, qualquer que seja o resultado, e o cartão é cobrado no `,_jsx(_components.code,{children:`finalAmount`}),` da sessão. Sem ela, o cartão é cobrado sem 3DS.`]})}),`\n`,_jsx(ParamField,{body:`ipAddress`,type:`string`,id:`param-ip-address`,children:_jsx(_components.p,{children:`IPv4 ou IPv6 público do pagador. Não é aceito em Pix.`})}),`\n`,_jsx(ParamField,{body:`location`,type:`object`,id:`param-location`,children:_jsxs(_components.p,{children:[`Localização do pagador resolvida a partir do IP: `,_jsx(_components.code,{children:`city`}),` (até 50), `,_jsx(_components.code,{children:`state`}),` (2 letras), `,_jsx(_components.code,{children:`country`}),` (2 letras), `,_jsx(_components.code,{children:`zip`}),` (até 9). Usada só para completar o endereço de cobrança exigido pela adquirente; nunca é gravada no cliente.`]})}),`\n`,_jsx(ParamField,{body:`softDescriptor`,type:`string`,id:`param-soft-descriptor`,children:_jsx(_components.p,{children:`Texto na fatura do pagador, 1 a 13 caracteres. Padrão: o descritivo da conta.`})}),`\n`,_jsx(Heading,{level:`2`,id:`antifraude`,children:`Antifraude`}),`\n`,_jsxs(_components.p,{children:[`Em cobranças de cartão, envie `,_jsx(_components.code,{children:`meta.session_id`}),` com o identificador da sessão de dispositivo do pagador e `,_jsx(_components.code,{children:`ipAddress`}),` com o IP dele. No browser, o `,_jsx(_components.code,{children:`upag-js`}),` gera o identificador e carrega o coletor de dispositivo:`]}),`\n`,_jsx(CodeBlock,{filename:`upag-js`,numberOfLines:`9`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`9`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`UpagJs`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` } `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'upag-js'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` upag`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` new`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` UpagJs`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'pk_test_your_public_key'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// envie ao seu servidor junto com o card e o clientSecret/sessão 3DS`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` sessionId`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` upag`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`antifraud`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`sessionId`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// antes de uma nova tentativa de pagamento`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`upag`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`antifraud`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`rotate`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Gere um `,_jsx(_components.code,{children:`session_id`}),` novo a cada tentativa de pagamento: reutilizar reduz a aprovação. Mais detalhes em `,_jsx(_components.a,{href:`/pages/sdk/frontend`,children:`SDK frontend`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`resposta`,children:`Resposta`}),`\n`,_jsx(_components.p,{children:_jsx(_components.code,{children:`201 Created`})}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`Pix`,numberOfLines:`30`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`30`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1f7d3c8a-4b52-4c9e-8a11-6d0e2f5b7c34\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"pix\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"pending\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"amount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`12550`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"failureCode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"description\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Pedido #10482\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"meta\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"customer\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"8c1f0a26-5d3b-4f1e-9c72-1a4e6b9d0f83\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"pix\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"reference\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"9d4c2b7f6a1e40538c9b2d7f1a6e0c34\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"qrCode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"00020101021226930014br.gov.bcb.pix...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"expiresAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-07-28T12:00:00.000Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"splits\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"b0a9c7d4-2e51-4c8f-9a3b-7d5e1f0c6a92\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"mdr\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"pending\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"amount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`126`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"createdAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-07-27T18:06:02.113Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"updatedAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-07-27T18:06:02.113Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"items\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"ipAddress\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"paidAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"createdAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-07-27T18:06:02.113Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"updatedAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-07-27T18:06:02.113Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Cartão`,numberOfLines:`23`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`23`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"c2a5e8d1-3b47-4f90-a6d2-9e1f0b7c4a58\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"card\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"paid\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"amount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`10000`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"failureCode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"description\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"meta\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"session_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"7f3b2a91-5c4d-4e8f-b0a1-2d6c9e1f4a73\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"customer\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"8c1f0a26-5d3b-4f1e-9c72-1a4e6b9d0f83\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"card\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"5f0c3d1a-7b2e-4c9d-8a41-0e6f2b9d7c15\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"installments\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`3`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"nsu\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"284751\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"authorizationCode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"A1B2C3\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"acquirerStatusCode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0000\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"splits\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"items\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"ipAddress\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"203.0.113.10\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"paidAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-07-27T18:06:04.331Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"createdAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-07-27T18:06:02.113Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"updatedAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-07-27T18:06:04.331Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),`\n`,_jsxs(_components.p,{children:[`Se a adquirente recusar, a resposta continua `,_jsx(_components.code,{children:`201`}),`, com `,_jsx(_components.code,{children:`status: \"failed\"`}),` e `,_jsx(_components.code,{children:`failureCode`}),` preenchido (ver `,_jsx(_components.a,{href:`/pages/charges/reference#c%C3%B3digos-de-falha`,children:`códigos de falha`}),`). Campos completos em `,_jsx(_components.a,{href:`/pages/charges/reference`,children:`Referência de cobranças`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`erros`,children:`Erros`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Mensagem / código`}),_jsx(_components.th,{children:`Causa`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Account is not active`})}),_jsx(_components.td,{children:`Conta ainda não pode receber`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Splits exceed the charge amount`})}),_jsx(_components.td,{children:`Splits (mais taxa) não cabem no valor`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Split recipient cannot be the charged account`})}),_jsx(_components.td,{children:`Split para a própria conta`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Split recipient account not found or inactive`})}),_jsx(_components.td,{children:`Recebedor do split inexistente ou inativo`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Installments are not enabled for this account`})}),_jsx(_components.td,{children:`Parcelamento desabilitado`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Installments exceed the maximum of N for this account`})}),_jsx(_components.td,{children:`Parcelas acima do máximo da conta`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`Card is not active`}),` / `,_jsx(_components.code,{children:`Card is expired`})]}),_jsx(_components.td,{children:`Cartão inutilizável`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Customer is missing fields required for card payments: …`})}),_jsxs(_components.td,{children:[`Cliente sem `,_jsx(_components.code,{children:`email`}),` e/ou `,_jsx(_components.code,{children:`phone`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`404`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Customer not found`})}),_jsx(_components.td,{children:`UUID de cliente inexistente na conta`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`404`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Card not found`})}),_jsx(_components.td,{children:`Cartão inexistente, removido ou de outra conta`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`404`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Pix key not found`})}),_jsx(_components.td,{children:`A conta não tem chave Pix para receber`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`404`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`session_not_found`})}),_jsx(_components.td,{children:`Sessão 3DS inexistente na conta`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`409`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`invalid_session_state`})}),_jsx(_components.td,{children:`Sessão 3DS não concluída ou já usada`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`409`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`threeds_session_mismatch`})}),_jsx(_components.td,{children:`Sessão autenticada para outro cartão, valor ou parcelas`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`410`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`session_expired`})}),_jsx(_components.td,{children:`Sessão 3DS expirada`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`422`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`VALIDATION_FAILED`})}),_jsxs(_components.td,{children:[`Corpo inválido, inclusive Pix dinâmico sem `,_jsx(_components.code,{children:`customer`})]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Formato dos erros em `,_jsx(_components.a,{href:`/pages/guides/errors`,children:`Erros`}),`.`]})]})}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":"Criar cobrança","description":"Cria uma cobrança Pix ou de cartão na conta da chave de API","sidebarTitle":"Criar","api":"POST https://api.upag.io/v1/charges","href":"/pages/charges/create"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Endpoint","slug":"endpoint","depth":2,"children":[{"title":"Pix","slug":"pix","depth":3,"children":[]},{"title":"Cartão","slug":"cartão","depth":3,"children":[]}]},{"title":"Parâmetros","slug":"parâmetros","depth":2,"children":[{"title":"Comuns","slug":"comuns","depth":3,"children":[]},{"title":"Pix (type: \"pix\")","slug":"pix-type-pix","depth":3,"children":[]},{"title":"Cartão (type: \"card\")","slug":"cartão-type-card","depth":3,"children":[]}]},{"title":"Antifraude","slug":"antifraude","depth":2,"children":[]},{"title":"Resposta","slug":"resposta","depth":2,"children":[]},{"title":"Erros","slug":"erros","depth":2,"children":[]}],"codeExamples":{},"endpoint":{"title":"Criar cobrança","path":"/v1/charges","servers":[{"url":"https://api.upag.io"}],"method":"post","request":{"security":[{"title":"Bearer Auth","parameters":{"header":{"Authorization":{"type":"http","scheme":"bearer","description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token."}},"query":{},"cookie":{}}}],"parameters":{"query":{},"header":{},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"type":[{"type":"string","description":"`pix` ou `card` .","required":true}],"amount":[{"type":"integer","description":"Valor em centavos, maior que zero. Em cartão parcelado, é o preço cheio: os juros de parcelamento não entram aqui.","required":true}],"description":[{"type":"string","description":"1 a 140 caracteres. Uso interno (conciliação); não vai no QR code nem o pagador vê."}],"meta":[{"type":"object","properties":{},"description":"Até 50 chaves (1 a 40 caracteres), valores string de até 500 caracteres. Devolvido como enviado em respostas e webhooks. Em cartão, `session_id` é lido pela plataforma como a sessão de dispositivo do pagador (antifraude), veja Antifraude ."}],"items":[{"type":"array","items":[{"type":"object","properties":{}}],"description":"Até 100 itens informativos (não alteram valor nem taxas): `name` (obrigatório, 1 a 255 caracteres) `quantity` (obrigatório, inteiro de 1 a 9999) `unitAmount` (obrigatório, inteiro ≥ 0, em centavos) `kind` : `physical` , `digital` , `shipping` ou `other` (padrão) `sku` (até 64), `externalId` (até 255), `url` (HTTP/HTTPS, até 255) `quantity × unitAmount` deve caber em inteiro de 32 bits (2.147.483.647). Em cartão, os itens também seguem junto com o pagamento."}],"splits":[{"type":"array","items":[{"type":"object","properties":{}}],"description":"Repasses para outras contas: `{ \"account\": \"uuid\", \"amount\": centavos }` ( `amount` inteiro maior que zero). A soma dos splits precisa ser menor que o valor líquido da cobrança ( `amount` menos a taxa da plataforma). A conta recebedora precisa estar ativa e não pode ser a sua."}],"pix":[{"type":"object","properties":{},"description":"Configuração do QR code. Padrão: dinâmico, vencendo em 10 minutos. `method` : `dynamic` (padrão) ou `static` . `dueDate` (só `dynamic` ): vencimento, data ISO 8601. Padrão: 10 minutos a partir de agora."}],"customer":[{"type":"object","properties":{},"description":"UUID do cliente ou objeto cliente inline (aceita também `ipAddress` , com o mesmo sentido do campo da cobrança; se ambos forem enviados, vale o do cliente, e ele nunca é gravado no cadastro). O cliente precisa ter `email` e `phone` .","required":true}],"card":[{"type":"string","description":"UUID de um cartão tokenizado da conta.","required":true}],"installments":[{"type":"integer","description":"1 a 12. Padrão `1` . Acima de 1 exige parcelamento habilitado na conta, respeitando o máximo configurado. Com sessão 3DS, deve ser igual ao da sessão."}],"threeDSecureSession":[{"type":"string","description":"UUID de uma sessão 3D Secure concluída para este cartão, valor e parcelas. A sessão é consumida pela cobrança, qualquer que seja o resultado, e o cartão é cobrado no `finalAmount` da sessão. Sem ela, o cartão é cobrado sem 3DS."}],"ipAddress":[{"type":"string","description":"IPv4 ou IPv6 público do pagador. Não é aceito em Pix."}],"location":[{"type":"object","properties":{},"description":"Localização do pagador resolvida a partir do IP: `city` (até 50), `state` (2 letras), `country` (2 letras), `zip` (até 9). Usada só para completar o endereço de cobrança exigido pela adquirente; nunca é gravada no cliente."}],"softDescriptor":[{"type":"string","description":"Texto na fatura do pagador, 1 a 13 caracteres. Padrão: o descritivo da conta."}]}}],"examples":{"example":{"value":{"type":"\u003cstring>","amount":123,"description":"\u003cstring>","meta":{},"items":[{}],"splits":[{}],"pix":{},"customer":{},"card":"\u003cstring>","installments":123,"threeDSecureSession":"\u003cstring>","ipAddress":"\u003cstring>","location":{},"softDescriptor":"\u003cstring>"}}}}}},"response":{},"deprecated":false}},"jsLinks":[],"subdomain":"upag","siteName":"Upag Documentation","title":"Criar cobrança - Upag Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-08T11:19:53.382Z","originalFileLocation":"pages/charges/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=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Cria uma cobrança Pix ou de cartão na conta da chave de API\">\u003cmeta data-mint-head name=\"application-name\" content=\"Upag Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/upag/-kAfZwMHyVqMVY71/_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/upag/-kAfZwMHyVqMVY71/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/upag/-kAfZwMHyVqMVY71/_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/upag/-kAfZwMHyVqMVY71/_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/upag/-kAfZwMHyVqMVY71/_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/upag/-kAfZwMHyVqMVY71/_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/upag/-kAfZwMHyVqMVY71/_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/upag/-kAfZwMHyVqMVY71/_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/upag/-kAfZwMHyVqMVY71/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Criar cobrança - Upag Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Cria uma cobrança Pix ou de cartão na conta da chave de API\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Upag Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.upag.io/pages/charges/create\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://upag.mintlify.site/_mintlify/api/og/v2?division=Cobran%C3%A7as\u0026amp;title=Criar+cobran%C3%A7a\u0026amp;description=Cria+uma+cobran%C3%A7a+Pix+ou+de+cart%C3%A3o+na+conta+da+chave+de+API\u0026amp;theme=ec18ef61f13e0db7a8ddbb8d\u0026amp;signature=ad84a276495d6582ed91e0a80a06e1bf6f933856680926aeb78be4c199d1fcb4\">\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=\"Criar cobrança - Upag Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Cria uma cobrança Pix ou de cartão na conta da chave de API\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://upag.mintlify.site/_mintlify/api/og/v2?division=Cobran%C3%A7as\u0026amp;title=Criar+cobran%C3%A7a\u0026amp;description=Cria+uma+cobran%C3%A7a+Pix+ou+de+cart%C3%A3o+na+conta+da+chave+de+API\u0026amp;theme=ec18ef61f13e0db7a8ddbb8d\u0026amp;signature=ad84a276495d6582ed91e0a80a06e1bf6f933856680926aeb78be4c199d1fcb4\">\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/upag/-kAfZwMHyVqMVY71/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Upag Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#06AEDD\">\u003cmeta data-mint-head name=\"og:locale\" content=\"pt_BR\">\u003cmeta data-mint-head name=\"language\" content=\"pt-BR\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.upag.io/pages/charges/create\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/pages/charges/create.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://upag.io/#organization\",\"name\":\"Upag\",\"url\":\"https://upag.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/upag/J0FSTIds_wQSyfe4/logo/light.svg?fit=max\u0026auto=format\u0026n=J0FSTIds_wQSyfe4\u0026q=85\u0026s=69934217fd5359442c60393a5611af74\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.upag.io#website\",\"name\":\"Upag Documentation\",\"url\":\"https://docs.upag.io\",\"publisher\":{\"@id\":\"https://upag.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.upag.io/pages/charges/create#webpage\",\"url\":\"https://docs.upag.io/pages/charges/create\",\"name\":\"Criar cobrança\",\"description\":\"Cria uma cobrança Pix ou de cartão na conta da chave de API\",\"dateModified\":\"2026-10-08T11:19:53.382Z\",\"isPartOf\":{\"@id\":\"https://docs.upag.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.upag.io/pages/charges/create#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.upag.io/pages/charges/create#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Cobranças\",\"item\":\"https://docs.upag.io/pages/charges/reference\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Criar cobrança\",\"item\":\"https://docs.upag.io/pages/charges/create\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.upag.io/pages/charges/create#apireference\",\"headline\":\"Criar cobrança\",\"name\":\"Criar cobrança\",\"description\":\"Cria uma cobrança Pix ou de cartão na conta da chave de API\",\"url\":\"https://docs.upag.io/pages/charges/create\",\"mainEntityOfPage\":{\"@id\":\"https://docs.upag.io/pages/charges/create#webpage\"},\"dateModified\":\"2026-10-08T11:19:53.382Z\",\"publisher\":{\"@id\":\"https://upag.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.upag.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Upag Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Upag\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/pages/charges/create.md","siteName":"Upag Documentation","nav":{"global":null,"tabs":[{"tab":"Guias","pages":[{"title":"Guias","href":"/pages/guides/quickstart"}]},{"tab":"Referência","groups":[{"group":"Cobranças","pages":[{"title":"Referência","description":"Objeto Cobrança (charge): Pix e cartão","sidebarTitle":"Visão geral","href":"/pages/charges/reference"},{"title":"Criar cobrança","sidebarTitle":"Criar","api":"POST https://api.upag.io/v1/charges","href":"/pages/charges/create"},{"title":"Listar cobranças","description":"Lista as cobranças da conta, mais recentes primeiro","sidebarTitle":"Listar","api":"GET https://api.upag.io/v1/charges","href":"/pages/charges/list"},{"title":"Obter cobrança","sidebarTitle":"Obter","api":"GET https://api.upag.io/v1/charges/{chargeId}","href":"/pages/charges/get"}]},{"group":"Cartões","pages":[{"title":"Referência","sidebarTitle":"Visão geral","href":"/pages/cards/reference"},{"title":"Criar cartão","sidebarTitle":"Criar","api":"POST https://api.upag.io/v1/cards","href":"/pages/cards/create"},{"title":"Listar cartões","sidebarTitle":"Listar","api":"GET https://api.upag.io/v1/cards","href":"/pages/cards/list"},{"title":"Obter cartão","sidebarTitle":"Obter","api":"GET https://api.upag.io/v1/cards/{cardId}","href":"/pages/cards/get"},{"title":"Remover cartão","sidebarTitle":"Remover","api":"DELETE https://api.upag.io/v1/cards/{cardId}","href":"/pages/cards/delete"}]},{"group":"3D Secure","pages":[{"title":"Referência","sidebarTitle":"Visão geral","href":"/pages/three-d-secure/reference"},{"title":"Criar sessão 3DS","sidebarTitle":"Criar","api":"POST https://api.upag.io/v1/3ds/sessions","href":"/pages/three-d-secure/create"},{"title":"Obter sessão 3DS","sidebarTitle":"Obter","api":"GET https://api.upag.io/v1/3ds/sessions/{sessionId}","href":"/pages/three-d-secure/get"},{"title":"Iniciar sessão 3DS","sidebarTitle":"Iniciar","api":"POST https://api.upag.io/v1/3ds/sessions/start","href":"/pages/three-d-secure/start"},{"title":"Concluir sessão 3DS","sidebarTitle":"Concluir","api":"POST https://api.upag.io/v1/3ds/sessions/complete","href":"/pages/three-d-secure/complete"}]},{"group":"Clientes","pages":[{"title":"Referência","sidebarTitle":"Visão geral","href":"/pages/customers/reference"},{"title":"Criar cliente","sidebarTitle":"Criar","api":"POST https://api.upag.io/v1/customers","href":"/pages/customers/create"},{"title":"Listar clientes","sidebarTitle":"Listar","api":"GET https://api.upag.io/v1/customers","href":"/pages/customers/list"},{"title":"Obter cliente","sidebarTitle":"Obter","api":"GET https://api.upag.io/v1/customers/{customerId}","href":"/pages/customers/get"},{"title":"Atualizar cliente","sidebarTitle":"Atualizar","api":"PATCH https://api.upag.io/v1/customers/{customerId}","href":"/pages/customers/update"},{"title":"Excluir cliente","sidebarTitle":"Excluir","api":"DELETE https://api.upag.io/v1/customers/{customerId}","href":"/pages/customers/delete"}]},{"group":"Produtos","pages":[{"title":"Referência","sidebarTitle":"Visão geral","href":"/pages/products/reference"},{"title":"Criar produto","sidebarTitle":"Criar","api":"POST https://api.upag.io/v1/products","href":"/pages/products/create"},{"title":"Listar produtos","sidebarTitle":"Listar","api":"GET https://api.upag.io/v1/products","href":"/pages/products/list"},{"title":"Obter produto","sidebarTitle":"Obter","api":"GET https://api.upag.io/v1/products/{productId}","href":"/pages/products/get"},{"title":"Atualizar produto","sidebarTitle":"Atualizar","api":"PATCH https://api.upag.io/v1/products/{productId}","href":"/pages/products/update"}]},{"group":"Preços","pages":[{"title":"Referência","sidebarTitle":"Visão geral","href":"/pages/prices/reference"},{"title":"Criar preço","sidebarTitle":"Criar","api":"POST https://api.upag.io/v1/products/{productId}/prices","href":"/pages/prices/create"},{"title":"Listar preços","sidebarTitle":"Listar","api":"GET https://api.upag.io/v1/products/{productId}/prices","href":"/pages/prices/list"},{"title":"Obter preço","sidebarTitle":"Obter","api":"GET https://api.upag.io/v1/products/{productId}/prices/{priceId}","href":"/pages/prices/get"},{"title":"Atualizar preço","sidebarTitle":"Atualizar","api":"PATCH https://api.upag.io/v1/products/{productId}/prices/{priceId}","href":"/pages/prices/update"}]},{"group":"Cupons","pages":[{"title":"Referência","sidebarTitle":"Visão geral","href":"/pages/coupons/reference"},{"title":"Criar cupom","sidebarTitle":"Criar","api":"POST https://api.upag.io/v1/coupons","href":"/pages/coupons/create"},{"title":"Listar cupons","sidebarTitle":"Listar","api":"GET https://api.upag.io/v1/coupons","href":"/pages/coupons/list"},{"title":"Obter cupom","sidebarTitle":"Obter","api":"GET https://api.upag.io/v1/coupons/{couponId}","href":"/pages/coupons/get"},{"title":"Atualizar cupom","sidebarTitle":"Atualizar","api":"PATCH https://api.upag.io/v1/coupons/{couponId}","href":"/pages/coupons/update"},{"title":"Excluir cupom","sidebarTitle":"Excluir","api":"DELETE https://api.upag.io/v1/coupons/{couponId}","href":"/pages/coupons/delete"}]},{"group":"Faturas","pages":[{"title":"Referência","sidebarTitle":"Visão geral","href":"/pages/invoices/reference"},{"title":"Criar fatura","sidebarTitle":"Criar","api":"POST https://api.upag.io/v1/invoices","href":"/pages/invoices/create"},{"title":"Listar faturas","sidebarTitle":"Listar","api":"GET https://api.upag.io/v1/invoices","href":"/pages/invoices/list"},{"title":"Obter fatura","sidebarTitle":"Obter","api":"GET https://api.upag.io/v1/invoices/{invoiceId}","href":"/pages/invoices/get"},{"title":"Atualizar fatura","sidebarTitle":"Atualizar","api":"PATCH https://api.upag.io/v1/invoices/{invoiceId}","href":"/pages/invoices/update"},{"title":"Próxima fatura","sidebarTitle":"Próxima fatura","api":"GET https://api.upag.io/v1/invoices/upcoming","href":"/pages/invoices/upcoming"},{"title":"Pagar fatura","sidebarTitle":"Pagar","api":"POST https://api.upag.io/v1/invoices/{invoiceId}/pay","href":"/pages/invoices/pay"},{"title":"Marcar como paga","sidebarTitle":"Marcar como paga","api":"POST https://api.upag.io/v1/invoices/{invoiceId}/mark-as-paid","href":"/pages/invoices/mark-as-paid"},{"title":"Adicionar item","sidebarTitle":"Adicionar item","api":"POST https://api.upag.io/v1/invoices/{invoiceId}/items","href":"/pages/invoices/create-item"},{"title":"Atualizar item","sidebarTitle":"Atualizar item","api":"PATCH https://api.upag.io/v1/invoices/{invoiceId}/items/{itemId}","href":"/pages/invoices/update-item"},{"title":"Remover item","sidebarTitle":"Remover item","api":"DELETE https://api.upag.io/v1/invoices/{invoiceId}/items/{itemId}","href":"/pages/invoices/delete-item"}]},{"group":"Assinaturas","pages":[{"title":"Referência","sidebarTitle":"Visão geral","href":"/pages/subscriptions/reference"},{"title":"Criar assinatura","sidebarTitle":"Criar","api":"POST https://api.upag.io/v1/subscriptions","href":"/pages/subscriptions/create"},{"title":"Listar assinaturas","sidebarTitle":"Listar","api":"GET https://api.upag.io/v1/subscriptions","href":"/pages/subscriptions/list"},{"title":"Obter assinatura","sidebarTitle":"Obter","api":"GET https://api.upag.io/v1/subscriptions/{subscriptionId}","href":"/pages/subscriptions/get"},{"title":"Atualizar assinatura","sidebarTitle":"Atualizar","api":"PATCH https://api.upag.io/v1/subscriptions/{subscriptionId}","href":"/pages/subscriptions/update"},{"title":"Cancelar assinatura","sidebarTitle":"Cancelar","api":"POST https://api.upag.io/v1/subscriptions/{subscriptionId}/cancel","href":"/pages/subscriptions/cancel"},{"title":"Adicionar item","sidebarTitle":"Adicionar item","api":"POST https://api.upag.io/v1/subscriptions/{subscriptionId}/items","href":"/pages/subscriptions/create-item"},{"title":"Atualizar item","sidebarTitle":"Atualizar item","api":"PATCH https://api.upag.io/v1/subscriptions/{subscriptionId}/items/{itemId}","href":"/pages/subscriptions/update-item"},{"title":"Remover item","sidebarTitle":"Remover item","api":"DELETE https://api.upag.io/v1/subscriptions/{subscriptionId}/items/{itemId}","href":"/pages/subscriptions/delete-item"},{"title":"Mudanças agendadas","sidebarTitle":"Mudanças agendadas","api":"GET https://api.upag.io/v1/subscriptions/{subscriptionId}/scheduled-changes","href":"/pages/subscriptions/scheduled-changes"},{"title":"Cancelar mudança agendada","sidebarTitle":"Cancelar mudança agendada","api":"DELETE https://api.upag.io/v1/subscriptions/{subscriptionId}/scheduled-changes/{changeId}","href":"/pages/subscriptions/delete-scheduled-change"}]},{"group":"Links de pagamento","pages":[{"title":"Referência","sidebarTitle":"Visão geral","href":"/pages/payment-links/reference"},{"title":"Criar link de pagamento","sidebarTitle":"Criar","api":"POST https://api.upag.io/v1/payment-links","href":"/pages/payment-links/create"},{"title":"Listar links de pagamento","sidebarTitle":"Listar","api":"GET https://api.upag.io/v1/payment-links","href":"/pages/payment-links/list"},{"title":"Obter link de pagamento","sidebarTitle":"Obter","api":"GET https://api.upag.io/v1/payment-links/{paymentLinkId}","href":"/pages/payment-links/get"},{"title":"Atualizar link de pagamento","sidebarTitle":"Atualizar","api":"PATCH https://api.upag.io/v1/payment-links/{paymentLinkId}","href":"/pages/payment-links/update"},{"title":"Adicionar item ao link","sidebarTitle":"Adicionar item","api":"POST https://api.upag.io/v1/payment-links/{paymentLinkId}/items","href":"/pages/payment-links/add-item"},{"title":"Atualizar item do link","sidebarTitle":"Atualizar item","api":"PATCH https://api.upag.io/v1/payment-links/{paymentLinkId}/items/{itemId}","href":"/pages/payment-links/update-item"},{"title":"Remover item do link","sidebarTitle":"Remover item","api":"DELETE https://api.upag.io/v1/payment-links/{paymentLinkId}/items/{itemId}","href":"/pages/payment-links/remove-item"},{"title":"Adicionar bump ao link","sidebarTitle":"Adicionar bump","api":"POST https://api.upag.io/v1/payment-links/{paymentLinkId}/bumps","href":"/pages/payment-links/add-bump"},{"title":"Atualizar bump do link","sidebarTitle":"Atualizar bump","api":"PATCH https://api.upag.io/v1/payment-links/{paymentLinkId}/bumps/{bumpId}","href":"/pages/payment-links/update-bump"},{"title":"Remover bump do link","sidebarTitle":"Remover bump","api":"DELETE https://api.upag.io/v1/payment-links/{paymentLinkId}/bumps/{bumpId}","href":"/pages/payment-links/remove-bump"}]},{"group":"Sessões de checkout","pages":[{"title":"Referência","sidebarTitle":"Visão geral","href":"/pages/checkout-sessions/reference"},{"title":"Criar sessão de checkout","sidebarTitle":"Criar","api":"POST https://api.upag.io/v1/checkout/sessions","href":"/pages/checkout-sessions/create"},{"title":"Listar sessões de checkout","sidebarTitle":"Listar","api":"GET https://api.upag.io/v1/checkout/sessions","href":"/pages/checkout-sessions/list"},{"title":"Obter sessão de checkout","sidebarTitle":"Obter","api":"GET https://api.upag.io/v1/checkout/sessions/{sessionId}","href":"/pages/checkout-sessions/get"},{"title":"Atualizar sessão de checkout","sidebarTitle":"Atualizar","api":"PATCH https://api.upag.io/v1/checkout/sessions/{sessionId}","href":"/pages/checkout-sessions/update"},{"title":"Remover sessão de checkout","sidebarTitle":"Remover","api":"DELETE https://api.upag.io/v1/checkout/sessions/{sessionId}","href":"/pages/checkout-sessions/delete"},{"title":"Iniciar sessão de checkout","sidebarTitle":"Iniciar","api":"POST https://api.upag.io/v1/checkout/payment-links/{code}/sessions","href":"/pages/checkout-sessions/start"},{"title":"Obter sessão (pagador)","sidebarTitle":"Obter (pagador)","api":"GET https://api.upag.io/v1/checkout/sessions/{sessionId}","href":"/pages/checkout-sessions/retrieve"},{"title":"Confirmar sessão de checkout","sidebarTitle":"Confirmar","api":"POST https://api.upag.io/v1/checkout/sessions/{sessionId}/confirm","href":"/pages/checkout-sessions/confirm"},{"title":"Abrir sessão 3DS do checkout","sidebarTitle":"Sessão 3DS","api":"POST https://api.upag.io/v1/checkout/sessions/{sessionId}/3ds/session","href":"/pages/checkout-sessions/three-d-secure"},{"title":"Aplicar cupom","sidebarTitle":"Aplicar cupom","api":"POST https://api.upag.io/v1/checkout/sessions/{sessionId}/coupon","href":"/pages/checkout-sessions/apply-coupon"},{"title":"Remover cupom","sidebarTitle":"Remover cupom","api":"DELETE https://api.upag.io/v1/checkout/sessions/{sessionId}/coupon","href":"/pages/checkout-sessions/remove-coupon"},{"title":"Listar apps do checkout","sidebarTitle":"Listar apps","api":"GET https://api.upag.io/v1/checkout/sessions/{sessionId}/apps","href":"/pages/checkout-sessions/list-apps"},{"title":"Iniciar checkout Shopify","sidebarTitle":"Checkout Shopify","api":"POST https://api.upag.io/v1/checkout/shopify/sessions","href":"/pages/checkout-sessions/shopify"}]},{"group":"Layouts de checkout","pages":[{"title":"Referência","sidebarTitle":"Visão geral","href":"/pages/checkout-layouts/reference"},{"title":"Criar layout de checkout","sidebarTitle":"Criar","api":"POST https://api.upag.io/v1/checkout/layouts","href":"/pages/checkout-layouts/create"},{"title":"Listar layouts de checkout","sidebarTitle":"Listar","api":"GET https://api.upag.io/v1/checkout/layouts","href":"/pages/checkout-layouts/list"},{"title":"Obter layout de checkout","sidebarTitle":"Obter","api":"GET https://api.upag.io/v1/checkout/layouts/{layoutId}","href":"/pages/checkout-layouts/get"},{"title":"Atualizar layout de checkout","sidebarTitle":"Atualizar","api":"PATCH https://api.upag.io/v1/checkout/layouts/{layoutId}","href":"/pages/checkout-layouts/update"},{"title":"Excluir layout de checkout","sidebarTitle":"Excluir","api":"DELETE https://api.upag.io/v1/checkout/layouts/{layoutId}","href":"/pages/checkout-layouts/delete"}]},{"group":"Transferências Pix","pages":[{"title":"Referência","sidebarTitle":"Visão geral","href":"/pages/transfers/reference"},{"title":"Consultar destino Pix","sidebarTitle":"Consultar","api":"POST https://api.upag.io/v1/transfers/lookup","href":"/pages/transfers/lookup"},{"title":"Criar transferência","sidebarTitle":"Criar","api":"POST https://api.upag.io/v1/transfers","href":"/pages/transfers/create"},{"title":"Listar transferências","sidebarTitle":"Listar","api":"GET https://api.upag.io/v1/transfers","href":"/pages/transfers/list"},{"title":"Obter transferência","sidebarTitle":"Obter","api":"GET https://api.upag.io/v1/transfers/{transferId}","href":"/pages/transfers/get"},{"title":"Comprovante","sidebarTitle":"Comprovante","api":"GET https://api.upag.io/v1/transfers/{transferId}/receipt","href":"/pages/transfers/receipt"}]},{"group":"Subcontas","pages":[{"title":"Referência","sidebarTitle":"Visão geral","href":"/pages/sub-accounts/reference"},{"title":"Criar subconta","sidebarTitle":"Criar","api":"POST https://api.upag.io/v1/sub-accounts","href":"/pages/sub-accounts/create"},{"title":"Listar subcontas","sidebarTitle":"Listar","api":"GET https://api.upag.io/v1/sub-accounts","href":"/pages/sub-accounts/list"},{"title":"Obter subconta","sidebarTitle":"Obter","api":"GET https://api.upag.io/v1/sub-accounts/{subAccountId}","href":"/pages/sub-accounts/get"},{"title":"Rotacionar chave da subconta","sidebarTitle":"Rotacionar chave","api":"POST https://api.upag.io/v1/sub-accounts/{subAccountId}/api-key/roll","href":"/pages/sub-accounts/roll-api-key"}]},{"group":"Apps","pages":[{"title":"Referência","sidebarTitle":"Visão geral","href":"/pages/apps/reference"},{"title":"Criar app","sidebarTitle":"Criar","api":"POST https://api.upag.io/v1/apps","href":"/pages/apps/create"},{"title":"Listar apps","sidebarTitle":"Listar","api":"GET https://api.upag.io/v1/apps","href":"/pages/apps/list"},{"title":"Obter app","sidebarTitle":"Obter","api":"GET https://api.upag.io/v1/apps/{appId}","href":"/pages/apps/get"},{"title":"Atualizar app","sidebarTitle":"Atualizar","api":"PATCH https://api.upag.io/v1/apps/{appId}","href":"/pages/apps/update"},{"title":"Excluir app","sidebarTitle":"Excluir","api":"DELETE https://api.upag.io/v1/apps/{appId}","href":"/pages/apps/delete"},{"title":"Instalar app","sidebarTitle":"Instalar","api":"POST https://api.upag.io/v1/apps/{appId}/install","href":"/pages/apps/install"},{"title":"Verificar script","sidebarTitle":"Verificar script","api":"GET https://api.upag.io/v1/apps/{appId}/script","href":"/pages/apps/verify-script"},{"title":"Desinstalar app","sidebarTitle":"Desinstalar","api":"DELETE https://api.upag.io/v1/apps/{appId}/uninstall","href":"/pages/apps/uninstall"},{"title":"Listar logs do app","sidebarTitle":"Listar logs","api":"GET https://api.upag.io/v1/apps/{appId}/logs","href":"/pages/apps/list-logs"},{"title":"Obter log do app","sidebarTitle":"Obter log","api":"GET https://api.upag.io/v1/apps/{appId}/logs/{logId}","href":"/pages/apps/get-log"}]},{"group":"Chave de API","pages":[{"title":"Identificar chave","sidebarTitle":"Identificar chave","api":"GET https://api.upag.io/v1/me","href":"/pages/me/get"}]}]},{"tab":"Webhooks","pages":[{"title":"Webhooks","href":"/pages/webhooks/overview"}]},{"tab":"SDK","pages":[{"title":"SDK","href":"/pages/sdk/overview"}]},{"tab":"Simulador","pages":[{"title":"Simulador","href":"/pages/simulator"}]}]},"basePath":"","title":"Criar cobrança - Upag Documentation","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js"]}