{
"statusCode": 400,
"error": "BadRequest",
"message": "name must be longer than or equal to 2 characters",
"timestamp": "2025-12-15T22:00:00.000Z",
"details": {},
"traceId": "<string>"
}
{
"statusCode": 400,
"error": "BadRequest",
"message": "name must be longer than or equal to 2 characters",
"timestamp": "2025-12-15T22:00:00.000Z",
"details": {},
"traceId": "<string>"
}
Split entre subcontas. O campo opcional split reparte parte do valor com outras carteiras suas — subcontas ou a conta principal, pela palavra reservada principal. No máximo 10 itens, valores fixos em reais.Quem cria a cobrança é o originador: recebe o bruto, paga a taxa cheia e só então reparte, então o teto do rateio é o líquido (valor da cobrança menos a taxa), não o bruto. O rateio acontece na liquidação, não na criação. Estorno e MED debitam só o originador — quem recebeu rateio nunca é debitado.Veja Split de Pagamento para as regras completas, os exemplos e a tabela de erros.
Escolha da instituição. Se a sua conta tem essa opção habilitada, o campo opcional pspCredentialId fixa a instituição que emite esta cobrança, ignorando o roteamento configurado. Copie o ID em Configurações → Roteamento no painel.Fixar não é preferir: se a instituição estiver fora do ar ou sem capacidade, a cobrança falha em vez de sair por outra. A resposta ecoa pspCredentialId como recibo.Veja Escolha da Instituição para as regras completas e a tabela de erros.
Autorizações
Authorization
string
header
obrigatório
Access token obtido no POST /auth (client_id + client_secret). Válido por 300 segundos.
Cabeçalhos
Idempotency-Key
string
Chave única do cliente (8-255 chars) que torna a requisição idempotente. Retentativas com a mesma chave retornam a resposta cacheada (TTL 24h). Mesma chave com body diferente retorna 422.
Required string length: 8 - 255
X-Sub-Account
string
Reference da subconta em que a operação deve ser executada. Quando omitido, a operação acontece na conta principal; o valor reservado principal também resolve para a conta principal e é equivalente a omitir o header. Aceito em todos os endpoints, exceto POST /auth e os próprios endpoints de /sub-accounts, que sempre operam na conta principal.
Exige que a credencial tenha o acesso a subcontas habilitado (Configurações → Integração → Credenciais de API). Ele nasce desligado e não é substituído por nenhuma permissão, nem por FULL_ACCESS: sem ele a resposta é 403 SUB_ACCOUNT_FORBIDDEN.
Pattern: ^[a-z0-9][a-z0-9_-]{1,31}$
Exemplo:
"loja-centro"
Corpo
application/json
amount
number
obrigatório
Valor em BRL (ex: 100.50 para R$ 100,50)
Intervalo obrigatório: x >= 1
Exemplo:
150.75
description
string
obrigatório
Descrição da cobrança
Maximum string length: 255
Exemplo:
"Pagamento do pedido #12345"
customer
object
Dados do pagador (todos opcionais).
Show child attributes
projectId
string<uuid>
ID do projeto para associar a transação. Se não informado e a conta tiver um único projeto, a cobrança herda esse projeto; com mais de um, a cobrança fica sem projeto.
pspCredentialId
string<uuid>
Fixa a instituição que emite esta cobrança, ignorando o roteamento configurado. Use o ID que aparece em Configurações → Roteamento no painel. Precisa ser uma instituição habilitada e ativa da sua conta. Se ela estiver fora do ar ou sem capacidade, a cobrança FALHA — não cai para outra: você pediu esta. Disponível para contas com a escolha de instituição habilitada.
Exemplo:
"6e307aa4-4772-4230-a648-d88cee308f54"
expiresIn
integer
Segundos até expiração (padrão: 86400 = 24h)
Intervalo obrigatório: 300 <= x <= 604800
Exemplo:
3600
externalReference
string
Seu ID de referência externa
Maximum string length: 255
Exemplo:
"pedido-12345"
metadata
object
Metadados customizados (pares chave-valor)
Exemplo:
{ "orderId": "12345", "source": "website" }
split
object[]
Reparte parte do valor com outras subcontas da mesma conta, na liquidação. Quem cria a cobrança é o originador: recebe o valor bruto, paga a taxa cheia e só então reparte — a taxa não é rateada entre os destinatários. A soma do split não pode exceder o líquido (valor da cobrança menos a taxa). Estorno e MED debitam apenas o originador; quem recebeu rateio nunca é debitado.
QR Code do PIX em formato data URI (data:image/png;base64,...)
pspPaymentId
string
ID da transação no provedor de pagamento (PSP). Use para conciliação; ausente se o PSP não retornou o ID na criação.
Exemplo:
"de3516a2-c63a-4c02-b132-a239bf42e183"
pspCredentialId
string<uuid>
Instituição que emitiu esta cobrança. Só vem quando você fixou a instituição no request (pspCredentialId), como recibo de que ela foi respeitada.
Exemplo:
"6e307aa4-4772-4230-a648-d88cee308f54"
externalReference
string
Seu ID de referência externa
Exemplo:
"pedido-12345"
split
object[]
Rateio aceito, em reais. Presente apenas quando a cobrança foi criada com split — se veio na resposta, as subcontas existiam e a soma cabia no líquido. O que foi efetivamente distribuído chega no webhook payment_completed.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Jetpag","colors":{"primary":"#18181b","light":"#a1a1aa","dark":"#09090b"},"logo":{"light":"https://mintcdn.com/jetpag/lKCj1ucL64b7J4qL/logo/light.svg?fit=max\u0026auto=format\u0026n=lKCj1ucL64b7J4qL\u0026q=85\u0026s=b561a1a87be045a48745c62887a84e2b","dark":"https://mintcdn.com/jetpag/lKCj1ucL64b7J4qL/logo/dark.svg?fit=max\u0026auto=format\u0026n=lKCj1ucL64b7J4qL\u0026q=85\u0026s=31b484e8b21f2608e5053944d0180bf4"},"favicon":"https://mintcdn.com/jetpag/lKCj1ucL64b7J4qL/favicon.svg?fit=max\u0026auto=format\u0026n=lKCj1ucL64b7J4qL\u0026q=85\u0026s=3058b4ac03acedeb28ff8d2604b956c3","api":{"playground":{}},"navbar":{"primary":{"type":"button","label":"Dashboard","href":"https://banking.jetpag.com"}},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Dashboard","icon":"gauge","href":"https://banking.jetpag.com"}]},"languages":[{"language":"pt-BR","href":""},{"language":"en","href":"en"},{"language":"ru","href":"ru"},{"language":"cn","href":"cn"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"jetpag","hasAudioNarration":false,"actualSubdomain":"jetpag","customDomains":["docs.jetpag.com"],"gitSource":{"type":"github","owner":"jetpag","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6af4a218f8db9a78751ffb07","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"pt-BR","tag":"Projetos","count":2},{"language":"pt-BR","tag":"Subcontas","count":2},{"language":"pt-BR","tag":"Transações","count":2},{"language":"pt-BR","tag":"Visão Geral","count":2},{"language":"cn","tag":"项目","count":2},{"language":"cn","tag":"子账户","count":2},{"language":"cn","tag":"交易","count":2},{"language":"cn","tag":"概览","count":2},{"language":"en","tag":"Projects","count":2},{"language":"en","tag":"Sub-accounts","count":2},{"language":"en","tag":"Transactions","count":2},{"language":"en","tag":"Overview","count":2},{"language":"ru","tag":"Проекты","count":2},{"language":"ru","tag":"Субсчета","count":2},{"language":"ru","tag":"Транзакции","count":2},{"language":"ru","tag":"Обзор","count":2},{"language":"pt-BR","tag":"Conta","count":1},{"language":"pt-BR","tag":"Autenticação","count":1},{"language":"pt-BR","tag":"Bloqueios de Saldo","count":1},{"language":"pt-BR","tag":"PIX","count":1},{"language":"pt-BR","tag":"Saques","count":1},{"language":"cn","tag":"账户","count":1},{"language":"cn","tag":"身份验证","count":1},{"language":"cn","tag":"余额冻结","count":1},{"language":"cn","tag":"PIX","count":1},{"language":"cn","tag":"提现","count":1},{"language":"en","tag":"Account","count":1},{"language":"en","tag":"Authentication","count":1},{"language":"en","tag":"Balance Blocks","count":1},{"language":"en","tag":"PIX","count":1},{"language":"en","tag":"Withdrawals","count":1},{"language":"ru","tag":"Аккаунт","count":1},{"language":"ru","tag":"Аутентификация","count":1},{"language":"ru","tag":"Блокировки баланса","count":1},{"language":"ru","tag":"PIX","count":1},{"language":"ru","tag":"Вывод средств","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"api-reference/pix/create","slug":"/api-reference/pix/create","pageMetadata":{"title":"Criar Cobrança PIX","openapi":"openapi.json POST /pix","description":"Cria uma cobrança PIX instantânea.\n\n**Permissão requerida:** `PIX:WRITE` ou `FULL_ACCESS`","href":"/api-reference/pix/create"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Cria uma cobrança PIX instantânea.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Permissão requerida:\"\n }), \" \", _jsx(_components.code, {\n children: \"PIX:WRITE\"\n }), \" ou \", _jsx(_components.code, {\n children: \"FULL_ACCESS\"\n })]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Note}=_components;if(!Note)_missingMdxReference(`Note`,true);return _jsxs(_Fragment,{children:[_jsxs(Note,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Split entre subcontas.`}),` O campo opcional `,_jsx(_components.code,{children:`split`}),` reparte parte do valor com outras carteiras suas — subcontas ou a conta principal, pela palavra reservada `,_jsx(_components.code,{children:`principal`}),`. No máximo 10 itens, valores fixos em reais.`]}),_jsxs(_components.p,{children:[`Quem cria a cobrança é o `,_jsx(_components.strong,{children:`originador`}),`: recebe o bruto, paga a taxa cheia e só então reparte, então o teto do rateio é o `,_jsx(_components.strong,{children:`líquido`}),` (valor da cobrança menos a taxa), não o bruto. O rateio acontece na liquidação, não na criação. Estorno e MED debitam `,_jsx(_components.strong,{children:`só o originador`}),` — quem recebeu rateio nunca é debitado.`]}),_jsxs(_components.p,{children:[`Veja `,_jsx(_components.a,{href:`/#split-de-pagamento`,children:`Split de Pagamento`}),` para as regras completas, os exemplos e a tabela de erros.`]})]}),`\n`,_jsxs(Note,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Escolha da instituição.`}),` Se a sua conta tem essa opção habilitada, o campo opcional `,_jsx(_components.code,{children:`pspCredentialId`}),` fixa a instituição que emite esta cobrança, ignorando o roteamento configurado. Copie o ID em `,_jsx(_components.strong,{children:`Configurações → Roteamento`}),` no painel.`]}),_jsxs(_components.p,{children:[`Fixar `,_jsx(_components.strong,{children:`não é preferir`}),`: se a instituição estiver fora do ar ou sem capacidade, a cobrança falha em vez de sair por outra. A resposta ecoa `,_jsx(_components.code,{children:`pspCredentialId`}),` como recibo.`]}),_jsxs(_components.p,{children:[`Veja `,_jsx(_components.a,{href:`/#escolha-da-institui%C3%A7%C3%A3o`,children:`Escolha da Instituição`}),` para as regras completas e a tabela de 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 PIX","openapi":"openapi.json POST /pix","description":"Cria uma cobrança PIX instantânea.\n\n**Permissão requerida:** `PIX:WRITE` ou `FULL_ACCESS`","href":"/api-reference/pix/create"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Cria uma cobrança PIX instantânea.\n\n**Permissão requerida:** `PIX:WRITE` ou `FULL_ACCESS`","operationId":"ExternalPixController_createCharge","parameters":["2dab18f2-cb15-4cae-aa2b-0eb42d8f3344","2601bb0b-fb58-4000-a9b9-a1180527ddfe"],"requestBody":"c7709af5-6002-4f00-a587-8926bae549d8","responses":{"201":"305e6e49-2fbb-4675-ad7f-7f625437adc4","400":"94a4a7bd-53d0-4674-aad6-eba3d01900d7","401":"7bde0d13-0338-4cdc-b52a-80def7fe5f90","404":"4c35e341-cff0-4cf1-bf30-865f57b0c5ea","500":"1a2e167f-ef20-475c-a3d0-3dacdf604664"},"summary":"Criar uma cobrança PIX","tags":["External API - PIX"],"security":["cd4fea5d-695e-49fd-b7e2-fd06a9aa1901"],"method":"post","type":"path","servers":["ef2f18b9-28bc-4e1b-b8e3-83b41308585c"],"path":"/pix","baseUrlOptions":["https://api.jetpag.com/v2"],"title":"Criar uma cobrança PIX","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"2dab18f2-cb15-4cae-aa2b-0eb42d8f3344":{"name":"Idempotency-Key","in":"header","required":false,"description":"Chave única do cliente (8-255 chars) que torna a requisição idempotente. Retentativas com a mesma chave retornam a resposta cacheada (TTL 24h). Mesma chave com body diferente retorna 422.","schema":{"type":"string","minLength":8,"maxLength":255,"isRequired":false,"description":"Chave única do cliente (8-255 chars) que torna a requisição idempotente. Retentativas com a mesma chave retornam a resposta cacheada (TTL 24h). Mesma chave com body diferente retorna 422.","uniqueKey":"","typeLabel":"string"}},"2601bb0b-fb58-4000-a9b9-a1180527ddfe":{"name":"X-Sub-Account","in":"header","required":false,"description":"Reference da subconta em que a operação deve ser executada. Quando omitido, a operação acontece na conta principal; o valor reservado `principal` também resolve para a conta principal e é equivalente a omitir o header. Aceito em todos os endpoints, exceto `POST /auth` e os próprios endpoints de `/sub-accounts`, que sempre operam na conta principal.\n\nErros possíveis: `404 SUB_ACCOUNT_NOT_FOUND`, `403 SUB_ACCOUNT_FORBIDDEN`, `403 SUB_ACCOUNT_SUSPENDED`.\n\nExige que a credencial tenha o **acesso a subcontas** habilitado (Configurações → Integração → Credenciais de API). Ele nasce desligado e não é substituído por nenhuma permissão, nem por `FULL_ACCESS`: sem ele a resposta é `403 SUB_ACCOUNT_FORBIDDEN`.","schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9_-]{1,31}$","example":"loja-centro","isRequired":false,"description":"Reference da subconta em que a operação deve ser executada. Quando omitido, a operação acontece na conta principal; o valor reservado `principal` também resolve para a conta principal e é equivalente a omitir o header. Aceito em todos os endpoints, exceto `POST /auth` e os próprios endpoints de `/sub-accounts`, que sempre operam na conta principal.\n\nErros possíveis: `404 SUB_ACCOUNT_NOT_FOUND`, `403 SUB_ACCOUNT_FORBIDDEN`, `403 SUB_ACCOUNT_SUSPENDED`.\n\nExige que a credencial tenha o **acesso a subcontas** habilitado (Configurações → Integração → Credenciais de API). Ele nasce desligado e não é substituído por nenhuma permissão, nem por `FULL_ACCESS`: sem ele a resposta é `403 SUB_ACCOUNT_FORBIDDEN`.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"amount":{"type":"number","description":"Valor em BRL (ex: 100.50 para R$ 100,50)","minimum":1,"example":150.75,"isRequired":true,"uniqueKey":"amount","typeLabel":"number"},"description":{"type":"string","description":"Descrição da cobrança","maxLength":255,"example":"Pagamento do pedido #12345","isRequired":true,"uniqueKey":"description","typeLabel":"string"},"customer":{"type":"object","description":"Dados do pagador (todos opcionais).","properties":{"name":{"type":"string","description":"Nome do pagador","maxLength":255,"example":"João da Silva","uniqueKey":"customer.name","typeLabel":"string"},"document":{"type":"string","description":"CPF ou CNPJ do pagador, apenas números (opcional)","maxLength":20,"example":"12345678909","uniqueKey":"customer.document","typeLabel":"string"},"email":{"type":"string","description":"E-mail do pagador","format":"email","maxLength":255,"uniqueKey":"customer.email","typeLabel":"string\u003cemail>"},"phone":{"type":"string","description":"Telefone do pagador (formato livre)","maxLength":20,"example":"+5511999998888","uniqueKey":"customer.phone","typeLabel":"string"}},"uniqueKey":"customer","typeLabel":"object"},"projectId":{"type":"string","description":"ID do projeto para associar a transação. Se não informado e a conta tiver um único projeto, a cobrança herda esse projeto; com mais de um, a cobrança fica sem projeto.","format":"uuid","uniqueKey":"projectId","typeLabel":"string\u003cuuid>"},"pspCredentialId":{"type":"string","description":"Fixa a instituição que emite esta cobrança, ignorando o roteamento configurado. Use o ID que aparece em Configurações → Roteamento no painel. Precisa ser uma instituição habilitada e ativa da sua conta. Se ela estiver fora do ar ou sem capacidade, a cobrança FALHA — não cai para outra: você pediu esta. Disponível para contas com a escolha de instituição habilitada.","format":"uuid","example":"6e307aa4-4772-4230-a648-d88cee308f54","uniqueKey":"pspCredentialId","typeLabel":"string\u003cuuid>"},"expiresIn":{"type":"integer","description":"Segundos até expiração (padrão: 86400 = 24h)","minimum":300,"maximum":604800,"example":3600,"uniqueKey":"expiresIn","typeLabel":"integer"},"externalReference":{"type":"string","description":"Seu ID de referência externa","maxLength":255,"example":"pedido-12345","uniqueKey":"externalReference","typeLabel":"string"},"metadata":{"type":"object","description":"Metadados customizados (pares chave-valor)","additionalProperties":true,"example":{"orderId":"12345","source":"website"},"uniqueKey":"metadata","typeLabel":"object"},"split":{"type":"array","description":"Reparte parte do valor com outras subcontas da mesma conta, na liquidação. Quem cria a cobrança é o originador: recebe o valor bruto, paga a taxa cheia e só então reparte — a taxa não é rateada entre os destinatários. A soma do split não pode exceder o líquido (valor da cobrança menos a taxa). Estorno e MED debitam apenas o originador; quem recebeu rateio nunca é debitado.","maxItems":10,"items":{"type":"object","properties":{"subAccount":{"type":"string","description":"Reference de uma subconta ativa da mesma conta que recebe o rateio. A palavra reservada `principal` endereça a conta principal — use quando a cobrança for originada por uma subconta (header `X-Sub-Account`); uma cobrança criada pela própria conta principal não pode ratear para `principal`.","pattern":"^[a-z0-9][a-z0-9_-]{1,31}$","example":"loja-centro","isRequired":true,"uniqueKey":"split.items.[INDEX].subAccount","typeLabel":"string"},"amount":{"type":"number","description":"Valor em BRL destinado a essa carteira. Valor fixo — percentual não é aceito. No máximo 2 casas decimais.","minimum":0.01,"example":30,"isRequired":true,"uniqueKey":"split.items.[INDEX].amount","typeLabel":"number"}},"required":["subAccount","amount"],"uniqueKey":"split.items.[INDEX]","typeLabel":"object"},"uniqueKey":"split","typeLabel":"object[]"}},"required":["amount","description"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"amount":150.75,"description":"Pagamento do pedido #12345","customer":{"name":"João da Silva","document":"12345678909","email":"[email protected]","phone":"+5511999998888"},"projectId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","pspCredentialId":"6e307aa4-4772-4230-a648-d88cee308f54","expiresIn":3600,"externalReference":"pedido-12345","metadata":{"orderId":"12345","source":"website"},"split":[{"subAccount":"loja-centro","amount":30}]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"305e6e49-2fbb-4675-ad7f-7f625437adc4":{"description":"Cobrança PIX criada com sucesso","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"ID da cobrança (ID da transação)","format":"uuid","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"status":{"type":"string","description":"Status da cobrança","enum":["pending","completed","failed","cancelled"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"amount":{"type":"number","description":"Valor em BRL","example":150.75,"isRequired":true,"uniqueKey":"amount","typeLabel":"number"},"currency":{"type":"string","description":"Código da moeda","example":"BRL","isRequired":true,"uniqueKey":"currency","typeLabel":"string"},"pixCopyPaste":{"type":"string","description":"Código PIX copia e cola","example":"00020126580014br.gov.bcb.pix0136a1b2c3d4-e5f6-7890-abcd-ef1234567890","isRequired":true,"uniqueKey":"pixCopyPaste","typeLabel":"string"},"expiresAt":{"type":"string","description":"Data de expiração","format":"date-time","isRequired":true,"uniqueKey":"expiresAt","typeLabel":"string\u003cdate-time>"},"createdAt":{"type":"string","description":"Data de criação","format":"date-time","isRequired":true,"uniqueKey":"createdAt","typeLabel":"string\u003cdate-time>"},"qrCodeBase64":{"type":"string","description":"QR Code do PIX em formato data URI (data:image/png;base64,...)","uniqueKey":"qrCodeBase64","typeLabel":"string"},"pspPaymentId":{"type":"string","description":"ID da transação no provedor de pagamento (PSP). Use para conciliação; ausente se o PSP não retornou o ID na criação.","example":"de3516a2-c63a-4c02-b132-a239bf42e183","uniqueKey":"pspPaymentId","typeLabel":"string"},"pspCredentialId":{"type":"string","description":"Instituição que emitiu esta cobrança. Só vem quando você fixou a instituição no request (`pspCredentialId`), como recibo de que ela foi respeitada.","format":"uuid","example":"6e307aa4-4772-4230-a648-d88cee308f54","uniqueKey":"pspCredentialId","typeLabel":"string\u003cuuid>"},"externalReference":{"type":"string","description":"Seu ID de referência externa","example":"pedido-12345","uniqueKey":"externalReference","typeLabel":"string"},"split":{"type":"array","description":"Rateio aceito, em reais. Presente apenas quando a cobrança foi criada com split — se veio na resposta, as subcontas existiam e a soma cabia no líquido. O que foi efetivamente distribuído chega no webhook payment_completed.","items":{"type":"object","properties":{"subAccount":{"type":"string","description":"Reference da subconta que recebe o rateio, ou `principal` quando o destino é a conta principal","example":"loja-centro","isRequired":true,"uniqueKey":"split.items.[INDEX].subAccount","typeLabel":"string"},"amount":{"type":"number","description":"Valor em BRL destinado a essa carteira","example":30,"isRequired":true,"uniqueKey":"split.items.[INDEX].amount","typeLabel":"number"}},"required":["subAccount","amount"],"uniqueKey":"split.items.[INDEX]","typeLabel":"object"},"uniqueKey":"split","typeLabel":"object[]"}},"required":["id","status","amount","currency","pixCopyPaste","expiresAt","createdAt"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","status":"pending","amount":150.75,"currency":"BRL","pixCopyPaste":"00020126580014br.gov.bcb.pix0136a1b2c3d4-e5f6-7890-abcd-ef1234567890","expiresAt":"2023-11-07T05:31:56Z","createdAt":"2023-11-07T05:31:56Z","qrCodeBase64":"\u003cstring>","pspPaymentId":"de3516a2-c63a-4c02-b132-a239bf42e183","pspCredentialId":"6e307aa4-4772-4230-a648-d88cee308f54","externalReference":"pedido-12345","split":[{"subAccount":"loja-centro","amount":30}]}}},"exampleType":"generated"}},"exampleType":"generated"},"94a4a7bd-53d0-4674-aad6-eba3d01900d7":{"description":"Bad Request - Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","example":400,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"error":{"type":"string","example":"BadRequest","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","example":"name must be longer than or equal to 2 characters","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","example":"2025-12-15T22:00:00.000Z","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string"},"details":{"type":"object","uniqueKey":"details","typeLabel":"object"},"traceId":{"type":"string","uniqueKey":"traceId","typeLabel":"string"}},"required":["statusCode","error","message","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":400,"error":"BadRequest","message":"name must be longer than or equal to 2 characters","timestamp":"2025-12-15T22:00:00.000Z","details":{},"traceId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"7bde0d13-0338-4cdc-b52a-80def7fe5f90":{"description":"Unauthorized - Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","example":401,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"error":{"type":"string","example":"Unauthorized","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","example":"Authentication token is required","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","example":"2025-12-15T22:00:00.000Z","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string"},"details":{"type":"object","uniqueKey":"details","typeLabel":"object"},"traceId":{"type":"string","uniqueKey":"traceId","typeLabel":"string"}},"required":["statusCode","error","message","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":401,"error":"Unauthorized","message":"Authentication token is required","timestamp":"2025-12-15T22:00:00.000Z","details":{},"traceId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"4c35e341-cff0-4cf1-bf30-865f57b0c5ea":{"description":"Not Found - Resource not found","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","example":404,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"error":{"type":"string","example":"NotFound","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","example":"Resource with id 550e8400-e29b-41d4-a716-446655440000 not found","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","example":"2025-12-15T22:00:00.000Z","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string"},"details":{"type":"object","example":{"resource":"Example","id":"550e8400-e29b-41d4-a716-446655440000"},"uniqueKey":"details","typeLabel":"object"},"traceId":{"type":"string","uniqueKey":"traceId","typeLabel":"string"}},"required":["statusCode","error","message","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":404,"error":"NotFound","message":"Resource with id 550e8400-e29b-41d4-a716-446655440000 not found","timestamp":"2025-12-15T22:00:00.000Z","details":{"resource":"Example","id":"550e8400-e29b-41d4-a716-446655440000"},"traceId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"1a2e167f-ef20-475c-a3d0-3dacdf604664":{"description":"Internal Server Error","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","example":500,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"error":{"type":"string","example":"InternalError","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","example":"An unexpected error occurred","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","example":"2025-12-15T22:00:00.000Z","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string"},"details":{"type":"object","uniqueKey":"details","typeLabel":"object"},"traceId":{"type":"string","example":"2771463d58840c8e116dc6dda1e1e5d0","uniqueKey":"traceId","typeLabel":"string"}},"required":["statusCode","error","message","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":500,"error":"InternalError","message":"An unexpected error occurred","timestamp":"2025-12-15T22:00:00.000Z","details":{},"traceId":"2771463d58840c8e116dc6dda1e1e5d0"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"cd4fea5d-695e-49fd-b7e2-fd06a9aa1901":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Access token obtido no POST /auth (client_id + client_secret). Válido por 300 segundos.","scopes":[]}}},"servers":{"ef2f18b9-28bc-4e1b-b8e3-83b41308585c":{"url":"https://api.jetpag.com/v2"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Access token obtido no POST /auth (client_id + client_secret). Válido por 300 segundos.","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Access token obtido no POST /auth (client_id + client_secret). Válido por 300 segundos.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"jetpag","siteName":"Jetpag","title":"Criar Cobrança PIX - Jetpag","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"pt-BR":{"href":"/api-reference/pix/create","matchLevel":0},"en":{"href":"/en/api-reference/pix/create","matchLevel":1},"ru":{"href":"/ru/api-reference/pix/create","matchLevel":1},"cn":{"href":"/cn/api-reference/pix/create","matchLevel":1}}},"lastModified":"2026-09-21T23:36:50.258Z","originalFileLocation":"api-reference/pix/create.mdx","locale":"pt-BR"},"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 instantânea. Permissão requerida: PIX:WRITE ou FULL_ACCESS\">\u003cmeta data-mint-head name=\"application-name\" content=\"Jetpag\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/jetpag/3DSjF1bJYug6UZRD/_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/jetpag/3DSjF1bJYug6UZRD/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/jetpag/3DSjF1bJYug6UZRD/_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/jetpag/3DSjF1bJYug6UZRD/_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/jetpag/3DSjF1bJYug6UZRD/_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/jetpag/3DSjF1bJYug6UZRD/_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/jetpag/3DSjF1bJYug6UZRD/_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/jetpag/3DSjF1bJYug6UZRD/_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/jetpag/3DSjF1bJYug6UZRD/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Criar Cobrança PIX - Jetpag\">\u003cmeta data-mint-head property=\"og:description\" content=\"Cria uma cobrança PIX instantânea. Permissão requerida: PIX:WRITE ou FULL_ACCESS\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Jetpag\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.jetpag.com/api-reference/pix/create\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://jetpag.mintlify.site/_mintlify/api/og/v2?division=PIX\u0026amp;title=Criar+Cobran%C3%A7a+PIX\u0026amp;description=Cria+uma+cobran%C3%A7a+PIX+instant%C3%A2nea.%0A%0A**Permiss%C3%A3o+requerida%3A**+%60PIX%3AWRITE%60+ou+%60FULL_ACCESS%60\u0026amp;theme=99f5733103b5ec295c3eca6e\u0026amp;signature=ebbdc01f25ba4c466a4fa17bb6a894634a38d1f6406c6db32349f75a38da1425\">\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 PIX - Jetpag\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Cria uma cobrança PIX instantânea. Permissão requerida: PIX:WRITE ou FULL_ACCESS\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://jetpag.mintlify.site/_mintlify/api/og/v2?division=PIX\u0026amp;title=Criar+Cobran%C3%A7a+PIX\u0026amp;description=Cria+uma+cobran%C3%A7a+PIX+instant%C3%A2nea.%0A%0A**Permiss%C3%A3o+requerida%3A**+%60PIX%3AWRITE%60+ou+%60FULL_ACCESS%60\u0026amp;theme=99f5733103b5ec295c3eca6e\u0026amp;signature=ebbdc01f25ba4c466a4fa17bb6a894634a38d1f6406c6db32349f75a38da1425\">\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/jetpag/3DSjF1bJYug6UZRD/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Jetpag\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#18181b\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.jetpag.com/api-reference/pix/create\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/pix/create.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt-BR\" href=\"https://docs.jetpag.com/api-reference/pix/create\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.jetpag.com/en/api-reference/pix/create\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ru\" href=\"https://docs.jetpag.com/ru/api-reference/pix/create\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.jetpag.com/cn/api-reference/pix/create\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.jetpag.com/api-reference/pix/create\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.jetpag.com/#organization\",\"name\":\"Jetpag\",\"url\":\"https://docs.jetpag.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/jetpag/lKCj1ucL64b7J4qL/logo/light.svg?fit=max\u0026auto=format\u0026n=lKCj1ucL64b7J4qL\u0026q=85\u0026s=b561a1a87be045a48745c62887a84e2b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.jetpag.com#website\",\"name\":\"Jetpag\",\"url\":\"https://docs.jetpag.com\",\"publisher\":{\"@id\":\"https://docs.jetpag.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.jetpag.com/api-reference/pix/create#webpage\",\"url\":\"https://docs.jetpag.com/api-reference/pix/create\",\"name\":\"Criar Cobrança PIX\",\"description\":\"Cria uma cobrança PIX instantânea. Permissão requerida: PIX:WRITE ou FULL_ACCESS\",\"dateModified\":\"2026-09-21T23:36:50.258Z\",\"isPartOf\":{\"@id\":\"https://docs.jetpag.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.jetpag.com/api-reference/pix/create#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.jetpag.com/api-reference/pix/create#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Jetpag\",\"item\":\"https://docs.jetpag.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Criar Cobrança PIX\",\"item\":\"https://docs.jetpag.com/api-reference/pix/create\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.jetpag.com/api-reference/pix/create#apireference\",\"headline\":\"Criar Cobrança PIX\",\"name\":\"Criar Cobrança PIX\",\"description\":\"Cria uma cobrança PIX instantânea. Permissão requerida: PIX:WRITE ou FULL_ACCESS\",\"url\":\"https://docs.jetpag.com/api-reference/pix/create\",\"mainEntityOfPage\":{\"@id\":\"https://docs.jetpag.com/api-reference/pix/create#webpage\"},\"dateModified\":\"2026-09-21T23:36:50.258Z\",\"publisher\":{\"@id\":\"https://docs.jetpag.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.jetpag.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Jetpag\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Jetpag\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/pix/create.md","siteName":"Jetpag","nav":{"global":{"anchors":[{"anchor":"Dashboard","icon":"gauge","href":"https://banking.jetpag.com"}]},"languages":[{"language":"pt-BR","groups":[{"group":"Visão Geral","pages":[{"title":"Introdução","href":""},{"title":"Webhooks","href":"/api-reference/webhooks"}]},{"group":"Autenticação","pages":[{"title":"Gerar Access Token","openapi":"openapi.json POST /auth","href":"/api-reference/auth/token"}]},{"group":"Conta","pages":[{"title":"Obter Dados da Conta","openapi":"openapi.json GET /account","description":"Retorna os dados da conta, informações da empresa e saldo disponível.\n\n**Permissão requerida:** `ACCOUNT:READ` ou `FULL_ACCESS`","href":"/api-reference/account/get"}]},{"group":"PIX","pages":[{"title":"Criar Cobrança PIX","openapi":"openapi.json POST /pix","href":"/api-reference/pix/create"}]},{"group":"Saques","pages":[{"title":"Criar Saque PIX","openapi":"openapi.json POST /withdrawals","description":"Cria um novo saque via PIX informando os dados da chave PIX e do titular da conta destino.\n\n**Permissão requerida:** `WITHDRAWAL:WRITE` ou `FULL_ACCESS`\n\n**Restrição de IP:** Se a credencial tiver uma lista de IPs permitidos configurada, requisições fora dela são rejeitadas com `403`. Recomendado para credenciais com esta permissão.","href":"/api-reference/withdrawals/create"}]},{"group":"Transações","pages":[{"title":"Buscar Transação","openapi":"openapi.json GET /transactions/{id}","href":"/api-reference/transactions/get"},{"title":"Solicitar Reembolso","openapi":"openapi.json POST /transactions/{id}/refund","href":"/api-reference/transactions/refund"}]},{"group":"Bloqueios de Saldo","pages":[{"title":"Listar Bloqueios de Saldo","openapi":"openapi.json GET /balance-blocks","href":"/api-reference/balance-blocks/list"}]},{"group":"Projetos","pages":[{"title":"Criar Projeto","openapi":"openapi.json POST /projects","href":"/api-reference/projects/create"},{"title":"Listar Projetos","openapi":"openapi.json GET /projects","href":"/api-reference/projects/list"}]},{"group":"Subcontas","pages":[{"title":"Criar Subconta","openapi":"openapi.json POST /sub-accounts","href":"/api-reference/sub-accounts/create"},{"title":"Listar Subcontas","openapi":"openapi.json GET /sub-accounts","href":"/api-reference/sub-accounts/list"}]}]},{"language":"en","pages":[{"title":"en","href":"/en/api-reference/pix/create"}]},{"language":"ru","pages":[{"title":"ru","href":"/ru/api-reference/pix/create"}]},{"language":"cn","pages":[{"title":"cn","href":"/cn/api-reference/pix/create"}]}]},"basePath":"","title":"Criar Cobrança PIX - Jetpag","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CrDfRf61.js","snippetPresets-Dv-cOUrx.js","utils-BUTreAgv.js","style-to-object-BY3JEAdk.js","utils-wsznt9RM.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-DEsMlaPy.js","conditional-requirements-CFM0id0Q.js","cloneDeep-DontW4xJ.js","_Uint8Array-pP7X6_RM.js","isObject-FP1Yky1u.js","ApiExamples-CU_aGGP0.js","usePlaygroundInputsStore-7dNmUIbS.js","shallow-fTtruD8x.js","isEqual-BRfNFpSD.js","CodeSnippets-52884wUJ.js","CodeSnippet-eoRjC4Le.js","getApiPlaygroundDisplay-CZyAPlR2.js","Page-Cr9IwkK7.js","DynamicMarkdown-NFqqduU7.js","SectionHeading-DQ-mJoAt.js","icon-DXTBUt6s.js","MethodPill-2v-b3js5.js","getPastedJson-v_8Y1_4v.js","DuplicateIcon-DXIkhZIo.js","createIcon-DRpYuPZs.js","axios-CsQoIw0U.js","Markdown-CwtoSfEf.js","AssistantPageLink-CTqa3eoi.js","dist-DIfYWxfm.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}