{ "item": [ { "id": "8ec2b261-9fe7-4455-b063-804dbfe35bf2", "name": "Primeiros passos", "description": { "content": "A chave de sandbox e a verificação de que o serviço está no ar.", "type": "text/plain" }, "item": [ { "id": "ed58566a-2b9c-4420-9aee-dc6216830ce4", "name": "Verifica se o serviço está no ar", "request": { "name": "Verifica se o serviço está no ar", "description": { "content": "Não consulta o provedor bancário de propósito: um BaaS lento faria o\nbalanceador tirar do ar uma instância perfeitamente saudável.\n", "type": "text/plain" }, "url": { "path": [ "health" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "e62661ba-f2d3-46af-ac88-471639984255", "name": "No ar", "originalRequest": { "url": { "path": [ "health" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"ok\",\n \"time\": \"2013-01-08T10:41:24.114Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ac75b45c-dcf0-4219-980b-b5d95544607d", "name": "Verifica se a instância está apta a receber tráfego", "request": { "name": "Verifica se a instância está apta a receber tráfego", "description": { "content": "Separado do `/health` de propósito: vivo e apto são perguntas\ndiferentes, com consequências diferentes. O supervisor reinicia quem\nnão está vivo; o balanceador tira do ar quem não está apto. Misturar as\nduas faz um banco lento reiniciar todas as instâncias ao mesmo tempo, e\né assim que uma indisponibilidade parcial vira total.\n\nAo contrário do `/health`, este confere o banco de dados.\n", "type": "text/plain" }, "url": { "path": [ "ready" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "51ec50c4-33b4-4222-970f-aa1bee44837a", "name": "Apta", "originalRequest": { "url": { "path": [ "ready" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"ready\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8db396b5-241a-4a47-aa18-4fcfdf25169a", "name": "Dependência essencial indisponível", "originalRequest": { "url": { "path": [ "ready" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"unavailable\",\n \"reason\": \"repositório indisponível\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8ac88906-a448-430a-8b25-520d3c8b0ec8", "name": "Lista as funcionalidades ligadas nesta instalação", "request": { "name": "Lista as funcionalidades ligadas nesta instalação", "description": { "content": "Cada instalação liga só o que o seu provedor bancário oferece. Esta\nrota diz o que está ligado, para a tela esconder o que não está em vez\nde mostrar um botão que vai responder `403 FEATURE_DISABLED`.\n\nPública, como o `/health`: a tela de entrada precisa saber, antes do\nlogin, se oferece \"abrir conta\". A resposta é a mesma para todo mundo e\nsó muda quando a instalação é reconfigurada; não traz provedor,\nambiente nem configuração.\n\nTraz também o nome público da instituição prestadora da instalação\n(`institution`), que a tela imprime na linha \"Instituição\" dos\ncomprovantes.\n", "type": "text/plain" }, "url": { "path": [ "v1", "features" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "f73d21e7-c65f-4a32-b89c-a727195b7d73", "name": "Funcionalidades ligadas", "originalRequest": { "url": { "path": [ "v1", "features" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"features\": [\n \"pix_transfer\",\n \"pix_keys\",\n \"pix_qr\",\n \"billet_issue\",\n \"bill_payment\"\n ],\n \"accountOpening\": {\n \"enabled\": false,\n \"mode\": \"own\",\n \"emailConfirmation\": true\n },\n \"institution\": {\n \"name\": \"Azimut Brasil DTVM\",\n \"cnpj\": \"consectetur ea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "eb0ea2e3-b9d8-4c1b-ab8a-c431b3863c02", "name": "Limite de requisições atingido. O cabeçalho `Retry-After` diz quantos\nsegundos esperar.\n", "originalRequest": { "url": { "path": [ "v1", "features" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8da7f715-983d-4392-b5a9-ff2ccff79fc6", "name": "Versão do app que a instalação anuncia", "request": { "name": "Versão do app que a instalação anuncia", "description": { "content": "A versão mais nova do app publicada para cada plataforma, a mínima que\nainda opera e onde atualizar. O app compara com a própria versão (o\n`version` do `app.json`): abaixo de `latestVersion`, avisa que há\nversão nova; abaixo de `minimumVersion`, bloqueia o uso até atualizar.\n\nPública, como `/v1/features`: o aviso aparece também na tela de\nentrada, antes do login. A resposta é a mesma para todo mundo e só muda\nquando a instalação é reconfigurada (`LUME_APP__*`).\nPlataforma não configurada não vem; sem nenhuma, o corpo é `{}` e o\napp segue sem aviso.\n", "type": "text/plain" }, "url": { "path": [ "v1", "app", "versions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "1340bf32-ab38-4106-b3dc-a839d688f5be", "name": "Versões anunciadas, por plataforma", "originalRequest": { "url": { "path": [ "v1", "app", "versions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ios\": {\n \"latestVersion\": \"0.2.0\",\n \"minimumVersion\": \"0.1.0\",\n \"updateUrl\": \"itms-beta://beta.itunes.apple.com/v1/app/6828064942\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b4e783c9-30c8-430d-bf2d-c9ed00ed9cb9", "name": "Limite de requisições atingido. O cabeçalho `Retry-After` diz quantos\nsegundos esperar.\n", "originalRequest": { "url": { "path": [ "v1", "app", "versions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8e5da56d-63a7-49af-ad62-5c1ccd2edc58", "name": "Emite uma chave de sandbox", "request": { "name": "Emite uma chave de sandbox", "description": { "content": "Cria uma chave de API **e** uma conta de testes isolada, com saldo\nfictício de R$ 5.000,00, uma chave PIX já cadastrada e credenciais para\nabrir a mesma conta no internet banking.\n\nSem aprovação e sem confirmação de e-mail: no sandbox nada é real. O que\nexiste é teto — cinco chaves por e-mail por dia e, por endereço de\norigem, dez de imediato e depois uma por minuto (`429` com\n`Retry-After`).\n\n**O segredo aparece uma única vez.** Não há endpoint que o mostre de\nnovo; guardá-lo para poder reexibi-lo transformaria o banco de dados\nnuma lista de credenciais em claro. Perdeu, emite outra.\n\nEste endpoint só existe no sandbox. Em produção ele responde `403`:\nchave de produção é processo comercial, emitida depois da assinatura.\nFora de produção também responde `403` quando a instalação não ligou o\nautoatendimento (`LUME_SANDBOX_KEYS=true`) ou não roda o provedor de\npagamentos simulado: a conta que ele cria só é inofensiva onde o\ndinheiro é fictício.\n", "type": "text/plain" }, "url": { "path": [ "v1", "sandbox", "keys" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"email\": \"dev@integradora.com.br\",\n \"company\": \"Integradora Ltda\",\n \"label\": \"Ambiente local do Bruno\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "ca86ba90-369d-4ad8-9859-1dc826a1b08a", "name": "Chave e conta de testes criadas", "originalRequest": { "url": { "path": [ "v1", "sandbox", "keys" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"email\": \"dev@integradora.com.br\",\n \"company\": \"Integradora Ltda\",\n \"label\": \"Ambiente local do Bruno\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"apiKey\": \"lume_sk_sandbox_k7m2p9qr4tvxaz3n6hjd8swy5cbe2fgk4mpq\",\n \"prefix\": \"lume_sk_sandbox_k7m2p9qr\",\n \"environment\": \"sandbox\",\n \"header\": \"X-API-Key\",\n \"scopes\": [\n \"accounts:read\",\n \"pix:read\",\n \"pix:write\",\n \"pix:keys:write\",\n \"beneficiaries:write\"\n ],\n \"rateLimitPerMinute\": 60,\n \"expiresAfterDaysIdle\": 30,\n \"account\": {\n \"id\": \"acc_sbx_9f2c1a7b\",\n \"branch\": \"0001\",\n \"number\": \"900142-2\",\n \"name\": \"Integradora Ltda (teste)\",\n \"balanceCents\": 500000\n },\n \"credentials\": {\n \"document\": \"52998224725\",\n \"password\": \"sbx-3k9mqp2tvxza7nhd\",\n \"totpSecret\": \"SEGREDO-BASE32-DA-CONTA-DE-SANDBOX\",\n \"totpUri\": \"otpauth://totp/Lume%20Sandbox:dev@integradora.com.br?secret=...\"\n },\n \"warning\": \"sunt mollit\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "16b63187-5be5-4f07-a0c8-c9710c61328b", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "sandbox", "keys" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"email\": \"dev@integradora.com.br\",\n \"company\": \"Integradora Ltda\",\n \"label\": \"Ambiente local do Bruno\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aa78ca8f-4ce4-48f1-a0a9-16b83c3bbd69", "name": "Requisição malformada ou com dado inválido", "originalRequest": { "url": { "path": [ "v1", "sandbox", "keys" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"email\": \"dev@integradora.com.br\",\n \"company\": \"Integradora Ltda\",\n \"label\": \"Ambiente local do Bruno\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4ad0de8c-5f1d-4850-a2b0-ceb2317ba329", "name": "Limite de requisições atingido. O cabeçalho `Retry-After` diz quantos\nsegundos esperar.\n", "originalRequest": { "url": { "path": [ "v1", "sandbox", "keys" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"email\": \"dev@integradora.com.br\",\n \"company\": \"Integradora Ltda\",\n \"label\": \"Ambiente local do Bruno\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "2176e8af-30b7-49b0-a0d0-e171ed82c3c4", "name": "Autenticação", "description": { "content": "Duas credenciais diferentes, para dois usos diferentes.\n\n**Chave de API** (`X-API-Key`) é a credencial de integração\nservidor-a-servidor. Não expira por tempo, expira por 30 dias de\ninatividade, e é revogável a qualquer momento. Com a conta bloqueada\nou encerrada, toda chamada com a chave responde `403` com\n`code: FORBIDDEN`; reativada a conta, a chave volta a valer.\n\nCada chave carrega **escopos**, e uma chave só alcança o que os seus\nescopos permitem:\n\n| Escopo | O que abre |\n| --- | --- |\n| `accounts:read` | Perfil, saldo, extrato, transação, limites, beneficiários, trilha de segurança e tabela e cotação de tarifas |\n| `pix:read` | Listar chaves, consultar o DICT, ler um BR Code, listar cobranças por QR Code |\n| `pix:write` | Transferir, emitir BR Code e gerar ou excluir cobranças por QR Code |\n| `pix:keys:write` | Cadastrar chave PIX (excluir é só de sessão) |\n| `beneficiaries:write` | Cadastrar e excluir beneficiário |\n\nA chave de sandbox nasce com todos: o ambiente existe para ser\nexercitado inteiro. A chave de produção nasce **só com\n`accounts:read`** — quem precisa mover dinheiro pede na emissão.\n\nAlgumas rotas não são alcançáveis por chave de API, com escopo nenhum, e\nno contrato declaram `security` só de sessão: `POST /v1/auth/step-up`,\nporque o segundo fator é um ato humano; `POST /v1/transactions/{id}/review`,\nporque decidir sobre a própria transação retida é do titular da conta;\n`POST /v1/transactions/{id}/refund`, porque devolver Pix recebido é\ndinheiro saindo da conta, com segundo fator;\n`POST /v1/ted/transfers`; a cobrança por boleto (`/v1/billets`) e o\npagamento de contas (`/v1/billets/lookup` e `/v1/billets/pay`), que só\nexistem para a sessão de quem está na tela. Chave de API nelas, ou\nfalta de escopo nas demais, devolve `403` com `code: FORBIDDEN`.\n\n**Sessão** (`Authorization: Bearer`) é a credencial de quem está numa\ntela: documento e senha, depois código do aplicativo autenticador. O\ntoken de acesso vale 15 minutos e o de renovação, 30 dias, com rotação a\ncada uso.\n\nAlém das duas, o **step-up** (`X-Step-Up`) é uma prova de segundo fator\namarrada a *uma* operação: aprovar uma transferência de R$ 50 não\nautoriza a próxima de R$ 50 mil.\n", "type": "text/plain" }, "item": [ { "id": "d89133f3-ba6b-4d22-aee2-c6f55597ff9c", "name": "Primeira etapa do acesso interativo", "request": { "name": "Primeira etapa do acesso interativo", "description": { "content": "A senha sozinha nunca abre sessão. O token devolvido aqui só serve para\napresentar o segundo fator em `POST /v1/auth/mfa`, e vale 5 minutos.\n\nA resposta é idêntica para documento inexistente e senha errada,\ninclusive no tempo de resposta: responder diferente entregaria quem é\ncliente do banco.\n", "type": "text/plain" }, "url": { "path": [ "v1", "auth", "login" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"document\": \"123.456.789-09\",\n \"password\": \"lume-demo-2026\",\n \"deviceFingerprint\": \"b7f3c1e9a2d84f60\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "aa5009d2-61fc-49a9-9dda-b9cebbed0ddb", "name": "Senha aceita; falta o segundo fator", "originalRequest": { "url": { "path": [ "v1", "auth", "login" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"document\": \"123.456.789-09\",\n \"password\": \"lume-demo-2026\",\n \"deviceFingerprint\": \"b7f3c1e9a2d84f60\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"mfaToken\": \"laboris Ut in\",\n \"mfaRequired\": true,\n \"newDevice\": false,\n \"enrollment\": true,\n \"enrollToken\": \"fugi\",\n \"totpSecret\": \"minim magna\",\n \"otpauthUri\": \"in dolor quis\",\n \"onboarding\": true,\n \"onboardingToken\": \"do consectetur ullamco exer\",\n \"mode\": \"hosted\",\n \"stage\": \"CUSTOMER_CREATED\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6e8f3c7b-d70a-49ec-9d2c-fb9ff14aaa55", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "auth", "login" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"document\": \"123.456.789-09\",\n \"password\": \"lume-demo-2026\",\n \"deviceFingerprint\": \"b7f3c1e9a2d84f60\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "377fba25-8a82-4e5f-bf79-8628dbb8fb2f", "name": "Requisição malformada ou com dado inválido", "originalRequest": { "url": { "path": [ "v1", "auth", "login" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"document\": \"123.456.789-09\",\n \"password\": \"lume-demo-2026\",\n \"deviceFingerprint\": \"b7f3c1e9a2d84f60\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c666b11b-41aa-4c1b-8b02-12a46d88f150", "name": "Trava depois de cinco erros em quinze minutos (`TOO_MANY_ATTEMPTS`).\nOs erros são contados no servidor, e não só no processo — reiniciar a\nAPI não os zera —, e `Retry-After` diz quantos segundos faltam.\n\nNas etapas que exigem a posse de um fator (código do autenticador,\nconfirmação adicional, cadastro do autenticador, troca de senha) a\ntrava escalona por identidade: 5 erros, 15 minutos; 10 erros, 1 hora;\n20 erros, 24 horas — cerca de vinte palpites por ciclo de um dia e\nmeio; tentar de outro aparelho não adianta. Nas etapas por\nidentificador público (senha no login, recuperação de senha, login do\noperador) o documento ou o e-mail não trava: trava, e escalona, só a\ncombinação documento + origem (endereço) de quem insiste, para que\nsaber um CPF ou o e-mail de um operador não baste para trancar o dono,\nque entra de outro lugar. Os erros do documento ou do e-mail, somados\nde todas as origens, avisam o titular (ou o operador) por e-mail do\nsegundo degrau em diante. Um acesso concluído com senha e segundo\nfator, ou uma recuperação de senha concluída, zera as travas do\ndocumento; para o operador, também a redefinição da senha ou do\nautenticador por outro administrador.\n", "originalRequest": { "url": { "path": [ "v1", "auth", "login" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"document\": \"123.456.789-09\",\n \"password\": \"lume-demo-2026\",\n \"deviceFingerprint\": \"b7f3c1e9a2d84f60\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c6464f25-6dc8-4651-8458-fa582457b003", "name": "Pede o código do primeiro acesso", "request": { "name": "Pede o código do primeiro acesso", "description": { "content": "Para o cliente que o atendimento abriu no backoffice: o atendente não\nrecebe senha, e o cliente a cria no \"Primeiro acesso\". Este pedido\nenvia um código de seis dígitos ao contato cadastrado na abertura\n(e-mail ou celular, o canal escolhido pelo atendente; o destino nunca\nvem do pedido). O código vale 10 minutos, há 60 segundos entre dois\nenvios ao mesmo destino e tetos por documento, destino e IP. Enquanto\no código enviado vale, um pedido novo ao mesmo destino não envia outro\nnem anula o que foi enviado; os tetos de destino e de titular são\nmenores que os do contato verificado na sessão (2 por hora e 3 por dia\nao mesmo destino), e contados à parte dos dele.\n\nA resposta é sempre `202`, exista ou não o documento e tenha ou não\nprimeiro acesso pendente: responder diferente entregaria quem é cliente\ndo banco. Não depende da funcionalidade de abertura de conta, porque o\ncliente já aberto precisa dela.\n", "type": "text/plain" }, "url": { "path": [ "v1", "auth", "password", "setup", "request" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"document\": \"123.456.789-09\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "d16aa14c-e306-4570-b20e-a7fe43a25440", "name": "Pedido aceito. Se havia primeiro acesso pendente, o código foi enviado.", "originalRequest": { "url": { "path": [ "v1", "auth", "password", "setup", "request" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"document\": \"123.456.789-09\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Accepted", "code": 202, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"message\": \"sunt sint enim velit dolore\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "230c3935-b8c6-422f-a3c6-39ca14011f54", "name": "Requisição malformada ou com dado inválido", "originalRequest": { "url": { "path": [ "v1", "auth", "password", "setup", "request" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"document\": \"123.456.789-09\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4a176a6c-bc26-41a0-8954-6205bc139fd9", "name": "Trava depois de cinco erros em quinze minutos (`TOO_MANY_ATTEMPTS`).\nOs erros são contados no servidor, e não só no processo — reiniciar a\nAPI não os zera —, e `Retry-After` diz quantos segundos faltam.\n\nNas etapas que exigem a posse de um fator (código do autenticador,\nconfirmação adicional, cadastro do autenticador, troca de senha) a\ntrava escalona por identidade: 5 erros, 15 minutos; 10 erros, 1 hora;\n20 erros, 24 horas — cerca de vinte palpites por ciclo de um dia e\nmeio; tentar de outro aparelho não adianta. Nas etapas por\nidentificador público (senha no login, recuperação de senha, login do\noperador) o documento ou o e-mail não trava: trava, e escalona, só a\ncombinação documento + origem (endereço) de quem insiste, para que\nsaber um CPF ou o e-mail de um operador não baste para trancar o dono,\nque entra de outro lugar. Os erros do documento ou do e-mail, somados\nde todas as origens, avisam o titular (ou o operador) por e-mail do\nsegundo degrau em diante. Um acesso concluído com senha e segundo\nfator, ou uma recuperação de senha concluída, zera as travas do\ndocumento; para o operador, também a redefinição da senha ou do\nautenticador por outro administrador.\n", "originalRequest": { "url": { "path": [ "v1", "auth", "password", "setup", "request" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"document\": \"123.456.789-09\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "580ba1c6-2572-4354-b3f6-0cb68498de34", "name": "Cria a senha no primeiro acesso", "request": { "name": "Cria a senha no primeiro acesso", "description": { "content": "Confere o código recebido em `POST /v1/auth/password/setup/request`,\naplica a política de senha e grava a senha do cliente. Depois, o login\nnormal (`POST /v1/auth/login`) leva ao cadastro do segundo fator.\n\nCódigo errado, vencido, já usado ou sem pedido, e documento sem primeiro\nacesso pendente, respondem o mesmo `422`: nada diz qual aconteceu. Cada\nerro conta como tentativa do documento, e no teto (5 em 15 minutos) a\nresposta é `429`, para documento existente ou não. Senha fora da\npolítica é `422` e não gasta o código. O código vale uma vez só.\n", "type": "text/plain" }, "url": { "path": [ "v1", "auth", "password", "setup" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"document\": \"123.456.789-09\",\n \"code\": \"482913\",\n \"password\": \"id Lorem velit\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "e4568da7-174a-4cc4-b7fe-ec54c461c159", "name": "Senha criada.", "originalRequest": { "url": { "path": [ "v1", "auth", "password", "setup" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"document\": \"123.456.789-09\",\n \"code\": \"482913\",\n \"password\": \"id Lorem velit\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "No Content", "code": 204, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "cb23417b-38a0-454b-a3e2-ac129522fcd4", "name": "Requisição malformada ou com dado inválido", "originalRequest": { "url": { "path": [ "v1", "auth", "password", "setup" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"document\": \"123.456.789-09\",\n \"code\": \"482913\",\n \"password\": \"id Lorem velit\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d006cd36-dd17-48b2-95aa-9abd469acd5d", "name": "Trava depois de cinco erros em quinze minutos (`TOO_MANY_ATTEMPTS`).\nOs erros são contados no servidor, e não só no processo — reiniciar a\nAPI não os zera —, e `Retry-After` diz quantos segundos faltam.\n\nNas etapas que exigem a posse de um fator (código do autenticador,\nconfirmação adicional, cadastro do autenticador, troca de senha) a\ntrava escalona por identidade: 5 erros, 15 minutos; 10 erros, 1 hora;\n20 erros, 24 horas — cerca de vinte palpites por ciclo de um dia e\nmeio; tentar de outro aparelho não adianta. Nas etapas por\nidentificador público (senha no login, recuperação de senha, login do\noperador) o documento ou o e-mail não trava: trava, e escalona, só a\ncombinação documento + origem (endereço) de quem insiste, para que\nsaber um CPF ou o e-mail de um operador não baste para trancar o dono,\nque entra de outro lugar. Os erros do documento ou do e-mail, somados\nde todas as origens, avisam o titular (ou o operador) por e-mail do\nsegundo degrau em diante. Um acesso concluído com senha e segundo\nfator, ou uma recuperação de senha concluída, zera as travas do\ndocumento; para o operador, também a redefinição da senha ou do\nautenticador por outro administrador.\n", "originalRequest": { "url": { "path": [ "v1", "auth", "password", "setup" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"document\": \"123.456.789-09\",\n \"code\": \"482913\",\n \"password\": \"id Lorem velit\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5ac766b8-ae33-41d0-9d12-eda6b783508e", "name": "Pede o código para recuperar a senha", "request": { "name": "Pede o código para recuperar a senha", "description": { "content": "\"Esqueci a senha\", para quem já tem senha. Envia um código de seis\ndígitos ao contato cadastrado: o e-mail, ou o celular quando a conta\nfoi aberta com envio por SMS. O destino nunca vem do pedido. O código\nvale 10 minutos, há 60 segundos entre dois envios ao mesmo destino e\nhá tetos por documento, destino e IP. Enquanto o código enviado vale,\num pedido novo ao mesmo destino não envia outro nem anula o que foi\nenviado; os tetos são os do primeiro acesso (2 por hora e 3 por dia ao\nmesmo destino).\n\nA resposta é sempre `202`, exista ou não o documento: responder\ndiferente entregaria quem é cliente do banco. Quem tem primeiro acesso\npendente não recebe código aqui; o caminho dele é\n`POST /v1/auth/password/setup/request`.\n", "type": "text/plain" }, "url": { "path": [ "v1", "auth", "password", "reset", "request" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"document\": \"123.456.789-09\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "0fd2675d-770c-4d48-ad05-7a4dfcbeab06", "name": "Pedido aceito. Se o documento tem cadastro com senha, o código foi enviado.", "originalRequest": { "url": { "path": [ "v1", "auth", "password", "reset", "request" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"document\": \"123.456.789-09\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Accepted", "code": 202, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"message\": \"sunt sint enim velit dolore\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9be43500-457a-4917-a29c-f730c84ee5de", "name": "Requisição malformada ou com dado inválido", "originalRequest": { "url": { "path": [ "v1", "auth", "password", "reset", "request" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"document\": \"123.456.789-09\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "617ee8f8-0df4-4b92-ac44-51495d7c0fcb", "name": "Trava depois de cinco erros em quinze minutos (`TOO_MANY_ATTEMPTS`).\nOs erros são contados no servidor, e não só no processo — reiniciar a\nAPI não os zera —, e `Retry-After` diz quantos segundos faltam.\n\nNas etapas que exigem a posse de um fator (código do autenticador,\nconfirmação adicional, cadastro do autenticador, troca de senha) a\ntrava escalona por identidade: 5 erros, 15 minutos; 10 erros, 1 hora;\n20 erros, 24 horas — cerca de vinte palpites por ciclo de um dia e\nmeio; tentar de outro aparelho não adianta. Nas etapas por\nidentificador público (senha no login, recuperação de senha, login do\noperador) o documento ou o e-mail não trava: trava, e escalona, só a\ncombinação documento + origem (endereço) de quem insiste, para que\nsaber um CPF ou o e-mail de um operador não baste para trancar o dono,\nque entra de outro lugar. Os erros do documento ou do e-mail, somados\nde todas as origens, avisam o titular (ou o operador) por e-mail do\nsegundo degrau em diante. Um acesso concluído com senha e segundo\nfator, ou uma recuperação de senha concluída, zera as travas do\ndocumento; para o operador, também a redefinição da senha ou do\nautenticador por outro administrador.\n", "originalRequest": { "url": { "path": [ "v1", "auth", "password", "reset", "request" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"document\": \"123.456.789-09\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6ba12d98-2827-4033-a4b1-913ab907b190", "name": "Define uma senha nova com o código recebido e o do autenticador", "request": { "name": "Define uma senha nova com o código recebido e o do autenticador", "description": { "content": "Confere dois códigos: o recebido em\n`POST /v1/auth/password/reset/request` e o do aplicativo autenticador\n(`totpCode`), quando a conta já cadastrou o segundo fator. Só o código\ndo contato não basta, porque quem invadiu o e-mail tomaria a conta.\nQuem perdeu o autenticador, ou ainda não o cadastrou, recupera o acesso\npelo atendimento: sem segundo fator cadastrado, a resposta é o mesmo `422`.\nExceção: quem ainda não é cliente de fato (sem autenticador, com todas\nas contas próprias em abertura, sem representar nenhum titular e com o\ncadastro da abertura ainda não enviado para análise) troca a senha só\ncom o código do contato, e `totpCode` pode ir vazio.\n\nA ordem das conferências:\n\n1. senha fora da política: `422`, antes de tudo, sem gastar código\n nenhum;\n2. código do autenticador errado: `422`, sem gastar o código do\n contato;\n3. código do contato errado, vencido, já usado ou sem pedido, e\n documento sem cadastro: o mesmo `422`, com a mesma mensagem.\n\nCada erro conta como tentativa do documento a partir desta origem\n(endereço). No teto (5 em 15 minutos) a resposta é `429`, exista ou\nnão o documento; de outra origem, a recuperação continua.\n\nCom os dois códigos certos, a senha é gravada e **todas** as sessões do\ntitular são encerradas na mesma transação, em todos os aparelhos. A\ntrava de tentativas do login do documento é liberada, e a troca entra\nno histórico de segurança como `PASSWORD_CHANGE`. O código do contato\nvale uma vez só.\n", "type": "text/plain" }, "url": { "path": [ "v1", "auth", "password", "reset" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"document\": \"123.456.789-09\",\n \"code\": \"482913\",\n \"password\": \"ut dolor nisi qui\",\n \"totpCode\": \"731045\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "b65247ca-8d44-4e02-9439-2bcad7523978", "name": "Senha redefinida, e todas as sessões encerradas.", "originalRequest": { "url": { "path": [ "v1", "auth", "password", "reset" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"document\": \"123.456.789-09\",\n \"code\": \"482913\",\n \"password\": \"ut dolor nisi qui\",\n \"totpCode\": \"731045\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "No Content", "code": 204, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "9a88669b-b9e0-49f0-9e6e-460a4fa9edf3", "name": "Requisição malformada ou com dado inválido", "originalRequest": { "url": { "path": [ "v1", "auth", "password", "reset" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"document\": \"123.456.789-09\",\n \"code\": \"482913\",\n \"password\": \"ut dolor nisi qui\",\n \"totpCode\": \"731045\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "249b902f-2ab5-4e2c-a787-047a3b05c9c6", "name": "Trava depois de cinco erros em quinze minutos (`TOO_MANY_ATTEMPTS`).\nOs erros são contados no servidor, e não só no processo — reiniciar a\nAPI não os zera —, e `Retry-After` diz quantos segundos faltam.\n\nNas etapas que exigem a posse de um fator (código do autenticador,\nconfirmação adicional, cadastro do autenticador, troca de senha) a\ntrava escalona por identidade: 5 erros, 15 minutos; 10 erros, 1 hora;\n20 erros, 24 horas — cerca de vinte palpites por ciclo de um dia e\nmeio; tentar de outro aparelho não adianta. Nas etapas por\nidentificador público (senha no login, recuperação de senha, login do\noperador) o documento ou o e-mail não trava: trava, e escalona, só a\ncombinação documento + origem (endereço) de quem insiste, para que\nsaber um CPF ou o e-mail de um operador não baste para trancar o dono,\nque entra de outro lugar. Os erros do documento ou do e-mail, somados\nde todas as origens, avisam o titular (ou o operador) por e-mail do\nsegundo degrau em diante. Um acesso concluído com senha e segundo\nfator, ou uma recuperação de senha concluída, zera as travas do\ndocumento; para o operador, também a redefinição da senha ou do\nautenticador por outro administrador.\n", "originalRequest": { "url": { "path": [ "v1", "auth", "password", "reset" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"document\": \"123.456.789-09\",\n \"code\": \"482913\",\n \"password\": \"ut dolor nisi qui\",\n \"totpCode\": \"731045\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e6fb65e4-c4e1-42e8-9552-32f7426e1940", "name": "Cadastra o segundo fator no primeiro acesso", "request": { "name": "Cadastra o segundo fator no primeiro acesso", "description": { "content": "Para a conta que ainda não cadastrou o segundo fator: `POST\n/v1/auth/login` devolve `enrollment: true` com a chave do autenticador.\nO cliente a cadastra no aplicativo e apresenta aqui o primeiro código de\nseis dígitos, dentro dos 5 minutos de validade do `enrollToken`. A\nchave só fica guardada quando o código a confirma: cada login antes\ndisso sorteia uma nova, a primeira confirmada é a que fica, e as\noutras deixam de servir. O\ncódigo confere, o cadastro é gravado e a sessão abre na mesma resposta,\nno mesmo formato de `POST /v1/auth/mfa` (no navegador, o refresh vai em\ncookie). Um código só vale uma vez. Após 5 erros em 15 minutos, as\ntentativas ficam bloqueadas.\n\nA conta em análise pode cadastrar o segundo fator e entrar; movimentar\ndinheiro continua exigindo conta ativa em cada operação.\n", "type": "text/plain" }, "url": { "path": [ "v1", "auth", "mfa", "enroll" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": true, "description": "Modelo do aparelho, para a lista de aparelhos da pessoa. Só exibição:\nnão decide acesso. Até 64 caracteres; fora de letras, dígitos, espaço e\n`. _ - ( ) ,` é descartado.\n", "key": "X-Device-Model", "value": "Galaxy S23 Ultra" }, { "disabled": true, "description": "Fabricante do aparelho, nas mesmas regras de `X-Device-Model`.", "key": "X-Device-Manufacturer", "value": "samsung" }, { "disabled": true, "description": "Versão do sistema, quando o `User-Agent` não a traz ou a traz congelada.\nNo Windows é a versão da plataforma informada pelo navegador\n(`navigator.userAgentData`): de 13 em diante é o Windows 11.\n", "key": "X-Device-OS-Version", "value": "15.0.0" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"enrollToken\": \"magna\",\n \"code\": \"482913\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "7e07a920-651a-4de8-bb6d-fee347934c22", "name": "Segundo fator cadastrado e sessão aberta", "originalRequest": { "url": { "path": [ "v1", "auth", "mfa", "enroll" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Modelo do aparelho, para a lista de aparelhos da pessoa. Só exibição:\nnão decide acesso. Até 64 caracteres; fora de letras, dígitos, espaço e\n`. _ - ( ) ,` é descartado.\n", "key": "X-Device-Model", "value": "Galaxy S23 Ultra" }, { "disabled": true, "description": "Fabricante do aparelho, nas mesmas regras de `X-Device-Model`.", "key": "X-Device-Manufacturer", "value": "samsung" }, { "disabled": true, "description": "Versão do sistema, quando o `User-Agent` não a traz ou a traz congelada.\nNo Windows é a versão da plataforma informada pelo navegador\n(`navigator.userAgentData`): de 13 em diante é o Windows 11.\n", "key": "X-Device-OS-Version", "value": "15.0.0" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"enrollToken\": \"magna\",\n \"code\": \"482913\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"accessToken\": \"Excepteur quis\",\n \"refreshToken\": \"in reprehenderit\",\n \"expiresIn\": 900,\n \"name\": \"Marina Advíncula Rocha\",\n \"accountId\": \"acc_u1\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "41d0052b-c7ff-4738-9edf-cd7b38753806", "name": "`enrollToken` inválido ou expirado (\"Cadastro expirado. Entre\nnovamente para recomeçar.\"), código incorreto (\"Código inválido ou\nexpirado.\") ou código já usado.\n", "originalRequest": { "url": { "path": [ "v1", "auth", "mfa", "enroll" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Modelo do aparelho, para a lista de aparelhos da pessoa. Só exibição:\nnão decide acesso. Até 64 caracteres; fora de letras, dígitos, espaço e\n`. _ - ( ) ,` é descartado.\n", "key": "X-Device-Model", "value": "Galaxy S23 Ultra" }, { "disabled": true, "description": "Fabricante do aparelho, nas mesmas regras de `X-Device-Model`.", "key": "X-Device-Manufacturer", "value": "samsung" }, { "disabled": true, "description": "Versão do sistema, quando o `User-Agent` não a traz ou a traz congelada.\nNo Windows é a versão da plataforma informada pelo navegador\n(`navigator.userAgentData`): de 13 em diante é o Windows 11.\n", "key": "X-Device-OS-Version", "value": "15.0.0" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"enrollToken\": \"magna\",\n \"code\": \"482913\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "05bf715c-93e5-46eb-af60-350a59f4a162", "name": "Senha e código certos, mas o aparelho não está habilitado para a conta\n(`DEVICE_NOT_ENABLED`). Nenhuma sessão foi aberta. `details.deviceStatus`\ndiz por quê: `PENDING` (aguardando habilitação), `REVOKED`\n(desabilitado), `BLOCKED` (bloqueado; só o atendimento libera) ou\n`UNKNOWN` (o login não trouxe identificação do aparelho).\n", "originalRequest": { "url": { "path": [ "v1", "auth", "mfa", "enroll" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Modelo do aparelho, para a lista de aparelhos da pessoa. Só exibição:\nnão decide acesso. Até 64 caracteres; fora de letras, dígitos, espaço e\n`. _ - ( ) ,` é descartado.\n", "key": "X-Device-Model", "value": "Galaxy S23 Ultra" }, { "disabled": true, "description": "Fabricante do aparelho, nas mesmas regras de `X-Device-Model`.", "key": "X-Device-Manufacturer", "value": "samsung" }, { "disabled": true, "description": "Versão do sistema, quando o `User-Agent` não a traz ou a traz congelada.\nNo Windows é a versão da plataforma informada pelo navegador\n(`navigator.userAgentData`): de 13 em diante é o Windows 11.\n", "key": "X-Device-OS-Version", "value": "15.0.0" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"enrollToken\": \"magna\",\n \"code\": \"482913\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"DEVICE_NOT_ENABLED\",\n \"message\": \"Este aparelho ainda não está habilitado para acessar a sua conta.\",\n \"requestId\": \"07bc304002adf0d4\",\n \"details\": {\n \"deviceStatus\": \"PENDING\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b476a38d-3212-4d0f-88a4-9b06c7b6e637", "name": "O segundo fator já está cadastrado; o cliente deve entrar normalmente (`CONFLICT`).", "originalRequest": { "url": { "path": [ "v1", "auth", "mfa", "enroll" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Modelo do aparelho, para a lista de aparelhos da pessoa. Só exibição:\nnão decide acesso. Até 64 caracteres; fora de letras, dígitos, espaço e\n`. _ - ( ) ,` é descartado.\n", "key": "X-Device-Model", "value": "Galaxy S23 Ultra" }, { "disabled": true, "description": "Fabricante do aparelho, nas mesmas regras de `X-Device-Model`.", "key": "X-Device-Manufacturer", "value": "samsung" }, { "disabled": true, "description": "Versão do sistema, quando o `User-Agent` não a traz ou a traz congelada.\nNo Windows é a versão da plataforma informada pelo navegador\n(`navigator.userAgentData`): de 13 em diante é o Windows 11.\n", "key": "X-Device-OS-Version", "value": "15.0.0" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"enrollToken\": \"magna\",\n \"code\": \"482913\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c1e1f333-d630-48a9-a4ae-fa7e5fa80a85", "name": "Trava depois de cinco erros em quinze minutos (`TOO_MANY_ATTEMPTS`).\nOs erros são contados no servidor, e não só no processo — reiniciar a\nAPI não os zera —, e `Retry-After` diz quantos segundos faltam.\n\nNas etapas que exigem a posse de um fator (código do autenticador,\nconfirmação adicional, cadastro do autenticador, troca de senha) a\ntrava escalona por identidade: 5 erros, 15 minutos; 10 erros, 1 hora;\n20 erros, 24 horas — cerca de vinte palpites por ciclo de um dia e\nmeio; tentar de outro aparelho não adianta. Nas etapas por\nidentificador público (senha no login, recuperação de senha, login do\noperador) o documento ou o e-mail não trava: trava, e escalona, só a\ncombinação documento + origem (endereço) de quem insiste, para que\nsaber um CPF ou o e-mail de um operador não baste para trancar o dono,\nque entra de outro lugar. Os erros do documento ou do e-mail, somados\nde todas as origens, avisam o titular (ou o operador) por e-mail do\nsegundo degrau em diante. Um acesso concluído com senha e segundo\nfator, ou uma recuperação de senha concluída, zera as travas do\ndocumento; para o operador, também a redefinição da senha ou do\nautenticador por outro administrador.\n", "originalRequest": { "url": { "path": [ "v1", "auth", "mfa", "enroll" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Modelo do aparelho, para a lista de aparelhos da pessoa. Só exibição:\nnão decide acesso. Até 64 caracteres; fora de letras, dígitos, espaço e\n`. _ - ( ) ,` é descartado.\n", "key": "X-Device-Model", "value": "Galaxy S23 Ultra" }, { "disabled": true, "description": "Fabricante do aparelho, nas mesmas regras de `X-Device-Model`.", "key": "X-Device-Manufacturer", "value": "samsung" }, { "disabled": true, "description": "Versão do sistema, quando o `User-Agent` não a traz ou a traz congelada.\nNo Windows é a versão da plataforma informada pelo navegador\n(`navigator.userAgentData`): de 13 em diante é o Windows 11.\n", "key": "X-Device-OS-Version", "value": "15.0.0" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"enrollToken\": \"magna\",\n \"code\": \"482913\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ccc90e02-188c-4c07-8fdf-fe211ee715c8", "name": "Segunda etapa do acesso interativo", "request": { "name": "Segunda etapa do acesso interativo", "description": { "content": "Troca o token de MFA e o código de seis dígitos por uma sessão. Um\ncódigo válido só vale uma vez: quem o intercepta não tem meio minuto\npara reutilizá-lo.\n\nCom o código certo, o aparelho do login (`deviceFingerprint`) é\navaliado. Senha e código certos não habilitam um aparelho: no modo\nimpor da instalação, aparelho que não está habilitado não recebe\nsessão (`403 DEVICE_NOT_ENABLED`) e passa a constar como pendente em\n`GET /v1/security/devices`. No modo observar, o padrão, o aparelho é\nhabilitado na entrada, como antes. Aparelho desabilitado ou bloqueado\né recusado nos dois modos, e desabilitar ou bloquear um aparelho\nencerra na hora todas as sessões abertas nele.\n", "type": "text/plain" }, "url": { "path": [ "v1", "auth", "mfa" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": true, "description": "Modelo do aparelho, para a lista de aparelhos da pessoa. Só exibição:\nnão decide acesso. Até 64 caracteres; fora de letras, dígitos, espaço e\n`. _ - ( ) ,` é descartado.\n", "key": "X-Device-Model", "value": "Galaxy S23 Ultra" }, { "disabled": true, "description": "Fabricante do aparelho, nas mesmas regras de `X-Device-Model`.", "key": "X-Device-Manufacturer", "value": "samsung" }, { "disabled": true, "description": "Versão do sistema, quando o `User-Agent` não a traz ou a traz congelada.\nNo Windows é a versão da plataforma informada pelo navegador\n(`navigator.userAgentData`): de 13 em diante é o Windows 11.\n", "key": "X-Device-OS-Version", "value": "15.0.0" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"mfaToken\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\n \"code\": \"482913\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "669bc81b-0aaf-47b7-b3c5-281cf6cfa65b", "name": "Sessão aberta. Exceção (PROVISÓRIA, 27/10/2026): o titular que\nainda está abrindo conta (contas em abertura, cadastro não enviado)\nnão recebe sessão; recebe `onboarding: true` com `onboardingToken`,\n`mode` e `stage`, como `POST /v1/onboarding/resume`, e segue para a\nabertura.\n", "originalRequest": { "url": { "path": [ "v1", "auth", "mfa" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Modelo do aparelho, para a lista de aparelhos da pessoa. Só exibição:\nnão decide acesso. Até 64 caracteres; fora de letras, dígitos, espaço e\n`. _ - ( ) ,` é descartado.\n", "key": "X-Device-Model", "value": "Galaxy S23 Ultra" }, { "disabled": true, "description": "Fabricante do aparelho, nas mesmas regras de `X-Device-Model`.", "key": "X-Device-Manufacturer", "value": "samsung" }, { "disabled": true, "description": "Versão do sistema, quando o `User-Agent` não a traz ou a traz congelada.\nNo Windows é a versão da plataforma informada pelo navegador\n(`navigator.userAgentData`): de 13 em diante é o Windows 11.\n", "key": "X-Device-OS-Version", "value": "15.0.0" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"mfaToken\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\n \"code\": \"482913\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"accessToken\": \"ea voluptate culpa\",\n \"refreshToken\": \"ullamco nulla in\",\n \"expiresIn\": 900,\n \"name\": \"Marina Advíncula Rocha\",\n \"accountId\": \"acc_u1\",\n \"onboarding\": true,\n \"onboardingToken\": \"nulla ex sit\",\n \"mode\": \"hosted\",\n \"stage\": \"CUSTOMER_CREATED\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a09d2046-7407-4983-8713-06bff90ba805", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "auth", "mfa" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Modelo do aparelho, para a lista de aparelhos da pessoa. Só exibição:\nnão decide acesso. Até 64 caracteres; fora de letras, dígitos, espaço e\n`. _ - ( ) ,` é descartado.\n", "key": "X-Device-Model", "value": "Galaxy S23 Ultra" }, { "disabled": true, "description": "Fabricante do aparelho, nas mesmas regras de `X-Device-Model`.", "key": "X-Device-Manufacturer", "value": "samsung" }, { "disabled": true, "description": "Versão do sistema, quando o `User-Agent` não a traz ou a traz congelada.\nNo Windows é a versão da plataforma informada pelo navegador\n(`navigator.userAgentData`): de 13 em diante é o Windows 11.\n", "key": "X-Device-OS-Version", "value": "15.0.0" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"mfaToken\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\n \"code\": \"482913\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "47141d44-8dc1-4b25-acef-20ae991c6b71", "name": "Senha e código certos, mas o aparelho não está habilitado para a conta\n(`DEVICE_NOT_ENABLED`). Nenhuma sessão foi aberta. `details.deviceStatus`\ndiz por quê: `PENDING` (aguardando habilitação), `REVOKED`\n(desabilitado), `BLOCKED` (bloqueado; só o atendimento libera) ou\n`UNKNOWN` (o login não trouxe identificação do aparelho).\n", "originalRequest": { "url": { "path": [ "v1", "auth", "mfa" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Modelo do aparelho, para a lista de aparelhos da pessoa. Só exibição:\nnão decide acesso. Até 64 caracteres; fora de letras, dígitos, espaço e\n`. _ - ( ) ,` é descartado.\n", "key": "X-Device-Model", "value": "Galaxy S23 Ultra" }, { "disabled": true, "description": "Fabricante do aparelho, nas mesmas regras de `X-Device-Model`.", "key": "X-Device-Manufacturer", "value": "samsung" }, { "disabled": true, "description": "Versão do sistema, quando o `User-Agent` não a traz ou a traz congelada.\nNo Windows é a versão da plataforma informada pelo navegador\n(`navigator.userAgentData`): de 13 em diante é o Windows 11.\n", "key": "X-Device-OS-Version", "value": "15.0.0" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"mfaToken\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\n \"code\": \"482913\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"DEVICE_NOT_ENABLED\",\n \"message\": \"Este aparelho ainda não está habilitado para acessar a sua conta.\",\n \"requestId\": \"07bc304002adf0d4\",\n \"details\": {\n \"deviceStatus\": \"PENDING\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "22acd69b-7d3d-421d-9c37-59eea162f6a7", "name": "Trava depois de cinco erros em quinze minutos (`TOO_MANY_ATTEMPTS`).\nOs erros são contados no servidor, e não só no processo — reiniciar a\nAPI não os zera —, e `Retry-After` diz quantos segundos faltam.\n\nNas etapas que exigem a posse de um fator (código do autenticador,\nconfirmação adicional, cadastro do autenticador, troca de senha) a\ntrava escalona por identidade: 5 erros, 15 minutos; 10 erros, 1 hora;\n20 erros, 24 horas — cerca de vinte palpites por ciclo de um dia e\nmeio; tentar de outro aparelho não adianta. Nas etapas por\nidentificador público (senha no login, recuperação de senha, login do\noperador) o documento ou o e-mail não trava: trava, e escalona, só a\ncombinação documento + origem (endereço) de quem insiste, para que\nsaber um CPF ou o e-mail de um operador não baste para trancar o dono,\nque entra de outro lugar. Os erros do documento ou do e-mail, somados\nde todas as origens, avisam o titular (ou o operador) por e-mail do\nsegundo degrau em diante. Um acesso concluído com senha e segundo\nfator, ou uma recuperação de senha concluída, zera as travas do\ndocumento; para o operador, também a redefinição da senha ou do\nautenticador por outro administrador.\n", "originalRequest": { "url": { "path": [ "v1", "auth", "mfa" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Modelo do aparelho, para a lista de aparelhos da pessoa. Só exibição:\nnão decide acesso. Até 64 caracteres; fora de letras, dígitos, espaço e\n`. _ - ( ) ,` é descartado.\n", "key": "X-Device-Model", "value": "Galaxy S23 Ultra" }, { "disabled": true, "description": "Fabricante do aparelho, nas mesmas regras de `X-Device-Model`.", "key": "X-Device-Manufacturer", "value": "samsung" }, { "disabled": true, "description": "Versão do sistema, quando o `User-Agent` não a traz ou a traz congelada.\nNo Windows é a versão da plataforma informada pelo navegador\n(`navigator.userAgentData`): de 13 em diante é o Windows 11.\n", "key": "X-Device-OS-Version", "value": "15.0.0" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"mfaToken\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\n \"code\": \"482913\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "60b4625d-a3a4-4bd0-a55a-99875404f31d", "name": "Renova a sessão", "request": { "name": "Renova a sessão", "description": { "content": "Devolve um par novo e gasta o anterior. A rotação existe por uma razão\nsó: sem ela, um token de trinta dias vale trinta dias para quem o\ncopiar, e o dono legítimo nunca fica sabendo. Um token já gasto que\nreaparece derruba a linhagem inteira nascida daquele login.\n\nNo modo impor da instalação, renovar exige que o aparelho em que a\nsessão foi aberta continue habilitado. Se não estiver, a resposta é\n`401 DEVICE_NOT_ENABLED` e a linhagem inteira é encerrada.\n", "type": "text/plain" }, "url": { "path": [ "v1", "auth", "refresh" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": true, "description": "Modelo do aparelho, para a lista de aparelhos da pessoa. Só exibição:\nnão decide acesso. Até 64 caracteres; fora de letras, dígitos, espaço e\n`. _ - ( ) ,` é descartado.\n", "key": "X-Device-Model", "value": "Galaxy S23 Ultra" }, { "disabled": true, "description": "Fabricante do aparelho, nas mesmas regras de `X-Device-Model`.", "key": "X-Device-Manufacturer", "value": "samsung" }, { "disabled": true, "description": "Versão do sistema, quando o `User-Agent` não a traz ou a traz congelada.\nNo Windows é a versão da plataforma informada pelo navegador\n(`navigator.userAgentData`): de 13 em diante é o Windows 11.\n", "key": "X-Device-OS-Version", "value": "15.0.0" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"refreshToken\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "b7b6deb0-1ee0-4983-9425-7d374eef7fa7", "name": "Par novo emitido", "originalRequest": { "url": { "path": [ "v1", "auth", "refresh" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Modelo do aparelho, para a lista de aparelhos da pessoa. Só exibição:\nnão decide acesso. Até 64 caracteres; fora de letras, dígitos, espaço e\n`. _ - ( ) ,` é descartado.\n", "key": "X-Device-Model", "value": "Galaxy S23 Ultra" }, { "disabled": true, "description": "Fabricante do aparelho, nas mesmas regras de `X-Device-Model`.", "key": "X-Device-Manufacturer", "value": "samsung" }, { "disabled": true, "description": "Versão do sistema, quando o `User-Agent` não a traz ou a traz congelada.\nNo Windows é a versão da plataforma informada pelo navegador\n(`navigator.userAgentData`): de 13 em diante é o Windows 11.\n", "key": "X-Device-OS-Version", "value": "15.0.0" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"refreshToken\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"accessToken\": \"Excepteur quis\",\n \"refreshToken\": \"in reprehenderit\",\n \"expiresIn\": 900,\n \"name\": \"Marina Advíncula Rocha\",\n \"accountId\": \"acc_u1\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "653e748f-7ba5-4ca4-b677-12efef77a792", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "auth", "refresh" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Modelo do aparelho, para a lista de aparelhos da pessoa. Só exibição:\nnão decide acesso. Até 64 caracteres; fora de letras, dígitos, espaço e\n`. _ - ( ) ,` é descartado.\n", "key": "X-Device-Model", "value": "Galaxy S23 Ultra" }, { "disabled": true, "description": "Fabricante do aparelho, nas mesmas regras de `X-Device-Model`.", "key": "X-Device-Manufacturer", "value": "samsung" }, { "disabled": true, "description": "Versão do sistema, quando o `User-Agent` não a traz ou a traz congelada.\nNo Windows é a versão da plataforma informada pelo navegador\n(`navigator.userAgentData`): de 13 em diante é o Windows 11.\n", "key": "X-Device-OS-Version", "value": "15.0.0" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"refreshToken\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4f996bdf-2f8a-4f8a-a14e-fede27e53bba", "name": "Encerra a sessão", "request": { "name": "Encerra a sessão", "description": { "content": "Público de propósito: sair precisa funcionar quando a sessão já está\nestranha, e o que ele invalida é o próprio token apresentado. Responde\n`204` mesmo para token ilegível, para não virar um oráculo sobre quais\ntokens ainda valem.\n", "type": "text/plain" }, "url": { "path": [ "v1", "auth", "logout" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"refreshToken\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\n \"allDevices\": false\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "5642b6d4-d599-4c87-814e-9590b1d74f5d", "name": "Encerrada", "originalRequest": { "url": { "path": [ "v1", "auth", "logout" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"refreshToken\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\n \"allDevices\": false\n}", "options": { "raw": { "language": "json" } } } }, "status": "No Content", "code": 204, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6bd7f315-e001-47eb-805e-df33ea68d249", "name": "Emite a prova de segundo fator para uma operação", "request": { "name": "Emite a prova de segundo fator para uma operação", "description": { "content": "O `purpose` amarra o token à operação, e o token vale 5 minutos. Envie o\nvalor devolvido no cabeçalho `X-Step-Up` da chamada que o exige.\n\nValores em uso:\n\n- `transfer`: transferência a partir de R$ 1.000,00, ou quando a soma\n do dia chega a esse valor;\n- `ted`: toda TED, qualquer que seja o valor;\n- `pix_key`: cadastro de chave PIX;\n- `review`: liberar transferência retida;\n- `card`: ver o número do cartão ou desbloqueá-lo;\n- `biometrics`: cadastrar ou trocar a biometria facial;\n- `limits`: pedir aumento de limite;\n- `password`: trocar a senha (`POST /v1/auth/password`);\n- `dispute`: contestar um Pix enviado (MED), sempre;\n- `preferences`: desligar uma proteção ou um aviso em Segurança\n (`PATCH /v1/security/preferences`);\n- `devices`: remover um aparelho (`DELETE /v1/security/devices/{id}`);\n- `subscription`: aderir a um plano, trocá-lo, trocar o dia de\n cobrança ou cancelá-lo (`POST /v1/subscription`,\n `POST /v1/subscription/plan-change`,\n `POST /v1/subscription/plan-change/cancel`,\n `POST /v1/subscription/billing-day`,\n `POST /v1/subscription/billing-day/cancel` e\n `POST /v1/subscription/cancel`), sempre;\n- `account_block`: bloquear a própria conta\n (`POST /v1/security/account-block`).\n\nO token vale uma vez só, e a marca de uso é guardada no servidor, não\nsó no processo: reiniciar a API ou cair em outra instância não o\ndevolve. O mesmo vale para o código de seis dígitos aceito aqui e em\n`POST /v1/auth/mfa`.\n\n**Esta rota é de sessão (`Authorization: Bearer`) e não aceita chave de\nAPI**: com `X-API-Key` a resposta é `403 FORBIDDEN`. O token de step-up\nsai de uma sessão do titular e vale na chamada seguinte, qualquer que\nseja a credencial dela. Isso inclui o cadastro de chave PIX\n(`pix:keys:write`, que exige step-up sempre) e o Pix a partir de\nR$ 1.000,00, por operação ou pela soma do dia.\n\nNo sandbox, faça login e MFA com as `credentials` devolvidas em\n`POST /v1/sandbox/keys` (`POST /v1/auth/login`, depois\n`POST /v1/auth/mfa`) e calcule o código de seis dígitos com o\n`totpSecret` — qualquer biblioteca de TOTP o calcula. Em produção, o\ntoken vem de uma sessão do próprio titular, que tem o aplicativo\nautenticador.\n", "type": "text/plain" }, "url": { "path": [ "v1", "auth", "step-up" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"code\": \"482913\",\n \"purpose\": \"review\",\n \"selfie\": \"eiusmod ipsum\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "fb49aa27-2fc5-416a-85dc-aee28e6aa927", "name": "Prova emitida", "originalRequest": { "url": { "path": [ "v1", "auth", "step-up" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"482913\",\n \"purpose\": \"review\",\n \"selfie\": \"eiusmod ipsum\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"stepUpToken\": \"cupidat\",\n \"expiresIn\": 300\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "adbf2c93-630b-4b88-9c84-4249f9fbd79e", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "auth", "step-up" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"482913\",\n \"purpose\": \"review\",\n \"selfie\": \"eiusmod ipsum\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3a7b8a0c-509e-4c24-a5cb-3c667af454e0", "name": "Requisição malformada ou com dado inválido", "originalRequest": { "url": { "path": [ "v1", "auth", "step-up" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"482913\",\n \"purpose\": \"review\",\n \"selfie\": \"eiusmod ipsum\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5249f9bc-37d1-4bb7-9b30-9f3b9b8fef22", "name": "Trava depois de cinco erros em quinze minutos (`TOO_MANY_ATTEMPTS`).\nOs erros são contados no servidor, e não só no processo — reiniciar a\nAPI não os zera —, e `Retry-After` diz quantos segundos faltam.\n\nNas etapas que exigem a posse de um fator (código do autenticador,\nconfirmação adicional, cadastro do autenticador, troca de senha) a\ntrava escalona por identidade: 5 erros, 15 minutos; 10 erros, 1 hora;\n20 erros, 24 horas — cerca de vinte palpites por ciclo de um dia e\nmeio; tentar de outro aparelho não adianta. Nas etapas por\nidentificador público (senha no login, recuperação de senha, login do\noperador) o documento ou o e-mail não trava: trava, e escalona, só a\ncombinação documento + origem (endereço) de quem insiste, para que\nsaber um CPF ou o e-mail de um operador não baste para trancar o dono,\nque entra de outro lugar. Os erros do documento ou do e-mail, somados\nde todas as origens, avisam o titular (ou o operador) por e-mail do\nsegundo degrau em diante. Um acesso concluído com senha e segundo\nfator, ou uma recuperação de senha concluída, zera as travas do\ndocumento; para o operador, também a redefinição da senha ou do\nautenticador por outro administrador.\n", "originalRequest": { "url": { "path": [ "v1", "auth", "step-up" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"482913\",\n \"purpose\": \"review\",\n \"selfie\": \"eiusmod ipsum\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e004c666-4913-4631-adbb-f98562fc434b", "name": "Troca a senha do titular logado", "request": { "name": "Troca a senha do titular logado", "description": { "content": "Pede a senha atual, a senha nova e o segundo fator: `X-Step-Up` com\n`purpose: password`. A sessão sozinha não basta, nem a senha atual\nsozinha.\n\nA conferência segue esta ordem, e o `X-Step-Up` é o último passo:\n\n1. senha atual errada: `422`;\n2. senha nova igual à atual ou fora da política de senha (mínimo de 10\n caracteres, com letras e ao menos um número, símbolo ou espaço):\n `422`;\n3. sem `X-Step-Up` válido para `password`: `403 STEP_UP_REQUIRED`.\n\nNenhuma dessas recusas gasta a prova, que pode ser reenviada com os\ncampos corrigidos. Por isso, a tela pode mandar o pedido sem\n`X-Step-Up` para conferir os campos e só pedir o código quando a\nresposta for `403`. Depois do passo 3 a prova já foi gasta: um `409`\nou uma falha do servidor pedem um código novo.\n\nSenha atual errada responde `422`, e não `401`, porque `401` quer\ndizer sessão encerrada. Cada erro da senha atual conta para a trava do\ntitular nesta rota e também para a do login do documento a partir\ndesta origem (5 em 15 minutos em cada uma, depois `429`), e entra no\nhistórico de segurança\ncomo `FAILED_LOGIN`.\n\nQuando a senha é trocada, as outras sessões do titular são encerradas\nna mesma transação, em todos os aparelhos. A sessão que fez a troca\ncontinua aberta. A troca entra no histórico como `PASSWORD_CHANGE`.\nSe outra sessão trocou a senha entre a conferência e a gravação, a\nresposta é `409`.\n\n**Rota de sessão**: com `X-API-Key`, a resposta é `403 FORBIDDEN`.\n", "type": "text/plain" }, "url": { "path": [ "v1", "auth", "password" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"currentPassword\": \"tempor in\",\n \"newPassword\": \"veniam\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "04871090-6299-41b0-ae13-bc94d8f4af20", "name": "Senha trocada, e as outras sessões encerradas.", "originalRequest": { "url": { "path": [ "v1", "auth", "password" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"currentPassword\": \"tempor in\",\n \"newPassword\": \"veniam\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "No Content", "code": 204, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "a2496890-60c0-44b8-8d92-be7e7fd662d1", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "auth", "password" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"currentPassword\": \"tempor in\",\n \"newPassword\": \"veniam\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "41dda8a7-0d40-4c4e-939c-468feb616b9d", "name": "Falta a confirmação de segundo fator (`STEP_UP_REQUIRED`). Chame\n`POST /v1/auth/step-up` e repita com o cabeçalho `X-Step-Up`.\n", "originalRequest": { "url": { "path": [ "v1", "auth", "password" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"currentPassword\": \"tempor in\",\n \"newPassword\": \"veniam\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9d1b1f27-3603-4852-8498-dd0a624d29e8", "name": "A senha mudou em outra sessão durante a troca.", "originalRequest": { "url": { "path": [ "v1", "auth", "password" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"currentPassword\": \"tempor in\",\n \"newPassword\": \"veniam\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "61836dc4-f328-4df2-814f-bdb6a67cb148", "name": "Requisição malformada ou com dado inválido", "originalRequest": { "url": { "path": [ "v1", "auth", "password" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"currentPassword\": \"tempor in\",\n \"newPassword\": \"veniam\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a01736e1-d245-421d-bcdb-24f608701de9", "name": "Trava depois de cinco erros em quinze minutos (`TOO_MANY_ATTEMPTS`).\nOs erros são contados no servidor, e não só no processo — reiniciar a\nAPI não os zera —, e `Retry-After` diz quantos segundos faltam.\n\nNas etapas que exigem a posse de um fator (código do autenticador,\nconfirmação adicional, cadastro do autenticador, troca de senha) a\ntrava escalona por identidade: 5 erros, 15 minutos; 10 erros, 1 hora;\n20 erros, 24 horas — cerca de vinte palpites por ciclo de um dia e\nmeio; tentar de outro aparelho não adianta. Nas etapas por\nidentificador público (senha no login, recuperação de senha, login do\noperador) o documento ou o e-mail não trava: trava, e escalona, só a\ncombinação documento + origem (endereço) de quem insiste, para que\nsaber um CPF ou o e-mail de um operador não baste para trancar o dono,\nque entra de outro lugar. Os erros do documento ou do e-mail, somados\nde todas as origens, avisam o titular (ou o operador) por e-mail do\nsegundo degrau em diante. Um acesso concluído com senha e segundo\nfator, ou uma recuperação de senha concluída, zera as travas do\ndocumento; para o operador, também a redefinição da senha ou do\nautenticador por outro administrador.\n", "originalRequest": { "url": { "path": [ "v1", "auth", "password" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"currentPassword\": \"tempor in\",\n \"newPassword\": \"veniam\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "de2628c7-34ed-484d-9dac-a80ff1b0b366", "name": "Abertura de conta", "description": { "content": "Abrir conta e acompanhar a abertura. O modo da instalação\n(`accountOpening.mode` em `GET /v1/features`) decide quem conduz o\ncadastro: o Lume (`own`) ou o provedor financeiro, na tela dele\n(`hosted`).\n", "type": "text/plain" }, "item": [ { "id": "6dcf8b21-9c1c-4a78-9ecb-69ca1f9be4a5", "name": "Abre uma conta", "request": { "name": "Abre uma conta", "description": { "content": "Pública, como o login: quem abre conta ainda não tem credencial. O\ncaminho depende de `accountOpening.mode` em `GET /v1/features`.\n\n**E-mail confirmado antes**, em todos os modos: `emailVerificationId` é\no pedido de `POST /v1/onboarding/email-verifications` confirmado em\n`.../{id}/confirm` para este mesmo `email`. Ele é consumido depois de\ntodas as conferências do pedido e antes de qualquer gravação (e, nos\nmodos do provedor, antes de o cliente ir ao provedor): um campo\ninválido não o gasta, e a abertura com ele ausente, de outro e-mail, não\nconfirmado, vencido ou já usado é `422 INVALID_REQUEST`, sem criar nada.\nSe a gravação falhar depois do consumo, confirme o e-mail de novo.\n\n**Documento já cadastrado** responde como o cadastro recebido (`201`,\ncom os mesmos campos), **sem criar nada**: a rota é pública, e uma\nrecusa distinta diria a qualquer um quem é cliente. Quem é avisado é o\ndono do documento, pelo e-mail que ele cadastrou. A conferência vem\ndepois do consumo da confirmação do e-mail, então cada tentativa custa\num e-mail confirmado.\n\n**Abertura parada no meio** (modos do provedor): quando o e-mail\nconfirmado é o MESMO do cadastro existente, o titular ainda não é\ncliente de fato (sem autenticador, todas as contas próprias em\nabertura, sem representar ninguém) e o processo dele é do mesmo modo e\nainda está na coleta, a abertura é retomada: a senha deste pedido passa\na valer, as sessões do titular caem e o `onboardingToken` devolvido é o\ndele, para seguir de onde parou. Nada é criado de novo.\n\n**Contato já cadastrado no provedor** (modos do provedor): quando o\nprovedor recusa criar o cliente porque o celular ou o e-mail já estão\nem outro cadastro lá, a resposta é `409 CONFLICT` com a mensagem que\ndiz qual dado trocar e `details.field` (`phone`, `email`, ou vazio\nquando o provedor não diz qual). Nada é criado, e a confirmação do\ne-mail já foi consumida: o próximo pedido precisa de outra.\n\n**`own`** (fluxo do Lume): o cadastro inteiro vai neste pedido, com\n`selfie` e `documents`, e a conta nasce em análise (`PENDING`). Quem\ndecide é a análise no backoffice. A resposta traz `account`.\n\n**`hosted`** (o provedor financeiro conduz o cadastro): este pedido\ncria o titular e o cliente no provedor; a tela de cadastro do\nprovedor, onde a pessoa envia os documentos e faz a biometria, vem de\n`POST /v1/onboarding/hosted-link`, com o `onboardingToken` (a abertura\nnão devolve `url`). `selfie` e `documents` são recusados (`422`). O celular é\nobrigatório (é por ele que o provedor manda o link da biometria); na\nempresa, `email` e `phone` são os do representante legal que fará a\nbiometria, e `businessType` e `tradeName` são obrigatórios. Com\n`birthDate`, menor de 18 anos é recusado. A resposta traz o\n`onboardingToken`, que lê o estágio em `GET /v1/onboarding` e pede a\ntela de novo em `POST /v1/onboarding/hosted-link` por uma hora; depois\ndisso, a pessoa entra com a senha (conta em análise já entra) e usa a\nsessão. A conta é liberada quando o provedor aprova o cadastro.\n\n**`own` com o provedor financeiro decidindo o cadastro** (a Azify, que\ndeclara o onboarding próprio): a tela é a do Lume, mas o cadastro vai\nao provedor pela API, e quem decide é ele. Este pedido cria o titular e\no cliente no provedor, como no `hosted`, e a resposta traz o\n`onboardingToken`, sem `url` e sem `account`. Pessoa física:\n`birthDate` é obrigatório e menor de 18 anos é recusado. Empresa: só\ncom a funcionalidade `business_opening_own` ligada (em construção,\ndesligada por padrão; desligada, CNPJ é recusado com `422`), e só\n`businessType` `MEI` ou `EI`, com exatamente um representante (quem\nabre a conta e faz a biometria); `LTDA`, `SA` e `TS` são recusadas com\n`422`, e `birthDate` não vai (o do representante vai nos dados do\ncadastro). `selfie` e `documents` são recusados (`422`), porque vão na\nbiometria e, na empresa, em `POST /v1/onboarding/documents`. A pessoa\nsegue por `PUT /v1/onboarding/profile` (na empresa, depois do\ndocumento), `GET /v1/onboarding/terms`, a biometria\n(`POST /v1/onboarding/biometrics/session`) e\n`POST /v1/onboarding/complete`. Sem a biometria configurada na\ninstalação, este pedido responde `503` antes de criar qualquer coisa.\n", "type": "text/plain" }, "url": { "path": [ "v1", "onboarding" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"name\": \"labore est\",\n \"document\": \"minim \",\n \"email\": \"et qui amet enim\",\n \"password\": \"minim elit \",\n \"emailVerificationId\": \"ver_8c1d2e4b9a7f40c1b2d3e4f5a6b7c8d9\",\n \"phone\": \"qui\",\n \"city\": \"Niterói, RJ\",\n \"referralCode\": \"elit pariatur ulla\",\n \"birthDate\": \"2020-03-06\",\n \"businessType\": \"LTDA\",\n \"tradeName\": \"Excepteur \",\n \"stateRegistration\": \"q\",\n \"representatives\": [\n {\n \"name\": \"sed velit elit cupidatat\",\n \"document\": \"deserunt \",\n \"role\": \"ea nulla\",\n \"email\": \"est exercitation adipisicing\",\n \"phone\": \"laborum consequat\"\n },\n {\n \"name\": \"non aliquip eu\",\n \"document\": \"esse anim et\",\n \"role\": \"minim tempor eu\",\n \"email\": \"dolor in proident cupidatat\",\n \"phone\": \"magna ut et\"\n }\n ],\n \"selfie\": \"Duis ut et nostrud\",\n \"documents\": [\n {\n \"kind\": \"dolore culpa amet adipisicing esse\",\n \"content\": \"ipsum\"\n },\n {\n \"kind\": \"et in ipsum culpa\",\n \"content\": \"consequat ea velit irure minim\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "bbb05483-1de1-4ff4-81d0-9dfa0303cb6f", "name": "Cadastro recebido e conta em análise. `account` no fluxo do Lume;\n`stage`, `onboardingToken` e `expiresIn` nos modos do provedor\n(`hosted` e `own` com o provedor decidindo). No `hosted`, a tela\ndo provedor vem de `POST /v1/onboarding/hosted-link`.\n", "originalRequest": { "url": { "path": [ "v1", "onboarding" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"velit eu\",\n \"document\": \"incididunt elit non\",\n \"email\": \"est officia\",\n \"password\": \"minim si\",\n \"emailVerificationId\": \"ver_8c1d2e4b9a7f40c1b2d3e4f5a6b7c8d9\",\n \"phone\": \"anim adipisici\",\n \"city\": \"Niterói, RJ\",\n \"referralCode\": \"consectetur id\",\n \"birthDate\": \"2010-11-26\",\n \"businessType\": \"SA\",\n \"tradeName\": \"irure magna nulla\",\n \"stateRegistration\": \"esse est aliqua sunt si\",\n \"representatives\": [\n {\n \"name\": \"incididunt eu est Ut\",\n \"document\": \"consectetur es\",\n \"role\": \"sed amet elit\",\n \"email\": \"ipsum nulla elit fugiat nisi\",\n \"phone\": \"nostrud\"\n },\n {\n \"name\": \"est sit culpa\",\n \"document\": \"esse \",\n \"role\": \"a\",\n \"email\": \"in in consequat officia\",\n \"phone\": \"sunt et\"\n }\n ],\n \"selfie\": \"do eu laborum esse\",\n \"documents\": [\n {\n \"kind\": \"nulla Ut\",\n \"content\": \"est in dolor id\"\n },\n {\n \"kind\": \"ad do in Ut\",\n \"content\": \"occaecat non proident consectetur\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"IN_REVIEW\",\n \"message\": \"officia ipsum\",\n \"account\": {\n \"branch\": \"pariatur in sed laboris\",\n \"number\": \"fugiat consequat\"\n },\n \"stage\": \"IN_PROGRESS\",\n \"onboardingToken\": \"sunt minim ex\",\n \"expiresIn\": 3600\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7f78013b-dab8-4087-8e2c-e1c66e5e649a", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "onboarding" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"velit eu\",\n \"document\": \"incididunt elit non\",\n \"email\": \"est officia\",\n \"password\": \"minim si\",\n \"emailVerificationId\": \"ver_8c1d2e4b9a7f40c1b2d3e4f5a6b7c8d9\",\n \"phone\": \"anim adipisici\",\n \"city\": \"Niterói, RJ\",\n \"referralCode\": \"consectetur id\",\n \"birthDate\": \"2010-11-26\",\n \"businessType\": \"SA\",\n \"tradeName\": \"irure magna nulla\",\n \"stateRegistration\": \"esse est aliqua sunt si\",\n \"representatives\": [\n {\n \"name\": \"incididunt eu est Ut\",\n \"document\": \"consectetur es\",\n \"role\": \"sed amet elit\",\n \"email\": \"ipsum nulla elit fugiat nisi\",\n \"phone\": \"nostrud\"\n },\n {\n \"name\": \"est sit culpa\",\n \"document\": \"esse \",\n \"role\": \"a\",\n \"email\": \"in in consequat officia\",\n \"phone\": \"sunt et\"\n }\n ],\n \"selfie\": \"do eu laborum esse\",\n \"documents\": [\n {\n \"kind\": \"nulla Ut\",\n \"content\": \"est in dolor id\"\n },\n {\n \"kind\": \"ad do in Ut\",\n \"content\": \"occaecat non proident consectetur\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d61a6f9b-48eb-4e2e-a90c-8c4469b5831d", "name": "Conflito passageiro na gravação da abertura (`CONFLICT`): repita o\npedido. Documento de cliente **não** responde 409 nesta rota (veja\na descrição); só a abertura pelo atendimento, autenticada, o faz.\n\nExceção (PROVISÓRIA, 27/10/2026): o documento de quem ainda está\nabrindo conta (contas em abertura, cadastro não enviado), com uma\nsenha diferente da do cadastro ou com o autenticador já\nconfigurado, responde 409 com `details.reason =\nONBOARDING_IN_PROGRESS`: a tela pede a senha e segue por\n`POST /v1/onboarding/resume`. Com a mesma senha (e sem\nautenticador), a resposta é `201` com o token de acompanhamento do\npróprio titular e `onboarding: true`: a abertura continua de onde\nparou.\n", "originalRequest": { "url": { "path": [ "v1", "onboarding" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"velit eu\",\n \"document\": \"incididunt elit non\",\n \"email\": \"est officia\",\n \"password\": \"minim si\",\n \"emailVerificationId\": \"ver_8c1d2e4b9a7f40c1b2d3e4f5a6b7c8d9\",\n \"phone\": \"anim adipisici\",\n \"city\": \"Niterói, RJ\",\n \"referralCode\": \"consectetur id\",\n \"birthDate\": \"2010-11-26\",\n \"businessType\": \"SA\",\n \"tradeName\": \"irure magna nulla\",\n \"stateRegistration\": \"esse est aliqua sunt si\",\n \"representatives\": [\n {\n \"name\": \"incididunt eu est Ut\",\n \"document\": \"consectetur es\",\n \"role\": \"sed amet elit\",\n \"email\": \"ipsum nulla elit fugiat nisi\",\n \"phone\": \"nostrud\"\n },\n {\n \"name\": \"est sit culpa\",\n \"document\": \"esse \",\n \"role\": \"a\",\n \"email\": \"in in consequat officia\",\n \"phone\": \"sunt et\"\n }\n ],\n \"selfie\": \"do eu laborum esse\",\n \"documents\": [\n {\n \"kind\": \"nulla Ut\",\n \"content\": \"est in dolor id\"\n },\n {\n \"kind\": \"ad do in Ut\",\n \"content\": \"occaecat non proident consectetur\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f25c0d39-6740-47d3-bab6-f86bc0a9e862", "name": "Campo faltando ou inválido, inclusive senha fora da política (mínimo de\n10 caracteres, com letras e ao menos um número, símbolo ou espaço)\n(`INVALID_REQUEST`); e-mail sem confirmação válida\n(`INVALID_REQUEST`, \"Confirme o e-mail com o código enviado antes de\nabrir a conta.\"); campo de texto acima do `maxLength` ou mais\nrepresentantes que o `maxItems` (`INVALID_REQUEST`, \"O campo ... é\nlongo demais.\", contado em caracteres depois de aparar os espaços;\no valor nunca volta na resposta); ou o provedor financeiro recusou\no cadastro (`PROVIDER_ERROR`).\n", "originalRequest": { "url": { "path": [ "v1", "onboarding" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"velit eu\",\n \"document\": \"incididunt elit non\",\n \"email\": \"est officia\",\n \"password\": \"minim si\",\n \"emailVerificationId\": \"ver_8c1d2e4b9a7f40c1b2d3e4f5a6b7c8d9\",\n \"phone\": \"anim adipisici\",\n \"city\": \"Niterói, RJ\",\n \"referralCode\": \"consectetur id\",\n \"birthDate\": \"2010-11-26\",\n \"businessType\": \"SA\",\n \"tradeName\": \"irure magna nulla\",\n \"stateRegistration\": \"esse est aliqua sunt si\",\n \"representatives\": [\n {\n \"name\": \"incididunt eu est Ut\",\n \"document\": \"consectetur es\",\n \"role\": \"sed amet elit\",\n \"email\": \"ipsum nulla elit fugiat nisi\",\n \"phone\": \"nostrud\"\n },\n {\n \"name\": \"est sit culpa\",\n \"document\": \"esse \",\n \"role\": \"a\",\n \"email\": \"in in consequat officia\",\n \"phone\": \"sunt et\"\n }\n ],\n \"selfie\": \"do eu laborum esse\",\n \"documents\": [\n {\n \"kind\": \"nulla Ut\",\n \"content\": \"est in dolor id\"\n },\n {\n \"kind\": \"ad do in Ut\",\n \"content\": \"occaecat non proident consectetur\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "956b7310-2011-4759-8b46-edf2be61d1cf", "name": "Limite de requisições atingido. O cabeçalho `Retry-After` diz quantos\nsegundos esperar.\n", "originalRequest": { "url": { "path": [ "v1", "onboarding" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"velit eu\",\n \"document\": \"incididunt elit non\",\n \"email\": \"est officia\",\n \"password\": \"minim si\",\n \"emailVerificationId\": \"ver_8c1d2e4b9a7f40c1b2d3e4f5a6b7c8d9\",\n \"phone\": \"anim adipisici\",\n \"city\": \"Niterói, RJ\",\n \"referralCode\": \"consectetur id\",\n \"birthDate\": \"2010-11-26\",\n \"businessType\": \"SA\",\n \"tradeName\": \"irure magna nulla\",\n \"stateRegistration\": \"esse est aliqua sunt si\",\n \"representatives\": [\n {\n \"name\": \"incididunt eu est Ut\",\n \"document\": \"consectetur es\",\n \"role\": \"sed amet elit\",\n \"email\": \"ipsum nulla elit fugiat nisi\",\n \"phone\": \"nostrud\"\n },\n {\n \"name\": \"est sit culpa\",\n \"document\": \"esse \",\n \"role\": \"a\",\n \"email\": \"in in consequat officia\",\n \"phone\": \"sunt et\"\n }\n ],\n \"selfie\": \"do eu laborum esse\",\n \"documents\": [\n {\n \"kind\": \"nulla Ut\",\n \"content\": \"est in dolor id\"\n },\n {\n \"kind\": \"ad do in Ut\",\n \"content\": \"occaecat non proident consectetur\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9633ce29-5d28-4bd4-9eee-fd90c43e4e99", "name": "O arranjo de pagamento está indisponível (`PROVIDER_ERROR`); ou a\ninstância já processa o máximo de aberturas simultâneas\n(`RATE_LIMITED`, com `Retry-After`): repita em instantes.\n", "originalRequest": { "url": { "path": [ "v1", "onboarding" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"velit eu\",\n \"document\": \"incididunt elit non\",\n \"email\": \"est officia\",\n \"password\": \"minim si\",\n \"emailVerificationId\": \"ver_8c1d2e4b9a7f40c1b2d3e4f5a6b7c8d9\",\n \"phone\": \"anim adipisici\",\n \"city\": \"Niterói, RJ\",\n \"referralCode\": \"consectetur id\",\n \"birthDate\": \"2010-11-26\",\n \"businessType\": \"SA\",\n \"tradeName\": \"irure magna nulla\",\n \"stateRegistration\": \"esse est aliqua sunt si\",\n \"representatives\": [\n {\n \"name\": \"incididunt eu est Ut\",\n \"document\": \"consectetur es\",\n \"role\": \"sed amet elit\",\n \"email\": \"ipsum nulla elit fugiat nisi\",\n \"phone\": \"nostrud\"\n },\n {\n \"name\": \"est sit culpa\",\n \"document\": \"esse \",\n \"role\": \"a\",\n \"email\": \"in in consequat officia\",\n \"phone\": \"sunt et\"\n }\n ],\n \"selfie\": \"do eu laborum esse\",\n \"documents\": [\n {\n \"kind\": \"nulla Ut\",\n \"content\": \"est in dolor id\"\n },\n {\n \"kind\": \"ad do in Ut\",\n \"content\": \"occaecat non proident consectetur\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8902efac-3124-4ce4-8f8a-2f312f0eee58", "name": "Estágio da abertura de conta", "request": { "name": "Estágio da abertura de conta", "description": { "content": "A abertura decidida pelo provedor financeiro (modo `hosted`, ou `own`\ncom o provedor decidindo) do próprio titular: o do `onboardingToken` ou\no da sessão. Quem abriu conta pelo\nfluxo do Lume recebe `404`. `reason` e `pending` só aparecem com texto\nque pode ser mostrado ao cliente.\n", "type": "text/plain" }, "url": { "path": [ "v1", "onboarding" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "ebf342a2-22fb-4686-95f1-895800ffb079", "name": "Estágio atual", "originalRequest": { "url": { "path": [ "v1", "onboarding" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"mode\": \"hosted\",\n \"stage\": \"IN_PROGRESS\",\n \"personType\": \"PF\",\n \"documents\": [\n {\n \"kind\": \"LEGAL_DOCUMENTS\",\n \"contentType\": \"application/pdf\",\n \"sizeBytes\": 27475178,\n \"profileSent\": false,\n \"uploadedAt\": \"2018-11-12T09:40:52.311Z\"\n },\n {\n \"kind\": \"LEGAL_DOCUMENTS\",\n \"contentType\": \"application/pdf\",\n \"sizeBytes\": 8106126,\n \"profileSent\": true,\n \"uploadedAt\": \"2019-05-12T23:48:54.461Z\"\n }\n ],\n \"businessType\": \"MEI\",\n \"reason\": \"aliquip reprehenderit veniam commodo\",\n \"pending\": [\n {\n \"title\": \"do veniam\"\n },\n {\n \"title\": \"Excepteur sunt velit\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "07d4d9e6-dfd2-4a8a-b0da-85a992ef9805", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "onboarding" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8ca5eb4a-a841-4b98-aca2-6d6b440134e0", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "onboarding" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "568bdbd6-aba6-4064-8b55-3ddc6788a624", "name": "Registro não encontrado", "originalRequest": { "url": { "path": [ "v1", "onboarding" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "394815c2-226f-45ab-9cf6-eccff069a0fd", "name": "Envia o código de confirmação do e-mail da abertura", "request": { "name": "Envia o código de confirmação do e-mail da abertura", "description": { "content": "Primeiro passo da abertura de conta, em todos os modos: o Lume envia um\ncódigo de seis dígitos ao e-mail informado. A pessoa o confirma em\n`POST /v1/onboarding/email-verifications/{id}/confirm` e abre a conta\ncom o `verificationId` em `POST /v1/onboarding`. Pública, como a\nabertura: ainda não há titular nem conta.\n\nO e-mail é gravado sem espaço nas pontas e em minúsculas; a abertura\nconfere o mesmo e-mail. O código vale 10 minutos. Um pedido novo ao\nmesmo e-mail cancela o anterior. Limites (`429 RATE_LIMITED`, com\n`Retry-After` em segundos): 60 segundos entre dois envios ao mesmo\ne-mail; 3 por hora e 5 por dia ao mesmo e-mail; 10 por hora por\nendereço IP. E-mail com cinco códigos errados nos últimos 15 minutos\nnão recebe outro até a janela passar (`429 TOO_MANY_ATTEMPTS`).\n\nO código nunca aparece em resposta nem em log.\n", "type": "text/plain" }, "url": { "path": [ "v1", "onboarding", "email-verifications" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"email\": \"rosalina.alencar@email.com.br\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "494e7030-d64f-4aa5-a81a-91a5fe1b1135", "name": "Código enviado", "originalRequest": { "url": { "path": [ "v1", "onboarding", "email-verifications" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"email\": \"rosalina.alencar@email.com.br\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"verificationId\": \"ver_8c1d2e4b9a7f40c1b2d3e4f5a6b7c8d9\",\n \"sentTo\": \"ro***@email.com.br\",\n \"expiresAt\": \"2008-09-05T12:51:19.538Z\",\n \"resendAfter\": \"1974-11-18T10:16:33.016Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d20bd2b2-e0d6-4f0c-ad4a-478296fd633a", "name": "Requisição malformada ou com dado inválido", "originalRequest": { "url": { "path": [ "v1", "onboarding", "email-verifications" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"email\": \"rosalina.alencar@email.com.br\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a3d44fcb-e81d-49b3-a6be-63f434921693", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "onboarding", "email-verifications" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"email\": \"rosalina.alencar@email.com.br\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fd36baa3-632e-463a-b519-9268b02ecae7", "name": "E-mail inválido (`INVALID_REQUEST`), instalação sem fornecedor de\ne-mail (`INVALID_REQUEST`), ou o fornecedor recusou o destino\n(`PROVIDER_ERROR`).\n", "originalRequest": { "url": { "path": [ "v1", "onboarding", "email-verifications" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"email\": \"rosalina.alencar@email.com.br\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aa8494ba-693e-43a8-ac3f-a788d27f03ee", "name": "Limite de envio (`RATE_LIMITED`) ou e-mail travado por códigos\nerrados (`TOO_MANY_ATTEMPTS`). `Retry-After` diz quantos segundos\nesperar.\n", "originalRequest": { "url": { "path": [ "v1", "onboarding", "email-verifications" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"email\": \"rosalina.alencar@email.com.br\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "disabled": true, "key": "Retry-After", "value": "-55892037", "description": "" }, { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4ae22d4b-2884-4367-bee4-ba1362274965", "name": "O fornecedor de e-mail não respondeu, ou a abertura está\nindisponível nesta instalação (`PROVIDER_ERROR`). O código pode ter\nsaído; o pedido não vale e conta nos limites.\n", "originalRequest": { "url": { "path": [ "v1", "onboarding", "email-verifications" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"email\": \"rosalina.alencar@email.com.br\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "bcd8f79c-2918-425a-86ea-fcccce23d9b4", "name": "Confirma o código do e-mail da abertura", "request": { "name": "Confirma o código do e-mail da abertura", "description": { "content": "A pessoa digita o código recebido. Certo, o pedido fica confirmado e\nvale 15 minutos, uma vez, para abrir a conta com aquele e-mail\n(`emailVerificationId` em `POST /v1/onboarding`).\n\nCódigo errado é `422 INVALID_REQUEST` com `details.remainingAttempts`.\nNo quinto erro do pedido, ou no quinto do e-mail em 15 minutos somando\ntodos os pedidos, a resposta é `429 TOO_MANY_ATTEMPTS` e o pedido não\nserve mais; espere o `Retry-After` e peça outro código.\n\nPedido que não existe é `404`. Pedido já confirmado, usado,\nsubstituído ou vencido é `409 CONFLICT`: peça outro.\n", "type": "text/plain" }, "url": { "path": [ "v1", "onboarding", "email-verifications", ":id", "confirm" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"code\": \"482913\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "04c94cd5-bf59-48ec-8118-cde570abbd4c", "name": "E-mail confirmado", "originalRequest": { "url": { "path": [ "v1", "onboarding", "email-verifications", ":id", "confirm" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"482913\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"verificationId\": \"laborum mollit\",\n \"verifiedAt\": \"1994-08-26T08:44:26.433Z\",\n \"validUntil\": \"1996-09-12T21:32:48.619Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dd7c5a0c-af25-49af-afd9-8a87995af526", "name": "Requisição malformada ou com dado inválido", "originalRequest": { "url": { "path": [ "v1", "onboarding", "email-verifications", ":id", "confirm" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"482913\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a6c14e58-9867-4b9b-ac0d-ac95a12dc2a8", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "onboarding", "email-verifications", ":id", "confirm" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"482913\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "561e49c4-04d0-4c72-9aeb-de3990a4dcf4", "name": "Registro não encontrado", "originalRequest": { "url": { "path": [ "v1", "onboarding", "email-verifications", ":id", "confirm" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"482913\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "428d6ab9-6e59-4a8c-af2d-70485c2b3c8b", "name": "Pedido já confirmado, usado, substituído ou vencido (`CONFLICT`). Peça outro.", "originalRequest": { "url": { "path": [ "v1", "onboarding", "email-verifications", ":id", "confirm" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"482913\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7a33df23-b7b5-4c54-9aaa-2b3e649f70e9", "name": "Código incorreto (`INVALID_REQUEST`), com `details.remainingAttempts`.", "originalRequest": { "url": { "path": [ "v1", "onboarding", "email-verifications", ":id", "confirm" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"482913\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c4fa2540-7773-4b9b-8af0-11c2e887945b", "name": "Pedido ou e-mail travado por códigos errados (`TOO_MANY_ATTEMPTS`).", "originalRequest": { "url": { "path": [ "v1", "onboarding", "email-verifications", ":id", "confirm" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"482913\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "disabled": true, "key": "Retry-After", "value": "-55892037", "description": "" }, { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "01fe24c8-a5d2-47d7-8a8e-91ac4d2e3755", "name": "Pede de novo a tela de cadastro do provedor", "request": { "name": "Pede de novo a tela de cadastro do provedor", "description": { "content": "É por aqui que a tela de cadastro do provedor chega ao front, logo\ndepois da abertura e sempre que a pessoa precisa voltar a ela. Só\nenquanto o cadastro não foi enviado para análise\n(`CUSTOMER_CREATED` ou `IN_PROGRESS`); depois, `409`. Sem corpo.\n", "type": "text/plain" }, "url": { "path": [ "v1", "onboarding", "hosted-link" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "6c8fa0b1-e023-4d3a-b6af-497ccdfc16b7", "name": "Endereço da tela de cadastro", "originalRequest": { "url": { "path": [ "v1", "onboarding", "hosted-link" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"url\": \"https://pyrJAFHNsDuFQb.bvgnZrerzfKkUEAdfdMcgiEus1I6G.tSbFdGG-GhVt\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bbf1dc56-0956-4a23-be41-a98c276efbb6", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "onboarding", "hosted-link" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c56ae7e7-54b6-4c13-84a6-fba5db0d00cc", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "onboarding", "hosted-link" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9c9fa7cf-77aa-479f-8077-0ee0891989e9", "name": "Registro não encontrado", "originalRequest": { "url": { "path": [ "v1", "onboarding", "hosted-link" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d4be83fd-c43c-4993-89c9-fa21a85bf0b2", "name": "O cadastro já foi enviado, a conta não está mais em abertura (bloqueada ou encerrada), ou a abertura não é do modo `hosted` (`CONFLICT`).", "originalRequest": { "url": { "path": [ "v1", "onboarding", "hosted-link" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dc75fc1d-46a7-4c6e-a06d-5ade851c91b6", "name": "O provedor financeiro recusou o pedido (`PROVIDER_ERROR`).", "originalRequest": { "url": { "path": [ "v1", "onboarding", "hosted-link" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9f6ed990-acb7-4ae7-970c-f39e756ebbf4", "name": "O arranjo de pagamento está indisponível. Tente novamente.", "originalRequest": { "url": { "path": [ "v1", "onboarding", "hosted-link" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b2c051c6-a3c0-4c0b-baaf-d332ecfcb198", "name": "Continua a abertura parada no meio, pela página pública", "request": { "name": "Continua a abertura parada no meio, pela página pública", "description": { "content": "Para quem começou a abertura e parou na coleta (PROVISÓRIO,\n27/10/2026): com o documento e a senha escolhida na abertura, devolve\num `onboardingToken` novo, o mesmo da abertura recém-feita, que só\nalcança as rotas de `/v1/onboarding`. Não abre sessão e não dá acesso\nà conta. Quem já configurou o autenticador (entrou pela área logada)\ninforma também o código dele (`code`), que vale uma vez só.\n\nVale enquanto o titular não é cliente de fato: todas as contas em\nabertura, sem representação, e o cadastro ainda não enviado\n(`CUSTOMER_CREATED` ou `IN_PROGRESS`). Fora disso, `409`, mas só com a\nsenha certa; documento inexistente responde como senha errada. As\ntentativas contam junto com as do login (`429`).\n", "type": "text/plain" }, "url": { "path": [ "v1", "onboarding", "resume" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"document\": \"non deserunt\",\n \"password\": \"enim\",\n \"code\": \"aliquip reprehenderit dolor ex\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "3317caa9-95a4-4856-8e0d-9af88cd4fe45", "name": "Abertura retomada. `mode` é o da abertura (`own` ou `hosted`); no `hosted`, a tela do provedor vem de `POST /v1/onboarding/hosted-link`.", "originalRequest": { "url": { "path": [ "v1", "onboarding", "resume" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"document\": \"non deserunt\",\n \"password\": \"enim\",\n \"code\": \"aliquip reprehenderit dolor ex\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"onboardingToken\": \"adipisicing officia veniam consequat\",\n \"stage\": \"CUSTOMER_CREATED\",\n \"mode\": \"own\",\n \"status\": \"IN_REVIEW\",\n \"expiresIn\": 1511334,\n \"message\": \"labore\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "06e42dc1-957a-452b-9d56-e72d76835fd4", "name": "Corpo ilegível (`INVALID_REQUEST`).", "originalRequest": { "url": { "path": [ "v1", "onboarding", "resume" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"document\": \"non deserunt\",\n \"password\": \"enim\",\n \"code\": \"aliquip reprehenderit dolor ex\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d899153f-c4a2-4b72-a8a9-59efd26d77d2", "name": "Documento ou senha incorretos, ou o código do autenticador faltando ou incorreto, com `details.field = \"code\"` (`UNAUTHORIZED`).", "originalRequest": { "url": { "path": [ "v1", "onboarding", "resume" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"document\": \"non deserunt\",\n \"password\": \"enim\",\n \"code\": \"aliquip reprehenderit dolor ex\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e40dcae8-fbf0-43a6-be16-d6bfdc9c97b2", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "onboarding", "resume" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"document\": \"non deserunt\",\n \"password\": \"enim\",\n \"code\": \"aliquip reprehenderit dolor ex\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b7acd730-429e-4f10-b9cc-558ad5640263", "name": "A abertura não está mais em preenchimento (enviada, aprovada, conta ativa) (`CONFLICT`).", "originalRequest": { "url": { "path": [ "v1", "onboarding", "resume" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"document\": \"non deserunt\",\n \"password\": \"enim\",\n \"code\": \"aliquip reprehenderit dolor ex\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "83fcd780-432d-4704-94e4-fde919a0820b", "name": "Documento inválido (`INVALID_REQUEST`).", "originalRequest": { "url": { "path": [ "v1", "onboarding", "resume" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"document\": \"non deserunt\",\n \"password\": \"enim\",\n \"code\": \"aliquip reprehenderit dolor ex\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "545eb9fa-8da9-4ecf-b072-5df698ba7286", "name": "Limite de requisições atingido. O cabeçalho `Retry-After` diz quantos\nsegundos esperar.\n", "originalRequest": { "url": { "path": [ "v1", "onboarding", "resume" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"document\": \"non deserunt\",\n \"password\": \"enim\",\n \"code\": \"aliquip reprehenderit dolor ex\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "eca9c1e1-1388-41c3-b769-1bb49b69bbc9", "name": "Envia os dados do cadastro ao provedor", "request": { "name": "Envia os dados do cadastro ao provedor", "description": { "content": "Só a abertura própria pelo provedor (`own` com o provedor decidindo),\nenquanto o cadastro não foi enviado\n(`CUSTOMER_CREATED` ou `IN_PROGRESS`); depois, `409`. Pode repetir até\na conclusão: cada envio regrava o cadastro no provedor.\n\n**Pessoa física:** nome e data de nascimento não vão aqui: são os\ninformados em `POST /v1/onboarding`. Mãe, PEP, endereço e renda vão ao\nprovedor e, depois que ele os aceita, ficam gravados também no Lume, na\nqualificação do cliente que o backoffice mostra; o nome social vai só\nao provedor. `birthDate`, `occupation` e `business` são recusados\n(`400`), como qualquer campo fora do contrato.\n\n**Empresa MEI ou EI** (`business_opening_own`; desligada, `403\nFEATURE_DISABLED`): `motherName`, `pep`, `address` e `declaredIncome`\nsão os do representante legal, e `birthDate` (o dele; menor de 18 anos\né recusado), `occupation` e `business` são obrigatórios. `socialName`\ne `averageMonthlyIncomeCents` não valem (a renda média é a da empresa,\nem `business`). O nome, o CPF e o contato do representante são os da\nabertura. O documento da empresa vai antes, em\n`POST /v1/onboarding/documents`; sem ele, `409`. Os dados do\nrepresentante vão só ao provedor (PROVISÓRIO): a qualificação do Lume\né do titular, e o titular é a empresa.\n\nO primeiro envio também pede ao provedor o processo biométrico do\ncliente, que vai junto (a Azify o exige no cadastro) e é o mesmo que a\nbiometria usa depois (na empresa, vai no representante: PROVISÓRIO).\nSem a biometria do provedor configurada na instalação, `503`.\nCom sucesso, o estágio vai a `IN_PROGRESS`; se o provedor falhar, o\nestágio não muda.\n", "type": "text/plain" }, "url": { "path": [ "v1", "onboarding", "profile" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"motherName\": \"laboris in do aliqua elit\",\n \"pep\": \"SELF\",\n \"address\": {\n \"street\": \"qui aliquip culpa ea\",\n \"number\": \"45\",\n \"neighborhood\": \"enim minim\",\n \"city\": \"sit nulla elit do\",\n \"state\": \"RJ\",\n \"zipCode\": \"24220-031\",\n \"complement\": \"in\",\n \"country\": \"BR\"\n },\n \"declaredIncome\": \"LESS_THAN_ONE_THOUSAND\",\n \"socialName\": \"nostrud officia Lorem cillum\",\n \"averageMonthlyIncomeCents\": 51334246,\n \"birthDate\": \"1966-08-05\",\n \"occupation\": \"OCP0001\",\n \"business\": {\n \"declaredAnnualBilling\": \"MORE_THAN_FIFTY_THOUSAND_UP_TO_ONE_HUNDRED_THOUSAND\",\n \"address\": {\n \"street\": \"ipsum sit ut anim\",\n \"number\": \"in eiusmod ullamc\",\n \"neighborhood\": \"reprehe\",\n \"city\": \"aute occaecat enim\",\n \"state\": \"SP\",\n \"zipCode\": \"01311-000\",\n \"complement\": \"enim\",\n \"country\": \"BR\"\n },\n \"averageMonthlyIncomeCents\": 80193522\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "d3d77f65-825e-4dce-b745-2283d9ac5676", "name": "Dados aceitos pelo provedor", "originalRequest": { "url": { "path": [ "v1", "onboarding", "profile" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"motherName\": \"laboris in do aliqua elit\",\n \"pep\": \"SELF\",\n \"address\": {\n \"street\": \"qui aliquip culpa ea\",\n \"number\": \"45\",\n \"neighborhood\": \"enim minim\",\n \"city\": \"sit nulla elit do\",\n \"state\": \"RJ\",\n \"zipCode\": \"24220-031\",\n \"complement\": \"in\",\n \"country\": \"BR\"\n },\n \"declaredIncome\": \"LESS_THAN_ONE_THOUSAND\",\n \"socialName\": \"nostrud officia Lorem cillum\",\n \"averageMonthlyIncomeCents\": 51334246,\n \"birthDate\": \"1966-08-05\",\n \"occupation\": \"OCP0001\",\n \"business\": {\n \"declaredAnnualBilling\": \"MORE_THAN_FIFTY_THOUSAND_UP_TO_ONE_HUNDRED_THOUSAND\",\n \"address\": {\n \"street\": \"ipsum sit ut anim\",\n \"number\": \"in eiusmod ullamc\",\n \"neighborhood\": \"reprehe\",\n \"city\": \"aute occaecat enim\",\n \"state\": \"SP\",\n \"zipCode\": \"01311-000\",\n \"complement\": \"enim\",\n \"country\": \"BR\"\n },\n \"averageMonthlyIncomeCents\": 80193522\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"stage\": \"FAILED\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f4091ca9-457c-4b82-b32d-293878278626", "name": "Corpo ilegível ou com campo que o contrato não tem (`INVALID_REQUEST`).", "originalRequest": { "url": { "path": [ "v1", "onboarding", "profile" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"motherName\": \"laboris in do aliqua elit\",\n \"pep\": \"SELF\",\n \"address\": {\n \"street\": \"qui aliquip culpa ea\",\n \"number\": \"45\",\n \"neighborhood\": \"enim minim\",\n \"city\": \"sit nulla elit do\",\n \"state\": \"RJ\",\n \"zipCode\": \"24220-031\",\n \"complement\": \"in\",\n \"country\": \"BR\"\n },\n \"declaredIncome\": \"LESS_THAN_ONE_THOUSAND\",\n \"socialName\": \"nostrud officia Lorem cillum\",\n \"averageMonthlyIncomeCents\": 51334246,\n \"birthDate\": \"1966-08-05\",\n \"occupation\": \"OCP0001\",\n \"business\": {\n \"declaredAnnualBilling\": \"MORE_THAN_FIFTY_THOUSAND_UP_TO_ONE_HUNDRED_THOUSAND\",\n \"address\": {\n \"street\": \"ipsum sit ut anim\",\n \"number\": \"in eiusmod ullamc\",\n \"neighborhood\": \"reprehe\",\n \"city\": \"aute occaecat enim\",\n \"state\": \"SP\",\n \"zipCode\": \"01311-000\",\n \"complement\": \"enim\",\n \"country\": \"BR\"\n },\n \"averageMonthlyIncomeCents\": 80193522\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "15150263-df19-4f3e-b08a-5b4213b97ed3", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "onboarding", "profile" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"motherName\": \"laboris in do aliqua elit\",\n \"pep\": \"SELF\",\n \"address\": {\n \"street\": \"qui aliquip culpa ea\",\n \"number\": \"45\",\n \"neighborhood\": \"enim minim\",\n \"city\": \"sit nulla elit do\",\n \"state\": \"RJ\",\n \"zipCode\": \"24220-031\",\n \"complement\": \"in\",\n \"country\": \"BR\"\n },\n \"declaredIncome\": \"LESS_THAN_ONE_THOUSAND\",\n \"socialName\": \"nostrud officia Lorem cillum\",\n \"averageMonthlyIncomeCents\": 51334246,\n \"birthDate\": \"1966-08-05\",\n \"occupation\": \"OCP0001\",\n \"business\": {\n \"declaredAnnualBilling\": \"MORE_THAN_FIFTY_THOUSAND_UP_TO_ONE_HUNDRED_THOUSAND\",\n \"address\": {\n \"street\": \"ipsum sit ut anim\",\n \"number\": \"in eiusmod ullamc\",\n \"neighborhood\": \"reprehe\",\n \"city\": \"aute occaecat enim\",\n \"state\": \"SP\",\n \"zipCode\": \"01311-000\",\n \"complement\": \"enim\",\n \"country\": \"BR\"\n },\n \"averageMonthlyIncomeCents\": 80193522\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7e23f3e2-9e0c-49e1-b1a3-85fa319d27f4", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "onboarding", "profile" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"motherName\": \"laboris in do aliqua elit\",\n \"pep\": \"SELF\",\n \"address\": {\n \"street\": \"qui aliquip culpa ea\",\n \"number\": \"45\",\n \"neighborhood\": \"enim minim\",\n \"city\": \"sit nulla elit do\",\n \"state\": \"RJ\",\n \"zipCode\": \"24220-031\",\n \"complement\": \"in\",\n \"country\": \"BR\"\n },\n \"declaredIncome\": \"LESS_THAN_ONE_THOUSAND\",\n \"socialName\": \"nostrud officia Lorem cillum\",\n \"averageMonthlyIncomeCents\": 51334246,\n \"birthDate\": \"1966-08-05\",\n \"occupation\": \"OCP0001\",\n \"business\": {\n \"declaredAnnualBilling\": \"MORE_THAN_FIFTY_THOUSAND_UP_TO_ONE_HUNDRED_THOUSAND\",\n \"address\": {\n \"street\": \"ipsum sit ut anim\",\n \"number\": \"in eiusmod ullamc\",\n \"neighborhood\": \"reprehe\",\n \"city\": \"aute occaecat enim\",\n \"state\": \"SP\",\n \"zipCode\": \"01311-000\",\n \"complement\": \"enim\",\n \"country\": \"BR\"\n },\n \"averageMonthlyIncomeCents\": 80193522\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "adb94769-dfe2-48c2-8d94-b1295b761897", "name": "Registro não encontrado", "originalRequest": { "url": { "path": [ "v1", "onboarding", "profile" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"motherName\": \"laboris in do aliqua elit\",\n \"pep\": \"SELF\",\n \"address\": {\n \"street\": \"qui aliquip culpa ea\",\n \"number\": \"45\",\n \"neighborhood\": \"enim minim\",\n \"city\": \"sit nulla elit do\",\n \"state\": \"RJ\",\n \"zipCode\": \"24220-031\",\n \"complement\": \"in\",\n \"country\": \"BR\"\n },\n \"declaredIncome\": \"LESS_THAN_ONE_THOUSAND\",\n \"socialName\": \"nostrud officia Lorem cillum\",\n \"averageMonthlyIncomeCents\": 51334246,\n \"birthDate\": \"1966-08-05\",\n \"occupation\": \"OCP0001\",\n \"business\": {\n \"declaredAnnualBilling\": \"MORE_THAN_FIFTY_THOUSAND_UP_TO_ONE_HUNDRED_THOUSAND\",\n \"address\": {\n \"street\": \"ipsum sit ut anim\",\n \"number\": \"in eiusmod ullamc\",\n \"neighborhood\": \"reprehe\",\n \"city\": \"aute occaecat enim\",\n \"state\": \"SP\",\n \"zipCode\": \"01311-000\",\n \"complement\": \"enim\",\n \"country\": \"BR\"\n },\n \"averageMonthlyIncomeCents\": 80193522\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1ee6dd33-6008-498f-a3ff-e629bebe11d3", "name": "O cadastro já foi enviado, a conta não está mais em abertura (bloqueada, encerrada ou já ativa), a abertura não é a própria, ou a empresa ainda não enviou o documento (`CONFLICT`).", "originalRequest": { "url": { "path": [ "v1", "onboarding", "profile" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"motherName\": \"laboris in do aliqua elit\",\n \"pep\": \"SELF\",\n \"address\": {\n \"street\": \"qui aliquip culpa ea\",\n \"number\": \"45\",\n \"neighborhood\": \"enim minim\",\n \"city\": \"sit nulla elit do\",\n \"state\": \"RJ\",\n \"zipCode\": \"24220-031\",\n \"complement\": \"in\",\n \"country\": \"BR\"\n },\n \"declaredIncome\": \"LESS_THAN_ONE_THOUSAND\",\n \"socialName\": \"nostrud officia Lorem cillum\",\n \"averageMonthlyIncomeCents\": 51334246,\n \"birthDate\": \"1966-08-05\",\n \"occupation\": \"OCP0001\",\n \"business\": {\n \"declaredAnnualBilling\": \"MORE_THAN_FIFTY_THOUSAND_UP_TO_ONE_HUNDRED_THOUSAND\",\n \"address\": {\n \"street\": \"ipsum sit ut anim\",\n \"number\": \"in eiusmod ullamc\",\n \"neighborhood\": \"reprehe\",\n \"city\": \"aute occaecat enim\",\n \"state\": \"SP\",\n \"zipCode\": \"01311-000\",\n \"complement\": \"enim\",\n \"country\": \"BR\"\n },\n \"averageMonthlyIncomeCents\": 80193522\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "37b80108-ef2e-48ff-9090-f8d53f1db88c", "name": "Campo faltando ou inválido (`INVALID_REQUEST`), ou o provedor recusou os dados (`PROVIDER_ERROR`).", "originalRequest": { "url": { "path": [ "v1", "onboarding", "profile" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"motherName\": \"laboris in do aliqua elit\",\n \"pep\": \"SELF\",\n \"address\": {\n \"street\": \"qui aliquip culpa ea\",\n \"number\": \"45\",\n \"neighborhood\": \"enim minim\",\n \"city\": \"sit nulla elit do\",\n \"state\": \"RJ\",\n \"zipCode\": \"24220-031\",\n \"complement\": \"in\",\n \"country\": \"BR\"\n },\n \"declaredIncome\": \"LESS_THAN_ONE_THOUSAND\",\n \"socialName\": \"nostrud officia Lorem cillum\",\n \"averageMonthlyIncomeCents\": 51334246,\n \"birthDate\": \"1966-08-05\",\n \"occupation\": \"OCP0001\",\n \"business\": {\n \"declaredAnnualBilling\": \"MORE_THAN_FIFTY_THOUSAND_UP_TO_ONE_HUNDRED_THOUSAND\",\n \"address\": {\n \"street\": \"ipsum sit ut anim\",\n \"number\": \"in eiusmod ullamc\",\n \"neighborhood\": \"reprehe\",\n \"city\": \"aute occaecat enim\",\n \"state\": \"SP\",\n \"zipCode\": \"01311-000\",\n \"complement\": \"enim\",\n \"country\": \"BR\"\n },\n \"averageMonthlyIncomeCents\": 80193522\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d8a6a946-4b9e-46e4-b369-400060c4884e", "name": "O arranjo de pagamento está indisponível. Tente novamente.", "originalRequest": { "url": { "path": [ "v1", "onboarding", "profile" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"motherName\": \"laboris in do aliqua elit\",\n \"pep\": \"SELF\",\n \"address\": {\n \"street\": \"qui aliquip culpa ea\",\n \"number\": \"45\",\n \"neighborhood\": \"enim minim\",\n \"city\": \"sit nulla elit do\",\n \"state\": \"RJ\",\n \"zipCode\": \"24220-031\",\n \"complement\": \"in\",\n \"country\": \"BR\"\n },\n \"declaredIncome\": \"LESS_THAN_ONE_THOUSAND\",\n \"socialName\": \"nostrud officia Lorem cillum\",\n \"averageMonthlyIncomeCents\": 51334246,\n \"birthDate\": \"1966-08-05\",\n \"occupation\": \"OCP0001\",\n \"business\": {\n \"declaredAnnualBilling\": \"MORE_THAN_FIFTY_THOUSAND_UP_TO_ONE_HUNDRED_THOUSAND\",\n \"address\": {\n \"street\": \"ipsum sit ut anim\",\n \"number\": \"in eiusmod ullamc\",\n \"neighborhood\": \"reprehe\",\n \"city\": \"aute occaecat enim\",\n \"state\": \"SP\",\n \"zipCode\": \"01311-000\",\n \"complement\": \"enim\",\n \"country\": \"BR\"\n },\n \"averageMonthlyIncomeCents\": 80193522\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "caffc6c2-8f3f-4000-ad3a-3272e676a53f", "name": "Termos do provedor para o aceite", "request": { "name": "Termos do provedor para o aceite", "description": { "content": "Os documentos de termos do provedor que a pessoa aceita ao concluir, em\n`urls`, na ordem do provedor (desde 25/10/2026, a Azify devolve dois).\n`url` repete o primeiro, para o cliente que ainda não lê a lista. O\nLume guarda a lista e a versão como o que foi mostrado; a conclusão só\naceita essa mesma lista. Pedir de novo antes do aceite troca o que foi\nmostrado; depois do aceite, devolve os termos aceitos. A versão é a do\nprovedor quando ele a informar; até lá, é a impressão digital da lista\n(`url-sha256:…`; com um documento só, a do endereço, como antes). Só a\nabertura própria, antes do envio do cadastro.\n", "type": "text/plain" }, "url": { "path": [ "v1", "onboarding", "terms" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "75b1d181-b9c7-415f-81a8-ea519b85b2c9", "name": "Termos a aceitar", "originalRequest": { "url": { "path": [ "v1", "onboarding", "terms" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"url\": \"https://Lf.dkjJpJ6wX5DaMOs5nFALC5gkZmdE8rI1O6XhwUunTL,nltpfSP4fSqOMbvsSc\",\n \"urls\": [\n \"https://BlJYn.xmNYv+urpe+3eeBdew6fLUFhJBJbetfFagFXX,6x5,YpdxutFWrVl1X,13\"\n ],\n \"version\": \"url-sha256:3b1f0c9a7d2e4f61\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "00c759ea-4e13-4789-9f27-dfbb0996e05f", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "onboarding", "terms" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "840aaf8b-fcb8-4022-849e-067039a764de", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "onboarding", "terms" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c32cf106-3543-462e-9446-b3f42dbfe2a8", "name": "Registro não encontrado", "originalRequest": { "url": { "path": [ "v1", "onboarding", "terms" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7b3b35b8-b487-4012-81d1-26b733586dea", "name": "O cadastro já foi enviado, a conta não está mais em abertura (bloqueada, encerrada ou já ativa), ou a abertura não é a própria (`CONFLICT`).", "originalRequest": { "url": { "path": [ "v1", "onboarding", "terms" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "12156e9b-1e34-450e-b6fb-5345375e0518", "name": "O provedor recusou o pedido (`PROVIDER_ERROR`).", "originalRequest": { "url": { "path": [ "v1", "onboarding", "terms" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4a9fe11a-33f0-4388-b018-fa2bde50b206", "name": "O arranjo de pagamento está indisponível. Tente novamente.", "originalRequest": { "url": { "path": [ "v1", "onboarding", "terms" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "d95c2fe7-21b0-45cd-8155-24714193d668", "name": "Aceita os termos e envia o cadastro para análise", "request": { "name": "Aceita os termos e envia o cadastro para análise", "description": { "content": "Exige os dados enviados (`IN_PROGRESS`; em `CUSTOMER_CREATED`, `409`),\n`acceptTerms: true` e `termsUrls` igual à lista `urls` devolvida por\n`GET /v1/onboarding/terms`, inteira e na mesma ordem (ou, no cliente\nque ainda não manda a lista, `termsUrl` igual ao único documento); sem\nisso, `422` e nada vai ao provedor. Com mais de um documento, o\n`termsUrl` sozinho não prova o aceite e volta `422`.\nExige também a biometria aberta (alguma sessão pedida em\n`POST /v1/onboarding/biometrics/session` para esta abertura; o processo\nbiométrico, que nasce no envio dos dados, não basta); sem ela, `409`, sem gravar o\naceite nem chamar o provedor. Na empresa, exige também o documento\naceito em `POST /v1/onboarding/documents` e os dados do cadastro\nenviados depois dele (documento trocado depois dos dados pede os dados\nde novo), sem envio do documento em andamento; sem isso, `409`. O aceite é gravado com data e hora, endereço, versão, IP e user agent\nantes de o provedor concluir, e o primeiro aceite nunca é regravado.\nSe o provedor falhar, o estágio fica em `IN_PROGRESS` e a pessoa pode\nrepetir. Com sucesso, o estágio vai a `SUBMITTED` (ou ao que o evento\ndo provedor já trouxe), e a conta é liberada quando o provedor aprova o\ncadastro. Depois do envio, `409`.\n", "type": "text/plain" }, "url": { "path": [ "v1", "onboarding", "complete" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"acceptTerms\": true,\n \"termsUrls\": [\n \"https://EtwDAWOojokkehDeiASGzgbRTN.ialbKGwJkBX7VO2xpvpRJrZKef4SvN5-EpUWhp2MN8SxT\"\n ],\n \"termsUrl\": \"https://bHNgzdxgxJPWGRlfhuHkDjhrchLdvsr.gnv0AwXbh\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "53273e12-8cba-4014-a4a8-9814bb41536d", "name": "Cadastro enviado para análise", "originalRequest": { "url": { "path": [ "v1", "onboarding", "complete" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"acceptTerms\": true,\n \"termsUrls\": [\n \"https://EtwDAWOojokkehDeiASGzgbRTN.ialbKGwJkBX7VO2xpvpRJrZKef4SvN5-EpUWhp2MN8SxT\"\n ],\n \"termsUrl\": \"https://bHNgzdxgxJPWGRlfhuHkDjhrchLdvsr.gnv0AwXbh\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"stage\": \"FAILED\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1680cc0d-b125-4527-a99d-0ad2e48e330c", "name": "Corpo ilegível ou com campo que o contrato não tem (`INVALID_REQUEST`).", "originalRequest": { "url": { "path": [ "v1", "onboarding", "complete" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"acceptTerms\": true,\n \"termsUrls\": [\n \"https://EtwDAWOojokkehDeiASGzgbRTN.ialbKGwJkBX7VO2xpvpRJrZKef4SvN5-EpUWhp2MN8SxT\"\n ],\n \"termsUrl\": \"https://bHNgzdxgxJPWGRlfhuHkDjhrchLdvsr.gnv0AwXbh\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9556b609-e14d-4abd-a8ae-0991881e83f8", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "onboarding", "complete" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"acceptTerms\": true,\n \"termsUrls\": [\n \"https://EtwDAWOojokkehDeiASGzgbRTN.ialbKGwJkBX7VO2xpvpRJrZKef4SvN5-EpUWhp2MN8SxT\"\n ],\n \"termsUrl\": \"https://bHNgzdxgxJPWGRlfhuHkDjhrchLdvsr.gnv0AwXbh\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "71e50fe5-36f2-4fa2-bafb-de8502f6043b", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "onboarding", "complete" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"acceptTerms\": true,\n \"termsUrls\": [\n \"https://EtwDAWOojokkehDeiASGzgbRTN.ialbKGwJkBX7VO2xpvpRJrZKef4SvN5-EpUWhp2MN8SxT\"\n ],\n \"termsUrl\": \"https://bHNgzdxgxJPWGRlfhuHkDjhrchLdvsr.gnv0AwXbh\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7d29ac9e-1e65-4059-b85e-44583df1d1da", "name": "Registro não encontrado", "originalRequest": { "url": { "path": [ "v1", "onboarding", "complete" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"acceptTerms\": true,\n \"termsUrls\": [\n \"https://EtwDAWOojokkehDeiASGzgbRTN.ialbKGwJkBX7VO2xpvpRJrZKef4SvN5-EpUWhp2MN8SxT\"\n ],\n \"termsUrl\": \"https://bHNgzdxgxJPWGRlfhuHkDjhrchLdvsr.gnv0AwXbh\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "26f59239-0fe8-4650-94cb-113ec7529f29", "name": "Dados ainda não enviados, biometria ainda não aberta, documento da empresa ausente ou trocado depois dos dados, cadastro já enviado, conta fora de abertura (bloqueada, encerrada ou já ativa), ou a abertura não é a própria (`CONFLICT`).", "originalRequest": { "url": { "path": [ "v1", "onboarding", "complete" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"acceptTerms\": true,\n \"termsUrls\": [\n \"https://EtwDAWOojokkehDeiASGzgbRTN.ialbKGwJkBX7VO2xpvpRJrZKef4SvN5-EpUWhp2MN8SxT\"\n ],\n \"termsUrl\": \"https://bHNgzdxgxJPWGRlfhuHkDjhrchLdvsr.gnv0AwXbh\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "878c2f4b-3bb0-431f-8733-9f74b4cf6327", "name": "Sem o aceite, termos não abertos ou outro endereço\n(`INVALID_REQUEST`), ou o provedor recusou a conclusão\n(`PROVIDER_ERROR`).\n", "originalRequest": { "url": { "path": [ "v1", "onboarding", "complete" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"acceptTerms\": true,\n \"termsUrls\": [\n \"https://EtwDAWOojokkehDeiASGzgbRTN.ialbKGwJkBX7VO2xpvpRJrZKef4SvN5-EpUWhp2MN8SxT\"\n ],\n \"termsUrl\": \"https://bHNgzdxgxJPWGRlfhuHkDjhrchLdvsr.gnv0AwXbh\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "84bc449e-cae9-4404-a778-4c232add0edb", "name": "O arranjo de pagamento está indisponível. Tente novamente.", "originalRequest": { "url": { "path": [ "v1", "onboarding", "complete" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"acceptTerms\": true,\n \"termsUrls\": [\n \"https://EtwDAWOojokkehDeiASGzgbRTN.ialbKGwJkBX7VO2xpvpRJrZKef4SvN5-EpUWhp2MN8SxT\"\n ],\n \"termsUrl\": \"https://bHNgzdxgxJPWGRlfhuHkDjhrchLdvsr.gnv0AwXbh\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2924c1fa-a23a-4ff5-9351-6b463201a6b8", "name": "Envia o documento da empresa ao provedor", "request": { "name": "Envia o documento da empresa ao provedor", "description": { "content": "Só a abertura própria de empresa MEI ou EI (`own` com o provedor\ndecidindo, `PJ`), com a funcionalidade `business_opening_own` ligada\n(desligada, `403 FEATURE_DISABLED`), enquanto o cadastro não foi\nenviado (`CUSTOMER_CREATED` ou `IN_PROGRESS`); depois, `409`. Pessoa\nfísica, `409`.\n\n`kind` é `LEGAL_DOCUMENTS`: o Certificado da Condição de\nMicroempreendedor Individual (MEI) ou o Requerimento de Empresário\n(EI). `file` é o arquivo em base64, com ou sem o prefixo de data URL.\nSó PDF, conferido pelos bytes (e não pelo nome ou pelo tipo\ndeclarado), até 3 MB (PROVISÓRIO: o mesmo teto dos outros documentos,\naté o provedor informar o dele).\n\nO arquivo vai direto ao provedor e **não fica guardado no Lume**: ficam\no tipo, o tamanho, a impressão digital (sha256) e a data. A resposta\nnunca traz o id nem o endereço do documento no provedor. O endereço é\nguardado só enquanto o cadastro está na coleta, e no máximo 7 dias\n(PROVISÓRIO); passado isso, os dados do cadastro pedem o documento de\nnovo (`409`), e o mesmo arquivo pode ir outra vez.\n\nUm documento por abertura: o novo aceito substitui o anterior, e\ndepois dele os dados do cadastro (`PUT /v1/onboarding/profile`) têm de\nir de novo. O mesmo arquivo já aceito responde `200` com\n`reused: true`, sem ir ao provedor. Sem resposta do provedor (prazo\nesgotado), `503`, e o mesmo arquivo fica travado por 15 minutos\n(`409`) em vez de sair de novo às cegas: o provedor pode tê-lo\nrecebido. Dois envios ao mesmo tempo não saem juntos (`409` para o\nsegundo). Até 10 envios ao provedor por abertura em 24 horas, aceitos\nou recusados (o mesmo arquivo reaproveitado não conta); acima, `429`\n(PROVISÓRIO). A instância processa poucos envios ao mesmo tempo:\ncheia, `503 RATE_LIMITED` com `Retry-After`.\n", "type": "text/plain" }, "url": { "path": [ "v1", "onboarding", "documents" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"kind\": \"LEGAL_DOCUMENTS\",\n \"file\": \"pariatur sunt sint\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "171d5bda-6b1e-48b3-bd9e-1ad7121e80e7", "name": "O mesmo arquivo já tinha sido aceito; nada foi ao provedor (`reused` verdadeiro).", "originalRequest": { "url": { "path": [ "v1", "onboarding", "documents" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"kind\": \"LEGAL_DOCUMENTS\",\n \"file\": \"pariatur sunt sint\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"contentType\": \"application/pdf\",\n \"kind\": \"LEGAL_DOCUMENTS\",\n \"profileSent\": true,\n \"reused\": false,\n \"sizeBytes\": 8553396,\n \"uploadedAt\": \"1987-10-09T03:24:51.731Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "24155a4d-acbd-495f-949c-2ecad2ed2378", "name": "Documento aceito pelo provedor.", "originalRequest": { "url": { "path": [ "v1", "onboarding", "documents" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"kind\": \"LEGAL_DOCUMENTS\",\n \"file\": \"pariatur sunt sint\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"contentType\": \"application/pdf\",\n \"kind\": \"LEGAL_DOCUMENTS\",\n \"profileSent\": true,\n \"reused\": false,\n \"sizeBytes\": 8553396,\n \"uploadedAt\": \"1987-10-09T03:24:51.731Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "75b3aa4b-7cbf-4aae-922b-e177e0805b4a", "name": "Corpo ilegível ou com campo que o contrato não tem (`INVALID_REQUEST`).", "originalRequest": { "url": { "path": [ "v1", "onboarding", "documents" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"kind\": \"LEGAL_DOCUMENTS\",\n \"file\": \"pariatur sunt sint\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cc08abdd-b7c3-4904-b26e-5efb9e6d9191", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "onboarding", "documents" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"kind\": \"LEGAL_DOCUMENTS\",\n \"file\": \"pariatur sunt sint\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "788d47e8-7a60-403b-9e69-e4631081e44a", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "onboarding", "documents" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"kind\": \"LEGAL_DOCUMENTS\",\n \"file\": \"pariatur sunt sint\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7177709c-794c-444e-b792-4beac03dcda4", "name": "Registro não encontrado", "originalRequest": { "url": { "path": [ "v1", "onboarding", "documents" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"kind\": \"LEGAL_DOCUMENTS\",\n \"file\": \"pariatur sunt sint\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "862b977a-3c32-4c82-8c99-56a3efe6ac2f", "name": "Cadastro já enviado, conta fora de abertura, abertura que não é a\nprópria de empresa, envio do documento em andamento, ou o envio\nanterior do mesmo arquivo ficou sem resposta há menos de 15\nminutos (`CONFLICT`).\n", "originalRequest": { "url": { "path": [ "v1", "onboarding", "documents" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"kind\": \"LEGAL_DOCUMENTS\",\n \"file\": \"pariatur sunt sint\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a72761ee-d0f1-411b-984e-25097b972191", "name": "Arquivo acima de 3 MB (`INVALID_REQUEST`).", "originalRequest": { "url": { "path": [ "v1", "onboarding", "documents" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"kind\": \"LEGAL_DOCUMENTS\",\n \"file\": \"pariatur sunt sint\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Request Entity Too Large", "code": 413, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fd175f3a-cd1b-49ac-8428-0f1aeb8e316c", "name": "Tipo inválido, arquivo ilegível ou que não é PDF (`INVALID_REQUEST`), ou o provedor recusou o documento (`PROVIDER_ERROR`).", "originalRequest": { "url": { "path": [ "v1", "onboarding", "documents" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"kind\": \"LEGAL_DOCUMENTS\",\n \"file\": \"pariatur sunt sint\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "90e79658-95e3-4955-8e38-b4d547ede1f4", "name": "Teto de envios do documento nas últimas 24 horas (`RATE_LIMITED`).", "originalRequest": { "url": { "path": [ "v1", "onboarding", "documents" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"kind\": \"LEGAL_DOCUMENTS\",\n \"file\": \"pariatur sunt sint\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "31a0da69-f5b5-47c0-af65-b189c2945a81", "name": "Sem resposta do provedor, ou o provedor indisponível\n(`PROVIDER_ERROR`); ou a instância já processa o máximo de envios\nsimultâneos (`RATE_LIMITED`, com `Retry-After`): repita em instantes.\n", "originalRequest": { "url": { "path": [ "v1", "onboarding", "documents" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"kind\": \"LEGAL_DOCUMENTS\",\n \"file\": \"pariatur sunt sint\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "27c1ac46-2542-465f-9443-07edccddb57c", "name": "Abre a sessão da biometria do modo próprio", "request": { "name": "Abre a sessão da biometria do modo próprio", "description": { "content": "PROPOSTA (AZF-026), até a Azify confirmar o que o processamento exige.\n\nDevolve o que o SDK de biometria do provedor (o Aziface, no web e no\napp) precisa para iniciar, na abertura do modo `own` ainda na coleta\n(`CUSTOMER_CREATED` ou `IN_PROGRESS`). O titular é o do\n`onboardingToken` ou o da sessão; não há corpo.\n\n- `deviceKeyIdentifier`, `productionKey` e `publicKey` vão ao\n `initialize` do SDK.\n- `processUrl` é o `baseUrl` do SDK: o repasse do Lume\n (`POST /v1/onboarding/biometrics/process-request`).\n- `sdkToken` vai no cabeçalho `x-token-bearer` do SDK. É uma credencial\n opaca do Lume, e não a do provedor: vale até `expiresAt` (15 minutos)\n e 30 chamadas, só para este titular e esta abertura. Pedir uma sessão\n nova revoga a anterior.\n\nPor titular, no máximo 5 sessões por hora e 20 por dia (PROVISÓRIO,\nAZF-064f); acima disso, `429 TOO_MANY_ATTEMPTS` com `Retry-After`, sem\nchamar o provedor. Cada janela recomeça depois de uma pausa do tamanho\ndela sem sessão nova; quem passa do teto espera a janela inteira.\n", "type": "text/plain" }, "url": { "path": [ "v1", "onboarding", "biometrics", "session" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "9a509717-a83c-46fe-9c6f-f63f20f1b6b2", "name": "O que o SDK precisa para iniciar", "originalRequest": { "url": { "path": [ "v1", "onboarding", "biometrics", "session" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"deviceKeyIdentifier\": \"aliq\",\n \"productionKey\": \"voluptate dolor non ad ea\",\n \"publicKey\": \"eu dolore et\",\n \"sdkToken\": \"ea commodo\",\n \"processUrl\": \"http://JgoNfcxNciMCsCxyp.vjy3qNsELYBKGQOI1KdB8ORyfKzi6JGZq9KbPck1AJXGKAxfnw\",\n \"expiresAt\": \"2006-11-24T04:42:43.130Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ab748af5-c2a2-4830-8095-22c3b96f02a3", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "onboarding", "biometrics", "session" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8bee4450-fb2a-4287-a430-dc80192ddd8f", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "onboarding", "biometrics", "session" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bf2df0e7-c4f7-4c96-991a-a282e88bd3be", "name": "Registro não encontrado", "originalRequest": { "url": { "path": [ "v1", "onboarding", "biometrics", "session" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6ff8f459-b152-415e-8bcf-aa56c672dc62", "name": "O cadastro já foi enviado, a conta não está mais em abertura\n(bloqueada, encerrada ou já ativa), a abertura é do modo `hosted` ou\nainda não tem cadastro no provedor (`CONFLICT`).\n", "originalRequest": { "url": { "path": [ "v1", "onboarding", "biometrics", "session" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0d8a0a11-9c33-4081-93d2-d205ba22b219", "name": "Sessões demais deste titular na janela (`TOO_MANY_ATTEMPTS`): 5 por\nhora ou 20 por dia. `Retry-After` diz quantos segundos esperar.\n", "originalRequest": { "url": { "path": [ "v1", "onboarding", "biometrics", "session" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "disabled": true, "key": "Retry-After", "value": "-55892037", "description": "" }, { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "13b3684a-75a7-41d0-9a90-6384a11957ba", "name": "O provedor da biometria falhou, não respondeu no prazo de uma\nchamada ou respondeu fora do formato (`PROVIDER_ERROR`). Tente de novo.\n", "originalRequest": { "url": { "path": [ "v1", "onboarding", "biometrics", "session" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Bad Gateway", "code": 502, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7a6b1f3d-c83a-4969-9a1f-82fe64fa6f41", "name": "O arranjo de pagamento está indisponível. Tente novamente.", "originalRequest": { "url": { "path": [ "v1", "onboarding", "biometrics", "session" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "33c6563a-e299-45d4-84d5-c23559ec4952", "name": "O pedido passou do prazo da API enquanto esperava o provedor da\nbiometria (`PROVIDER_ERROR`). Tente de novo.\n", "originalRequest": { "url": { "path": [ "v1", "onboarding", "biometrics", "session" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Gateway Timeout", "code": 504, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "48004a5b-6ff5-429b-8579-243f60529bd7", "name": "Repassa o pedido do SDK de biometria ao processamento", "request": { "name": "Repassa o pedido do SDK de biometria ao processamento", "description": { "content": "PROPOSTA (AZF-026), até a Azify confirmar o que o processamento exige.\n\nChamada pelo SDK de biometria (é o `processUrl` da sessão), não pela\ntela. O corpo é o do SDK e é repassado como veio ao processamento do\nprovedor, que recebe a credencial do parceiro: o Lume só confere que é\nJSON com `requestBlob` e não guarda nem registra nada dele. A resposta\ndo processamento volta como veio (status e corpo).\n\nO `externalDatabaseRefID` (o registro na base biométrica) é sorteado\npelo SDK da Aziface a cada `photoMatch` (prefixo fixo e UUID, como\n`aziface_web_`), e o Lume o prende (AZF-064f; PROVISÓRIO até a\nAzify dizer como o processamento o usa):\n\n- ausente, vazio ou nulo: o corpo vai como veio;\n- só passa na forma que o SDK sorteia; o campo repetido, outra grafia\n do nome, um valor que não é texto ou qualquer chave do primeiro\n nível fora do ASCII também são recusados;\n- o valor é comparado sem diferenciar maiúsculas de minúsculas;\n- o primeiro repasse deste `sdkToken` que traz um valor o fixa nele, e\n os seguintes só passam com o mesmo; um valor já usado por outro\n titular é recusado.\n\nA recusa é `422` e nada é repassado. Para outro `photoMatch` (que\nsorteia outro valor), peça uma sessão nova e inicie o SDK com o\n`sdkToken` novo. A inicialização da FaceTec também passa por aqui,\ncom o mesmo corpo, e no SDK web leva um valor sorteado só para ela:\no Lume não a distingue da captura, então ela também fixa o valor.\nUse uma sessão para a inicialização e outra para cada captura.\n\nTeto do corpo: 10 MiB (configurável); acima dele, `413` sem repassar.\nPrazo: 25 s; esgotado, `504`. Falha do processamento não muda a\nabertura: o SDK repete.\n\nUm `401` ou `403` sem o `code` do `Error` do Lume é a resposta do\nprocessamento, devolvida como veio (a credencial do parceiro foi\nrecusada lá, e o Lume pede outra no próximo repasse): repita. O `401`\ncom `code: UNAUTHORIZED` é o do Lume: o `sdkToken` não vale mais, peça\noutra sessão.\n", "type": "text/plain" }, "url": { "path": [ "v1", "onboarding", "biometrics", "process-request" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-Token-Bearer" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] }, "body": { "mode": "raw", "raw": "{\n \"requestBlob\": \"magna et\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "bacb73b9-328c-4152-8a9e-682ee9c995d9", "name": "A resposta do processamento, como veio (`responseBlob` e o resto)", "originalRequest": { "url": { "path": [ "v1", "onboarding", "biometrics", "process-request" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-Token-Bearer", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"requestBlob\": \"magna et\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"mollit997\": \"ad\",\n \"Duis9d\": 11651543\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "52f261fd-cbd9-49b3-892d-cd88973a19c7", "name": "O corpo não é JSON ou não tem `requestBlob` (`INVALID_REQUEST`).", "originalRequest": { "url": { "path": [ "v1", "onboarding", "biometrics", "process-request" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-Token-Bearer", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"requestBlob\": \"magna et\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e9574e0c-df1b-446e-ab80-6773f4a43fca", "name": "`sdkToken` ausente, vencido, revogado, sem chamadas, de uma\nabertura que já não está na coleta ou de uma conta que não está\nmais em abertura (`UNAUTHORIZED`). Peça outra sessão.\n", "originalRequest": { "url": { "path": [ "v1", "onboarding", "biometrics", "process-request" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-Token-Bearer", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"requestBlob\": \"magna et\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fad88b05-780c-4727-8190-e1d23d493819", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "onboarding", "biometrics", "process-request" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-Token-Bearer", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"requestBlob\": \"magna et\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a1a838c8-64cd-4555-ad5f-ca2ede16ec90", "name": "O corpo passou do teto (`INVALID_REQUEST`). Nada foi repassado.", "originalRequest": { "url": { "path": [ "v1", "onboarding", "biometrics", "process-request" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-Token-Bearer", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"requestBlob\": \"magna et\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Request Entity Too Large", "code": 413, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "894f5967-6350-4d25-97f7-497e8b3505ba", "name": "O `externalDatabaseRefID` do corpo não vale para esta sessão\n(`INVALID_REQUEST`): fora da forma que o SDK sorteia, repetido, com\noutra grafia, que não é texto, com chave do primeiro nível fora do\nASCII, diferente do que este `sdkToken` já\nfixou, ou já usado por outro titular. Nada foi repassado. Peça uma\nsessão nova.\n", "originalRequest": { "url": { "path": [ "v1", "onboarding", "biometrics", "process-request" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-Token-Bearer", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"requestBlob\": \"magna et\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b01da986-036a-41ca-b06a-3ee56c3d96d4", "name": "Limite de requisições atingido. O cabeçalho `Retry-After` diz quantos\nsegundos esperar.\n", "originalRequest": { "url": { "path": [ "v1", "onboarding", "biometrics", "process-request" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-Token-Bearer", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"requestBlob\": \"magna et\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "42ba6650-00af-4b3e-adfe-0ddcfd59c6e2", "name": "O processamento falhou ou respondeu fora do formato (`PROVIDER_ERROR`).", "originalRequest": { "url": { "path": [ "v1", "onboarding", "biometrics", "process-request" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-Token-Bearer", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"requestBlob\": \"magna et\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Gateway", "code": 502, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1b1d568a-9c1a-45b6-a78a-38a15ac837e1", "name": "O arranjo de pagamento está indisponível. Tente novamente.", "originalRequest": { "url": { "path": [ "v1", "onboarding", "biometrics", "process-request" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-Token-Bearer", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"requestBlob\": \"magna et\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "df7d2717-cab5-4676-b911-3029a22554c2", "name": "O processamento não respondeu dentro do prazo (`PROVIDER_ERROR`).", "originalRequest": { "url": { "path": [ "v1", "onboarding", "biometrics", "process-request" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-Token-Bearer", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"requestBlob\": \"magna et\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Gateway Timeout", "code": 504, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "8756851d-5316-4bb2-9f45-40e050c1e103", "name": "Conta", "description": { "content": "Saldo, extrato e dados do titular.", "type": "text/plain" }, "item": [ { "id": "615b3dce-8edd-4738-8a21-a18dcf539746", "name": "Dados do titular e da conta", "request": { "name": "Dados do titular e da conta", "description": {}, "url": { "path": [ "v1", "me" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "2c4d6802-0d76-4d87-9fb3-aafc2ae3acd9", "name": "Titular e conta", "originalRequest": { "url": { "path": [ "v1", "me" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"et tempor amet\",\n \"name\": \"in\",\n \"email\": \"ea ex nostrud\",\n \"phone\": \"dolor in dolore\",\n \"account\": {\n \"id\": \"al\",\n \"branch\": \"0002\",\n \"number\": \"41700001\",\n \"numberPending\": true,\n \"numberUnavailable\": false,\n \"accountType\": \"SAVINGS\",\n \"bank\": {\n \"ispb\": \"18684408\",\n \"code\": \"562\",\n \"name\": \"AZIMUT BRASIL DTVM LTDA\"\n },\n \"status\": \"PENDING\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a43a9906-a87e-4c0f-9aaf-ba2ddc1e2980", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "me" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a5c1a312-66d6-43b4-988e-2b7061794229", "name": "Saldo disponível", "request": { "name": "Saldo disponível", "description": { "content": "`balanceCents` já está descontado do que foi reservado. `heldCents` vai\njunto para a tela poder explicar a diferença, em vez de o cliente\ndescobrir sozinho que \"sumiu\" dinheiro.\n\n`blockedCents` e `suspenseCents` vêm do provedor financeiro, lidos na\nhora, e só existem quando ele lê o saldo por conta (hoje, a Azify) e a\nleitura deu certo. **Ausente não é zero**: significa \"não sei\" (outro\nprovedor, conta ainda sem vínculo, falha ou demora do provedor), e a\nresposta continua `200` com o saldo do razão. Eles **não** entram em\n`balanceCents`, que continua sendo o que o servidor deixa gastar.\n\nA leitura do provedor vale por até 20 segundos por conta, e `asOf` diz\nde quando é o dado mais antigo da resposta: o instante dessa leitura,\nou o de agora quando só há o razão.\n", "type": "text/plain" }, "url": { "path": [ "v1", "accounts", "balance" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "26b9ce5d-4534-44f7-810a-9c625ba69581", "name": "Saldo", "originalRequest": { "url": { "path": [ "v1", "accounts", "balance" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"balanceCents\": 487235,\n \"heldCents\": 0,\n \"blockedCents\": 15000,\n \"suspenseCents\": 0,\n \"currency\": \"BRL\",\n \"asOf\": \"1978-09-04T15:50:31.782Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a36674b3-b883-4776-8e30-abfc6e3c5d97", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "accounts", "balance" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3537662f-4585-4baf-8c80-bca2797be182", "name": "Extrato", "request": { "name": "Extrato", "description": { "content": "Ordenado do mais recente para o mais antigo. O sinal de `amountCents`\nindica a direção: negativo saiu, positivo entrou.\n", "type": "text/plain" }, "url": { "path": [ "v1", "accounts", "statement" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": true, "key": "limit", "value": "50", "description": "Padrão 50, teto 200." }, { "disabled": true, "key": "offset", "value": "0" }, { "disabled": true, "key": "since", "value": "2026-09-01T00:00:00Z", "description": "RFC 3339." }, { "disabled": true, "key": "until", "value": "2026-09-30T23:59:59Z" }, { "disabled": true, "key": "kind", "value": "TRANSFER_EXTERNAL" }, { "disabled": true, "key": "status", "value": "HELD_FOR_REVIEW" }, { "disabled": true, "key": "q", "value": "nota 8841", "description": "Busca na descrição e no nome da contraparte." } ], "variable": [] }, "header": [ { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "6ee63375-3cc4-4736-bc92-4daa9f615f61", "name": "Lançamentos", "originalRequest": { "url": { "path": [ "v1", "accounts", "statement" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "offset", "value": "0" }, { "key": "since", "value": "2026-09-01T00:00:00Z" }, { "key": "until", "value": "2026-09-30T23:59:59Z" }, { "key": "kind", "value": "TRANSFER_EXTERNAL" }, { "key": "status", "value": "HELD_FOR_REVIEW" }, { "key": "q", "value": "nota 8841" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"items\": [\n {\n \"id\": \"tx_9f2c1a7b\",\n \"kind\": \"BLOCKAGE\",\n \"status\": \"COMPLETED\",\n \"amountCents\": -5000,\n \"description\": \"ut labore\",\n \"counterparty\": {\n \"name\": \"aliquip labore\",\n \"document\": \"proident incididunt\",\n \"bank\": \"consequat eu ad\",\n \"pixKey\": \"est nostrud elit aute\"\n },\n \"endToEndId\": \"deserunt nostrud ex sunt\",\n \"providerTransactionId\": \"velit\",\n \"riskScore\": 15,\n \"riskSignals\": [\n {\n \"code\": {\n \"value\": \"\"\n },\n \"label\": {\n \"value\": \"\"\n },\n \"detail\": {\n \"value\": \"\"\n },\n \"triggered\": {\n \"value\": \"\"\n }\n },\n {\n \"code\": {\n \"value\": \"\"\n },\n \"label\": {\n \"value\": \"\"\n },\n \"detail\": {\n \"value\": \"\"\n },\n \"triggered\": {\n \"value\": \"\"\n }\n }\n ],\n \"createdAt\": \"2005-01-17T20:43:46.054Z\",\n \"executedAt\": \"1956-01-21T17:06:07.889Z\",\n \"refundOf\": \"ullamco pariatur\",\n \"refundableCents\": 11983292,\n \"billetReceipt\": {\n \"description\": \"O comprovante de um pagamento de contas (`kind: PAYMENT_BILLET`): só a\\nautenticação, a data de liquidação e o convênio. Só no detalhe, e só\\nquando o banco já devolveu a confirmação.\\n\",\n \"value\": \"\"\n },\n \"disputableUntil\": \"1977-08-24T09:52:25.369Z\",\n \"disputeId\": \"laborum nisi in\",\n \"ted\": {\n \"bankIspb\": \"18236120\",\n \"branch\": \"0001\",\n \"accountMasked\": \"••••••977\",\n \"accountType\": \"CHECKING\",\n \"holderName\": \"ex inc\",\n \"holderDocumentMasked\": \"in tempor\",\n \"movementId\": \"dolore pariatur\",\n \"strControl\": \"laboris dolore id\"\n },\n \"bankAccount\": {\n \"bankIspb\": \"18236120\",\n \"branch\": \"0001\",\n \"accountMasked\": \"••••••977\",\n \"accountType\": \"SALARY\",\n \"holderName\": \"est adipisicing eiusmod exerc\",\n \"holderDocumentMasked\": \"adipisicing non\",\n \"movementId\": \"veniam consequat\"\n },\n \"feeCents\": 74092147,\n \"feeTransactionId\": \"dolore exercitation\",\n \"feeReason\": \"FREE\",\n \"feeStatus\": \"FAILED\",\n \"fee\": {\n \"description\": \"A tarifa desta operação, só no detalhe (`GET /v1/transactions/{id}`).\",\n \"value\": \"\"\n },\n \"feeOf\": \"sed ad do\"\n },\n {\n \"id\": \"tx_9f2c1a7b\",\n \"kind\": \"FEE_SHARE_RECEIVED\",\n \"status\": \"PENDING\",\n \"amountCents\": -5000,\n \"description\": \"anim consequat ven\",\n \"counterparty\": {\n \"name\": \"quis sit\",\n \"document\": \"commodo sit\",\n \"bank\": \"\",\n \"pixKey\": \"laborum enim\"\n },\n \"endToEndId\": \"proident ut veniam ea\",\n \"providerTransactionId\": \"Duis fugiat\",\n \"riskScore\": 77,\n \"riskSignals\": [\n {\n \"code\": {\n \"value\": \"\"\n },\n \"label\": {\n \"value\": \"\"\n },\n \"detail\": {\n \"value\": \"\"\n },\n \"triggered\": {\n \"value\": \"\"\n }\n },\n {\n \"code\": {\n \"value\": \"\"\n },\n \"label\": {\n \"value\": \"\"\n },\n \"detail\": {\n \"value\": \"\"\n },\n \"triggered\": {\n \"value\": \"\"\n }\n }\n ],\n \"createdAt\": \"2014-01-13T12:25:28.484Z\",\n \"executedAt\": \"1962-08-11T14:23:37.133Z\",\n \"refundOf\": \"sunt consectetur ea aliquip\",\n \"refundableCents\": 80549682,\n \"billetReceipt\": {\n \"description\": \"O comprovante de um pagamento de contas (`kind: PAYMENT_BILLET`): só a\\nautenticação, a data de liquidação e o convênio. Só no detalhe, e só\\nquando o banco já devolveu a confirmação.\\n\",\n \"value\": \"\"\n },\n \"disputableUntil\": \"1956-11-04T05:51:52.371Z\",\n \"disputeId\": \"aute in quis\",\n \"ted\": {\n \"bankIspb\": \"18236120\",\n \"branch\": \"0001\",\n \"accountMasked\": \"••••••977\",\n \"accountType\": \"SAVINGS\",\n \"holderName\": \"et labore\",\n \"holderDocumentMasked\": \"proident officia dolore sed\",\n \"movementId\": \"qui in Lorem\",\n \"strControl\": \"culpa dolor\"\n },\n \"bankAccount\": {\n \"bankIspb\": \"18236120\",\n \"branch\": \"0001\",\n \"accountMasked\": \"••••••977\",\n \"accountType\": \"PAYMENT\",\n \"holderName\": \"cupidatat fugiat dolor\",\n \"holderDocumentMasked\": \"in\",\n \"movementId\": \"culpa\"\n },\n \"feeCents\": 90281908,\n \"feeTransactionId\": \"in culpa\",\n \"feeReason\": \"COVERED_BY_PLAN\",\n \"feeStatus\": \"REVERSED\",\n \"fee\": {\n \"description\": \"A tarifa desta operação, só no detalhe (`GET /v1/transactions/{id}`).\",\n \"value\": \"\"\n },\n \"feeOf\": \"occaecat id\"\n }\n ],\n \"count\": -38034329\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "24896ae3-e856-42ad-8eba-3b71db188147", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "accounts", "statement" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "offset", "value": "0" }, { "key": "since", "value": "2026-09-01T00:00:00Z" }, { "key": "until", "value": "2026-09-30T23:59:59Z" }, { "key": "kind", "value": "TRANSFER_EXTERNAL" }, { "key": "status", "value": "HELD_FOR_REVIEW" }, { "key": "q", "value": "nota 8841" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b1349104-fb5e-4f19-aa93-45af37f4a4ee", "name": "Uma transação", "request": { "name": "Uma transação", "description": { "content": "Transação de outra conta responde `404`, e não `403`: é o que impede\ndescobrir identificadores por tentativa.\n", "type": "text/plain" }, "url": { "path": [ "v1", "transactions", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "a35c25155c2d13436508c4dd4ad82a48", "key": "id", "description": "(Required) " } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "c4f970ee-c166-44ed-a683-58d1861e5465", "name": "A transação", "originalRequest": { "url": { "path": [ "v1", "transactions", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "a35c25155c2d13436508c4dd4ad82a48", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"tx_9f2c1a7b\",\n \"kind\": \"CARD_FEE\",\n \"status\": \"PROCESSING\",\n \"amountCents\": -5000,\n \"description\": \"et adipisicing aliquip ad quis\",\n \"counterparty\": {\n \"name\": \"amet consequat\",\n \"document\": \"Lorem sint fugiat\",\n \"bank\": \"tempor deserunt amet\",\n \"pixKey\": \"commodo exercitation dolor\"\n },\n \"endToEndId\": \"esse enim\",\n \"providerTransactionId\": \"esse\",\n \"riskScore\": 99,\n \"riskSignals\": [\n {\n \"code\": \"NIGHT_WINDOW\",\n \"label\": \"Fora do horário habitual\",\n \"detail\": \"exercitation est commodo velit\",\n \"triggered\": true\n },\n {\n \"code\": \"NIGHT_WINDOW\",\n \"label\": \"Fora do horário habitual\",\n \"detail\": \"sint adipisic\",\n \"triggered\": false\n }\n ],\n \"createdAt\": \"1983-06-13T10:19:34.330Z\",\n \"executedAt\": \"1973-04-03T19:00:12.191Z\",\n \"refundOf\": \"id deserunt reprehenderit est dolor\",\n \"refundableCents\": 47603913,\n \"billetReceipt\": {\n \"kind\": \"BILL\",\n \"authentication\": \"Excepteur id\",\n \"settleDate\": \"1976-04-26\",\n \"convenant\": \"magna anim\"\n },\n \"disputableUntil\": \"1978-02-11T16:12:35.819Z\",\n \"disputeId\": \"laborum\",\n \"ted\": {\n \"bankIspb\": \"18236120\",\n \"branch\": \"0001\",\n \"accountMasked\": \"••••••977\",\n \"accountType\": \"CHECKING\",\n \"holderName\": \"sint\",\n \"holderDocumentMasked\": \"tempor quis magna sit\",\n \"movementId\": \"Duis laborum culpa officia in\",\n \"strControl\": \"commodo sed in labore\"\n },\n \"bankAccount\": {\n \"bankIspb\": \"18236120\",\n \"branch\": \"0001\",\n \"accountMasked\": \"••••••977\",\n \"accountType\": \"CHECKING\",\n \"holderName\": \"dolor aute velit Duis\",\n \"holderDocumentMasked\": \"aliquip in laborum proident\",\n \"movementId\": \"veniam Duis\"\n },\n \"feeCents\": 9892011,\n \"feeTransactionId\": \"fugiat eu do minim\",\n \"feeReason\": \"EXEMPT_BY_RULE\",\n \"feeStatus\": \"FAILED\",\n \"fee\": {\n \"service\": \"irure dolor dolore\",\n \"label\": \"labore\",\n \"feeCents\": 91029077,\n \"reason\": \"COVERED_BY_PLAN\",\n \"status\": \"CHARGED\",\n \"transactionId\": \"aute sint enim ullamco\"\n },\n \"feeOf\": \"enim nisi amet ut\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "35efdd13-9420-48a0-a126-f590aae254b6", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "transactions", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "a35c25155c2d13436508c4dd4ad82a48", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b4650c20-dccc-4702-881c-cb9a7304ab28", "name": "Registro não encontrado", "originalRequest": { "url": { "path": [ "v1", "transactions", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "a35c25155c2d13436508c4dd4ad82a48", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e080f57b-5735-4896-bd62-5f9a9e4d4725", "name": "Decide sobre uma transferência retida", "request": { "name": "Decide sobre uma transferência retida", "description": { "content": "Uma transferência com sinal de risco para em `HELD_FOR_REVIEW` e espera\na decisão do titular. `release` conclui, `block` devolve o dinheiro à\nconta na hora.\n\nLiberar move dinheiro e é irreversível: exige `X-Step-Up` com\n`purpose: review`. Bloquear não exige — travar a saída nunca pode ser\nmais difícil do que autorizá-la.\n\nLiberar pelo aplicativo tem ainda duas condições, conferidas\nantes de a prova ser consumida: a transação precisa ter sido retida há\npelo menos **15 minutos**, e o `riskScore` dela precisa ser menor que\n**85**. Com score 85 ou mais a transação está em análise pela\ninstituição e só o backoffice a libera. Nos dois casos a resposta é\n`409 CONFLICT`, a transação continua `HELD_FOR_REVIEW` (o valor segue\nreservado) e `block` segue valendo na hora.\n\nUma recarga de celular retida não pode ser liberada com a\nfuncionalidade `topup` desligada: a resposta é `403` com\n`code: FEATURE_DISABLED` e `details.feature: topup`, a transação\ncontinua `HELD_FOR_REVIEW` (o valor segue reservado desde a retenção)\ne nada é enviado à operadora.\n`block` segue valendo e devolve o dinheiro.\n\nDo mesmo jeito, um Pix por agência e conta retido não pode ser liberado\ncom a funcionalidade `pix_manual` desligada: `403 FEATURE_DISABLED`,\ncom `details.feature: pix_manual` (ou `pix_transfer`, se o Pix estiver\ndesligado), a transação continua `HELD_FOR_REVIEW` e nada é enviado ao\nprovedor. `block` segue valendo.\n\nAs recusas da liberação que não dependem da prova saem antes de o\n`X-Step-Up` ser conferido, e a prova enviada junto não é consumida:\nrecarga retida com `topup` desligada (`403 FEATURE_DISABLED`) ou sem\nprovedor de recarga na instalação (`501`), Pix por agência e conta\nretido com `pix_manual` ou `pix_transfer` desligada (`403 FEATURE_DISABLED`), e pagamento\nde QR Code retido que não pode ser liberado (`409`). Para o resto (transação\ninexistente, de outra conta, já decidida) a ordem é a de sempre: sem a\nprova, `403 STEP_UP_REQUIRED`.\n", "type": "text/plain" }, "url": { "path": [ "v1", "transactions", ":id", "review" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "a35c25155c2d13436508c4dd4ad82a48", "key": "id", "description": "(Required) " } ] }, "header": [ { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"decision\": \"release\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "a9ed9126-2b3d-4676-a373-c26be1b04dc5", "name": "Decisão aplicada", "originalRequest": { "url": { "path": [ "v1", "transactions", ":id", "review" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "a35c25155c2d13436508c4dd4ad82a48", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"decision\": \"release\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"tx_9f2c1a7b\",\n \"kind\": \"CARD_FEE\",\n \"status\": \"PROCESSING\",\n \"amountCents\": -5000,\n \"description\": \"et adipisicing aliquip ad quis\",\n \"counterparty\": {\n \"name\": \"amet consequat\",\n \"document\": \"Lorem sint fugiat\",\n \"bank\": \"tempor deserunt amet\",\n \"pixKey\": \"commodo exercitation dolor\"\n },\n \"endToEndId\": \"esse enim\",\n \"providerTransactionId\": \"esse\",\n \"riskScore\": 99,\n \"riskSignals\": [\n {\n \"code\": \"NIGHT_WINDOW\",\n \"label\": \"Fora do horário habitual\",\n \"detail\": \"exercitation est commodo velit\",\n \"triggered\": true\n },\n {\n \"code\": \"NIGHT_WINDOW\",\n \"label\": \"Fora do horário habitual\",\n \"detail\": \"sint adipisic\",\n \"triggered\": false\n }\n ],\n \"createdAt\": \"1983-06-13T10:19:34.330Z\",\n \"executedAt\": \"1973-04-03T19:00:12.191Z\",\n \"refundOf\": \"id deserunt reprehenderit est dolor\",\n \"refundableCents\": 47603913,\n \"billetReceipt\": {\n \"kind\": \"BILL\",\n \"authentication\": \"Excepteur id\",\n \"settleDate\": \"1976-04-26\",\n \"convenant\": \"magna anim\"\n },\n \"disputableUntil\": \"1978-02-11T16:12:35.819Z\",\n \"disputeId\": \"laborum\",\n \"ted\": {\n \"bankIspb\": \"18236120\",\n \"branch\": \"0001\",\n \"accountMasked\": \"••••••977\",\n \"accountType\": \"CHECKING\",\n \"holderName\": \"sint\",\n \"holderDocumentMasked\": \"tempor quis magna sit\",\n \"movementId\": \"Duis laborum culpa officia in\",\n \"strControl\": \"commodo sed in labore\"\n },\n \"bankAccount\": {\n \"bankIspb\": \"18236120\",\n \"branch\": \"0001\",\n \"accountMasked\": \"••••••977\",\n \"accountType\": \"CHECKING\",\n \"holderName\": \"dolor aute velit Duis\",\n \"holderDocumentMasked\": \"aliquip in laborum proident\",\n \"movementId\": \"veniam Duis\"\n },\n \"feeCents\": 9892011,\n \"feeTransactionId\": \"fugiat eu do minim\",\n \"feeReason\": \"EXEMPT_BY_RULE\",\n \"feeStatus\": \"FAILED\",\n \"fee\": {\n \"service\": \"irure dolor dolore\",\n \"label\": \"labore\",\n \"feeCents\": 91029077,\n \"reason\": \"COVERED_BY_PLAN\",\n \"status\": \"CHARGED\",\n \"transactionId\": \"aute sint enim ullamco\"\n },\n \"feeOf\": \"enim nisi amet ut\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "102f32a1-3413-446b-a1f7-a7efb61561a9", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "transactions", ":id", "review" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "a35c25155c2d13436508c4dd4ad82a48", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"decision\": \"release\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cd06443b-56a9-4618-900a-248a068242a6", "name": "Falta o segundo fator (`STEP_UP_REQUIRED`) para liberar, ou a\nrecarga retida não pode ser liberada com a funcionalidade `topup`\ndesligada, ou o Pix por agência e conta retido com `pix_manual` ou `pix_transfer`\ndesligada (`FEATURE_DISABLED`, com `details.feature`). Também\n`403 FORBIDDEN` (\"Conta bloqueada.\") quando a conta não está ativa:\n`release` é recusado por qualquer canal e a transação segue\n`HELD_FOR_REVIEW`; `block` continua permitido e devolve o valor.\n", "originalRequest": { "url": { "path": [ "v1", "transactions", ":id", "review" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "a35c25155c2d13436508c4dd4ad82a48", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"decision\": \"release\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "099500e0-711b-4acb-9ead-acc8afa69632", "name": "A transação já foi decidida, ou é um pagamento de QR Code retido\nque não pode ser liberado (`CONFLICT`): o código não foi guardado.\nEla continua `HELD_FOR_REVIEW`; só se pode bloqueá-la, e o cliente\npaga de novo. Também `409 CONFLICT` quando a liberação pelo\naplicativo vem antes de 15 minutos da retenção (\"aguarde para\nliberar\") ou a transação tem `riskScore` 85 ou mais (\"em análise\npela instituição\"): continua retida, e só se pode bloqueá-la.\n\n`details.reason` diz qual foi: `WAIT` (espera; vem também\n`details.releaseAvailableAt`, data-hora RFC 3339 em UTC a partir da\nqual a liberação abre), `INSTITUTION` (só o backoffice libera) ou\n`ALREADY_DECIDED` (já decidida). O QR retido que não se libera vem\nsem `details`.\n", "originalRequest": { "url": { "path": [ "v1", "transactions", ":id", "review" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "a35c25155c2d13436508c4dd4ad82a48", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"decision\": \"release\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "59934f80-b4cf-49ae-bbfe-58035efc8447", "name": "Dados inválidos (`INVALID_REQUEST`), ou `release` recusado por limite\n(`LIMIT_EXCEEDED`): o teto diário ou o noturno, o teto noturno para\num contato novo (`pixNightNewPeerCents`, por operação e pela soma\nda janela para a mesma chave ou conta nunca paga antes das 20h), ou\no bloqueio noturno das preferências, valem no momento da\nliberação. A recarga retida confere os tetos dela (por recarga e\ndiário de recarga) do mesmo jeito. Nesse caso a transação segue\n`HELD_FOR_REVIEW`, com o valor reservado.\n", "originalRequest": { "url": { "path": [ "v1", "transactions", ":id", "review" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "a35c25155c2d13436508c4dd4ad82a48", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"decision\": \"release\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0d2a75a0-6b50-4cde-ba1c-8f2956c70ad2", "name": "Recarga retida sem provedor de recarga nesta instalação\n(`PROVIDER_ERROR`). A transação continua `HELD_FOR_REVIEW`, com o\nvalor reservado; `block` devolve o dinheiro.\n", "originalRequest": { "url": { "path": [ "v1", "transactions", ":id", "review" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "a35c25155c2d13436508c4dd4ad82a48", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"decision\": \"release\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Implemented", "code": 501, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "fc36a239-d3d0-4009-a4e1-50aee652236a", "name": "Aceite para receber avisos pelo WhatsApp", "request": { "name": "Aceite para receber avisos pelo WhatsApp", "description": { "content": "O aceite do titular para receber avisos da instituição pelo WhatsApp\n(lembrete de vencimento e aviso de atraso), o texto que a tela mostra\nao lado da caixa e se o aceite pode ser dado agora (`available`:\ncanal configurado e um módulo que o use ligado). A caixa nasce **desmarcada**: sem aceite, nenhuma\nmensagem de WhatsApp sai, e os avisos continuam por e-mail.\n\nO aceite vale para o celular do cadastro no momento em que foi dado.\n`phoneChanged: true` diz que o cadastro mudou de número depois: o\naceite não vale para o número novo até ser dado de novo. O celular sai\nmascarado.\n\nSó a sessão do próprio titular: o representante que opera a conta de\numa empresa recebe `403 FORBIDDEN`, e chave de API também.\n", "type": "text/plain" }, "url": { "path": [ "v1", "notifications", "whatsapp" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "1d3beb0d-b4ea-429c-9654-fb95ce5e3292", "name": "Aceite em vigor", "originalRequest": { "url": { "path": [ "v1", "notifications", "whatsapp" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"available\": false,\n \"optedIn\": true,\n \"phoneChanged\": false,\n \"consentText\": \"laboris sed officia nulla\",\n \"consentTextVersion\": \"officia voluptate aliqua\",\n \"phone\": \"deserunt nostrud\",\n \"textVersion\": \"veniam et minim\",\n \"optedInAt\": \"1952-07-27T13:11:35.487Z\",\n \"optedOutAt\": \"1980-05-23T06:46:30.476Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8f8cd48e-92ba-49ac-9467-13e4e75d80c1", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "notifications", "whatsapp" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "38b850f1-53bd-4ee7-8a82-da6f68a1b3e9", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "notifications", "whatsapp" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6f3a5050-c376-42cb-86e3-0ab5199d6eec", "name": "Aceita ou deixa de aceitar avisos pelo WhatsApp", "request": { "name": "Aceita ou deixa de aceitar avisos pelo WhatsApp", "description": { "content": "`optIn: true` grava o aceite para o celular do cadastro, com a data e a\nversão do texto. `textVersion` é obrigatório e precisa ser o\n`consentTextVersion` em vigor (o texto que a tela mostrou); outro valor\ndevolve `422`. Aceitar de novo com o mesmo número e o mesmo texto não\nmuda a data do aceite.\n\n`optIn: false` sai: nenhuma mensagem de WhatsApp sai a partir daí. Sair\nnunca é recusado, nem com o canal desligado. A data e a versão do\núltimo aceite continuam na resposta, como prova do que foi aceito.\n\nCom o canal desligado nesta instalação, ou sem nenhum módulo que mande\nWhatsApp ligado (hoje, as assinaturas), aceitar devolve `409`\n(`available: false` no `GET`).\n", "type": "text/plain" }, "url": { "path": [ "v1", "notifications", "whatsapp" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"optIn\": false,\n \"textVersion\": \"aliqua nisi Duis aliquip\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "159e541c-c2b5-4c39-a8f2-cf4370113781", "name": "Aceite como ficou", "originalRequest": { "url": { "path": [ "v1", "notifications", "whatsapp" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"optIn\": false,\n \"textVersion\": \"aliqua nisi Duis aliquip\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"available\": false,\n \"optedIn\": true,\n \"phoneChanged\": false,\n \"consentText\": \"laboris sed officia nulla\",\n \"consentTextVersion\": \"officia voluptate aliqua\",\n \"phone\": \"deserunt nostrud\",\n \"textVersion\": \"veniam et minim\",\n \"optedInAt\": \"1952-07-27T13:11:35.487Z\",\n \"optedOutAt\": \"1980-05-23T06:46:30.476Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fbfe1c59-62fe-4b18-9ef0-d4d1be8bd792", "name": "Requisição malformada ou com dado inválido", "originalRequest": { "url": { "path": [ "v1", "notifications", "whatsapp" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"optIn\": false,\n \"textVersion\": \"aliqua nisi Duis aliquip\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ee105b9a-dbb7-4bd8-a326-50c044381bdc", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "notifications", "whatsapp" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"optIn\": false,\n \"textVersion\": \"aliqua nisi Duis aliquip\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5c4c907d-875a-4226-b841-5a88cb32c24e", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "notifications", "whatsapp" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"optIn\": false,\n \"textVersion\": \"aliqua nisi Duis aliquip\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "00897ced-f217-4752-be63-c809d9f4e2ac", "name": "O WhatsApp não está disponível nesta instalação (`CONFLICT`).", "originalRequest": { "url": { "path": [ "v1", "notifications", "whatsapp" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"optIn\": false,\n \"textVersion\": \"aliqua nisi Duis aliquip\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8bca1a14-e91d-4846-ae8c-38de4040f03c", "name": "O texto aceito não é o em vigor, ou o cadastro não tem celular\nválido (`INVALID_REQUEST`).\n", "originalRequest": { "url": { "path": [ "v1", "notifications", "whatsapp" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"optIn\": false,\n \"textVersion\": \"aliqua nisi Duis aliquip\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "c35c26a7-5d5b-4bef-ad04-85ca998e32ce", "name": "PIX", "description": { "content": "Chaves, consulta no DICT, transferência e BR Code.", "type": "text/plain" }, "item": [ { "id": "c87e62c5-e01f-4c96-804d-03942ee82fd6", "name": "Devolve um Pix recebido", "request": { "name": "Devolve um Pix recebido", "description": { "content": "Devolve, total ou parcialmente, um Pix que a conta recebeu\n(`kind: PIX_RECEIVED`, `COMPLETED`). Só com sessão de cliente: **não**\naceita chave de API.\n\n**`Idempotency-Key` é obrigatório**, como no Pix. Repetir a mesma chave\ncom o mesmo corpo devolve a resposta original (`Idempotent-Replay: true`)\ne o dinheiro sai uma vez só.\n\nResponde `202` com a **devolução**, uma transação nova\n(`kind: PIX_REFUND_SENT`, `amountCents` negativo, `refundOf` com o id do\nPix recebido) em `PROCESSING`. O desfecho chega depois, por aviso do\nbanco parceiro: `COMPLETED` quando a devolução sai, ou `FAILED` quando\né recusada, e nesse caso o valor volta à conta e volta a ser\ndevolvível. Um prazo esgotado no banco parceiro deixa a devolução em\n`PROCESSING`: o Lume nunca a repete.\n\nO valor devolvível é o do Pix recebido menos a soma das devoluções que\nnão falharam (`PROCESSING` e `COMPLETED`); `refundableCents` no Pix\nrecebido diz quanto resta. Pedir mais que isso responde `422\nINVALID_REQUEST` com o valor que ainda cabe. Duas devoluções\nsimultâneas do mesmo Pix nunca passam do valor original.\n\nAs regras são as do Pix que sai da conta: a partir de R$ 1.000,00, ou\nquando a soma dos Pix enviados no dia chega a esse valor, exige\n`X-Step-Up` com `purpose: transfer` (e selfie, acima do limiar de\nbiometria), a conta precisa estar ativa, a devolução **conta** nos\nlimites do Pix (por operação, diário e noturno) e exige saldo. Não passa\npelo motor de risco: o destino é fixo, quem pagou. Na alçada da conta\nempresarial — o valor somado às saídas do dia sem segunda assinatura —\na devolução é recusada com `422 APPROVAL_REQUIRED`: não há aprovação\nconjunta de devolução.\n\nTransação inexistente ou de outra conta responde `404`, sem distinguir.\nA transação que não é um Pix recebido, ou que ainda não está\n`COMPLETED`, responde `422`.\n", "type": "text/plain" }, "url": { "path": [ "v1", "transactions", ":id", "refund" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "a35c25155c2d13436508c4dd4ad82a48", "key": "id", "description": "(Required) Id do Pix recebido (o `kind` é `PIX_RECEIVED`)." } ] }, "header": [ { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"amountCents\": 2500,\n \"description\": \"Valor enviado por engano\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "c2b188f0-589b-466b-aae6-e44e3df6a8cf", "name": "Aceita; a devolução em `PROCESSING`.", "originalRequest": { "url": { "path": [ "v1", "transactions", ":id", "refund" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "a35c25155c2d13436508c4dd4ad82a48", "key": "id", "description": "(Required) Id do Pix recebido (o `kind` é `PIX_RECEIVED`)." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 2500,\n \"description\": \"Valor enviado por engano\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Accepted", "code": 202, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"tx_9f2c1a7b\",\n \"kind\": \"CARD_FEE\",\n \"status\": \"PROCESSING\",\n \"amountCents\": -5000,\n \"description\": \"et adipisicing aliquip ad quis\",\n \"counterparty\": {\n \"name\": \"amet consequat\",\n \"document\": \"Lorem sint fugiat\",\n \"bank\": \"tempor deserunt amet\",\n \"pixKey\": \"commodo exercitation dolor\"\n },\n \"endToEndId\": \"esse enim\",\n \"providerTransactionId\": \"esse\",\n \"riskScore\": 99,\n \"riskSignals\": [\n {\n \"code\": \"NIGHT_WINDOW\",\n \"label\": \"Fora do horário habitual\",\n \"detail\": \"exercitation est commodo velit\",\n \"triggered\": true\n },\n {\n \"code\": \"NIGHT_WINDOW\",\n \"label\": \"Fora do horário habitual\",\n \"detail\": \"sint adipisic\",\n \"triggered\": false\n }\n ],\n \"createdAt\": \"1983-06-13T10:19:34.330Z\",\n \"executedAt\": \"1973-04-03T19:00:12.191Z\",\n \"refundOf\": \"id deserunt reprehenderit est dolor\",\n \"refundableCents\": 47603913,\n \"billetReceipt\": {\n \"kind\": \"BILL\",\n \"authentication\": \"Excepteur id\",\n \"settleDate\": \"1976-04-26\",\n \"convenant\": \"magna anim\"\n },\n \"disputableUntil\": \"1978-02-11T16:12:35.819Z\",\n \"disputeId\": \"laborum\",\n \"ted\": {\n \"bankIspb\": \"18236120\",\n \"branch\": \"0001\",\n \"accountMasked\": \"••••••977\",\n \"accountType\": \"CHECKING\",\n \"holderName\": \"sint\",\n \"holderDocumentMasked\": \"tempor quis magna sit\",\n \"movementId\": \"Duis laborum culpa officia in\",\n \"strControl\": \"commodo sed in labore\"\n },\n \"bankAccount\": {\n \"bankIspb\": \"18236120\",\n \"branch\": \"0001\",\n \"accountMasked\": \"••••••977\",\n \"accountType\": \"CHECKING\",\n \"holderName\": \"dolor aute velit Duis\",\n \"holderDocumentMasked\": \"aliquip in laborum proident\",\n \"movementId\": \"veniam Duis\"\n },\n \"feeCents\": 9892011,\n \"feeTransactionId\": \"fugiat eu do minim\",\n \"feeReason\": \"EXEMPT_BY_RULE\",\n \"feeStatus\": \"FAILED\",\n \"fee\": {\n \"service\": \"irure dolor dolore\",\n \"label\": \"labore\",\n \"feeCents\": 91029077,\n \"reason\": \"COVERED_BY_PLAN\",\n \"status\": \"CHARGED\",\n \"transactionId\": \"aute sint enim ullamco\"\n },\n \"feeOf\": \"enim nisi amet ut\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d3dc6de8-4b32-4285-b2b8-8d2425fe52d0", "name": "Falta o cabeçalho `Idempotency-Key`", "originalRequest": { "url": { "path": [ "v1", "transactions", ":id", "refund" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "a35c25155c2d13436508c4dd4ad82a48", "key": "id", "description": "(Required) Id do Pix recebido (o `kind` é `PIX_RECEIVED`)." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 2500,\n \"description\": \"Valor enviado por engano\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6c75cef6-59aa-4984-b53d-e154022165ef", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "transactions", ":id", "refund" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "a35c25155c2d13436508c4dd4ad82a48", "key": "id", "description": "(Required) Id do Pix recebido (o `kind` é `PIX_RECEIVED`)." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 2500,\n \"description\": \"Valor enviado por engano\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "faf49856-ffb2-4318-b2fa-cc56d4097f6e", "name": "Falta o segundo fator (`STEP_UP_REQUIRED`) ou a selfie\n(`BIOMETRIC_REQUIRED`), ou a conta está bloqueada (`FORBIDDEN`).\n", "originalRequest": { "url": { "path": [ "v1", "transactions", ":id", "refund" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "a35c25155c2d13436508c4dd4ad82a48", "key": "id", "description": "(Required) Id do Pix recebido (o `kind` é `PIX_RECEIVED`)." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 2500,\n \"description\": \"Valor enviado por engano\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9dc73ccf-a10d-4b0b-bc76-273eb6ec97d4", "name": "Registro não encontrado", "originalRequest": { "url": { "path": [ "v1", "transactions", ":id", "refund" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "a35c25155c2d13436508c4dd4ad82a48", "key": "id", "description": "(Required) Id do Pix recebido (o `kind` é `PIX_RECEIVED`)." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 2500,\n \"description\": \"Valor enviado por engano\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aec097c1-8450-4fce-b1c3-75f83760ff88", "name": "A mesma chave de idempotência já foi usada com outro conteúdo\n(`IDEMPOTENCY_KEY_REUSED`), ou a operação anterior ainda está em\ncurso (`IDEMPOTENCY_IN_FLIGHT` — repita em alguns segundos).\n", "originalRequest": { "url": { "path": [ "v1", "transactions", ":id", "refund" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "a35c25155c2d13436508c4dd4ad82a48", "key": "id", "description": "(Required) Id do Pix recebido (o `kind` é `PIX_RECEIVED`)." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 2500,\n \"description\": \"Valor enviado por engano\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1e3736a3-38a8-4154-ada7-b0fc8ac8e7f1", "name": "Valor inválido, ou acima do que ainda pode ser devolvido\n(`INVALID_REQUEST`; a mensagem traz o valor que cabe); a transação\nnão é um Pix recebido, ainda não foi concluída, ou não pode ser\ndevolvida por aqui (`INVALID_REQUEST`); o banco desta instalação não\ndevolve Pix (`INVALID_REQUEST`); saldo insuficiente\n(`INSUFFICIENT_FUNDS`); limite excedido (`LIMIT_EXCEEDED`); valor\nque, somado às saídas do dia, alcança a alçada da conta empresarial\n(`APPROVAL_REQUIRED`).\n", "originalRequest": { "url": { "path": [ "v1", "transactions", ":id", "refund" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "a35c25155c2d13436508c4dd4ad82a48", "key": "id", "description": "(Required) Id do Pix recebido (o `kind` é `PIX_RECEIVED`)." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 2500,\n \"description\": \"Valor enviado por engano\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ec2da5e7-5d2b-4ba8-8fd7-8488519a48e3", "name": "O arranjo de pagamento está indisponível. Tente novamente.", "originalRequest": { "url": { "path": [ "v1", "transactions", ":id", "refund" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "a35c25155c2d13436508c4dd4ad82a48", "key": "id", "description": "(Required) Id do Pix recebido (o `kind` é `PIX_RECEIVED`)." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 2500,\n \"description\": \"Valor enviado por engano\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "850d38e5-3883-403f-87bf-d6c6be92b058", "name": "Contestações de Pix da conta", "request": { "name": "Contestações de Pix da conta", "description": { "content": "As contestações (MED, Mecanismo Especial de Devolução) que a conta abriu,\nda mais recente para a mais antiga. Só com sessão de cliente: **não**\naceita chave de API (a contestação é ato do titular).\n\nCom `refresh=true` a lista confere o andamento no banco parceiro das\ncontestações que ainda andam (no máximo uma vez a cada 30 s por\ncontestação, e só para algumas por chamada); se o banco não responder,\ndevolve o último estado conhecido. Nunca traz contestação de outra conta.\n", "type": "text/plain" }, "url": { "path": [ "v1", "pix", "disputes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": true, "key": "refresh", "value": "false", "description": "Com `true`, confere o andamento no banco parceiro antes de responder\n(a tela da lista). Sem, devolve só o que está gravado: é o que a carga\ndas notificações usa, e não espera pelo banco.\n" } ], "variable": [] }, "header": [ { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "6e6f32e7-570d-48b3-830e-4dd0ff696e47", "name": "Contestações da conta", "originalRequest": { "url": { "path": [ "v1", "pix", "disputes" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "refresh", "value": "false" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"items\": [\n {\n \"id\": \"enim irure est\",\n \"transactionId\": \"est consectetur\",\n \"status\": \"CANCELLING\",\n \"fraudType\": \"COERCION\",\n \"amountCents\": 67852563,\n \"openedAt\": \"1978-05-06T11:31:41.167Z\",\n \"updatedAt\": \"1974-05-08T23:42:20.922Z\",\n \"refundedCents\": 66628457,\n \"refundAnnouncedCents\": 52447600,\n \"canCancel\": true,\n \"protocol\": \"ut dolor\",\n \"details\": \"aute sint laboris s\",\n \"analysisDeadline\": \"2019-09-17T02:28:37.938Z\",\n \"refundDeadline\": \"1948-07-24T15:47:54.506Z\",\n \"infractionResult\": \"DISAGREED\",\n \"refundResult\": \"TOTALLY_ACCEPTED\",\n \"refundRejectionReason\": \"INVALID_REQUEST\",\n \"cancelledAt\": \"1966-10-06T11:20:47.649Z\",\n \"concludedAt\": \"1970-12-19T11:25:40.865Z\"\n },\n {\n \"id\": \"sunt incididunt nostrud\",\n \"transactionId\": \"id ut\",\n \"status\": \"NOT_REGISTERED\",\n \"fraudType\": \"UNKNOWN\",\n \"amountCents\": -31046254,\n \"openedAt\": \"2006-11-12T14:02:38.270Z\",\n \"updatedAt\": \"2018-03-22T08:58:19.976Z\",\n \"refundedCents\": 13360812,\n \"refundAnnouncedCents\": 37418166,\n \"canCancel\": false,\n \"protocol\": \"sint eu deserunt\",\n \"details\": \"sed est voluptate enim fugiat\",\n \"analysisDeadline\": \"1947-11-03T18:30:58.530Z\",\n \"refundDeadline\": \"1948-03-20T17:29:16.472Z\",\n \"infractionResult\": \"DISAGREED\",\n \"refundResult\": \"PARTIALLY_ACCEPTED\",\n \"refundRejectionReason\": \"ACCOUNT_CLOSURE\",\n \"cancelledAt\": \"1967-02-28T05:23:50.051Z\",\n \"concludedAt\": \"2002-07-09T07:52:14.980Z\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b222351f-6360-4d5c-9a86-2b326abb58e6", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "pix", "disputes" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "refresh", "value": "false" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "50f6bbff-c0e6-4cf8-935f-a8a56f0f91fd", "name": "Esta operação não pode ser feita com chave de API (`FORBIDDEN`).\n", "originalRequest": { "url": { "path": [ "v1", "pix", "disputes" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "refresh", "value": "false" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "79bd1b8d-717d-41a9-a767-be2b4a1378f4", "name": "Contesta um Pix enviado", "request": { "name": "Contesta um Pix enviado", "description": { "content": "Abre uma contestação por suspeita de fraude (MED) sobre um Pix **enviado**,\nconcluído (`COMPLETED`) e feito por este banco, até **80 dias** depois do\nenvio (`disputableUntil` no detalhe da transação diz até quando; o prazo é\ndo servidor). O valor contestado é o da transação. Só com sessão de\ncliente: **não** aceita chave de API.\n\n**`Idempotency-Key` é obrigatório.** Repetir a mesma chave com o mesmo\ncorpo devolve a resposta original (`Idempotent-Replay: true`) e abre uma\ncontestação só. **Exige `X-Step-Up`** com `purpose: dispute`\n(`403 STEP_UP_REQUIRED` sem ele; a recusa não é desfecho da chave de\nidempotência). A abertura fica registrada no histórico de segurança\n(`PIX_DISPUTE`).\n\nUma contestação vale por transação. Enquanto houver uma em andamento, e\n**depois de `CANCELLED` ou `CONCLUDED`**, a mesma transação não pode ser\ncontestada de novo (`422`). Depois de `NOT_REGISTERED` (o banco não\nregistrou) pode. A conta **bloqueada contesta** (o segundo fator e o\nteto seguram uma sessão roubada, e a vítima de tomada de conta é\njustamente a bloqueada); a **encerrada não** (`403 FORBIDDEN`). Há um\nteto por conta: 5 contestações a cada 24 horas e\n20 a cada 30 dias (as não registradas não contam); acima,\n`429 RATE_LIMITED` com `Retry-After`, registrado no histórico de\nsegurança, e o atendimento decide o resto.\n\nO `fraudType` é um de `SCAM` (golpe), `ACCOUNT_TAKEOVER` (conta invadida),\n`COERCION` (coerção), `FRAUDULENT_ACCESS` (acesso fraudulento),\n`OTHER` (outra razão, exige `details`) e `UNKNOWN`. O relato (`details`)\né texto livre de até 500 caracteres: dado pessoal, vai ao banco do\nrecebedor para a análise.\n\nResponde `201` com a contestação em `OPENING`, **sem o relato** (`details`):\na resposta fica guardada para repetir o pedido, e o relato é dado pessoal\nque não precisa existir em mais um lugar; leia-o em\n`GET /v1/pix/disputes/{id}`. O protocolo (`protocol`) e\no prazo de análise (`analysisDeadline`) aparecem quando o banco confirma o\nregistro. Se a resposta do banco se perder, a contestação fica em\n`OPENING`, o Lume **não** a abre de novo e a conferência a resolve.\n\nTransação inexistente ou de outra conta responde `404`, sem distinguir.\nEsta versão não permite editar a contestação.\n", "type": "text/plain" }, "url": { "path": [ "v1", "pix", "disputes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"transactionId\": \"a35c25155c2d13436508c4dd4ad82a48\",\n \"fraudType\": \"ACCOUNT_TAKEOVER\",\n \"details\": \"consequat eiusmod et\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "08928557-6e65-4329-b22d-a10214a70da0", "name": "Aberta; em `OPENING` até o banco confirmar.", "originalRequest": { "url": { "path": [ "v1", "pix", "disputes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"transactionId\": \"a35c25155c2d13436508c4dd4ad82a48\",\n \"fraudType\": \"ACCOUNT_TAKEOVER\",\n \"details\": \"consequat eiusmod et\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"pariatur voluptate ea anim\",\n \"transactionId\": \"non velit mollit anim laborum\",\n \"status\": \"CANCELLING\",\n \"fraudType\": \"UNKNOWN\",\n \"amountCents\": -93763042,\n \"openedAt\": \"2015-06-14T19:54:31.574Z\",\n \"updatedAt\": \"1961-09-06T09:59:14.170Z\",\n \"refundedCents\": 20686229,\n \"refundAnnouncedCents\": 67182783,\n \"canCancel\": true,\n \"protocol\": \"dolore dolor\",\n \"details\": \"do\",\n \"analysisDeadline\": \"1963-07-26T01:47:26.975Z\",\n \"refundDeadline\": \"2025-10-12T17:20:43.967Z\",\n \"infractionResult\": \"AGREED\",\n \"refundResult\": \"PARTIALLY_ACCEPTED\",\n \"refundRejectionReason\": \"ACCOUNT_CLOSURE\",\n \"cancelledAt\": \"2000-04-26T04:25:40.393Z\",\n \"concludedAt\": \"2021-06-14T05:36:11.605Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "44a8b70b-027a-4c7f-b45a-918d986e0955", "name": "Falta o cabeçalho `Idempotency-Key`, ou o corpo é inválido", "originalRequest": { "url": { "path": [ "v1", "pix", "disputes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"transactionId\": \"a35c25155c2d13436508c4dd4ad82a48\",\n \"fraudType\": \"ACCOUNT_TAKEOVER\",\n \"details\": \"consequat eiusmod et\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6b161934-5920-4d54-a330-19ea99a78c6c", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "pix", "disputes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"transactionId\": \"a35c25155c2d13436508c4dd4ad82a48\",\n \"fraudType\": \"ACCOUNT_TAKEOVER\",\n \"details\": \"consequat eiusmod et\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6a313dad-f830-425d-a929-d1674b8e0ad6", "name": "Falta o `X-Step-Up` com `purpose: dispute` (`STEP_UP_REQUIRED`); a\nconta está encerrada (`FORBIDDEN`); esta operação não pode ser feita\ncom chave de API (`FORBIDDEN`); ou a funcionalidade está desligada\nnesta instalação (`FEATURE_DISABLED`).\n", "originalRequest": { "url": { "path": [ "v1", "pix", "disputes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"transactionId\": \"a35c25155c2d13436508c4dd4ad82a48\",\n \"fraudType\": \"ACCOUNT_TAKEOVER\",\n \"details\": \"consequat eiusmod et\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d1507044-5d0a-49a7-8e15-9a0e3ffee60f", "name": "Registro não encontrado", "originalRequest": { "url": { "path": [ "v1", "pix", "disputes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"transactionId\": \"a35c25155c2d13436508c4dd4ad82a48\",\n \"fraudType\": \"ACCOUNT_TAKEOVER\",\n \"details\": \"consequat eiusmod et\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a6c5fe4e-6657-470c-864a-05242bc2ed33", "name": "A mesma chave de idempotência já foi usada com outro conteúdo\n(`IDEMPOTENCY_KEY_REUSED`), ou a operação anterior ainda está em\ncurso (`IDEMPOTENCY_IN_FLIGHT` — repita em alguns segundos).\n", "originalRequest": { "url": { "path": [ "v1", "pix", "disputes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"transactionId\": \"a35c25155c2d13436508c4dd4ad82a48\",\n \"fraudType\": \"ACCOUNT_TAKEOVER\",\n \"details\": \"consequat eiusmod et\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "503fc6b2-5c44-4dd1-a9d9-e3bd3905db7e", "name": "A transação não é um Pix enviado e concluído deste banco, passou de\n80 dias, já tem contestação em andamento ou encerrada, o tipo de\nfraude é inválido, falta o relato com `OTHER` ou o relato passa de\n500 caracteres (`INVALID_REQUEST`); o banco recusou o registro\n(`PROVIDER_ERROR`).\n", "originalRequest": { "url": { "path": [ "v1", "pix", "disputes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"transactionId\": \"a35c25155c2d13436508c4dd4ad82a48\",\n \"fraudType\": \"ACCOUNT_TAKEOVER\",\n \"details\": \"consequat eiusmod et\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "24063ff2-0854-485d-bda7-76106a3b954b", "name": "Limite de requisições atingido. O cabeçalho `Retry-After` diz quantos\nsegundos esperar.\n", "originalRequest": { "url": { "path": [ "v1", "pix", "disputes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"transactionId\": \"a35c25155c2d13436508c4dd4ad82a48\",\n \"fraudType\": \"ACCOUNT_TAKEOVER\",\n \"details\": \"consequat eiusmod et\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d6bbe746-7f6c-48d7-a9a8-8e50c97d39ce", "name": "O arranjo de pagamento está indisponível. Tente novamente.", "originalRequest": { "url": { "path": [ "v1", "pix", "disputes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"transactionId\": \"a35c25155c2d13436508c4dd4ad82a48\",\n \"fraudType\": \"ACCOUNT_TAKEOVER\",\n \"details\": \"consequat eiusmod et\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a5ebc12d-671c-4939-aad1-35daeec6643b", "name": "Uma contestação de Pix", "request": { "name": "Uma contestação de Pix", "description": { "content": "Confere o andamento no banco parceiro (no máximo uma vez a cada 30 s) e\ndevolve a contestação com o protocolo, os prazos, o resultado e o valor\ndevolvido. Só com sessão de cliente: **não** aceita chave de API.\n\n`CONCLUDED` no banco parceiro **não** quer dizer aceita: leia\n`infractionResult` e `refundResult`. `refundedCents` é o que de fato\nentrou na conta (devoluções recebidas ligadas ao Pix, `PIX_REFUND_RECEIVED`);\n`refundAnnouncedCents` é o que o banco parceiro anunciou e pode estar à\nfrente. O MED nunca credita por si.\n\nContestação inexistente ou de outra conta responde `404`, sem distinguir.\n", "type": "text/plain" }, "url": { "path": [ "v1", "pix", "disputes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "6b8e2e90475db750adf02ef9c9da8c2e", "key": "id", "description": "(Required) " } ] }, "header": [ { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "b0a9bbd6-e08b-4be0-bc70-d1c8b797b701", "name": "A contestação", "originalRequest": { "url": { "path": [ "v1", "pix", "disputes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "6b8e2e90475db750adf02ef9c9da8c2e", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"pariatur voluptate ea anim\",\n \"transactionId\": \"non velit mollit anim laborum\",\n \"status\": \"CANCELLING\",\n \"fraudType\": \"UNKNOWN\",\n \"amountCents\": -93763042,\n \"openedAt\": \"2015-06-14T19:54:31.574Z\",\n \"updatedAt\": \"1961-09-06T09:59:14.170Z\",\n \"refundedCents\": 20686229,\n \"refundAnnouncedCents\": 67182783,\n \"canCancel\": true,\n \"protocol\": \"dolore dolor\",\n \"details\": \"do\",\n \"analysisDeadline\": \"1963-07-26T01:47:26.975Z\",\n \"refundDeadline\": \"2025-10-12T17:20:43.967Z\",\n \"infractionResult\": \"AGREED\",\n \"refundResult\": \"PARTIALLY_ACCEPTED\",\n \"refundRejectionReason\": \"ACCOUNT_CLOSURE\",\n \"cancelledAt\": \"2000-04-26T04:25:40.393Z\",\n \"concludedAt\": \"2021-06-14T05:36:11.605Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e559d6cc-80e0-4c5b-b2e2-6cadd721ad03", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "pix", "disputes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "6b8e2e90475db750adf02ef9c9da8c2e", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "20de1edb-108e-419c-ba44-c3d95b9a5daf", "name": "Esta operação não pode ser feita com chave de API (`FORBIDDEN`).\n", "originalRequest": { "url": { "path": [ "v1", "pix", "disputes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "6b8e2e90475db750adf02ef9c9da8c2e", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "81df4420-2890-4f0d-8006-2018d2f9199b", "name": "Registro não encontrado", "originalRequest": { "url": { "path": [ "v1", "pix", "disputes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "6b8e2e90475db750adf02ef9c9da8c2e", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "adaf5977-d80b-49fa-bd18-fdabd2e34902", "name": "Cancela uma contestação de Pix", "request": { "name": "Cancela uma contestação de Pix", "description": { "content": "Cancela enquanto o banco parceiro aceita (`canCancel`: com o protocolo já\nconhecido e antes da conclusão). Responde `200` com a contestação em\n`CANCELLING`; o `CANCELLED` chega depois. Só com sessão de cliente:\n**não** aceita chave de API. Não pede segundo fator: o cancelamento fica\nregistrado no histórico de segurança (`PIX_DISPUTE`).\n\nDepois de cancelada a mesma transação **não** pode ser contestada de novo.\nFora do estado permitido responde `422 INVALID_REQUEST`. Se o banco não\nconfirmar, responde `503` e nada muda por aqui: a consulta seguinte diz o\nque houve.\n\nContestação inexistente ou de outra conta responde `404`, sem distinguir.\n", "type": "text/plain" }, "url": { "path": [ "v1", "pix", "disputes", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "ba2a4b58-492c-4f32-bfd0-ca895bb3ba65", "name": "Cancelamento pedido; a contestação em `CANCELLING`.", "originalRequest": { "url": { "path": [ "v1", "pix", "disputes", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"pariatur voluptate ea anim\",\n \"transactionId\": \"non velit mollit anim laborum\",\n \"status\": \"CANCELLING\",\n \"fraudType\": \"UNKNOWN\",\n \"amountCents\": -93763042,\n \"openedAt\": \"2015-06-14T19:54:31.574Z\",\n \"updatedAt\": \"1961-09-06T09:59:14.170Z\",\n \"refundedCents\": 20686229,\n \"refundAnnouncedCents\": 67182783,\n \"canCancel\": true,\n \"protocol\": \"dolore dolor\",\n \"details\": \"do\",\n \"analysisDeadline\": \"1963-07-26T01:47:26.975Z\",\n \"refundDeadline\": \"2025-10-12T17:20:43.967Z\",\n \"infractionResult\": \"AGREED\",\n \"refundResult\": \"PARTIALLY_ACCEPTED\",\n \"refundRejectionReason\": \"ACCOUNT_CLOSURE\",\n \"cancelledAt\": \"2000-04-26T04:25:40.393Z\",\n \"concludedAt\": \"2021-06-14T05:36:11.605Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0ed08c16-9804-440b-869a-40dc2586fa1b", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "pix", "disputes", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7a31599e-3cb2-4697-bbc5-cba7c139b8b4", "name": "Esta operação não pode ser feita com chave de API (`FORBIDDEN`).\n", "originalRequest": { "url": { "path": [ "v1", "pix", "disputes", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dfbf4785-f1a8-426f-b3ea-c7d378c2f2e7", "name": "Registro não encontrado", "originalRequest": { "url": { "path": [ "v1", "pix", "disputes", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1c6ca9ea-fd01-4833-9488-57c9508973d0", "name": "A contestação não pode ser cancelada agora (`INVALID_REQUEST`).", "originalRequest": { "url": { "path": [ "v1", "pix", "disputes", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b030c3b8-d3ac-4c8e-b620-5a9008c25efb", "name": "O arranjo de pagamento está indisponível. Tente novamente.", "originalRequest": { "url": { "path": [ "v1", "pix", "disputes", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1e759b45-ca29-4672-af21-0d59d96d05b1", "name": "Chaves PIX da conta", "request": { "name": "Chaves PIX da conta", "description": { "content": "O estado de cada chave vem do DICT, pelo provedor: na sessão do cliente\na lista consulta o provedor (no máximo uma vez a cada 30 s por conta) e\natualiza o que está gravado antes de responder. Se o provedor não\nresponder, devolve o último estado conhecido — nunca um `ACTIVE`\npresumido. Pela chave de API a lista é só o gravado: não consulta o\nprovedor nem grava.\n\nUma chave que o provedor tem e o Lume não (criada fora) aparece aqui.\nUma chave que o provedor deixou de listar passa a `REMOVED`, desde que a\nlista dele traga ao menos tantas chaves quanto as vivas daqui; lista\nvazia ou menor não remove nada.\n\n`max` é o teto de chaves do titular no DICT: 5 para pessoa física e 20\npara pessoa jurídica. Chave `REMOVED` não conta.\n", "type": "text/plain" }, "url": { "path": [ "v1", "pix", "keys" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "254000d0-47cb-4e23-b5e6-80179db6f770", "name": "Chaves cadastradas", "originalRequest": { "url": { "path": [ "v1", "pix", "keys" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"items\": [\n {\n \"id\": \"et magna non\",\n \"type\": \"CNPJ\",\n \"value\": \"in quis\",\n \"masked\": \"culpa dolore incididunt dolor dolor\",\n \"status\": \"ACTION_REQUIRED\",\n \"statusDetail\": \"dolor officia\",\n \"createdAt\": \"1965-01-16T18:59:21.404Z\",\n \"claimActions\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"claimRequest\": {\n \"id\": \"minim sed pariatur incididunt cillum\",\n \"action\": \"COMPLETE\",\n \"status\": \"RESERVED\",\n \"createdAt\": \"1989-09-05T08:23:15.875Z\"\n }\n },\n {\n \"id\": \"sint in irure dolore ea\",\n \"type\": \"CPF\",\n \"value\": \"elit cupidatat est velit\",\n \"masked\": \"elit irure\",\n \"status\": \"REMOVED\",\n \"statusDetail\": \"dolor elit labore\",\n \"createdAt\": \"1963-08-23T16:51:39.172Z\",\n \"claimActions\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"claimRequest\": {\n \"id\": \"enim\",\n \"action\": \"OPEN\",\n \"status\": \"UNKNOWN\",\n \"createdAt\": \"2004-11-08T16:00:02.904Z\"\n }\n }\n ],\n \"max\": 5\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f3972f77-b1f3-4db8-8c4e-c84ada2a8541", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "pix", "keys" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f78df7f9-9561-4a6a-9080-13df72b56eab", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "pix", "keys" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "eb89a5f0-a20d-41d1-8298-5d39dde5c6be", "name": "Cadastra uma chave PIX", "request": { "name": "Cadastra uma chave PIX", "description": { "content": "Exige `X-Step-Up` com `purpose: pix_key`. Uma chave sequestrada\nredireciona todo dinheiro que alguém tentar enviar ao titular — é a\noperação mais sensível da conta depois da própria transferência.\n\nO tipo é deduzido do valor: CPF, CNPJ, e-mail, telefone ou chave\naleatória.\n\n- **CPF e CNPJ**: só o documento do próprio titular da conta (CPF para\n pessoa física, CNPJ para pessoa jurídica). Outro documento é\n `422 INVALID_REQUEST`. CNPJ alfanumérico ainda não se cadastra\n (`422 INVALID_REQUEST`), recusado antes de o `X-Step-Up` ser\n consumido.\n- **Chave aleatória (`EVP`)**: pede-se, não se informa. Envie\n `{\"type\": \"EVP\"}` sem `key`; quem sorteia o valor é o DICT. Um\n UUID escolhido pelo cliente é `422 INVALID_REQUEST`.\n- **E-mail e telefone**: exigem `verificationId`, a confirmação por\n código enviado ao próprio e-mail ou telefone\n (`POST /v1/pix/keys/verifications` e `.../{id}/confirm`), em toda\n instalação. Sem o fornecedor de e-mail ou de SMS, o pedido do código\n daquele canal responde `422 INVALID_REQUEST` (\"verificação por SMS\n indisponível nesta instalação\"), e sem `verificationId` não há\n cadastro. A confirmação vale para\n aquele valor, aquela conta e aquele titular, por 15 minutos depois de\n confirmada, e é consumida no cadastro. Ausente, expirada, já usada, de outro valor,\n de outra conta ou de outro titular: `422 INVALID_REQUEST`. O código\n de verificação não substitui o `X-Step-Up`: um prova que o contato é\n seu, o outro que é o titular quem opera. Pela chave de API não se\n cadastram e-mail nem telefone (`403 FORBIDDEN`).\n\nA conta precisa estar ativa. O titular tem no máximo 5 chaves (pessoa\nfísica) ou 20 (pessoa jurídica) no DICT; passar disso é\n`409 CONFLICT`. O cadastro entra no histórico de segurança do titular\n(`PIX_KEY`), com a chave mascarada.\n\nA chave é registrada no DICT antes de existir aqui. Se o arranjo\nrecusar — porque a chave já pertence a outro titular, por exemplo —\nnada é gravado e a resposta é `422 PROVIDER_ERROR`. O estado\nintermediário não existe de propósito: uma chave que aparece na sua\nlistagem e que o arranjo não conhece é uma chave pela qual ninguém\nconsegue pagar o titular.\n", "type": "text/plain" }, "url": { "path": [ "v1", "pix", "keys" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "d5554746-4c31-46d2-9ad3-dd2a849f340a", "name": "Chave cadastrada, com o estado que o DICT informou. Logo depois da\ncriação o estado pode ainda ser `PENDING`; a lista traz o\ndefinitivo.\n", "originalRequest": { "url": { "path": [ "v1", "pix", "keys" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"aute\",\n \"type\": \"EMAIL\",\n \"value\": \"aute dolor\",\n \"masked\": \"enim\",\n \"status\": \"REMOVED\",\n \"statusDetail\": \"id\",\n \"createdAt\": \"1961-08-25T11:44:52.111Z\",\n \"claimActions\": [\n \"CANCEL\",\n \"COMPLETE\"\n ],\n \"claimRequest\": {\n \"id\": \"laborum minim ut sed\",\n \"action\": \"START\",\n \"status\": \"UNKNOWN\",\n \"createdAt\": \"1952-02-21T10:05:02.079Z\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f9328dc3-ea76-48d0-b2c8-5aab254c940b", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "pix", "keys" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0dfad030-1181-4c11-984e-067c45d9a44b", "name": "Falta a confirmação de segundo fator (`STEP_UP_REQUIRED`). Chame\n`POST /v1/auth/step-up` e repita com o cabeçalho `X-Step-Up`.\n", "originalRequest": { "url": { "path": [ "v1", "pix", "keys" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "463424c2-cdc0-4127-8c76-b133aded280e", "name": "A chave já está na sua conta, ou o titular está no teto de chaves\ndo DICT (5 para pessoa física, 20 para pessoa jurídica).\n", "originalRequest": { "url": { "path": [ "v1", "pix", "keys" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4b018f49-754c-4388-a3e9-bf86d924e7cf", "name": "Chave inválida (`INVALID_REQUEST`); CPF ou CNPJ que não é o\ndocumento do titular; e-mail ou telefone sem confirmação válida; ou\nrecusada pelo arranjo (`PROVIDER_ERROR`) — inclusive quando ela já\npertence a outro titular.\n", "originalRequest": { "url": { "path": [ "v1", "pix", "keys" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1227373c-d0bc-4391-8ae8-7ba9ab631300", "name": "O arranjo de pagamento está indisponível. Tente novamente.", "originalRequest": { "url": { "path": [ "v1", "pix", "keys" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "", "options": { "raw": { "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a7a7e4b9-4e7c-407d-be95-76eb5562dba2", "name": "Envia o código de verificação de uma chave de e-mail ou telefone", "request": { "name": "Envia o código de verificação de uma chave de e-mail ou telefone", "description": { "content": "Primeiro passo do cadastro de chave de e-mail ou de telefone: o Lume\nenvia um código de seis dígitos ao próprio endereço (por e-mail) ou\nnúmero (por SMS, só celular do Brasil). O titular o confirma em\n`POST /v1/pix/keys/verifications/{id}/confirm` e cadastra a chave com o\n`verificationId` em `POST /v1/pix/keys`, que continua exigindo\n`X-Step-Up`. Só pela sessão do titular: a chave de API não pede código.\n\nO tipo é deduzido do valor como no cadastro; mande o telefone com\n`+55` na frente (onze dígitos sem o código do país podem ser lidos como\nCPF). CPF, CNPJ e aleatória não se confirmam por código\n(`422 INVALID_REQUEST`). Chave que a conta já tem é `409 CONFLICT`, sem\nenviar nada. A conta precisa estar ativa (`403 FORBIDDEN`).\n\nO código vale 10 minutos. Um pedido novo ao mesmo destino cancela o\nanterior. Limites (`429 RATE_LIMITED`, com `Retry-After` em segundos):\n60 segundos entre dois envios ao mesmo destino; 3 por hora e 5 por dia\nao mesmo destino; 5 por hora e 10 por dia por titular; 10 por hora por\nendereço IP; e o teto diário de SMS da instalação. Titular com cinco\ncódigos errados nos últimos 15 minutos não pede outro até a janela\npassar (`429 TOO_MANY_ATTEMPTS`).\n\nO envio entra no histórico de segurança (`CONTACT_CODE_SENT`) com o\ndestino mascarado. O código nunca aparece em resposta nem em log.\n", "type": "text/plain" }, "url": { "path": [ "v1", "pix", "keys", "verifications" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "a3b81999-dc3a-41d0-9227-e785c00be669", "name": "Código enviado", "originalRequest": { "url": { "path": [ "v1", "pix", "keys", "verifications" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"verificationId\": \"ver_8c1d2e4b9a7f40c1b2d3e4f5a6b7c8d9\",\n \"channel\": \"SMS\",\n \"sentTo\": \"fi***@integradora.com.br\",\n \"expiresAt\": \"1987-02-21T08:05:25.184Z\",\n \"resendAfter\": \"1959-02-25T16:32:48.410Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f97159ce-a482-4ded-9497-803e2b89860e", "name": "Requisição malformada ou com dado inválido", "originalRequest": { "url": { "path": [ "v1", "pix", "keys", "verifications" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ae62537f-5aeb-4ad7-b563-ad65f8b42675", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "pix", "keys", "verifications" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1b619937-bad5-41e7-9948-2f296633355e", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "pix", "keys", "verifications" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c564c893-173c-403d-993c-702edf19ce1e", "name": "A chave já está na sua conta (`CONFLICT`). Nada foi enviado.", "originalRequest": { "url": { "path": [ "v1", "pix", "keys", "verifications" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "57f8329c-4a9e-4487-80d0-ae0382f0e29a", "name": "Chave inválida, ou que não é e-mail nem celular (`INVALID_REQUEST`);\ninstalação sem o fornecedor do canal (`INVALID_REQUEST`, \"verificação\npor SMS indisponível nesta instalação\"); ou o fornecedor recusou o\ndestino (`PROVIDER_ERROR`).\n", "originalRequest": { "url": { "path": [ "v1", "pix", "keys", "verifications" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "416423b6-8163-4733-bfe5-949cf9ff1b0b", "name": "Limite de envio (`RATE_LIMITED`) ou titular travado por códigos\nerrados (`TOO_MANY_ATTEMPTS`). `Retry-After` diz quantos segundos\nesperar.\n", "originalRequest": { "url": { "path": [ "v1", "pix", "keys", "verifications" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "disabled": true, "key": "Retry-After", "value": "-55892037", "description": "" }, { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c6de5511-f5b4-4ab5-ac3b-3e30d6010ddd", "name": "O fornecedor de e-mail ou de SMS não respondeu (`PROVIDER_ERROR`).\nO código pode ter saído; o pedido não vale e conta nos limites.\n", "originalRequest": { "url": { "path": [ "v1", "pix", "keys", "verifications" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "", "options": { "raw": { "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "46a69b92-c4a4-4222-9369-07ce44408a0d", "name": "Confirma o código de verificação", "request": { "name": "Confirma o código de verificação", "description": { "content": "O titular digita o código recebido. Certo, o pedido fica verificado e\nvale 15 minutos, uma vez, para cadastrar aquela chave naquela conta\n(`verificationId` em `POST /v1/pix/keys`).\n\nCódigo errado é `422 INVALID_REQUEST` com `details.remainingAttempts`.\nNo quinto erro do pedido, ou no quinto do titular em 15 minutos somando\ntodos os pedidos, a resposta é `429 TOO_MANY_ATTEMPTS` e o pedido não\nserve mais; o titular espera o `Retry-After` e pede outro código. A\ntrava entra no histórico de segurança\n(`CONTACT_VERIFICATION_LOCKED`), e a confirmação também\n(`CONTACT_VERIFIED`).\n\nPedido de outro titular ou de outra conta é `404`, igual ao que não\nexiste. Pedido já confirmado, usado, substituído ou vencido é\n`409 CONFLICT`: peça outro.\n", "type": "text/plain" }, "url": { "path": [ "v1", "pix", "keys", "verifications", ":id", "confirm" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "ver_8c1d2e4b9a7f40c1b2d3e4f5a6b7c8d9", "key": "id", "description": "(Required) O `verificationId` devolvido no envio." } ] }, "header": [ { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"code\": \"123456\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "fe2d731e-bc81-4600-adfe-af11f0c7dacb", "name": "Contato verificado", "originalRequest": { "url": { "path": [ "v1", "pix", "keys", "verifications", ":id", "confirm" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "ver_8c1d2e4b9a7f40c1b2d3e4f5a6b7c8d9", "key": "id", "description": "(Required) O `verificationId` devolvido no envio." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"123456\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"verificationId\": \"eiusmod sit esse nisi\",\n \"verifiedAt\": \"1972-08-11T14:52:21.445Z\",\n \"validUntil\": \"1955-02-06T01:03:14.971Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "729e7576-cafc-480b-992d-ab52b1d76a20", "name": "Requisição malformada ou com dado inválido", "originalRequest": { "url": { "path": [ "v1", "pix", "keys", "verifications", ":id", "confirm" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "ver_8c1d2e4b9a7f40c1b2d3e4f5a6b7c8d9", "key": "id", "description": "(Required) O `verificationId` devolvido no envio." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"123456\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9ae62f7f-aee5-4c31-91c2-2de185fc274e", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "pix", "keys", "verifications", ":id", "confirm" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "ver_8c1d2e4b9a7f40c1b2d3e4f5a6b7c8d9", "key": "id", "description": "(Required) O `verificationId` devolvido no envio." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"123456\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "771df81d-087a-4dc8-9fcc-fddb7563f059", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "pix", "keys", "verifications", ":id", "confirm" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "ver_8c1d2e4b9a7f40c1b2d3e4f5a6b7c8d9", "key": "id", "description": "(Required) O `verificationId` devolvido no envio." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"123456\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a9570077-d7e7-4c20-bd46-91b7d668aa34", "name": "Registro não encontrado", "originalRequest": { "url": { "path": [ "v1", "pix", "keys", "verifications", ":id", "confirm" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "ver_8c1d2e4b9a7f40c1b2d3e4f5a6b7c8d9", "key": "id", "description": "(Required) O `verificationId` devolvido no envio." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"123456\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "23895973-38b4-481a-a7fa-7ce2a316cd61", "name": "O pedido já foi confirmado, usado, substituído ou venceu (`CONFLICT`).", "originalRequest": { "url": { "path": [ "v1", "pix", "keys", "verifications", ":id", "confirm" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "ver_8c1d2e4b9a7f40c1b2d3e4f5a6b7c8d9", "key": "id", "description": "(Required) O `verificationId` devolvido no envio." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"123456\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a97f24d7-68c5-4a82-a4a8-be93f959b71e", "name": "Código incorreto (`INVALID_REQUEST`, com `details.remainingAttempts`).", "originalRequest": { "url": { "path": [ "v1", "pix", "keys", "verifications", ":id", "confirm" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "ver_8c1d2e4b9a7f40c1b2d3e4f5a6b7c8d9", "key": "id", "description": "(Required) O `verificationId` devolvido no envio." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"123456\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c72cd844-ce0c-451b-85cf-7b0830e122dc", "name": "Pedido ou titular travado por códigos errados\n(`TOO_MANY_ATTEMPTS`). `Retry-After`, quando vem, diz quantos\nsegundos esperar para pedir outro código.\n", "originalRequest": { "url": { "path": [ "v1", "pix", "keys", "verifications", ":id", "confirm" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "ver_8c1d2e4b9a7f40c1b2d3e4f5a6b7c8d9", "key": "id", "description": "(Required) O `verificationId` devolvido no envio." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"code\": \"123456\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "disabled": true, "key": "Retry-After", "value": "-55892037", "description": "" }, { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ae75bae4-f884-491e-9e93-09a24f74a5d3", "name": "Remove uma chave PIX", "request": { "name": "Remove uma chave PIX", "description": { "content": "A chave sai do DICT antes de sair daqui. Apagar só do nosso lado\ndeixaria o arranjo apontando para uma conta que não espera mais receber\npor ela — e sem nenhuma tela onde o titular a veja para tentar de novo.\n\nVale para as cinco espécies, inclusive CPF e CNPJ. A conta precisa\nestar ativa (`403 FORBIDDEN` se não); não exige `X-Step-Up`. A chave de\noutro titular é `404`. Uma chave `REMOVED` (que já não é sua no DICT) sai\nsó da lista. A exclusão entra no histórico de segurança do titular\n(`PIX_KEY`).\n\n**Só com sessão de cliente**: não aceita chave de API (com `X-API-Key`\na resposta é `403 FORBIDDEN`), nem com `pix:keys:write`. Excluir não\npede segundo fator, e uma chave de API vazada apagava todas as chaves\nda conta de uma vez; o cadastro continua pela chave de API, porque\nexige o `X-Step-Up` do titular.\n", "type": "text/plain" }, "url": { "path": [ "v1", "pix", "keys", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "9f2c1a7b4e6d8035", "key": "id", "description": "(Required) O `id` da chave, e nao a chave em si." } ] }, "header": [ { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "09a19ff9-76ac-46f7-a1f6-149470716723", "name": "Removida", "originalRequest": { "url": { "path": [ "v1", "pix", "keys", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "9f2c1a7b4e6d8035", "key": "id", "description": "(Required) O `id` da chave, e nao a chave em si." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "d6ff7291-1968-4885-b0d4-699c12ebc760", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "pix", "keys", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "9f2c1a7b4e6d8035", "key": "id", "description": "(Required) O `id` da chave, e nao a chave em si." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5edc54d0-8df5-4a77-95f9-4fed6c77234d", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "pix", "keys", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "9f2c1a7b4e6d8035", "key": "id", "description": "(Required) O `id` da chave, e nao a chave em si." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4e236aeb-918b-427b-b2b4-e42ae8e1336b", "name": "Registro não encontrado", "originalRequest": { "url": { "path": [ "v1", "pix", "keys", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "9f2c1a7b4e6d8035", "key": "id", "description": "(Required) O `id` da chave, e nao a chave em si." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3eb55972-cf09-404f-88ce-7c65f7f2c125", "name": "O arranjo recusou a exclusão (`PROVIDER_ERROR`).", "originalRequest": { "url": { "path": [ "v1", "pix", "keys", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "9f2c1a7b4e6d8035", "key": "id", "description": "(Required) O `id` da chave, e nao a chave em si." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "553a5a00-a2ac-4d4e-8007-05d98067536c", "name": "O arranjo de pagamento está indisponível. Tente novamente.", "originalRequest": { "url": { "path": [ "v1", "pix", "keys", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "9f2c1a7b4e6d8035", "key": "id", "description": "(Required) O `id` da chave, e nao a chave em si." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "d8d4b4be-c966-4c60-8e7b-172df4b7f89a", "name": "Traz uma chave PIX de outra instituição", "request": { "name": "Traz uma chave PIX de outra instituição", "description": { "content": "Pede a portabilidade de uma chave que hoje está em outra instituição\n(funcionalidade `pix_key_claims`, desligada por padrão; desligada,\n`403 FEATURE_DISABLED`). É o botão \"Trazer chave de outra instituição\"\nda tela de chaves.\n\n- **Tipos**: CPF, CNPJ, e-mail e telefone. A chave aleatória não se\n porta (`422 INVALID_REQUEST`). CPF e CNPJ só o documento do próprio\n titular; e-mail e telefone exigem `verificationId`, como no\n cadastro (`POST /v1/pix/keys/verifications`).\n- **Exige `X-Step-Up`** com `purpose: pix_key` e **`Idempotency-Key`**.\n Repetir a mesma chave devolve o mesmo pedido, sem pedir de novo à\n outra ponta.\n- A conta precisa estar ativa. A chave pedida conta para o teto do\n titular (5 pessoa física, 20 pessoa jurídica) desde o pedido.\n- **Só com sessão de cliente**: não aceita chave de API, e o\n atendimento não pede pelo titular.\n\nA resposta é `202`: o andamento vem depois, pela lista de chaves\n(`status`, `statusDetail`, `claimActions`, `claimRequest`). Se a\noutra ponta não respondeu a tempo, o pedido fica `UNKNOWN` e **não deve\nser repetido**: um novo pedido para a mesma chave é `409 CONFLICT` até\no andamento chegar. O pedido entra no histórico de segurança do\ntitular (`PIX_KEY`), com a chave mascarada.\n", "type": "text/plain" }, "url": { "path": [ "v1", "pix", "keys", "portability" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"key\": \"12345678909\",\n \"verificationId\": \"Excepteur dolor sit\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "a466b392-319c-420e-afab-b70bebcb50f5", "name": "Pedido registrado.", "originalRequest": { "url": { "path": [ "v1", "pix", "keys", "portability" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"key\": \"12345678909\",\n \"verificationId\": \"Excepteur dolor sit\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Accepted", "code": 202, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"Ut sit in\",\n \"keyId\": \"nisi sit aliqua et\",\n \"action\": \"CANCEL\",\n \"status\": \"UNKNOWN\",\n \"masked\": \"culpa aliquip\",\n \"message\": \"cillum mollit veniam laborum\",\n \"createdAt\": \"2024-09-16T17:13:06.779Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8c2205c9-dac2-47b1-8297-a2f66ca8f77f", "name": "Requisição malformada ou com dado inválido", "originalRequest": { "url": { "path": [ "v1", "pix", "keys", "portability" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"key\": \"12345678909\",\n \"verificationId\": \"Excepteur dolor sit\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d13d3c96-41d9-41be-8b92-bd2b4f6528b2", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "pix", "keys", "portability" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"key\": \"12345678909\",\n \"verificationId\": \"Excepteur dolor sit\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c3944324-f5c6-43fc-bd8b-1ebbac3dd2d9", "name": "Falta o `X-Step-Up` com `purpose: pix_key` (`STEP_UP_REQUIRED`); a\nconta não está ativa, a origem não é o titular (`FORBIDDEN`); ou a\nfuncionalidade está desligada (`FEATURE_DISABLED`).\n", "originalRequest": { "url": { "path": [ "v1", "pix", "keys", "portability" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"key\": \"12345678909\",\n \"verificationId\": \"Excepteur dolor sit\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "91cbb596-a899-4ed1-be8f-c40baaa60b56", "name": "A chave já está na sua conta, já há pedido em andamento para ela,\nela não pode vir para esta conta, o titular está no teto de chaves,\nou a `Idempotency-Key` já foi usada em outro pedido.\n", "originalRequest": { "url": { "path": [ "v1", "pix", "keys", "portability" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"key\": \"12345678909\",\n \"verificationId\": \"Excepteur dolor sit\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ee83f45a-bd85-4d40-9e47-4a02837edf9b", "name": "Chave inválida ou aleatória; CPF ou CNPJ que não é o do titular;\ne-mail ou telefone sem confirmação válida (`INVALID_REQUEST`); ou\nrecusa da outra ponta (`PROVIDER_ERROR`).\n", "originalRequest": { "url": { "path": [ "v1", "pix", "keys", "portability" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"key\": \"12345678909\",\n \"verificationId\": \"Excepteur dolor sit\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5352387b-488f-47e8-b2b4-4245a162292f", "name": "O arranjo de pagamento está indisponível. Tente novamente.", "originalRequest": { "url": { "path": [ "v1", "pix", "keys", "portability" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"key\": \"12345678909\",\n \"verificationId\": \"Excepteur dolor sit\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c53c4c51-3639-4ed7-9571-8b4b6792eb96", "name": "Responde a uma portabilidade ou reivindicação de chave PIX", "request": { "name": "Responde a uma portabilidade ou reivindicação de chave PIX", "description": { "content": "Age sobre o processo em andamento de uma chave da conta\n(funcionalidade `pix_key_claims`, desligada por padrão; desligada,\n`403 FEATURE_DISABLED`). A ação precisa estar em `claimActions` da\nchave na lista (`GET /v1/pix/keys`); fora disso, `409 CONFLICT`.\n\n| `action` | Quem | O quê |\n| --- | --- | --- |\n| `ACCEPT` | o titular da chave pedida por outra instituição | libera a chave para a outra instituição |\n| `REJECT` | o mesmo | mantém a chave (recusa o pedido) |\n| `OPEN` | quem pediu a chave aqui | confirma a abertura do pedido de reivindicação |\n| `CANCEL` | quem pediu a chave aqui | desiste do pedido |\n| `COMPLETE` | quem pediu a chave aqui | confirma a chave depois que a outra instituição a liberou |\n\n- **Exige `X-Step-Up`** com `purpose: pix_key` em toda ação e\n **`Idempotency-Key`**. Repetir a mesma chave devolve o mesmo pedido,\n sem repetir a ação.\n- A chave de outro titular é `404`. A conta precisa estar ativa.\n- **Só com sessão de cliente**: não aceita chave de API, e o\n atendimento não responde pelo titular.\n- Um pedido por vez por chave, e uma ação por andamento: depois de\n agir, a próxima ação só aparece quando a outra ponta responder.\n\nA resposta é `202`; o resultado vem pela lista de chaves. `UNKNOWN`\né a outra ponta sem resposta a tempo: **não repita**. A ação entra no\nhistórico de segurança do titular (`PIX_KEY`), com a chave mascarada.\n", "type": "text/plain" }, "url": { "path": [ "v1", "pix", "keys", ":id", "claim" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) O `id` da chave, e nao a chave em si." } ] }, "header": [ { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"action\": \"ACCEPT\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "e93b9c3b-1af6-4d45-92d2-f2fbd3034673", "name": "Pedido registrado.", "originalRequest": { "url": { "path": [ "v1", "pix", "keys", ":id", "claim" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) O `id` da chave, e nao a chave em si." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"action\": \"ACCEPT\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Accepted", "code": 202, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"Ut sit in\",\n \"keyId\": \"nisi sit aliqua et\",\n \"action\": \"CANCEL\",\n \"status\": \"UNKNOWN\",\n \"masked\": \"culpa aliquip\",\n \"message\": \"cillum mollit veniam laborum\",\n \"createdAt\": \"2024-09-16T17:13:06.779Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "82df60be-304c-4dc1-80b1-038b6248d17f", "name": "Requisição malformada ou com dado inválido", "originalRequest": { "url": { "path": [ "v1", "pix", "keys", ":id", "claim" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) O `id` da chave, e nao a chave em si." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"action\": \"ACCEPT\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "98ceab39-2981-475d-ad69-0f7a6d667939", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "pix", "keys", ":id", "claim" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) O `id` da chave, e nao a chave em si." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"action\": \"ACCEPT\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "62497257-780b-4eb6-ad32-f2835ec16d76", "name": "Falta o `X-Step-Up` com `purpose: pix_key` (`STEP_UP_REQUIRED`); a\nconta não está ativa, a origem não é o titular (`FORBIDDEN`); ou a\nfuncionalidade está desligada (`FEATURE_DISABLED`).\n", "originalRequest": { "url": { "path": [ "v1", "pix", "keys", ":id", "claim" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) O `id` da chave, e nao a chave em si." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"action\": \"ACCEPT\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "46ec249c-fac3-4dd8-a949-e32d2a7c7fad", "name": "Registro não encontrado", "originalRequest": { "url": { "path": [ "v1", "pix", "keys", ":id", "claim" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) O `id` da chave, e nao a chave em si." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"action\": \"ACCEPT\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7a979fca-3aa9-4f1e-a677-ffc1fc3ceb40", "name": "A ação não cabe à chave agora, já há pedido em andamento, ou a\n`Idempotency-Key` já foi usada em outro pedido.\n", "originalRequest": { "url": { "path": [ "v1", "pix", "keys", ":id", "claim" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) O `id` da chave, e nao a chave em si." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"action\": \"ACCEPT\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e3c20eb6-f873-453c-8cf9-abd6553fdd05", "name": "Ação inválida (`INVALID_REQUEST`) ou recusa da outra ponta (`PROVIDER_ERROR`).", "originalRequest": { "url": { "path": [ "v1", "pix", "keys", ":id", "claim" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) O `id` da chave, e nao a chave em si." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"action\": \"ACCEPT\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c223dfaf-6830-45cf-9839-b90eb529d106", "name": "O arranjo de pagamento está indisponível. Tente novamente.", "originalRequest": { "url": { "path": [ "v1", "pix", "keys", ":id", "claim" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) O `id` da chave, e nao a chave em si." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"action\": \"ACCEPT\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b23a95de-a916-44bd-ab75-3f3254604400", "name": "Consulta o titular de uma chave no DICT", "request": { "name": "Consulta o titular de uma chave no DICT", "description": { "content": "Chame antes de transferir e mostre o nome devolvido para conferência.\n\nA consulta é feita em nome da conta em uso, e uma conta bloqueada não\nconsulta (`403 FORBIDDEN`). Há um limite **por conta e por titular**,\nalém do limite por endereço: 20 consultas a cada 10 minutos, e a chave\nque o DICT não conhece conta como 3. Toda rota que devolve o dono de\numa chave gasta o mesmo saldo: esta, a leitura de BR Code\n(`POST /v1/pix/brcode/parse`) e o favorecido por chave\n(`POST /v1/beneficiaries`). A consulta feita dentro do envio\n(`POST /v1/pix/transfers`) tem saldo próprio, de 60 a cada 10 minutos,\ncom a mesma regra para a chave que não existe. A chave de API gasta\no mesmo limite da conta. Acima, `429 RATE_LIMITED` com `Retry-After`;\na primeira recusa fica no histórico de segurança do titular\n(`PIX_LOOKUP_LIMIT`). O `document` é sempre a **chave mascarada**,\nnunca o CPF ou o CNPJ do titular, mesmo quando o arranjo informa o\ndocumento inteiro. A consulta mostrada na tela não é a do envio: cada\n`POST /v1/pix/transfers` consulta a chave de novo, e é essa consulta que\ndefine o identificador da transferência.\n\n**Instalação de testes do provedor.** Em alguns provedores, qualquer\nchave sintaticamente válida existe no DICT - com uma exceção\ndeliberada: **chave cujo último caractere seja `0`** (um CPF terminado\nem zero, por exemplo) é recusada pelo arranjo, com\n`422 PROVIDER_ERROR`. É o caminho de erro que a sua tela precisa saber\ndesenhar, e ele é reproduzível.\n\nEm outros, quem responde é o DICT do próprio provedor (ou a massa de\ntestes dele), e a regra do último caractere não vale: a chave que ele\nnão conhece é `422 PROVIDER_ERROR`. Não suponha que uma chave\ninexistente numa instalação de testes também seja inexistente em outra,\nnem o contrário.\n", "type": "text/plain" }, "url": { "path": [ "v1", "pix", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "key", "value": "eurico.b@email.com.br", "description": "(Required) " } ], "variable": [] }, "header": [ { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "11013de6-64c0-4175-a366-0d6a4199ae6c", "name": "Titular da chave", "originalRequest": { "url": { "path": [ "v1", "pix", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "key", "value": "eurico.b@email.com.br" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"key\": \"aliqua ea cillum dolor\",\n \"name\": \"Auto Pecas Farol LTDA\",\n \"document\": \"e*******@email.com.br\",\n \"bank\": \"Itau\",\n \"recipientRef\": \"3f2a9c0d6b1e4f7a8c5d2e9b0a1f3c4d\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a0564ad5-062c-4354-8df1-d96bcf8c304a", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "pix", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "key", "value": "eurico.b@email.com.br" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bd44f078-1425-414f-986e-6ca20c0e2f89", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "pix", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "key", "value": "eurico.b@email.com.br" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "46d7464f-97bd-49bf-90a2-a69c125ef2cb", "name": "Chave malformada (`INVALID_REQUEST`) ou recusada pelo arranjo\n(`PROVIDER_ERROR`) - inclusive quando ela simplesmente não existe no\nDICT.\n", "originalRequest": { "url": { "path": [ "v1", "pix", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "key", "value": "eurico.b@email.com.br" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a40a08fe-9a92-43ca-804e-0fec3dbfe063", "name": "Limite de requisições atingido. O cabeçalho `Retry-After` diz quantos\nsegundos esperar.\n", "originalRequest": { "url": { "path": [ "v1", "pix", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "key", "value": "eurico.b@email.com.br" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "153c31e6-15d9-4b0b-a521-f6136d768fc0", "name": "O arranjo de pagamento está indisponível. Tente novamente.", "originalRequest": { "url": { "path": [ "v1", "pix", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "key", "value": "eurico.b@email.com.br" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6235ce5a-3e23-458d-81e4-c016ced5b52a", "name": "Transfere por PIX", "request": { "name": "Transfere por PIX", "description": { "content": "**`Idempotency-Key` é obrigatório.** Sem ele a chamada responde `400`\nantes de qualquer efeito. Repetir a mesma chave com o mesmo corpo\ndevolve a resposta original, marcada com `Idempotent-Replay: true`, e o\ndinheiro sai uma vez só. A mesma chave com corpo diferente responde\n`409`.\n\nResponde `202`, e não `201`: a transferência foi aceita, mas o desfecho\npode ainda não existir. Acompanhe pelo `status` da transação.\n\nTrês desfechos possíveis no corpo da resposta:\n\n- `PROCESSING` ou `COMPLETED` — seguiu o caminho normal.\n- `HELD_FOR_REVIEW` — o motor de risco reteve. O titular decide em\n `POST /v1/transactions/{id}/review`, e `riskSignals` explica o que\n chamou atenção e o que foi conferido e está normal.\n\nA partir de R$ 1.000,00 - o valor exato inclusive - exige `X-Step-Up`\ncom `purpose: transfer`, mesmo\ncom a sessão aberta. Vale também pela soma do dia: o Pix que leva a\nsoma dos Pix enviados no dia (por chave, por agência e conta, QR Code e\ndevolução) a R$ 1.000,00 exige o `X-Step-Up`, ainda que abaixo desse\nvalor (`403 STEP_UP_REQUIRED`, sem reservar nada; a instalação pode\nconfigurar o teto da soma).\n\nEm instalações cujo provedor exige uma pessoa na ponta, o envio só sai\npor sessão de cliente com aparelho identificado. Por chave\nde API, ou por uma sessão sem aparelho, a resposta é `503\nPROVIDER_ERROR` **antes** de qualquer débito: nada é reservado, e\nrepetir pelo mesmo canal não adianta.\n\n**Pix por agência e conta** (funcionalidade `pix_manual`). Informe\n**exatamente um** entre `key` (Pix por chave), `bankAccount` (banco,\nagência, conta, tipo, nome e CPF/CNPJ digitados) e `beneficiaryId`\n(favorecido por conta bancária salvo em `/v1/beneficiaries`); dois ou\nmais respondem `422 INVALID_REQUEST`. Sem chave não há consulta ao\nDICT: **o nome e o documento são os informados pelo cliente e não são\nconfirmados pelo banco de destino**. As regras são as do Pix por chave\n(segundo fator com `purpose: transfer`, selfie, alçada, conta ativa,\nlimites do Pix inclusive o noturno, risco). Na alçada da conta\nempresarial (o valor somado às saídas do dia sem segunda assinatura) o\nPix por agência e conta é recusado com `422\nAPPROVAL_REQUIRED`, a mesma resposta da alçada no resto da API: não há\naprovação conjunta dele, e o pedido de aprovação\n(`POST /v1/approvals/pix`) só aceita Pix por chave. O banco parceiro\nnão tem idempotência nem identificador antes do envio: o Lume registra\na tentativa e nunca a repete, e enquanto houver um Pix por agência e conta **igual** (mesma\nconta, mesmo destino, mesmo valor) sem desfecho, outro igual responde\n`409 CONFLICT`. **Repetição com a mesma `Idempotency-Key`:** se a chave\njá é de um Pix por agência e conta desta conta (por exemplo, o cliente\nrepetiu depois de um `5xx`), a resposta é a transação anterior, com o\nmesmo status, e nada é enviado nem reservado de novo — mesmo depois de\na soma do dia alcançar a alçada, e também quando o favorecido salvo\nfoi apagado nesse meio-tempo (o desfecho anterior vale mais que o\n`404`). Essa repetição é decidida pela regra de negócio e **não** traz\no cabeçalho `Idempotent-Replay`. Chave reaproveitada com outro valor,\ndestino, tipo de conta ou documento responde `409\nIDEMPOTENCY_KEY_REUSED`. A resposta traz `bankAccount` com a conta e o\ndocumento mascarados; `counterparty.pixKey` vem vazio.\n", "type": "text/plain" }, "url": { "path": [ "v1", "pix", "transfers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"amountCents\": 5000,\n \"key\": \"eurico.b@email.com.br\",\n \"bankAccount\": {\n \"ispb\": \"18236120\",\n \"branch\": \"0001\",\n \"account\": \"919261977\",\n \"accountType\": \"SALARY\",\n \"holderName\": \"occaecat\",\n \"holderDocument\": \"proident occaecat\"\n },\n \"beneficiaryId\": \"cupidatat culpa\",\n \"description\": \"Pagamento da nota 8841\",\n \"expectedFeeCents\": 190,\n \"expectedRecipientRef\": \"occaecat esse\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "54a254ab-f275-4398-abfc-b1501d7a172b", "name": "Aceita", "originalRequest": { "url": { "path": [ "v1", "pix", "transfers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 5000,\n \"key\": \"eurico.b@email.com.br\",\n \"bankAccount\": {\n \"ispb\": \"18236120\",\n \"branch\": \"0001\",\n \"account\": \"919261977\",\n \"accountType\": \"SALARY\",\n \"holderName\": \"occaecat\",\n \"holderDocument\": \"proident occaecat\"\n },\n \"beneficiaryId\": \"cupidatat culpa\",\n \"description\": \"Pagamento da nota 8841\",\n \"expectedFeeCents\": 190,\n \"expectedRecipientRef\": \"occaecat esse\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Accepted", "code": 202, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"tx_9f2c1a7b\",\n \"kind\": \"CARD_FEE\",\n \"status\": \"PROCESSING\",\n \"amountCents\": -5000,\n \"description\": \"et adipisicing aliquip ad quis\",\n \"counterparty\": {\n \"name\": \"amet consequat\",\n \"document\": \"Lorem sint fugiat\",\n \"bank\": \"tempor deserunt amet\",\n \"pixKey\": \"commodo exercitation dolor\"\n },\n \"endToEndId\": \"esse enim\",\n \"providerTransactionId\": \"esse\",\n \"riskScore\": 99,\n \"riskSignals\": [\n {\n \"code\": \"NIGHT_WINDOW\",\n \"label\": \"Fora do horário habitual\",\n \"detail\": \"exercitation est commodo velit\",\n \"triggered\": true\n },\n {\n \"code\": \"NIGHT_WINDOW\",\n \"label\": \"Fora do horário habitual\",\n \"detail\": \"sint adipisic\",\n \"triggered\": false\n }\n ],\n \"createdAt\": \"1983-06-13T10:19:34.330Z\",\n \"executedAt\": \"1973-04-03T19:00:12.191Z\",\n \"refundOf\": \"id deserunt reprehenderit est dolor\",\n \"refundableCents\": 47603913,\n \"billetReceipt\": {\n \"kind\": \"BILL\",\n \"authentication\": \"Excepteur id\",\n \"settleDate\": \"1976-04-26\",\n \"convenant\": \"magna anim\"\n },\n \"disputableUntil\": \"1978-02-11T16:12:35.819Z\",\n \"disputeId\": \"laborum\",\n \"ted\": {\n \"bankIspb\": \"18236120\",\n \"branch\": \"0001\",\n \"accountMasked\": \"••••••977\",\n \"accountType\": \"CHECKING\",\n \"holderName\": \"sint\",\n \"holderDocumentMasked\": \"tempor quis magna sit\",\n \"movementId\": \"Duis laborum culpa officia in\",\n \"strControl\": \"commodo sed in labore\"\n },\n \"bankAccount\": {\n \"bankIspb\": \"18236120\",\n \"branch\": \"0001\",\n \"accountMasked\": \"••••••977\",\n \"accountType\": \"CHECKING\",\n \"holderName\": \"dolor aute velit Duis\",\n \"holderDocumentMasked\": \"aliquip in laborum proident\",\n \"movementId\": \"veniam Duis\"\n },\n \"feeCents\": 9892011,\n \"feeTransactionId\": \"fugiat eu do minim\",\n \"feeReason\": \"EXEMPT_BY_RULE\",\n \"feeStatus\": \"FAILED\",\n \"fee\": {\n \"service\": \"irure dolor dolore\",\n \"label\": \"labore\",\n \"feeCents\": 91029077,\n \"reason\": \"COVERED_BY_PLAN\",\n \"status\": \"CHARGED\",\n \"transactionId\": \"aute sint enim ullamco\"\n },\n \"feeOf\": \"enim nisi amet ut\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b22b4531-da7b-4b68-afeb-090f72e78abe", "name": "Falta o cabeçalho `Idempotency-Key`", "originalRequest": { "url": { "path": [ "v1", "pix", "transfers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 5000,\n \"key\": \"eurico.b@email.com.br\",\n \"bankAccount\": {\n \"ispb\": \"18236120\",\n \"branch\": \"0001\",\n \"account\": \"919261977\",\n \"accountType\": \"SALARY\",\n \"holderName\": \"occaecat\",\n \"holderDocument\": \"proident occaecat\"\n },\n \"beneficiaryId\": \"cupidatat culpa\",\n \"description\": \"Pagamento da nota 8841\",\n \"expectedFeeCents\": 190,\n \"expectedRecipientRef\": \"occaecat esse\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4347f239-d7ec-49f1-8d0d-214e1b947d4e", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "pix", "transfers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 5000,\n \"key\": \"eurico.b@email.com.br\",\n \"bankAccount\": {\n \"ispb\": \"18236120\",\n \"branch\": \"0001\",\n \"account\": \"919261977\",\n \"accountType\": \"SALARY\",\n \"holderName\": \"occaecat\",\n \"holderDocument\": \"proident occaecat\"\n },\n \"beneficiaryId\": \"cupidatat culpa\",\n \"description\": \"Pagamento da nota 8841\",\n \"expectedFeeCents\": 190,\n \"expectedRecipientRef\": \"occaecat esse\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ee2c5061-4c30-4352-86a8-839599a27733", "name": "Falta a confirmação de segundo fator (`STEP_UP_REQUIRED`). Chame\n`POST /v1/auth/step-up` e repita com o cabeçalho `X-Step-Up`.\n", "originalRequest": { "url": { "path": [ "v1", "pix", "transfers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 5000,\n \"key\": \"eurico.b@email.com.br\",\n \"bankAccount\": {\n \"ispb\": \"18236120\",\n \"branch\": \"0001\",\n \"account\": \"919261977\",\n \"accountType\": \"SALARY\",\n \"holderName\": \"occaecat\",\n \"holderDocument\": \"proident occaecat\"\n },\n \"beneficiaryId\": \"cupidatat culpa\",\n \"description\": \"Pagamento da nota 8841\",\n \"expectedFeeCents\": 190,\n \"expectedRecipientRef\": \"occaecat esse\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6ecedc6f-9574-40f2-8bf8-f2ceb9fa480f", "name": "O `beneficiaryId` não é um favorecido desta conta (exceto na repetição\nde um Pix por agência e conta já feito com a mesma `Idempotency-Key`,\nque devolve `202`).\n", "originalRequest": { "url": { "path": [ "v1", "pix", "transfers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 5000,\n \"key\": \"eurico.b@email.com.br\",\n \"bankAccount\": {\n \"ispb\": \"18236120\",\n \"branch\": \"0001\",\n \"account\": \"919261977\",\n \"accountType\": \"SALARY\",\n \"holderName\": \"occaecat\",\n \"holderDocument\": \"proident occaecat\"\n },\n \"beneficiaryId\": \"cupidatat culpa\",\n \"description\": \"Pagamento da nota 8841\",\n \"expectedFeeCents\": 190,\n \"expectedRecipientRef\": \"occaecat esse\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7d5af43f-100f-4c0b-a1a7-38dffff251eb", "name": "A mesma chave de idempotência já foi usada com outro conteúdo\n(`IDEMPOTENCY_KEY_REUSED`), ou a operação anterior ainda está em\ncurso (`IDEMPOTENCY_IN_FLIGHT` — repita em alguns segundos). No\nPix por agência e conta, também um igual ainda em processamento\n(`CONFLICT`, \"Já há uma transferência igual em processamento.\"), e\na repetição com a mesma chave de um Pix em trânsito cujo destino\nainda não foi gravado (`IDEMPOTENCY_IN_FLIGHT`; não é \"outro\nconteúdo\": aguarde e repita com a mesma chave). Com\n`expectedRecipientRef`, o titular da chave mudou (`CONFLICT`,\n`details.reason: RECIPIENT_CHANGED`) ou não pôde ser confirmado\n(`RECIPIENT_UNVERIFIED`), sem nada reservado.\n", "originalRequest": { "url": { "path": [ "v1", "pix", "transfers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 5000,\n \"key\": \"eurico.b@email.com.br\",\n \"bankAccount\": {\n \"ispb\": \"18236120\",\n \"branch\": \"0001\",\n \"account\": \"919261977\",\n \"accountType\": \"SALARY\",\n \"holderName\": \"occaecat\",\n \"holderDocument\": \"proident occaecat\"\n },\n \"beneficiaryId\": \"cupidatat culpa\",\n \"description\": \"Pagamento da nota 8841\",\n \"expectedFeeCents\": 190,\n \"expectedRecipientRef\": \"occaecat esse\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "24932ee3-e903-471d-9c76-f7c3aedaf302", "name": "Saldo insuficiente (`INSUFFICIENT_FUNDS`), limite excedido\n(`LIMIT_EXCEEDED`), chave inválida ou da própria conta. No Pix por\nagência e conta: mais de um destino informado, dados do destino\ninválidos (`INVALID_REQUEST`, `details.field` diz o campo:\n`bankIspb`, `branch`, `account`, `accountType`, `holderName`,\n`holderDocument` ou `description`), a conta de destino é a\nprópria, ou o valor, somado às saídas do dia, alcança a alçada da\nconta empresarial (`APPROVAL_REQUIRED`).\n", "originalRequest": { "url": { "path": [ "v1", "pix", "transfers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 5000,\n \"key\": \"eurico.b@email.com.br\",\n \"bankAccount\": {\n \"ispb\": \"18236120\",\n \"branch\": \"0001\",\n \"account\": \"919261977\",\n \"accountType\": \"SALARY\",\n \"holderName\": \"occaecat\",\n \"holderDocument\": \"proident occaecat\"\n },\n \"beneficiaryId\": \"cupidatat culpa\",\n \"description\": \"Pagamento da nota 8841\",\n \"expectedFeeCents\": 190,\n \"expectedRecipientRef\": \"occaecat esse\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "763e69a3-5ef8-4c04-8796-a54341a38b3e", "name": "Limite de consultas de chave da conta no envio atingido\n(`RATE_LIMITED`, 60 a cada 10 minutos; a chave que não existe conta\ncomo 3). `Retry-After` diz quanto esperar. Nada foi reservado nem\nenviado; repita com a mesma `Idempotency-Key`.\n", "originalRequest": { "url": { "path": [ "v1", "pix", "transfers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 5000,\n \"key\": \"eurico.b@email.com.br\",\n \"bankAccount\": {\n \"ispb\": \"18236120\",\n \"branch\": \"0001\",\n \"account\": \"919261977\",\n \"accountType\": \"SALARY\",\n \"holderName\": \"occaecat\",\n \"holderDocument\": \"proident occaecat\"\n },\n \"beneficiaryId\": \"cupidatat culpa\",\n \"description\": \"Pagamento da nota 8841\",\n \"expectedFeeCents\": 190,\n \"expectedRecipientRef\": \"occaecat esse\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "685f5970-c888-4403-8dd0-a57f2dc71762", "name": "O provedor desta instalação não envia Pix por agência e conta.", "originalRequest": { "url": { "path": [ "v1", "pix", "transfers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 5000,\n \"key\": \"eurico.b@email.com.br\",\n \"bankAccount\": {\n \"ispb\": \"18236120\",\n \"branch\": \"0001\",\n \"account\": \"919261977\",\n \"accountType\": \"SALARY\",\n \"holderName\": \"occaecat\",\n \"holderDocument\": \"proident occaecat\"\n },\n \"beneficiaryId\": \"cupidatat culpa\",\n \"description\": \"Pagamento da nota 8841\",\n \"expectedFeeCents\": 190,\n \"expectedRecipientRef\": \"occaecat esse\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Implemented", "code": 501, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "0d03da05-b743-4368-8e75-3f56dfd248e6", "name": "O arranjo de pagamento está indisponível. Tente novamente.", "originalRequest": { "url": { "path": [ "v1", "pix", "transfers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 5000,\n \"key\": \"eurico.b@email.com.br\",\n \"bankAccount\": {\n \"ispb\": \"18236120\",\n \"branch\": \"0001\",\n \"account\": \"919261977\",\n \"accountType\": \"SALARY\",\n \"holderName\": \"occaecat\",\n \"holderDocument\": \"proident occaecat\"\n },\n \"beneficiaryId\": \"cupidatat culpa\",\n \"description\": \"Pagamento da nota 8841\",\n \"expectedFeeCents\": 190,\n \"expectedRecipientRef\": \"occaecat esse\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e5e6dead-6e86-4b99-849a-c31c6ef0caca", "name": "Gera um BR Code de cobrança estático", "request": { "name": "Gera um BR Code de cobrança estático", "description": { "content": "Rota anterior ao recurso `POST /v1/pix/qrcodes`, que a substitui:\ngera uma cobrança **estática** pelo mesmo caminho e devolve a mesma\ncobrança, acrescida de `payload` e `amountCents` como sempre. Fica por\ncompatibilidade; o que é novo usa `/v1/pix/qrcodes`.\n\nA chave precisa estar cadastrada na própria conta e ativa: gerar\ncobrança com a chave de outra pessoa é exatamente o golpe que o QR Code\nfalsificado explora. **A conta precisa estar ativa**: conta bloqueada,\npendente ou encerrada não gera cobrança (`403 FORBIDDEN`), porque cobrar\né redirecionar entrada de dinheiro.\n\n`amountCents` maior que zero produz um código de uso único.\n\nO código é **gravado** (aparece em `GET /v1/pix/qrcodes`) e, quando o\nprovedor da instalação gera cobrança (`pix_qr_dynamic`), nasce nele, e\né assim que o Pix pago volta ligado à cobrança. `Idempotency-Key` é\nopcional aqui (8 a 128 caracteres, `400` se for outro tamanho): com\nele, repetir o pedido devolve a mesma cobrança, e a mesma chave com\noutro pedido é `409` (`IDEMPOTENCY_KEY_REUSED`).\n", "type": "text/plain" }, "url": { "path": [ "v1", "pix", "brcode" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": true, "description": "Opcional. Com ela, repetir o pedido devolve a mesma cobrança.", "key": "Idempotency-Key", "value": "proident" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"key\": \"financeiro@integradora.com.br\",\n \"amountCents\": 12990,\n \"city\": \"RIO DE JANEIRO\",\n \"txid\": \"PEDIDO8841\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "95e85d8d-19ad-4f5f-bf22-ceab04e7f97f", "name": "Cobrança gerada: o recurso de `POST /v1/pix/qrcodes` (`id`, `type`,\n`status`...), que inclui `payload` e `amountCents`.\n", "originalRequest": { "url": { "path": [ "v1", "pix", "brcode" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Opcional. Com ela, repetir o pedido devolve a mesma cobrança.", "key": "Idempotency-Key", "value": "proident" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"key\": \"financeiro@integradora.com.br\",\n \"amountCents\": 12990,\n \"city\": \"RIO DE JANEIRO\",\n \"txid\": \"PEDIDO8841\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"exercitation proident eu adipisicing\",\n \"type\": \"STATIC\",\n \"payload\": \"labore Ut dolor anim ullamco\",\n \"paymentLink\": \"http://hAe.nghxx\",\n \"amountCents\": 91988056,\n \"amountEditable\": true,\n \"expiresAt\": \"1957-04-25T08:52:16.365Z\",\n \"description\": \"in\",\n \"status\": \"PAID\",\n \"createdAt\": \"1989-07-04T04:33:05.283Z\",\n \"paidTransactionId\": \"Duis\",\n \"paidCents\": 48642149\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "87e61a2d-6265-4db4-a70f-da35a2b84db9", "name": "O corpo é ilegível, ou o `Idempotency-Key` enviado não tem de 8 a 128 caracteres.", "originalRequest": { "url": { "path": [ "v1", "pix", "brcode" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Opcional. Com ela, repetir o pedido devolve a mesma cobrança.", "key": "Idempotency-Key", "value": "proident" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"key\": \"financeiro@integradora.com.br\",\n \"amountCents\": 12990,\n \"city\": \"RIO DE JANEIRO\",\n \"txid\": \"PEDIDO8841\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7c4b8512-e87a-47d2-bd95-1c9257f88e9f", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "pix", "brcode" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Opcional. Com ela, repetir o pedido devolve a mesma cobrança.", "key": "Idempotency-Key", "value": "proident" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"key\": \"financeiro@integradora.com.br\",\n \"amountCents\": 12990,\n \"city\": \"RIO DE JANEIRO\",\n \"txid\": \"PEDIDO8841\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e08115ad-cab2-41ff-97a0-f2b2eb596d6a", "name": "A chave não pertence a esta conta, não está ativa, ou a conta não\nestá ativa; chave de API sem o escopo `pix:write`; cobrança por QR\nCode desligada nesta instalação (`FEATURE_DISABLED`).\n", "originalRequest": { "url": { "path": [ "v1", "pix", "brcode" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Opcional. Com ela, repetir o pedido devolve a mesma cobrança.", "key": "Idempotency-Key", "value": "proident" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"key\": \"financeiro@integradora.com.br\",\n \"amountCents\": 12990,\n \"city\": \"RIO DE JANEIRO\",\n \"txid\": \"PEDIDO8841\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "47f98602-4416-41f4-8467-e6411806fc4f", "name": "A chave de idempotência já foi usada com outro pedido\n(`IDEMPOTENCY_KEY_REUSED`), ou a tentativa anterior ainda está em\nandamento (`IDEMPOTENCY_IN_FLIGHT`).\n", "originalRequest": { "url": { "path": [ "v1", "pix", "brcode" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Opcional. Com ela, repetir o pedido devolve a mesma cobrança.", "key": "Idempotency-Key", "value": "proident" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"key\": \"financeiro@integradora.com.br\",\n \"amountCents\": 12990,\n \"city\": \"RIO DE JANEIRO\",\n \"txid\": \"PEDIDO8841\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b161fc25-4fcd-4eef-9c8e-3a51b8c75a43", "name": "Requisição malformada ou com dado inválido", "originalRequest": { "url": { "path": [ "v1", "pix", "brcode" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Opcional. Com ela, repetir o pedido devolve a mesma cobrança.", "key": "Idempotency-Key", "value": "proident" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"key\": \"financeiro@integradora.com.br\",\n \"amountCents\": 12990,\n \"city\": \"RIO DE JANEIRO\",\n \"txid\": \"PEDIDO8841\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "19499ff9-2a4a-4425-8712-bebaa5e69f98", "name": "O arranjo de pagamento está indisponível. Tente novamente.", "originalRequest": { "url": { "path": [ "v1", "pix", "brcode" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Opcional. Com ela, repetir o pedido devolve a mesma cobrança.", "key": "Idempotency-Key", "value": "proident" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"key\": \"financeiro@integradora.com.br\",\n \"amountCents\": 12990,\n \"city\": \"RIO DE JANEIRO\",\n \"txid\": \"PEDIDO8841\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e14a6d59-b5a5-49cd-b3a0-7a3a76a7b3dd", "name": "Cobranças por QR Code da conta", "request": { "name": "Cobranças por QR Code da conta", "description": { "content": "As cobranças por QR Code desta conta em uso, da mais recente para a\nmais antiga (até 100). `status` é `OPEN`, `PAID`, `EXPIRED` ou\n`DELETED`; `EXPIRED` é a aberta cujo vencimento passou, mesmo sem\nevento do provedor. Chave de API precisa do escopo `pix:read`.\n", "type": "text/plain" }, "url": { "path": [ "v1", "pix", "qrcodes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "eb7baf1e-66e8-4be2-a4f4-11b15c4e8b5e", "name": "Cobranças", "originalRequest": { "url": { "path": [ "v1", "pix", "qrcodes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"items\": [\n {\n \"id\": \"fugiat ipsum nisi dolore minim\",\n \"type\": \"DYNAMIC\",\n \"payload\": \"magna adipisicing laborum\",\n \"paymentLink\": \"http://iPlYuOqFY.cxqLadPtRA-auyKz4rl\",\n \"amountCents\": -10192355,\n \"amountEditable\": true,\n \"expiresAt\": \"1958-01-18T03:53:44.748Z\",\n \"description\": \"occaecat in dolor exercitation\",\n \"status\": \"EXPIRED\",\n \"createdAt\": \"1968-07-20T21:50:24.376Z\",\n \"paidTransactionId\": \"consequat tempor Duis\",\n \"paidCents\": 2984750\n },\n {\n \"id\": \"Excepteur Duis proident\",\n \"type\": \"DYNAMIC\",\n \"payload\": \"id\",\n \"paymentLink\": \"https://glpP.gdbyByBtRGTiTvHDLoXgOS,NKkDqR1N+.gFKfqCWLq6IvIFbL\",\n \"amountCents\": -20764624,\n \"amountEditable\": true,\n \"expiresAt\": \"2013-10-16T02:52:23.634Z\",\n \"description\": \"ipsum cupi\",\n \"status\": \"PAID\",\n \"createdAt\": \"1953-09-02T05:49:06.465Z\",\n \"paidTransactionId\": \"deserunt veniam adipisicing eius\",\n \"paidCents\": -52275185\n }\n ],\n \"keyTypes\": [\n \"EVP\",\n \"EVP\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7de28dd8-04b1-445c-92b2-81c8aa9bd247", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "pix", "qrcodes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3545c86d-5123-428f-9d8a-370e98959aca", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "pix", "qrcodes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2b22397a-3cec-48a7-aeb6-ae1e50af2057", "name": "Gera uma cobrança por QR Code (estática ou dinâmica)", "request": { "name": "Gera uma cobrança por QR Code (estática ou dinâmica)", "description": { "content": "Sem `expiresAt` a cobrança é **estática**; com `expiresAt`, **dinâmica**\n(exige `amountCents` maior que zero e vencimento no futuro, em até um\nano).\n\n- **Estática**: valor fixo (`amountCents` > 0, uso único) ou livre\n (`amountCents` omitido ou zero: quem paga escolhe o valor, e o código\n pode ser pago mais de uma vez). `amountEditable: true` com valor\n fixo é `422`.\n- **Dinâmica**: valor e vencimento; `amountEditable: true` deixa o\n pagador mudar o valor. **Uso único** (decisão da instalação, não um\n campo do pedido). Só existe quando o provedor da instalação gera\n cobrança (`pix_qr_dynamic`); sem ele, `501`.\n\n**Quem gera o código** é o provedor, quando declara `pix_qr_dynamic`\n(a Azify): é o que traz o Pix pago de volta ligado à cobrança. Sem a\ncapacidade (a Celcoin), o BR Code estático é gerado localmente, e o\ncrédito do Pix não se liga à cobrança.\n\n**A cidade** do recebedor é a do cadastro do titular, normalizada pelo\nservidor; o pedido não a recebe.\n\n**A chave** é da própria conta, ativa e de um tipo que o provedor gera\nem QR Code (a Azify: CPF, CNPJ e chave aleatória; e-mail e telefone\nsão `422`). **A conta precisa estar ativa** (`403` se não).\n\n**Idempotência obrigatória**: a mesma `Idempotency-Key` devolve a mesma\ncobrança (marcada com `Idempotent-Replay: true`), e não outro código\npagável; com pedido diferente, `409` (`IDEMPOTENCY_KEY_REUSED`; a rota\n`POST /v1/pix/brcode` compartilha o espaço de chaves da conta). Uma\nrecusa `4xx` definitiva (`403`, `422`...) fica gravada sob a chave:\ndepois de corrigir o pedido, use uma chave nova. **O `409`\n`IDEMPOTENCY_IN_FLIGHT`, o `5xx` e a falha de rede não renovam a\nchave**: o código pode ter sido gerado, e repetir com a mesma chave\ndevolve a mesma cobrança em vez de outro código pagável.\n\nSem segundo fator: gerar cobrança não tira dinheiro. Chave de API\nprecisa do escopo `pix:write`.\n", "type": "text/plain" }, "url": { "path": [ "v1", "pix", "qrcodes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"key\": \"financeiro@integradora.com.br\",\n \"amountCents\": 19900,\n \"amountEditable\": false,\n \"expiresAt\": \"2026-10-10T15:00:00Z\",\n \"description\": \"Pedido 42\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "7a6f7823-3b4b-431f-b538-9986dda3c1b5", "name": "Cobrança gerada", "originalRequest": { "url": { "path": [ "v1", "pix", "qrcodes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"key\": \"financeiro@integradora.com.br\",\n \"amountCents\": 19900,\n \"amountEditable\": false,\n \"expiresAt\": \"2026-10-10T15:00:00Z\",\n \"description\": \"Pedido 42\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"exercitation proident eu adipisicing\",\n \"type\": \"STATIC\",\n \"payload\": \"labore Ut dolor anim ullamco\",\n \"paymentLink\": \"http://hAe.nghxx\",\n \"amountCents\": 91988056,\n \"amountEditable\": true,\n \"expiresAt\": \"1957-04-25T08:52:16.365Z\",\n \"description\": \"in\",\n \"status\": \"PAID\",\n \"createdAt\": \"1989-07-04T04:33:05.283Z\",\n \"paidTransactionId\": \"Duis\",\n \"paidCents\": 48642149\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8ce831bc-b68e-4a3f-bae9-231a1987725b", "name": "Falta o cabeçalho `Idempotency-Key`, ou o corpo é ilegível.", "originalRequest": { "url": { "path": [ "v1", "pix", "qrcodes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"key\": \"financeiro@integradora.com.br\",\n \"amountCents\": 19900,\n \"amountEditable\": false,\n \"expiresAt\": \"2026-10-10T15:00:00Z\",\n \"description\": \"Pedido 42\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "252d2686-5660-4c7d-8ea3-5c2e202ed8c2", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "pix", "qrcodes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"key\": \"financeiro@integradora.com.br\",\n \"amountCents\": 19900,\n \"amountEditable\": false,\n \"expiresAt\": \"2026-10-10T15:00:00Z\",\n \"description\": \"Pedido 42\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "10d6dc11-c39d-4213-95cd-33fbf926ccab", "name": "A chave não é desta conta ou não está ativa; a conta não está ativa;\nchave de API sem o escopo `pix:write`; cobrança por QR Code desligada\nnesta instalação (`FEATURE_DISABLED`).\n", "originalRequest": { "url": { "path": [ "v1", "pix", "qrcodes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"key\": \"financeiro@integradora.com.br\",\n \"amountCents\": 19900,\n \"amountEditable\": false,\n \"expiresAt\": \"2026-10-10T15:00:00Z\",\n \"description\": \"Pedido 42\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "950e3b8e-5fb0-4f6c-abfb-4dc1f71a0419", "name": "A mesma chave de idempotência já foi usada com outro conteúdo ou\noutro pedido (`IDEMPOTENCY_KEY_REUSED`), ou a operação anterior\nainda está em andamento (`IDEMPOTENCY_IN_FLIGHT`; inclui a tentativa\nanterior cujo resultado no provedor ainda não se conhece: espere e\nrepita com a mesma chave).\n", "originalRequest": { "url": { "path": [ "v1", "pix", "qrcodes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"key\": \"financeiro@integradora.com.br\",\n \"amountCents\": 19900,\n \"amountEditable\": false,\n \"expiresAt\": \"2026-10-10T15:00:00Z\",\n \"description\": \"Pedido 42\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "84db8720-f22a-4710-9305-2a59e00b98fa", "name": "Tipo de chave que o provedor não gera, vencimento no passado ou\nlonge demais, valor inválido para o tipo (dinâmico sem valor,\nestático com valor editável), descrição longa demais, ou pedido\nrecusado pelo provedor (`PROVIDER_ERROR`).\n", "originalRequest": { "url": { "path": [ "v1", "pix", "qrcodes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"key\": \"financeiro@integradora.com.br\",\n \"amountCents\": 19900,\n \"amountEditable\": false,\n \"expiresAt\": \"2026-10-10T15:00:00Z\",\n \"description\": \"Pedido 42\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d7a7e1bf-eb97-428c-844a-f517c3a2d507", "name": "O provedor desta instalação não gera cobrança com vencimento.", "originalRequest": { "url": { "path": [ "v1", "pix", "qrcodes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"key\": \"financeiro@integradora.com.br\",\n \"amountCents\": 19900,\n \"amountEditable\": false,\n \"expiresAt\": \"2026-10-10T15:00:00Z\",\n \"description\": \"Pedido 42\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Implemented", "code": 501, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cc5dcb67-69c6-4972-9abb-02cbbfb5af97", "name": "O arranjo de pagamento está indisponível. Tente novamente.", "originalRequest": { "url": { "path": [ "v1", "pix", "qrcodes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"key\": \"financeiro@integradora.com.br\",\n \"amountCents\": 19900,\n \"amountEditable\": false,\n \"expiresAt\": \"2026-10-10T15:00:00Z\",\n \"description\": \"Pedido 42\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c6b5cc38-f957-4e8e-8fe7-f5b55b916099", "name": "Exclui uma cobrança por QR Code", "request": { "name": "Exclui uma cobrança por QR Code", "description": { "content": "**O provedor primeiro, o banco depois**: a falha do provedor mantém a\ncobrança `OPEN` e responde `503` (ou `422`, se ele a recusar). Um\ncódigo que o provedor já não tem (`404` dele) conta como excluído. Devolve a cobrança com\n`status: DELETED`; excluir de novo devolve o mesmo, sem outra chamada\nao provedor.\n\n- Cobrança já **paga** não se exclui: `409`.\n- Cobrança de outra conta é `404`, igual à que não existe.\n- A conta precisa estar ativa (`403` se não).\n- Cobrança gerada **localmente** (provedor sem `pix_qr_dynamic`) só sai\n da lista: o BR Code já entregue continua podendo ser pago.\n\nChave de API precisa do escopo `pix:write`.\n", "type": "text/plain" }, "url": { "path": [ "v1", "pix", "qrcodes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) O `id` da cobrança." } ] }, "header": [ { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "auth": null }, "response": [ { "id": "4b32ea52-4e8c-4c6c-b654-ed04b31efdc1", "name": "Cobrança excluída", "originalRequest": { "url": { "path": [ "v1", "pix", "qrcodes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) O `id` da cobrança." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"exercitation proident eu adipisicing\",\n \"type\": \"STATIC\",\n \"payload\": \"labore Ut dolor anim ullamco\",\n \"paymentLink\": \"http://hAe.nghxx\",\n \"amountCents\": 91988056,\n \"amountEditable\": true,\n \"expiresAt\": \"1957-04-25T08:52:16.365Z\",\n \"description\": \"in\",\n \"status\": \"PAID\",\n \"createdAt\": \"1989-07-04T04:33:05.283Z\",\n \"paidTransactionId\": \"Duis\",\n \"paidCents\": 48642149\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bf977a25-b382-4e15-8908-f93aab9c5d86", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "pix", "qrcodes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) O `id` da cobrança." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3c0959ac-64ad-4eea-ad41-55c8d68d46d2", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "pix", "qrcodes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) O `id` da cobrança." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "37327181-bdf0-4890-91a6-eba95cd4d8b5", "name": "Registro não encontrado", "originalRequest": { "url": { "path": [ "v1", "pix", "qrcodes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) O `id` da cobrança." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "02e1e422-dd9c-4790-9fa7-9c5b085951a7", "name": "A cobrança já foi paga, ou foi gerada por outro provedor.", "originalRequest": { "url": { "path": [ "v1", "pix", "qrcodes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) O `id` da cobrança." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f15c46f1-36f1-489b-8a94-e2cc1b19d455", "name": "O provedor recusou a exclusão (`PROVIDER_ERROR`); a cobrança continua aberta.", "originalRequest": { "url": { "path": [ "v1", "pix", "qrcodes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) O `id` da cobrança." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e2955541-2c71-46a3-984b-4ee090ae6ed3", "name": "O arranjo de pagamento está indisponível. Tente novamente.", "originalRequest": { "url": { "path": [ "v1", "pix", "qrcodes", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) O `id` da cobrança." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e9afd087-2406-43b8-a948-e3f0ddee4d85", "name": "Lê um BR Code", "request": { "name": "Lê um BR Code", "description": { "content": "Confere o código antes de pagar. Quem o lê é o provedor da instalação,\ncom a conta em uso, e **o código pode ser estático ou dinâmico**: o\nleitor local do Lume só complementa a exibição (`city`, `txid`,\n`oneTime`) e uma falha dele não recusa o código. Nas instalações cujo\nprovedor não decodifica, o código é lido localmente (só estático) e o\nnome vem do DICT.\n\nO nome devolvido vem do provedor ou do DICT, e não do que está escrito\nno código: a leitura do QR não é confiança suficiente, e quem responde\npela titularidade é o diretório.\n\n**O que esta resposta mostra não autoriza o pagamento.** O pagamento\n(`POST /v1/pix/brcode/pay`) lê o código de novo e paga o que essa\nleitura disser; nenhum identificador do provedor (`qrCodeId`,\n`endToEndId`) vai ao cliente.\n", "type": "text/plain" }, "url": { "path": [ "v1", "pix", "brcode", "parse" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"payload\": \"00020126580014BR.GOV.BCB.PIX0136financeiro@integradora.com.br5204000053039865802BR6014RIO DE JANEIRO62070503***6304ABCD\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "de53210e-39fa-4d64-a62a-b67be946d035", "name": "Código lido", "originalRequest": { "url": { "path": [ "v1", "pix", "brcode", "parse" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"payload\": \"00020126580014BR.GOV.BCB.PIX0136financeiro@integradora.com.br5204000053039865802BR6014RIO DE JANEIRO62070503***6304ABCD\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"qrType\": \"STATIC\",\n \"amountEditable\": false,\n \"document\": \"***.556.504-**\",\n \"key\": \"anim cillum ex d\",\n \"name\": \"ad ni\",\n \"bank\": \"amet sunt est\",\n \"city\": \"occaecat\",\n \"amountCents\": -76079850,\n \"txid\": \"voluptate ullamco do pariatur enim\",\n \"oneTime\": false\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "779c6a36-18be-45db-b5de-b3722e4901de", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "pix", "brcode", "parse" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"payload\": \"00020126580014BR.GOV.BCB.PIX0136financeiro@integradora.com.br5204000053039865802BR6014RIO DE JANEIRO62070503***6304ABCD\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d4cb5635-73a5-405e-8c38-af5fb49a0cb5", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "pix", "brcode", "parse" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"payload\": \"00020126580014BR.GOV.BCB.PIX0136financeiro@integradora.com.br5204000053039865802BR6014RIO DE JANEIRO62070503***6304ABCD\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bf331c83-8172-4b45-b80b-79d167e8d998", "name": "Código ilegível, adulterado, vencido ou já pago\n(`INVALID_REQUEST`).\n", "originalRequest": { "url": { "path": [ "v1", "pix", "brcode", "parse" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"payload\": \"00020126580014BR.GOV.BCB.PIX0136financeiro@integradora.com.br5204000053039865802BR6014RIO DE JANEIRO62070503***6304ABCD\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "82dfd198-f1b8-4d1a-b69f-bbe35367bea4", "name": "Limite de consultas de chave da conta atingido (`RATE_LIMITED`,\no mesmo de `GET /v1/pix/lookup`); `Retry-After` diz quanto esperar.\n", "originalRequest": { "url": { "path": [ "v1", "pix", "brcode", "parse" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"payload\": \"00020126580014BR.GOV.BCB.PIX0136financeiro@integradora.com.br5204000053039865802BR6014RIO DE JANEIRO62070503***6304ABCD\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a1712ec1-0d78-4db1-b4cd-1d8d18b5c5d3", "name": "O arranjo de pagamento está indisponível. Tente novamente.", "originalRequest": { "url": { "path": [ "v1", "pix", "brcode", "parse" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"payload\": \"00020126580014BR.GOV.BCB.PIX0136financeiro@integradora.com.br5204000053039865802BR6014RIO DE JANEIRO62070503***6304ABCD\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b401451d-9b15-4ea5-baa2-fb95806889fb", "name": "Paga um QR Code Pix", "request": { "name": "Paga um QR Code Pix", "description": { "content": "Paga um QR Code estático ou dinâmico a partir do copia e cola.\n\n**`Idempotency-Key` é obrigatório**, como em `POST /v1/pix/transfers`:\na mesma chave com o mesmo corpo devolve a resposta original (marcada\ncom `Idempotent-Replay: true`) e o dinheiro sai uma vez só; com corpo\ndiferente, `409`.\n\n**Quem decide o pagamento é o servidor.** Ele lê o código de novo, no\nmomento de pagar e com a conta em uso, e paga pelo identificador dessa\nleitura. O cliente manda o código e, quando o valor é dele, o valor;\nnunca informa o recebedor, o `endToEndId` nem o `qrCodeId`, e a tela de\n`parse` não vale como autorização.\n\n**Valor.**\n\n- Valor fixo (`amountEditable: false` no `parse`): paga o valor do\n código. `amountCents` é opcional e, se vier, tem de ser igual ao do\n código; diferente, `422` e nada é enviado.\n- Valor editável ou sem valor (`amountEditable: true`):\n `amountCents` é obrigatório, inteiro em centavos, maior que zero.\n\nMesmas regras de qualquer Pix: conta ativa, a própria chave recusada,\nlimites (o QR conta no limite do Pix), análise de risco, segundo fator\na partir de R$ 1.000,00 ou quando a soma dos Pix do dia chega a esse\nvalor (`X-Step-Up` com `purpose: transfer`), selfie\nquando a instalação a exige e a alçada de aprovação conjunta da conta\nda empresa. **Na alçada — o valor somado às saídas do dia sem segunda\nassinatura — o pagamento é recusado** (`422`, `APPROVAL_REQUIRED`):\npedir aprovação de QR Code ainda não existe.\n\nComo no Pix por chave, o envio sai no máximo uma vez. Prazo esgotado\nnão é falha: a transação fica `PROCESSING` e o desfecho vem por evento\nou conciliação.\n\n**Retida.** Se o risco reter o pagamento (`HELD_FOR_REVIEW`), nada é\nenviado. Nas instalações cujo provedor paga pelo identificador da\nleitura, o código não é guardado e a retida **não pode ser liberada**\n(`409`): só bloqueada, o que devolve o valor, e o cliente paga de novo.\n\nEm instalações cujo provedor exige uma pessoa na ponta, o pagamento só\nsai por sessão de cliente com aparelho identificado; por chave de API ou\nsessão sem aparelho, a resposta é `503 PROVIDER_ERROR` antes de\nqualquer débito.\n", "type": "text/plain" }, "url": { "path": [ "v1", "pix", "brcode", "pay" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"payload\": \"00020126580014BR.GOV.BCB.PIX0136financeiro@integradora.com.br5204000053039865802BR6014RIO DE JANEIRO62070503***6304ABCD\",\n \"amountCents\": 1990,\n \"description\": \"Pagamento por código PIX\",\n \"expectedFeeCents\": 190\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "d6c41638-0059-4b22-a725-4cef220ccb50", "name": "Aceito. A transação tem `kind: PAYMENT_QRCODE`. `status` é\n`PROCESSING` (o normal), `COMPLETED`, `HELD_FOR_REVIEW` ou `FAILED`\n(recusado pelo banco, valor devolvido).\n", "originalRequest": { "url": { "path": [ "v1", "pix", "brcode", "pay" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"payload\": \"00020126580014BR.GOV.BCB.PIX0136financeiro@integradora.com.br5204000053039865802BR6014RIO DE JANEIRO62070503***6304ABCD\",\n \"amountCents\": 1990,\n \"description\": \"Pagamento por código PIX\",\n \"expectedFeeCents\": 190\n}", "options": { "raw": { "language": "json" } } } }, "status": "Accepted", "code": 202, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"tx_9f2c1a7b\",\n \"kind\": \"CARD_FEE\",\n \"status\": \"PROCESSING\",\n \"amountCents\": -5000,\n \"description\": \"et adipisicing aliquip ad quis\",\n \"counterparty\": {\n \"name\": \"amet consequat\",\n \"document\": \"Lorem sint fugiat\",\n \"bank\": \"tempor deserunt amet\",\n \"pixKey\": \"commodo exercitation dolor\"\n },\n \"endToEndId\": \"esse enim\",\n \"providerTransactionId\": \"esse\",\n \"riskScore\": 99,\n \"riskSignals\": [\n {\n \"code\": \"NIGHT_WINDOW\",\n \"label\": \"Fora do horário habitual\",\n \"detail\": \"exercitation est commodo velit\",\n \"triggered\": true\n },\n {\n \"code\": \"NIGHT_WINDOW\",\n \"label\": \"Fora do horário habitual\",\n \"detail\": \"sint adipisic\",\n \"triggered\": false\n }\n ],\n \"createdAt\": \"1983-06-13T10:19:34.330Z\",\n \"executedAt\": \"1973-04-03T19:00:12.191Z\",\n \"refundOf\": \"id deserunt reprehenderit est dolor\",\n \"refundableCents\": 47603913,\n \"billetReceipt\": {\n \"kind\": \"BILL\",\n \"authentication\": \"Excepteur id\",\n \"settleDate\": \"1976-04-26\",\n \"convenant\": \"magna anim\"\n },\n \"disputableUntil\": \"1978-02-11T16:12:35.819Z\",\n \"disputeId\": \"laborum\",\n \"ted\": {\n \"bankIspb\": \"18236120\",\n \"branch\": \"0001\",\n \"accountMasked\": \"••••••977\",\n \"accountType\": \"CHECKING\",\n \"holderName\": \"sint\",\n \"holderDocumentMasked\": \"tempor quis magna sit\",\n \"movementId\": \"Duis laborum culpa officia in\",\n \"strControl\": \"commodo sed in labore\"\n },\n \"bankAccount\": {\n \"bankIspb\": \"18236120\",\n \"branch\": \"0001\",\n \"accountMasked\": \"••••••977\",\n \"accountType\": \"CHECKING\",\n \"holderName\": \"dolor aute velit Duis\",\n \"holderDocumentMasked\": \"aliquip in laborum proident\",\n \"movementId\": \"veniam Duis\"\n },\n \"feeCents\": 9892011,\n \"feeTransactionId\": \"fugiat eu do minim\",\n \"feeReason\": \"EXEMPT_BY_RULE\",\n \"feeStatus\": \"FAILED\",\n \"fee\": {\n \"service\": \"irure dolor dolore\",\n \"label\": \"labore\",\n \"feeCents\": 91029077,\n \"reason\": \"COVERED_BY_PLAN\",\n \"status\": \"CHARGED\",\n \"transactionId\": \"aute sint enim ullamco\"\n },\n \"feeOf\": \"enim nisi amet ut\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "80616dbc-f58c-4ca4-8df1-5c165aaeed3e", "name": "Falta o cabeçalho `Idempotency-Key`, ou o corpo é ilegível.", "originalRequest": { "url": { "path": [ "v1", "pix", "brcode", "pay" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"payload\": \"00020126580014BR.GOV.BCB.PIX0136financeiro@integradora.com.br5204000053039865802BR6014RIO DE JANEIRO62070503***6304ABCD\",\n \"amountCents\": 1990,\n \"description\": \"Pagamento por código PIX\",\n \"expectedFeeCents\": 190\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "75d6dc70-e0ef-46e1-93b0-f8fa2b7ae6d0", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "pix", "brcode", "pay" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"payload\": \"00020126580014BR.GOV.BCB.PIX0136financeiro@integradora.com.br5204000053039865802BR6014RIO DE JANEIRO62070503***6304ABCD\",\n \"amountCents\": 1990,\n \"description\": \"Pagamento por código PIX\",\n \"expectedFeeCents\": 190\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3790316b-509c-411d-af77-a539035277f0", "name": "Falta o segundo fator (`STEP_UP_REQUIRED`) ou a selfie\n(`BIOMETRIC_REQUIRED`); conta bloqueada ou chave de API sem o\nescopo `pix:write` (`FORBIDDEN`); pagamento de QR Code desligado\nnesta instalação (`FEATURE_DISABLED`).\n", "originalRequest": { "url": { "path": [ "v1", "pix", "brcode", "pay" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"payload\": \"00020126580014BR.GOV.BCB.PIX0136financeiro@integradora.com.br5204000053039865802BR6014RIO DE JANEIRO62070503***6304ABCD\",\n \"amountCents\": 1990,\n \"description\": \"Pagamento por código PIX\",\n \"expectedFeeCents\": 190\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1ec7e122-c06c-4548-9f57-874ca275cd19", "name": "A mesma chave de idempotência já foi usada com outro conteúdo\n(`IDEMPOTENCY_KEY_REUSED`), ou a operação anterior ainda está em\ncurso (`IDEMPOTENCY_IN_FLIGHT`).\n", "originalRequest": { "url": { "path": [ "v1", "pix", "brcode", "pay" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"payload\": \"00020126580014BR.GOV.BCB.PIX0136financeiro@integradora.com.br5204000053039865802BR6014RIO DE JANEIRO62070503***6304ABCD\",\n \"amountCents\": 1990,\n \"description\": \"Pagamento por código PIX\",\n \"expectedFeeCents\": 190\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "28562861-0fd2-4efe-af93-d50879350b44", "name": "Saldo insuficiente (`INSUFFICIENT_FUNDS`), limite excedido\n(`LIMIT_EXCEEDED`), valor que somado às saídas do dia alcança a\nalçada da empresa (`APPROVAL_REQUIRED`), chave da própria conta,\ncódigo ilegível ou\nvencido, `amountCents` ausente num código sem valor ou editável, e\n`amountCents` diferente do valor fixo do código\n(`INVALID_REQUEST`).\n", "originalRequest": { "url": { "path": [ "v1", "pix", "brcode", "pay" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"payload\": \"00020126580014BR.GOV.BCB.PIX0136financeiro@integradora.com.br5204000053039865802BR6014RIO DE JANEIRO62070503***6304ABCD\",\n \"amountCents\": 1990,\n \"description\": \"Pagamento por código PIX\",\n \"expectedFeeCents\": 190\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "71166759-8d53-4b07-aac4-6cc4c222dbab", "name": "Limite de consultas de chave da conta no envio atingido\n(`RATE_LIMITED`, 60 a cada 10 minutos; a chave que não existe conta\ncomo 3). `Retry-After` diz quanto esperar. Nada foi reservado nem\nenviado; repita com a mesma `Idempotency-Key`.\n", "originalRequest": { "url": { "path": [ "v1", "pix", "brcode", "pay" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"payload\": \"00020126580014BR.GOV.BCB.PIX0136financeiro@integradora.com.br5204000053039865802BR6014RIO DE JANEIRO62070503***6304ABCD\",\n \"amountCents\": 1990,\n \"description\": \"Pagamento por código PIX\",\n \"expectedFeeCents\": 190\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "996ca224-7641-4c02-ac0b-8003331c3ddf", "name": "O provedor desta instalação não paga QR Code.", "originalRequest": { "url": { "path": [ "v1", "pix", "brcode", "pay" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"payload\": \"00020126580014BR.GOV.BCB.PIX0136financeiro@integradora.com.br5204000053039865802BR6014RIO DE JANEIRO62070503***6304ABCD\",\n \"amountCents\": 1990,\n \"description\": \"Pagamento por código PIX\",\n \"expectedFeeCents\": 190\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Implemented", "code": 501, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "a5caff3f-b70d-42a9-be5f-de82c8c62c08", "name": "Provedor indisponível (`PROVIDER_ERROR`). Antes de qualquer débito\n(canal recusado, leitura do código fora do ar), nada é reservado.\nSe o provedor já tinha aceitado a reserva e o envio comprovadamente\n**não saiu**, a transação fica `FAILED` e **já estornada**, e\naparece assim no extrato: o pagamento de QR Code não é reenviado\ndepois (o código não é guardado), e o cliente paga de novo.\n", "originalRequest": { "url": { "path": [ "v1", "pix", "brcode", "pay" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"payload\": \"00020126580014BR.GOV.BCB.PIX0136financeiro@integradora.com.br5204000053039865802BR6014RIO DE JANEIRO62070503***6304ABCD\",\n \"amountCents\": 1990,\n \"description\": \"Pagamento por código PIX\",\n \"expectedFeeCents\": 190\n}", "options": { "raw": { "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "eac44cde-7e0e-48c1-9f1e-e8bfa587c900", "name": "TED", "description": { "content": "Transferência para conta de outra instituição, com os dados do favorecido\ndigitados. **O nome do favorecido é o que o cliente digitou**: não há DICT\npara conta bancária, e a tela não pode apresentá-lo como confirmado.\n", "type": "text/plain" }, "item": [ { "id": "d4da613b-380e-4a60-b56b-90fb03901269", "name": "Envia uma TED", "request": { "name": "Envia uma TED", "description": { "content": "TED de saída para uma conta de **outra instituição**, com os dados do\nfavorecido digitados ou a partir de um favorecido por conta bancária\nsalvo (`beneficiaryId`; o servidor completa o destino). Só com sessão de\ncliente: **não** aceita chave de API.\n\n**`Idempotency-Key` é obrigatório**, como no Pix. Repetir a mesma chave\ncom o mesmo corpo devolve a resposta original (`Idempotent-Replay: true`)\ne a TED sai uma vez só.\n\n**Exige `X-Step-Up` com `purpose: ted` em toda TED**, qualquer que seja o\nvalor (decisão ainda a confirmar; o `purpose: transfer` do Pix não vale).\n\n**Janela.** A TED só funciona em dias úteis, das 08h às 16h30 (horário\nda operação; configurável por instalação). Fora dela a TED é **recusada**\nantes de qualquer débito, com `422 INVALID_REQUEST` e a janela e o\npróximo dia útil em `details` - não é agendada. Feriado: o Lume não tem\ncalendário de feriados; o banco recusa e o resultado é o mesmo (valor\ndevolvido, mesma resposta).\n\n**No máximo uma vez.** O banco parceiro não tem chave de idempotência\npara TED. O Lume registra a tentativa antes de enviar e nunca a repete:\nse o prazo esgotar ou a resposta se perder, a TED fica `PROCESSING` e o\ndesfecho chega pelo aviso do banco ou pelo extrato. Enquanto houver uma\nTED **igual** (mesma conta, mesmo favorecido, mesmo valor) ainda sem desfecho\n(em envio, aceita e não liquidada, ou de desfecho desconhecido), outra\nigual responde `409 CONFLICT`.\n\nResponde `202`: a TED foi aceita, mas a liquidação vem depois.\nAcompanhe pelo `status` da transação. Na alçada da conta empresarial\n(o valor somado às saídas do dia sem segunda assinatura) a TED é\nrecusada com `422 APPROVAL_REQUIRED`: ainda não há aprovação conjunta\nde TED.\n", "type": "text/plain" }, "url": { "path": [ "v1", "ted", "transfers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"amountCents\": 5000,\n \"beneficiaryId\": \"pariatur nostrud esse\",\n \"bankIspb\": \"18236120\",\n \"branch\": \"0001\",\n \"account\": \"919261977\",\n \"accountType\": \"SAVINGS\",\n \"holderName\": \"dolor dolore cupidatat aliquip\",\n \"holderDocument\": \"culpa minim sunt\",\n \"description\": \"enim proident nisi eiusmod minim\",\n \"expectedFeeCents\": 190\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "c7de4b99-abcf-45b0-ba41-8d30ae11ca2e", "name": "Aceita. `status` é `PROCESSING` (o normal), `COMPLETED`,\n`HELD_FOR_REVIEW` ou `FAILED` (recusada pelo banco, valor devolvido).\n`ted` traz o destino com a conta e o documento mascarados.\n\n**Repetição com a mesma `Idempotency-Key`:** se a chave já é de uma\nTED desta conta (por exemplo, o cliente repetiu depois de um `5xx`),\na resposta é a TED anterior, com o mesmo status, e nada é enviado nem\nreservado de novo. Vale também quando o favorecido salvo foi apagado\nnesse meio-tempo: o desfecho anterior (`202`) vale mais que o `404`.\nSe a TED anterior falhou antes de gravar o destino (valor devolvido),\na repetição devolve essa mesma TED, `FAILED`. Essa repetição é decidida\npela regra de negócio, e **não** traz o cabeçalho `Idempotent-Replay`\n(só a repetição servida pelo registro da resposta o traz). Chave\nreaproveitada com outro valor, destino ou tipo responde `409`; uma\nfalha de leitura do banco ao procurar a chave responde `5xx`, nunca\ncomo ausência.\n", "originalRequest": { "url": { "path": [ "v1", "ted", "transfers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 5000,\n \"beneficiaryId\": \"pariatur nostrud esse\",\n \"bankIspb\": \"18236120\",\n \"branch\": \"0001\",\n \"account\": \"919261977\",\n \"accountType\": \"SAVINGS\",\n \"holderName\": \"dolor dolore cupidatat aliquip\",\n \"holderDocument\": \"culpa minim sunt\",\n \"description\": \"enim proident nisi eiusmod minim\",\n \"expectedFeeCents\": 190\n}", "options": { "raw": { "language": "json" } } } }, "status": "Accepted", "code": 202, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"tx_9f2c1a7b\",\n \"kind\": \"CARD_FEE\",\n \"status\": \"PROCESSING\",\n \"amountCents\": -5000,\n \"description\": \"et adipisicing aliquip ad quis\",\n \"counterparty\": {\n \"name\": \"amet consequat\",\n \"document\": \"Lorem sint fugiat\",\n \"bank\": \"tempor deserunt amet\",\n \"pixKey\": \"commodo exercitation dolor\"\n },\n \"endToEndId\": \"esse enim\",\n \"providerTransactionId\": \"esse\",\n \"riskScore\": 99,\n \"riskSignals\": [\n {\n \"code\": \"NIGHT_WINDOW\",\n \"label\": \"Fora do horário habitual\",\n \"detail\": \"exercitation est commodo velit\",\n \"triggered\": true\n },\n {\n \"code\": \"NIGHT_WINDOW\",\n \"label\": \"Fora do horário habitual\",\n \"detail\": \"sint adipisic\",\n \"triggered\": false\n }\n ],\n \"createdAt\": \"1983-06-13T10:19:34.330Z\",\n \"executedAt\": \"1973-04-03T19:00:12.191Z\",\n \"refundOf\": \"id deserunt reprehenderit est dolor\",\n \"refundableCents\": 47603913,\n \"billetReceipt\": {\n \"kind\": \"BILL\",\n \"authentication\": \"Excepteur id\",\n \"settleDate\": \"1976-04-26\",\n \"convenant\": \"magna anim\"\n },\n \"disputableUntil\": \"1978-02-11T16:12:35.819Z\",\n \"disputeId\": \"laborum\",\n \"ted\": {\n \"bankIspb\": \"18236120\",\n \"branch\": \"0001\",\n \"accountMasked\": \"••••••977\",\n \"accountType\": \"CHECKING\",\n \"holderName\": \"sint\",\n \"holderDocumentMasked\": \"tempor quis magna sit\",\n \"movementId\": \"Duis laborum culpa officia in\",\n \"strControl\": \"commodo sed in labore\"\n },\n \"bankAccount\": {\n \"bankIspb\": \"18236120\",\n \"branch\": \"0001\",\n \"accountMasked\": \"••••••977\",\n \"accountType\": \"CHECKING\",\n \"holderName\": \"dolor aute velit Duis\",\n \"holderDocumentMasked\": \"aliquip in laborum proident\",\n \"movementId\": \"veniam Duis\"\n },\n \"feeCents\": 9892011,\n \"feeTransactionId\": \"fugiat eu do minim\",\n \"feeReason\": \"EXEMPT_BY_RULE\",\n \"feeStatus\": \"FAILED\",\n \"fee\": {\n \"service\": \"irure dolor dolore\",\n \"label\": \"labore\",\n \"feeCents\": 91029077,\n \"reason\": \"COVERED_BY_PLAN\",\n \"status\": \"CHARGED\",\n \"transactionId\": \"aute sint enim ullamco\"\n },\n \"feeOf\": \"enim nisi amet ut\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "472071f7-5d62-4621-902f-390f05f11840", "name": "Falta o cabeçalho `Idempotency-Key`, ou o corpo é ilegível.", "originalRequest": { "url": { "path": [ "v1", "ted", "transfers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 5000,\n \"beneficiaryId\": \"pariatur nostrud esse\",\n \"bankIspb\": \"18236120\",\n \"branch\": \"0001\",\n \"account\": \"919261977\",\n \"accountType\": \"SAVINGS\",\n \"holderName\": \"dolor dolore cupidatat aliquip\",\n \"holderDocument\": \"culpa minim sunt\",\n \"description\": \"enim proident nisi eiusmod minim\",\n \"expectedFeeCents\": 190\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0be4e950-9da7-49ca-ad79-616d6b88f069", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "ted", "transfers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 5000,\n \"beneficiaryId\": \"pariatur nostrud esse\",\n \"bankIspb\": \"18236120\",\n \"branch\": \"0001\",\n \"account\": \"919261977\",\n \"accountType\": \"SAVINGS\",\n \"holderName\": \"dolor dolore cupidatat aliquip\",\n \"holderDocument\": \"culpa minim sunt\",\n \"description\": \"enim proident nisi eiusmod minim\",\n \"expectedFeeCents\": 190\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "48eb50e1-51dd-497b-ad40-8076ec7097dd", "name": "Falta o segundo fator (`STEP_UP_REQUIRED`), conta bloqueada\n(`FORBIDDEN`), ou TED desligada nesta\ninstalação (`FEATURE_DISABLED`).\n", "originalRequest": { "url": { "path": [ "v1", "ted", "transfers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 5000,\n \"beneficiaryId\": \"pariatur nostrud esse\",\n \"bankIspb\": \"18236120\",\n \"branch\": \"0001\",\n \"account\": \"919261977\",\n \"accountType\": \"SAVINGS\",\n \"holderName\": \"dolor dolore cupidatat aliquip\",\n \"holderDocument\": \"culpa minim sunt\",\n \"description\": \"enim proident nisi eiusmod minim\",\n \"expectedFeeCents\": 190\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9aacddae-f8c0-480e-a238-b2599c674c33", "name": "O `beneficiaryId` não é um favorecido desta conta (exceto na repetição\nde uma TED já feita com a mesma `Idempotency-Key`, que devolve `202`).\n", "originalRequest": { "url": { "path": [ "v1", "ted", "transfers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 5000,\n \"beneficiaryId\": \"pariatur nostrud esse\",\n \"bankIspb\": \"18236120\",\n \"branch\": \"0001\",\n \"account\": \"919261977\",\n \"accountType\": \"SAVINGS\",\n \"holderName\": \"dolor dolore cupidatat aliquip\",\n \"holderDocument\": \"culpa minim sunt\",\n \"description\": \"enim proident nisi eiusmod minim\",\n \"expectedFeeCents\": 190\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "20052c4e-0f56-4080-ade6-ad2193bda294", "name": "Já há uma transferência igual em processamento (`CONFLICT`,\n\"Já há uma transferência igual em processamento.\"), ou a mesma chave\nde idempotência foi usada com outro conteúdo\n(`IDEMPOTENCY_KEY_REUSED`). A repetição com a mesma chave de uma TED\nem trânsito cujo destino ainda não foi gravado responde\n`IDEMPOTENCY_IN_FLIGHT` (não é \"outro conteúdo\": aguarde e repita\ncom a mesma chave).\n", "originalRequest": { "url": { "path": [ "v1", "ted", "transfers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 5000,\n \"beneficiaryId\": \"pariatur nostrud esse\",\n \"bankIspb\": \"18236120\",\n \"branch\": \"0001\",\n \"account\": \"919261977\",\n \"accountType\": \"SAVINGS\",\n \"holderName\": \"dolor dolore cupidatat aliquip\",\n \"holderDocument\": \"culpa minim sunt\",\n \"description\": \"enim proident nisi eiusmod minim\",\n \"expectedFeeCents\": 190\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b187a658-9f1a-46b9-9f86-5ad090ee1561", "name": "Dados do favorecido inválidos (`INVALID_REQUEST`, `details.field`\ndiz o campo; `bankIspb` também quando o ISPB tem 8 dígitos mas não\nestá em `GET /v1/banks`); **fora da janela** (`INVALID_REQUEST`, com\n`details.window` - \"08:00-16:30\" -, `details.nextBusinessDay` e\n`details.nextOpensAt`); destino na própria instituição do banco\nparceiro, que só leva TED para outras instituições\n(`INVALID_REQUEST`, `details.field` = `bankIspb`; para essa conta,\nuse Pix); limite diário de TED ou teto noturno\nexcedido (`LIMIT_EXCEEDED`); saldo insuficiente\n(`INSUFFICIENT_FUNDS`); conta de destino igual à própria conta;\nvalor que, somado às saídas do dia, alcança a alçada da conta\nempresarial (`APPROVAL_REQUIRED`).\n", "originalRequest": { "url": { "path": [ "v1", "ted", "transfers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 5000,\n \"beneficiaryId\": \"pariatur nostrud esse\",\n \"bankIspb\": \"18236120\",\n \"branch\": \"0001\",\n \"account\": \"919261977\",\n \"accountType\": \"SAVINGS\",\n \"holderName\": \"dolor dolore cupidatat aliquip\",\n \"holderDocument\": \"culpa minim sunt\",\n \"description\": \"enim proident nisi eiusmod minim\",\n \"expectedFeeCents\": 190\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "388632f1-f359-4b02-ad03-e405f2de2a39", "name": "O provedor desta instalação não envia TED.", "originalRequest": { "url": { "path": [ "v1", "ted", "transfers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 5000,\n \"beneficiaryId\": \"pariatur nostrud esse\",\n \"bankIspb\": \"18236120\",\n \"branch\": \"0001\",\n \"account\": \"919261977\",\n \"accountType\": \"SAVINGS\",\n \"holderName\": \"dolor dolore cupidatat aliquip\",\n \"holderDocument\": \"culpa minim sunt\",\n \"description\": \"enim proident nisi eiusmod minim\",\n \"expectedFeeCents\": 190\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Implemented", "code": 501, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "7f53cc6f-8950-4807-a606-33453b0cc0a4", "name": "O arranjo de pagamento está indisponível. Tente novamente.", "originalRequest": { "url": { "path": [ "v1", "ted", "transfers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 5000,\n \"beneficiaryId\": \"pariatur nostrud esse\",\n \"bankIspb\": \"18236120\",\n \"branch\": \"0001\",\n \"account\": \"919261977\",\n \"accountType\": \"SAVINGS\",\n \"holderName\": \"dolor dolore cupidatat aliquip\",\n \"holderDocument\": \"culpa minim sunt\",\n \"description\": \"enim proident nisi eiusmod minim\",\n \"expectedFeeCents\": 190\n}", "options": { "raw": { "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2592d09c-e0da-46da-9fc6-5e6971c9f8fd", "name": "Lista as instituições de destino (TED e Pix por agência e conta)", "request": { "name": "Lista as instituições de destino (TED e Pix por agência e conta)", "description": { "content": "A lista oficial do Banco Central, reunida por ISPB:\n\n- `ted: true` - participante do STR com código de compensação (COMPE):\n recebe TED. Ficam fora os participantes sem código (Selic, Bacen,\n STN, câmaras).\n- `pix: true` - participante **ativo** do Pix na modalidade \"Provedor de\n Conta Transacional\": recebe Pix por agência e conta. Ficam fora os\n iniciadores e os em adesão.\n\nEm liquidação extrajudicial fica fora das duas. É a mesma lista que o\nservidor confere: a TED (`POST /v1/ted/transfers`) só sai para `ted`, o\nPix por agência e conta (`POST /v1/pix/transfers` e\n`POST /v1/schedules/pix` com `bankAccount`) só para `pix`, e o\nfavorecido por conta bancária (`POST /v1/beneficiaries`) só é salvo com\num dos dois; fora dela, `422` com `details.field: bankIspb`.\n\nVem inteira (pouco mais de mil instituições), em ordem de ISPB: a busca\ne o filtro por finalidade são do cliente. `sources` diz de que arquivo\ndo Banco Central cada lista saiu. Só com sessão de cliente: **não**\naceita chave de API.\n", "type": "text/plain" }, "url": { "path": [ "v1", "banks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "b8d6ae41-6827-4411-9de6-a6c86dfab7fd", "name": "As instituições.", "originalRequest": { "url": { "path": [ "v1", "banks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"sources\": [\n {\n \"name\": \"str\",\n \"asOf\": \"2026-10-06\"\n },\n {\n \"name\": \"pix\",\n \"asOf\": \"2026-10-06\"\n }\n ],\n \"items\": [\n {\n \"ispb\": \"60701190\",\n \"shortName\": \"ITAÚ UNIBANCO S.A.\",\n \"fullName\": \"ITAÚ UNIBANCO S.A.\",\n \"ted\": false,\n \"pix\": false,\n \"code\": \"341\"\n },\n {\n \"ispb\": \"60701190\",\n \"shortName\": \"ITAÚ UNIBANCO S.A.\",\n \"fullName\": \"ITAÚ UNIBANCO S.A.\",\n \"ted\": true,\n \"pix\": false,\n \"code\": \"341\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fffa5360-b17b-4393-a7f6-0cc305934ac3", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "banks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "7fe2c301-91e0-449e-a0a3-23fb7b45f95e", "name": "Beneficiários", "description": { "content": "Contatos salvos. O nome vem sempre do DICT, nunca do que foi digitado.", "type": "text/plain" }, "item": [ { "id": "e8a441b9-2897-4485-a713-8d69b554160c", "name": "Contatos salvos", "request": { "name": "Contatos salvos", "description": {}, "url": { "path": [ "v1", "beneficiaries" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "77fe0ee8-b113-4986-a14d-1ac052d96093", "name": "Beneficiários", "originalRequest": { "url": { "path": [ "v1", "beneficiaries" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"items\": [\n {\n \"id\": \"cupidatat laborum quis\",\n \"kind\": \"bank_account\",\n \"name\": \"dolore sit aliquip\",\n \"document\": \"voluptate ad\",\n \"bank\": \"in ut\",\n \"pixKey\": \"amet voluptate\",\n \"masked\": \"amet in\",\n \"bankAccount\": {\n \"ispb\": \"18236120\",\n \"branch\": \"0001\",\n \"accountMasked\": \"••••••977\",\n \"accountType\": \"SAVINGS\",\n \"holderName\": \"ea dolor\"\n }\n },\n {\n \"id\": \"enim anim\",\n \"kind\": \"pix_key\",\n \"name\": \"ei\",\n \"document\": \"sit est\",\n \"bank\": \"ame\",\n \"pixKey\": \"occaecat in labore Excepteur\",\n \"masked\": \"in mollit elit\",\n \"bankAccount\": {\n \"ispb\": \"18236120\",\n \"branch\": \"0001\",\n \"accountMasked\": \"••••••977\",\n \"accountType\": \"PAYMENT\",\n \"holderName\": \"elit proident\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0eff4cb2-8146-4a7e-9f54-809e30280882", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "beneficiaries" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "61455be0-5573-4f56-b67c-c95b203c84e9", "name": "Salva um contato", "request": { "name": "Salva um contato", "description": { "content": "Por chave (`key`): o nome vem do DICT, nunca do que foi digitado.\n`alias` é prefixado ao nome real, e não o substitui: deixar o apelido\nsubstituir o titular é como um golpista faz \"Maria\" aparecer no lugar\nde uma conta que não é dela.\n\nPor conta bancária (`bankAccount`, para o Pix por agência e conta e a\nTED; exige `pix_manual` ou `ted` ligada): não há DICT, então o nome e o\ndocumento são os digitados e **não são confirmados** pelo banco de\ndestino. Único por conta, banco, agência e conta (`409` no repetido).\nExatamente um entre `key` e `bankAccount`.\n", "type": "text/plain" }, "url": { "path": [ "v1", "beneficiaries" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"key\": \"eurico.b@email.com.br\",\n \"bankAccount\": {\n \"ispb\": \"18236120\",\n \"branch\": \"0001\",\n \"account\": \"919261977\",\n \"accountType\": \"SAVINGS\",\n \"holderName\": \"amet commodo sit\",\n \"holderDocument\": \"proident\"\n },\n \"alias\": \"Fornecedor de tecidos\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "47481db0-6006-4d0f-a413-23baf6112f59", "name": "Salvo. Por chave, a resposta da criação não traz `document` -\nconsulte a lista para obtê-lo. Por conta bancária, traz o item como\na lista o mostra (documento e conta mascarados).\n", "originalRequest": { "url": { "path": [ "v1", "beneficiaries" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"key\": \"eurico.b@email.com.br\",\n \"bankAccount\": {\n \"ispb\": \"18236120\",\n \"branch\": \"0001\",\n \"account\": \"919261977\",\n \"accountType\": \"SAVINGS\",\n \"holderName\": \"amet commodo sit\",\n \"holderDocument\": \"proident\"\n },\n \"alias\": \"Fornecedor de tecidos\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"cillum\",\n \"kind\": \"bank_account\",\n \"name\": \"in id\",\n \"document\": \"irure et\",\n \"bank\": \"pariatur dolor minim nostrud do\",\n \"pixKey\": \"esse oc\",\n \"masked\": \"commodo D\",\n \"bankAccount\": {\n \"ispb\": \"18236120\",\n \"branch\": \"0001\",\n \"accountMasked\": \"••••••977\",\n \"accountType\": \"SALARY\",\n \"holderName\": \"occaecat Duis Excepteur proident\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ad8636c0-301f-4205-b1e2-2f936b38960e", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "beneficiaries" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"key\": \"eurico.b@email.com.br\",\n \"bankAccount\": {\n \"ispb\": \"18236120\",\n \"branch\": \"0001\",\n \"account\": \"919261977\",\n \"accountType\": \"SAVINGS\",\n \"holderName\": \"amet commodo sit\",\n \"holderDocument\": \"proident\"\n },\n \"alias\": \"Fornecedor de tecidos\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "553676f3-3b46-4386-b71c-338daccb13f6", "name": "Conta bloqueada, ou favorecido por conta bancária sem `pix_manual`\nnem `ted` ligada (`FEATURE_DISABLED`).\n", "originalRequest": { "url": { "path": [ "v1", "beneficiaries" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"key\": \"eurico.b@email.com.br\",\n \"bankAccount\": {\n \"ispb\": \"18236120\",\n \"branch\": \"0001\",\n \"account\": \"919261977\",\n \"accountType\": \"SAVINGS\",\n \"holderName\": \"amet commodo sit\",\n \"holderDocument\": \"proident\"\n },\n \"alias\": \"Fornecedor de tecidos\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f16b7032-94af-4194-a4dc-ae62c7167d0e", "name": "Favorecido repetido.", "originalRequest": { "url": { "path": [ "v1", "beneficiaries" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"key\": \"eurico.b@email.com.br\",\n \"bankAccount\": {\n \"ispb\": \"18236120\",\n \"branch\": \"0001\",\n \"account\": \"919261977\",\n \"accountType\": \"SAVINGS\",\n \"holderName\": \"amet commodo sit\",\n \"holderDocument\": \"proident\"\n },\n \"alias\": \"Fornecedor de tecidos\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9efb5d91-1246-4447-8c0e-2254000abda9", "name": "Requisição malformada ou com dado inválido", "originalRequest": { "url": { "path": [ "v1", "beneficiaries" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"key\": \"eurico.b@email.com.br\",\n \"bankAccount\": {\n \"ispb\": \"18236120\",\n \"branch\": \"0001\",\n \"account\": \"919261977\",\n \"accountType\": \"SAVINGS\",\n \"holderName\": \"amet commodo sit\",\n \"holderDocument\": \"proident\"\n },\n \"alias\": \"Fornecedor de tecidos\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "90a1e7f0-42fb-4ea3-89f3-a8c98f1e2d52", "name": "Limite de consultas de chave da conta atingido (`RATE_LIMITED`,\no mesmo de `GET /v1/pix/lookup`); `Retry-After` diz quanto esperar.\n", "originalRequest": { "url": { "path": [ "v1", "beneficiaries" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"key\": \"eurico.b@email.com.br\",\n \"bankAccount\": {\n \"ispb\": \"18236120\",\n \"branch\": \"0001\",\n \"account\": \"919261977\",\n \"accountType\": \"SAVINGS\",\n \"holderName\": \"amet commodo sit\",\n \"holderDocument\": \"proident\"\n },\n \"alias\": \"Fornecedor de tecidos\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "61da47f8-1865-40aa-86ef-845c51716cd6", "name": "Remove um contato", "request": { "name": "Remove um contato", "description": {}, "url": { "path": [ "v1", "beneficiaries", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "4e6d80359f2c1a7b", "key": "id", "description": "(Required) " } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "auth": null }, "response": [ { "id": "0f69f569-3a8c-470c-844a-84e7b5fa283b", "name": "Removido", "originalRequest": { "url": { "path": [ "v1", "beneficiaries", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "4e6d80359f2c1a7b", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "9c59e2e8-03fe-4318-839a-ccf513582d24", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "beneficiaries", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "4e6d80359f2c1a7b", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0c104516-d5ea-40d0-9c46-0a91f110087f", "name": "Registro não encontrado", "originalRequest": { "url": { "path": [ "v1", "beneficiaries", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "4e6d80359f2c1a7b", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "e0119438-1e65-4800-92c5-e84c07c8184e", "name": "Cobrança", "description": { "content": "O boleto que o cliente **emite** para receber de alguem - o inverso do\npagamento de um titulo de terceiro.\n\nDuas coisas mudam em relacao a tudo o mais nesta API. A primeira e que\nemitir **nao move saldo**: o titulo e uma promessa de recebimento, nao um\nlancamento, e nada aparece no extrato ate que alguem pague. A segunda e\nque o credito nasce de um evento vindo de fora - a liquidacao -, e por\nisso chega como `BILLING_RECEIVED` no extrato, com o identificador que o\nboleto passa a apontar em `transactionId`.\n\nEntre a emissao e a liquidacao o titulo vive em `REGISTERING` ou\n`REGISTERED`. A diferenca importa: **um titulo em `REGISTERING` ainda nao\ne pagavel** e nao tem linha digitavel - entrega-la ao pagador nessa altura\ne entregar um numero que o caixa recusa.\n\nA cobranca por boleto e **so de sessao**: uma chave de API, com qualquer\nescopo, recebe `403 FORBIDDEN` nestas rotas.\n", "type": "text/plain" }, "item": [ { "id": "9a5f7634-3ea7-44fc-b5fc-3ac8a9ef89d4", "name": "Cobranças emitidas", "request": { "name": "Cobranças emitidas", "description": { "content": "As cobranças desta conta, da mais recente para a mais antiga.\n\n`available: false` significa que o provedor financeiro desta instalação\nnão registra cobrança — há BaaS que paga boleto de terceiro e não emite\nnenhum. A resposta é `200` com a lista vazia, e não um erro: a tela\nprecisa dizer \"esta conta ainda não emite boleto\" em vez de parecer que\no serviço caiu.\n", "type": "text/plain" }, "url": { "path": [ "v1", "billets" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": true, "key": "status", "value": "REGISTERING,REGISTERED", "description": "Uma ou mais situações, separadas por vírgula. É o filtro que separa\n\"a receber\" de \"recebidos\".\n" }, { "disabled": true, "key": "search", "value": "consequat", "description": "Casa com nome ou documento do pagador, nosso número e descrição." }, { "disabled": true, "key": "limit", "value": "100" }, { "disabled": true, "key": "offset", "value": "0" } ], "variable": [] }, "header": [ { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "0305af0d-9f7f-4507-bf86-2343d277963a", "name": "Cobranças", "originalRequest": { "url": { "path": [ "v1", "billets" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "status", "value": "REGISTERING,REGISTERED" }, { "key": "search", "value": "consequat" }, { "key": "limit", "value": "100" }, { "key": "offset", "value": "0" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"items\": [\n {\n \"id\": \"adipisicing do\",\n \"status\": \"FAILED\",\n \"amountCents\": -93094415,\n \"dueDate\": \"2026-10-20\",\n \"limitDate\": \"1980-11-17\",\n \"payer\": {\n \"name\": {\n \"value\": \"\"\n },\n \"document\": {\n \"value\": \"\"\n },\n \"email\": {\n \"value\": \"\"\n }\n },\n \"description\": \"culpa \",\n \"instructions\": \"reprehenderit amet cupidatat et eu\",\n \"fees\": {\n \"fineBasisPoints\": {\n \"value\": \"\"\n },\n \"interestMonthlyBasisPoints\": {\n \"value\": \"\"\n },\n \"discountCents\": {\n \"value\": \"\"\n },\n \"discountUntil\": {\n \"value\": \"\"\n },\n \"discounts\": {\n \"value\": \"\"\n },\n \"deductionCents\": {\n \"value\": \"\"\n }\n },\n \"paymentType\": \"TOTAL\",\n \"minAmountCents\": 82320659,\n \"maxAmountCents\": -16263475,\n \"maxPayments\": 986,\n \"kind\": \"DEPOSIT_CONTRIBUTION\",\n \"finalBeneficiary\": {\n \"name\": {\n \"value\": \"\"\n },\n \"document\": {\n \"value\": \"\"\n }\n },\n \"ourNumber\": \"laborum\",\n \"barcode\": \"velit tempor esse in\",\n \"digitableLine\": \"id do\",\n \"formattedLine\": \"veniam ipsum ea\",\n \"pixPayload\": \"Lorem sint dolor labore\",\n \"url\": \"consectetur culpa velit\",\n \"paidAmountCents\": -30218057,\n \"paidAt\": \"2006-04-07T07:43:49.775Z\",\n \"transactionId\": \"do tempor sunt magna\",\n \"compensatedAt\": \"1989-12-16T00:50:40.367Z\",\n \"settlements\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"failureReason\": \"tempor consectetur\",\n \"createdAt\": \"1985-04-17T15:01:55.296Z\",\n \"canceledAt\": \"1983-02-07T19:17:09.689Z\"\n },\n {\n \"id\": \"ea deserunt labore reprehen\",\n \"status\": \"REGISTERED\",\n \"amountCents\": -30355622,\n \"dueDate\": \"2026-10-20\",\n \"limitDate\": \"2012-02-01\",\n \"payer\": {\n \"name\": {\n \"value\": \"\"\n },\n \"document\": {\n \"value\": \"\"\n },\n \"email\": {\n \"value\": \"\"\n }\n },\n \"description\": \"nisi\",\n \"instructions\": \"elit velit\",\n \"fees\": {\n \"fineBasisPoints\": {\n \"value\": \"\"\n },\n \"interestMonthlyBasisPoints\": {\n \"value\": \"\"\n },\n \"discountCents\": {\n \"value\": \"\"\n },\n \"discountUntil\": {\n \"value\": \"\"\n },\n \"discounts\": {\n \"value\": \"\"\n },\n \"deductionCents\": {\n \"value\": \"\"\n }\n },\n \"paymentType\": \"TOTAL\",\n \"minAmountCents\": -75246581,\n \"maxAmountCents\": -54637616,\n \"maxPayments\": 298,\n \"kind\": \"SERVICE_DUPLICATE\",\n \"finalBeneficiary\": {\n \"name\": {\n \"value\": \"\"\n },\n \"document\": {\n \"value\": \"\"\n }\n },\n \"ourNumber\": \"aliqua Excepteur proident m\",\n \"barcode\": \"mollit velit consequ\",\n \"digitableLine\": \"ipsum Ut Excepteur\",\n \"formattedLine\": \"sint\",\n \"pixPayload\": \"pa\",\n \"url\": \"adipisicing\",\n \"paidAmountCents\": -67913169,\n \"paidAt\": \"1951-08-29T10:52:50.087Z\",\n \"transactionId\": \"quis aliqua nostrud esse eu\",\n \"compensatedAt\": \"1951-02-26T01:18:24.921Z\",\n \"settlements\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"failureReason\": \"amet sit pariatur laborum\",\n \"createdAt\": \"2026-01-17T01:06:46.790Z\",\n \"canceledAt\": \"1984-12-10T00:26:00.661Z\"\n }\n ],\n \"available\": false\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cb681861-b51f-4668-8a6c-500a92b844f7", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "billets" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "status", "value": "REGISTERING,REGISTERED" }, { "key": "search", "value": "consequat" }, { "key": "limit", "value": "100" }, { "key": "offset", "value": "0" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "76a3e6df-42b7-44ff-b21f-7bf164843e41", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "billets" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "status", "value": "REGISTERING,REGISTERED" }, { "key": "search", "value": "consequat" }, { "key": "limit", "value": "100" }, { "key": "offset", "value": "0" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "67330694-ff44-4930-9d65-cc33ea303a5a", "name": "Emite um boleto", "request": { "name": "Emite um boleto", "description": { "content": "Registra o título no arranjo e o devolve pronto para ser entregue ao\npagador.\n\n**A ordem é o arranjo primeiro.** Se o registro for recusado, nada é\ngravado para o cliente: um boleto que existe aqui e não lá é um número\nque o cliente imprime e nenhum caixa do país aceita. (O servidor guarda,\nantes de chamar o arranjo, só a intenção do pedido — a chave, o\nidentificador mandado ao arranjo e um hash —, que não aparece em\nnenhuma rota.)\n\n**`Idempotency-Key` é obrigatório.** Sem ele a chamada responde `400`.\nNão é burocracia: uma resposta perdida no caminho, sem a chave, vira\ndois títulos registrados para a mesma cobrança — e o pagador recebe duas\ncobranças, das quais pode pagar as duas. Repetir o mesmo pedido com a\nmesma chave, inclusive depois de um `503`, devolve o mesmo título; a\nmesma chave com outro pedido é `409` (`IDEMPOTENCY_KEY_REUSED`), mesmo\ndepois de um `5xx`. Enquanto a tentativa anterior ainda pode estar no\narranjo, a repetição é `409` (`IDEMPOTENCY_IN_FLIGHT`): espere e repita\ncom a mesma chave.\n\n**Linha digitável, código de barras, `pixPayload` e PDF só com\n`status` = `REGISTERED`.** O título em `REGISTERING` ainda pode ser\nrecusado pelo arranjo, e volta sem eles.\n\n`payer` não é opcional. A cobrança registrada não aceita título anônimo:\nsem nome e documento o arranjo recusa o registro, e é o CPF ou CNPJ do\npagador que permite ao banco dele exibir o boleto na conta.\n\nOs encargos são conferidos contra os tetos do Código de Defesa do\nConsumidor — 2% de multa e 1% de juros ao mês. O arranjo **não** recusa\num boleto acima disso: ele registra, cobra do pagador, e a devolução\nvolta meses depois contra quem emitiu.\n", "type": "text/plain" }, "url": { "path": [ "v1", "billets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"amountCents\": 125000,\n \"dueDate\": \"2026-10-20\",\n \"payer\": {\n \"name\": \"Construtora Vale Verde LTDA\",\n \"document\": \"11.222.333/0001-81\",\n \"email\": \"ad in nulla\",\n \"address\": {\n \"street\": \"laboris esse incididunt dolor in\",\n \"number\": \"occaecat adipisicing minim\",\n \"complement\": \"et nisi culpa\",\n \"district\": \"pariatur incididunt qui\",\n \"city\": \"minim occaecat veniam nostrud\",\n \"state\": \"Duis in\",\n \"zip\": \"id aliq\"\n }\n },\n \"limitDate\": \"1965-02-09\",\n \"description\": \"incididunt consectetur exercitation\",\n \"instructions\": \"v\",\n \"fees\": {\n \"fineBasisPoints\": -61473413,\n \"interestMonthlyBasisPoints\": -34150277,\n \"discountCents\": -72135320,\n \"discountUntil\": \"1955-09-09\",\n \"discounts\": [\n {\n \"type\": {\n \"value\": \"\"\n },\n \"amountCents\": {\n \"value\": \"\"\n },\n \"basisPoints\": {\n \"value\": \"\"\n },\n \"until\": {\n \"value\": \"\"\n }\n },\n {\n \"type\": {\n \"value\": \"\"\n },\n \"amountCents\": {\n \"value\": \"\"\n },\n \"basisPoints\": {\n \"value\": \"\"\n },\n \"until\": {\n \"value\": \"\"\n }\n }\n ],\n \"deductionCents\": 49804600\n },\n \"pixEnabled\": true,\n \"paymentType\": \"TOTAL\",\n \"minAmountCents\": -77161975,\n \"maxAmountCents\": -15920400,\n \"maxPayments\": 110,\n \"kind\": \"SERVICE_DUPLICATE\",\n \"finalBeneficiary\": {\n \"name\": \"officia amet\",\n \"document\": \"veniam tempor cupidatat eiusmod\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "2aba11c2-164b-44b2-bfb1-b5be8c68891b", "name": "Registrado. `201`, e não `202`: o título existe e — quando o\nregistro confirmou na hora — já é pagável. Confira `status` antes de\nentregar `digitableLine` a alguém.\n", "originalRequest": { "url": { "path": [ "v1", "billets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 125000,\n \"dueDate\": \"2026-10-20\",\n \"payer\": {\n \"name\": \"Construtora Vale Verde LTDA\",\n \"document\": \"11.222.333/0001-81\",\n \"email\": \"ad in nulla\",\n \"address\": {\n \"street\": \"laboris esse incididunt dolor in\",\n \"number\": \"occaecat adipisicing minim\",\n \"complement\": \"et nisi culpa\",\n \"district\": \"pariatur incididunt qui\",\n \"city\": \"minim occaecat veniam nostrud\",\n \"state\": \"Duis in\",\n \"zip\": \"id aliq\"\n }\n },\n \"limitDate\": \"1965-02-09\",\n \"description\": \"incididunt consectetur exercitation\",\n \"instructions\": \"v\",\n \"fees\": {\n \"fineBasisPoints\": -61473413,\n \"interestMonthlyBasisPoints\": -34150277,\n \"discountCents\": -72135320,\n \"discountUntil\": \"1955-09-09\",\n \"discounts\": [\n {\n \"type\": {\n \"value\": \"\"\n },\n \"amountCents\": {\n \"value\": \"\"\n },\n \"basisPoints\": {\n \"value\": \"\"\n },\n \"until\": {\n \"value\": \"\"\n }\n },\n {\n \"type\": {\n \"value\": \"\"\n },\n \"amountCents\": {\n \"value\": \"\"\n },\n \"basisPoints\": {\n \"value\": \"\"\n },\n \"until\": {\n \"value\": \"\"\n }\n }\n ],\n \"deductionCents\": 49804600\n },\n \"pixEnabled\": true,\n \"paymentType\": \"TOTAL\",\n \"minAmountCents\": -77161975,\n \"maxAmountCents\": -15920400,\n \"maxPayments\": 110,\n \"kind\": \"SERVICE_DUPLICATE\",\n \"finalBeneficiary\": {\n \"name\": \"officia amet\",\n \"document\": \"veniam tempor cupidatat eiusmod\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"quis ullamco eu minim dolore\",\n \"status\": \"EXPIRED\",\n \"amountCents\": -86063212,\n \"dueDate\": \"2026-10-20\",\n \"limitDate\": \"1987-09-14\",\n \"payer\": {\n \"name\": \"incididunt ut\",\n \"document\": \"sit consecte\",\n \"email\": \"tempor ullamco aliqua fugiat ut\"\n },\n \"description\": \"in Ut occaecat\",\n \"instructions\": \"non consectetur\",\n \"fees\": {\n \"fineBasisPoints\": -92716629,\n \"interestMonthlyBasisPoints\": -3358421,\n \"discountCents\": -60122138,\n \"discountUntil\": \"1948-10-11\",\n \"discounts\": [\n {\n \"type\": {\n \"value\": \"\"\n },\n \"amountCents\": {\n \"value\": \"\"\n },\n \"basisPoints\": {\n \"value\": \"\"\n },\n \"until\": {\n \"value\": \"\"\n }\n },\n {\n \"type\": {\n \"value\": \"\"\n },\n \"amountCents\": {\n \"value\": \"\"\n },\n \"basisPoints\": {\n \"value\": \"\"\n },\n \"until\": {\n \"value\": \"\"\n }\n }\n ],\n \"deductionCents\": -86450886\n },\n \"paymentType\": \"TOTAL\",\n \"minAmountCents\": -84165279,\n \"maxAmountCents\": -75397693,\n \"maxPayments\": 868,\n \"kind\": \"OTHER\",\n \"finalBeneficiary\": {\n \"name\": \"ullamco Duis deserunt\",\n \"document\": \"proident esse Lorem irure Ut\"\n },\n \"ourNumber\": \"voluptate Lorem\",\n \"barcode\": \"officia aute nisi\",\n \"digitableLine\": \"tempor\",\n \"formattedLine\": \"magna\",\n \"pixPayload\": \"in commodo\",\n \"url\": \"\",\n \"paidAmountCents\": -31871791,\n \"paidAt\": \"2024-04-19T08:48:16.718Z\",\n \"transactionId\": \"sunt officia commodo au\",\n \"compensatedAt\": \"1949-03-30T13:31:48.136Z\",\n \"settlements\": [\n {\n \"amountCents\": -75750722,\n \"at\": \"1990-04-17T08:12:47.788Z\",\n \"transactionId\": \"in fugiat\"\n },\n {\n \"amountCents\": -20959159,\n \"at\": \"1980-05-21T23:27:40.325Z\",\n \"transactionId\": \"Duis adipisicing do et\"\n }\n ],\n \"failureReason\": \"amet dolore ut\",\n \"createdAt\": \"1981-03-24T04:22:33.960Z\",\n \"canceledAt\": \"2002-08-18T08:45:29.509Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "677cf018-e571-4535-a462-336c7fb5e92a", "name": "Falta o cabeçalho `Idempotency-Key`", "originalRequest": { "url": { "path": [ "v1", "billets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 125000,\n \"dueDate\": \"2026-10-20\",\n \"payer\": {\n \"name\": \"Construtora Vale Verde LTDA\",\n \"document\": \"11.222.333/0001-81\",\n \"email\": \"ad in nulla\",\n \"address\": {\n \"street\": \"laboris esse incididunt dolor in\",\n \"number\": \"occaecat adipisicing minim\",\n \"complement\": \"et nisi culpa\",\n \"district\": \"pariatur incididunt qui\",\n \"city\": \"minim occaecat veniam nostrud\",\n \"state\": \"Duis in\",\n \"zip\": \"id aliq\"\n }\n },\n \"limitDate\": \"1965-02-09\",\n \"description\": \"incididunt consectetur exercitation\",\n \"instructions\": \"v\",\n \"fees\": {\n \"fineBasisPoints\": -61473413,\n \"interestMonthlyBasisPoints\": -34150277,\n \"discountCents\": -72135320,\n \"discountUntil\": \"1955-09-09\",\n \"discounts\": [\n {\n \"type\": {\n \"value\": \"\"\n },\n \"amountCents\": {\n \"value\": \"\"\n },\n \"basisPoints\": {\n \"value\": \"\"\n },\n \"until\": {\n \"value\": \"\"\n }\n },\n {\n \"type\": {\n \"value\": \"\"\n },\n \"amountCents\": {\n \"value\": \"\"\n },\n \"basisPoints\": {\n \"value\": \"\"\n },\n \"until\": {\n \"value\": \"\"\n }\n }\n ],\n \"deductionCents\": 49804600\n },\n \"pixEnabled\": true,\n \"paymentType\": \"TOTAL\",\n \"minAmountCents\": -77161975,\n \"maxAmountCents\": -15920400,\n \"maxPayments\": 110,\n \"kind\": \"SERVICE_DUPLICATE\",\n \"finalBeneficiary\": {\n \"name\": \"officia amet\",\n \"document\": \"veniam tempor cupidatat eiusmod\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "165fee57-e201-4f49-a9eb-311877e31a53", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "billets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 125000,\n \"dueDate\": \"2026-10-20\",\n \"payer\": {\n \"name\": \"Construtora Vale Verde LTDA\",\n \"document\": \"11.222.333/0001-81\",\n \"email\": \"ad in nulla\",\n \"address\": {\n \"street\": \"laboris esse incididunt dolor in\",\n \"number\": \"occaecat adipisicing minim\",\n \"complement\": \"et nisi culpa\",\n \"district\": \"pariatur incididunt qui\",\n \"city\": \"minim occaecat veniam nostrud\",\n \"state\": \"Duis in\",\n \"zip\": \"id aliq\"\n }\n },\n \"limitDate\": \"1965-02-09\",\n \"description\": \"incididunt consectetur exercitation\",\n \"instructions\": \"v\",\n \"fees\": {\n \"fineBasisPoints\": -61473413,\n \"interestMonthlyBasisPoints\": -34150277,\n \"discountCents\": -72135320,\n \"discountUntil\": \"1955-09-09\",\n \"discounts\": [\n {\n \"type\": {\n \"value\": \"\"\n },\n \"amountCents\": {\n \"value\": \"\"\n },\n \"basisPoints\": {\n \"value\": \"\"\n },\n \"until\": {\n \"value\": \"\"\n }\n },\n {\n \"type\": {\n \"value\": \"\"\n },\n \"amountCents\": {\n \"value\": \"\"\n },\n \"basisPoints\": {\n \"value\": \"\"\n },\n \"until\": {\n \"value\": \"\"\n }\n }\n ],\n \"deductionCents\": 49804600\n },\n \"pixEnabled\": true,\n \"paymentType\": \"TOTAL\",\n \"minAmountCents\": -77161975,\n \"maxAmountCents\": -15920400,\n \"maxPayments\": 110,\n \"kind\": \"SERVICE_DUPLICATE\",\n \"finalBeneficiary\": {\n \"name\": \"officia amet\",\n \"document\": \"veniam tempor cupidatat eiusmod\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3d2f2ea0-9572-4ddf-aec9-ee0c0037cc61", "name": "Conta bloqueada. Emitir cobrança é direcionar entrada de dinheiro.", "originalRequest": { "url": { "path": [ "v1", "billets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 125000,\n \"dueDate\": \"2026-10-20\",\n \"payer\": {\n \"name\": \"Construtora Vale Verde LTDA\",\n \"document\": \"11.222.333/0001-81\",\n \"email\": \"ad in nulla\",\n \"address\": {\n \"street\": \"laboris esse incididunt dolor in\",\n \"number\": \"occaecat adipisicing minim\",\n \"complement\": \"et nisi culpa\",\n \"district\": \"pariatur incididunt qui\",\n \"city\": \"minim occaecat veniam nostrud\",\n \"state\": \"Duis in\",\n \"zip\": \"id aliq\"\n }\n },\n \"limitDate\": \"1965-02-09\",\n \"description\": \"incididunt consectetur exercitation\",\n \"instructions\": \"v\",\n \"fees\": {\n \"fineBasisPoints\": -61473413,\n \"interestMonthlyBasisPoints\": -34150277,\n \"discountCents\": -72135320,\n \"discountUntil\": \"1955-09-09\",\n \"discounts\": [\n {\n \"type\": {\n \"value\": \"\"\n },\n \"amountCents\": {\n \"value\": \"\"\n },\n \"basisPoints\": {\n \"value\": \"\"\n },\n \"until\": {\n \"value\": \"\"\n }\n },\n {\n \"type\": {\n \"value\": \"\"\n },\n \"amountCents\": {\n \"value\": \"\"\n },\n \"basisPoints\": {\n \"value\": \"\"\n },\n \"until\": {\n \"value\": \"\"\n }\n }\n ],\n \"deductionCents\": 49804600\n },\n \"pixEnabled\": true,\n \"paymentType\": \"TOTAL\",\n \"minAmountCents\": -77161975,\n \"maxAmountCents\": -15920400,\n \"maxPayments\": 110,\n \"kind\": \"SERVICE_DUPLICATE\",\n \"finalBeneficiary\": {\n \"name\": \"officia amet\",\n \"document\": \"veniam tempor cupidatat eiusmod\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "5b858c7e-f4ba-41d1-8e85-45317c8d69a5", "name": "A chave de idempotência já foi usada com outro pedido\n(`IDEMPOTENCY_KEY_REUSED`), ou a tentativa anterior ainda pode estar\nno arranjo (`IDEMPOTENCY_IN_FLIGHT`; espere e repita com a mesma\nchave). Quando o banco já conhece o pedido e o título pode existir,\na tentativa fica aguardando conferência da equipe: a resposta é a\nmesma, e repetir não a resolve até a equipe concluir. Emitir com\noutra chave pode registrar um segundo boleto.\n", "originalRequest": { "url": { "path": [ "v1", "billets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 125000,\n \"dueDate\": \"2026-10-20\",\n \"payer\": {\n \"name\": \"Construtora Vale Verde LTDA\",\n \"document\": \"11.222.333/0001-81\",\n \"email\": \"ad in nulla\",\n \"address\": {\n \"street\": \"laboris esse incididunt dolor in\",\n \"number\": \"occaecat adipisicing minim\",\n \"complement\": \"et nisi culpa\",\n \"district\": \"pariatur incididunt qui\",\n \"city\": \"minim occaecat veniam nostrud\",\n \"state\": \"Duis in\",\n \"zip\": \"id aliq\"\n }\n },\n \"limitDate\": \"1965-02-09\",\n \"description\": \"incididunt consectetur exercitation\",\n \"instructions\": \"v\",\n \"fees\": {\n \"fineBasisPoints\": -61473413,\n \"interestMonthlyBasisPoints\": -34150277,\n \"discountCents\": -72135320,\n \"discountUntil\": \"1955-09-09\",\n \"discounts\": [\n {\n \"type\": {\n \"value\": \"\"\n },\n \"amountCents\": {\n \"value\": \"\"\n },\n \"basisPoints\": {\n \"value\": \"\"\n },\n \"until\": {\n \"value\": \"\"\n }\n },\n {\n \"type\": {\n \"value\": \"\"\n },\n \"amountCents\": {\n \"value\": \"\"\n },\n \"basisPoints\": {\n \"value\": \"\"\n },\n \"until\": {\n \"value\": \"\"\n }\n }\n ],\n \"deductionCents\": 49804600\n },\n \"pixEnabled\": true,\n \"paymentType\": \"TOTAL\",\n \"minAmountCents\": -77161975,\n \"maxAmountCents\": -15920400,\n \"maxPayments\": 110,\n \"kind\": \"SERVICE_DUPLICATE\",\n \"finalBeneficiary\": {\n \"name\": \"officia amet\",\n \"document\": \"veniam tempor cupidatat eiusmod\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d331d3cb-e0a9-45f0-b65e-62f4806457df", "name": "Pedido que o Lume ou o provedor desta instalação não aceita, com a\nmensagem que diz o que corrigir: desconto, abatimento, pagamento\nparcial, prazo de aceitação acima de 90 dias depois do vencimento,\nnome com mais de 50 caracteres, endereço do pagador incompleto.\n`LIMIT_EXCEEDED` também quando a conta atingiu o teto diário de\nemissão (quantidade de boletos, valor somado ou pagadores\ndistintos no dia): a mensagem diz qual, e a recusa não chama o\narranjo. Como toda resposta, ela fica com a chave: no dia\nseguinte, emita com outra. Repetir um pedido já emitido, com a\nmesma chave, continua devolvendo o título.\nTambém `PROVIDER_ERROR` quando a equipe confirmou que o boleto\ndeste pedido não foi emitido: emita de novo com outra chave.\n", "originalRequest": { "url": { "path": [ "v1", "billets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 125000,\n \"dueDate\": \"2026-10-20\",\n \"payer\": {\n \"name\": \"Construtora Vale Verde LTDA\",\n \"document\": \"11.222.333/0001-81\",\n \"email\": \"ad in nulla\",\n \"address\": {\n \"street\": \"laboris esse incididunt dolor in\",\n \"number\": \"occaecat adipisicing minim\",\n \"complement\": \"et nisi culpa\",\n \"district\": \"pariatur incididunt qui\",\n \"city\": \"minim occaecat veniam nostrud\",\n \"state\": \"Duis in\",\n \"zip\": \"id aliq\"\n }\n },\n \"limitDate\": \"1965-02-09\",\n \"description\": \"incididunt consectetur exercitation\",\n \"instructions\": \"v\",\n \"fees\": {\n \"fineBasisPoints\": -61473413,\n \"interestMonthlyBasisPoints\": -34150277,\n \"discountCents\": -72135320,\n \"discountUntil\": \"1955-09-09\",\n \"discounts\": [\n {\n \"type\": {\n \"value\": \"\"\n },\n \"amountCents\": {\n \"value\": \"\"\n },\n \"basisPoints\": {\n \"value\": \"\"\n },\n \"until\": {\n \"value\": \"\"\n }\n },\n {\n \"type\": {\n \"value\": \"\"\n },\n \"amountCents\": {\n \"value\": \"\"\n },\n \"basisPoints\": {\n \"value\": \"\"\n },\n \"until\": {\n \"value\": \"\"\n }\n }\n ],\n \"deductionCents\": 49804600\n },\n \"pixEnabled\": true,\n \"paymentType\": \"TOTAL\",\n \"minAmountCents\": -77161975,\n \"maxAmountCents\": -15920400,\n \"maxPayments\": 110,\n \"kind\": \"SERVICE_DUPLICATE\",\n \"finalBeneficiary\": {\n \"name\": \"officia amet\",\n \"document\": \"veniam tempor cupidatat eiusmod\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "34691c98-6380-4f70-8f54-a27317b6754e", "name": "O provedor desta instalação não registra cobrança.", "originalRequest": { "url": { "path": [ "v1", "billets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 125000,\n \"dueDate\": \"2026-10-20\",\n \"payer\": {\n \"name\": \"Construtora Vale Verde LTDA\",\n \"document\": \"11.222.333/0001-81\",\n \"email\": \"ad in nulla\",\n \"address\": {\n \"street\": \"laboris esse incididunt dolor in\",\n \"number\": \"occaecat adipisicing minim\",\n \"complement\": \"et nisi culpa\",\n \"district\": \"pariatur incididunt qui\",\n \"city\": \"minim occaecat veniam nostrud\",\n \"state\": \"Duis in\",\n \"zip\": \"id aliq\"\n }\n },\n \"limitDate\": \"1965-02-09\",\n \"description\": \"incididunt consectetur exercitation\",\n \"instructions\": \"v\",\n \"fees\": {\n \"fineBasisPoints\": -61473413,\n \"interestMonthlyBasisPoints\": -34150277,\n \"discountCents\": -72135320,\n \"discountUntil\": \"1955-09-09\",\n \"discounts\": [\n {\n \"type\": {\n \"value\": \"\"\n },\n \"amountCents\": {\n \"value\": \"\"\n },\n \"basisPoints\": {\n \"value\": \"\"\n },\n \"until\": {\n \"value\": \"\"\n }\n },\n {\n \"type\": {\n \"value\": \"\"\n },\n \"amountCents\": {\n \"value\": \"\"\n },\n \"basisPoints\": {\n \"value\": \"\"\n },\n \"until\": {\n \"value\": \"\"\n }\n }\n ],\n \"deductionCents\": 49804600\n },\n \"pixEnabled\": true,\n \"paymentType\": \"TOTAL\",\n \"minAmountCents\": -77161975,\n \"maxAmountCents\": -15920400,\n \"maxPayments\": 110,\n \"kind\": \"SERVICE_DUPLICATE\",\n \"finalBeneficiary\": {\n \"name\": \"officia amet\",\n \"document\": \"veniam tempor cupidatat eiusmod\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Implemented", "code": 501, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "42ef03dd-5732-4831-96ac-3b7772a6fe96", "name": "O arranjo de pagamento está indisponível. Tente novamente.", "originalRequest": { "url": { "path": [ "v1", "billets" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 125000,\n \"dueDate\": \"2026-10-20\",\n \"payer\": {\n \"name\": \"Construtora Vale Verde LTDA\",\n \"document\": \"11.222.333/0001-81\",\n \"email\": \"ad in nulla\",\n \"address\": {\n \"street\": \"laboris esse incididunt dolor in\",\n \"number\": \"occaecat adipisicing minim\",\n \"complement\": \"et nisi culpa\",\n \"district\": \"pariatur incididunt qui\",\n \"city\": \"minim occaecat veniam nostrud\",\n \"state\": \"Duis in\",\n \"zip\": \"id aliq\"\n }\n },\n \"limitDate\": \"1965-02-09\",\n \"description\": \"incididunt consectetur exercitation\",\n \"instructions\": \"v\",\n \"fees\": {\n \"fineBasisPoints\": -61473413,\n \"interestMonthlyBasisPoints\": -34150277,\n \"discountCents\": -72135320,\n \"discountUntil\": \"1955-09-09\",\n \"discounts\": [\n {\n \"type\": {\n \"value\": \"\"\n },\n \"amountCents\": {\n \"value\": \"\"\n },\n \"basisPoints\": {\n \"value\": \"\"\n },\n \"until\": {\n \"value\": \"\"\n }\n },\n {\n \"type\": {\n \"value\": \"\"\n },\n \"amountCents\": {\n \"value\": \"\"\n },\n \"basisPoints\": {\n \"value\": \"\"\n },\n \"until\": {\n \"value\": \"\"\n }\n }\n ],\n \"deductionCents\": 49804600\n },\n \"pixEnabled\": true,\n \"paymentType\": \"TOTAL\",\n \"minAmountCents\": -77161975,\n \"maxAmountCents\": -15920400,\n \"maxPayments\": 110,\n \"kind\": \"SERVICE_DUPLICATE\",\n \"finalBeneficiary\": {\n \"name\": \"officia amet\",\n \"document\": \"veniam tempor cupidatat eiusmod\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "da9fecf9-f691-4b56-b052-490dbb33ab53", "name": "Uma cobrança", "request": { "name": "Uma cobrança", "description": {}, "url": { "path": [ "v1", "billets", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "9de8fdbd-9ec7-456a-b55b-1a64754aa8a7", "name": "Cobrança", "originalRequest": { "url": { "path": [ "v1", "billets", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"quis ullamco eu minim dolore\",\n \"status\": \"EXPIRED\",\n \"amountCents\": -86063212,\n \"dueDate\": \"2026-10-20\",\n \"limitDate\": \"1987-09-14\",\n \"payer\": {\n \"name\": \"incididunt ut\",\n \"document\": \"sit consecte\",\n \"email\": \"tempor ullamco aliqua fugiat ut\"\n },\n \"description\": \"in Ut occaecat\",\n \"instructions\": \"non consectetur\",\n \"fees\": {\n \"fineBasisPoints\": -92716629,\n \"interestMonthlyBasisPoints\": -3358421,\n \"discountCents\": -60122138,\n \"discountUntil\": \"1948-10-11\",\n \"discounts\": [\n {\n \"type\": {\n \"value\": \"\"\n },\n \"amountCents\": {\n \"value\": \"\"\n },\n \"basisPoints\": {\n \"value\": \"\"\n },\n \"until\": {\n \"value\": \"\"\n }\n },\n {\n \"type\": {\n \"value\": \"\"\n },\n \"amountCents\": {\n \"value\": \"\"\n },\n \"basisPoints\": {\n \"value\": \"\"\n },\n \"until\": {\n \"value\": \"\"\n }\n }\n ],\n \"deductionCents\": -86450886\n },\n \"paymentType\": \"TOTAL\",\n \"minAmountCents\": -84165279,\n \"maxAmountCents\": -75397693,\n \"maxPayments\": 868,\n \"kind\": \"OTHER\",\n \"finalBeneficiary\": {\n \"name\": \"ullamco Duis deserunt\",\n \"document\": \"proident esse Lorem irure Ut\"\n },\n \"ourNumber\": \"voluptate Lorem\",\n \"barcode\": \"officia aute nisi\",\n \"digitableLine\": \"tempor\",\n \"formattedLine\": \"magna\",\n \"pixPayload\": \"in commodo\",\n \"url\": \"\",\n \"paidAmountCents\": -31871791,\n \"paidAt\": \"2024-04-19T08:48:16.718Z\",\n \"transactionId\": \"sunt officia commodo au\",\n \"compensatedAt\": \"1949-03-30T13:31:48.136Z\",\n \"settlements\": [\n {\n \"amountCents\": -75750722,\n \"at\": \"1990-04-17T08:12:47.788Z\",\n \"transactionId\": \"in fugiat\"\n },\n {\n \"amountCents\": -20959159,\n \"at\": \"1980-05-21T23:27:40.325Z\",\n \"transactionId\": \"Duis adipisicing do et\"\n }\n ],\n \"failureReason\": \"amet dolore ut\",\n \"createdAt\": \"1981-03-24T04:22:33.960Z\",\n \"canceledAt\": \"2002-08-18T08:45:29.509Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "798963c3-c334-4496-87a5-a175c0bbbbc5", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "billets", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7b0ce2cb-3183-4f56-8b10-7f2bbb1400ab", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "billets", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e4e98716-aca5-4a45-a0d8-aeabdcf66d8c", "name": "Registro não encontrado", "originalRequest": { "url": { "path": [ "v1", "billets", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "df0eb58a-42f5-4771-9ffd-8936e973e365", "name": "Dá baixa numa cobrança", "request": { "name": "Dá baixa numa cobrança", "description": { "content": "Baixa o título no arranjo e depois aqui — nesta ordem, porque baixar só\ndo nosso lado deixaria lá um boleto pagável que a nossa tela diz não\nexistir, e o dinheiro entraria sem ter onde cair.\n\n`POST`, e não `DELETE`: o título **não é apagado**. Ele muda para\n`CANCELED` e continua consultável — um boleto que some da lista é um\nboleto que ninguém consegue explicar depois.\n\nO título vira `CANCELED` quando o arranjo aceita a baixa. Onde a baixa\né assíncrona (a confirmação na registradora vem depois), o servidor a\nacompanha em segundo plano; repetir a baixa de um título ainda aberto,\ndepois de uma falha, manda o mesmo pedido e é inofensivo.\n", "type": "text/plain" }, "url": { "path": [ "v1", "billets", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "f1dd15dd-65b3-47f5-a667-fec1ab3179d3", "name": "Baixado", "originalRequest": { "url": { "path": [ "v1", "billets", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"quis ullamco eu minim dolore\",\n \"status\": \"EXPIRED\",\n \"amountCents\": -86063212,\n \"dueDate\": \"2026-10-20\",\n \"limitDate\": \"1987-09-14\",\n \"payer\": {\n \"name\": \"incididunt ut\",\n \"document\": \"sit consecte\",\n \"email\": \"tempor ullamco aliqua fugiat ut\"\n },\n \"description\": \"in Ut occaecat\",\n \"instructions\": \"non consectetur\",\n \"fees\": {\n \"fineBasisPoints\": -92716629,\n \"interestMonthlyBasisPoints\": -3358421,\n \"discountCents\": -60122138,\n \"discountUntil\": \"1948-10-11\",\n \"discounts\": [\n {\n \"type\": {\n \"value\": \"\"\n },\n \"amountCents\": {\n \"value\": \"\"\n },\n \"basisPoints\": {\n \"value\": \"\"\n },\n \"until\": {\n \"value\": \"\"\n }\n },\n {\n \"type\": {\n \"value\": \"\"\n },\n \"amountCents\": {\n \"value\": \"\"\n },\n \"basisPoints\": {\n \"value\": \"\"\n },\n \"until\": {\n \"value\": \"\"\n }\n }\n ],\n \"deductionCents\": -86450886\n },\n \"paymentType\": \"TOTAL\",\n \"minAmountCents\": -84165279,\n \"maxAmountCents\": -75397693,\n \"maxPayments\": 868,\n \"kind\": \"OTHER\",\n \"finalBeneficiary\": {\n \"name\": \"ullamco Duis deserunt\",\n \"document\": \"proident esse Lorem irure Ut\"\n },\n \"ourNumber\": \"voluptate Lorem\",\n \"barcode\": \"officia aute nisi\",\n \"digitableLine\": \"tempor\",\n \"formattedLine\": \"magna\",\n \"pixPayload\": \"in commodo\",\n \"url\": \"\",\n \"paidAmountCents\": -31871791,\n \"paidAt\": \"2024-04-19T08:48:16.718Z\",\n \"transactionId\": \"sunt officia commodo au\",\n \"compensatedAt\": \"1949-03-30T13:31:48.136Z\",\n \"settlements\": [\n {\n \"amountCents\": -75750722,\n \"at\": \"1990-04-17T08:12:47.788Z\",\n \"transactionId\": \"in fugiat\"\n },\n {\n \"amountCents\": -20959159,\n \"at\": \"1980-05-21T23:27:40.325Z\",\n \"transactionId\": \"Duis adipisicing do et\"\n }\n ],\n \"failureReason\": \"amet dolore ut\",\n \"createdAt\": \"1981-03-24T04:22:33.960Z\",\n \"canceledAt\": \"2002-08-18T08:45:29.509Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "af28fc99-e07c-4787-bfb6-54252bcfb52e", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "billets", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1ee728da-13e8-44bb-b885-db369c3a2d66", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "billets", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1670b114-69f2-4cbe-a4ea-e508d32d9ee0", "name": "Registro não encontrado", "originalRequest": { "url": { "path": [ "v1", "billets", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2d0add80-3aea-409d-83f5-69190e9b4ac3", "name": "O título não aceita mais baixa — já foi pago, já foi baixado, ou\npassou do prazo de aceitação.\n", "originalRequest": { "url": { "path": [ "v1", "billets", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" } ], "method": "POST", "body": {} }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "2e776a3e-cf55-4624-aadc-2b8aee142397", "name": "O provedor desta instalação não registra cobrança.", "originalRequest": { "url": { "path": [ "v1", "billets", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" } ], "method": "POST", "body": {} }, "status": "Not Implemented", "code": 501, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "92bfc8aa-f7cb-4dcd-b169-15f7534f2943", "name": "O arranjo de pagamento está indisponível. Tente novamente.", "originalRequest": { "url": { "path": [ "v1", "billets", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "e69a01b5-c494-4111-a5d0-9c81017ef20f", "name": "Pagamento de contas", "description": { "content": "Pagar, com o saldo da conta, um boleto (ficha de compensação) ou uma conta\nde concessionária ou tributo (guia de arrecadação) de terceiro: o inverso da\ncobrança. Duas etapas, e a primeira só informa: a consulta diz quanto custa\npagar **agora**, e o pagamento a refaz antes de debitar.\n\nSó de sessão: uma chave de API recebe `403 FORBIDDEN` nestas rotas. O\npagamento sai no máximo uma vez, e o desfecho pode chegar depois da resposta\n(`PROCESSING`).\n", "type": "text/plain" }, "item": [ { "id": "81d4f19d-c5fd-4d66-b26c-fb4ba646e8e9", "name": "Consulta um boleto ou uma conta para pagar", "request": { "name": "Consulta um boleto ou uma conta para pagar", "description": { "content": "Diz quanto custa pagar este título **agora**, antes de o cliente confirmar:\na partir do vencimento o valor impresso e o valor a pagar deixam de ser a\nmesma coisa (multa, juros e desconto correm por dia).\n\nAceita a **ficha de compensação** (boleto, 47 dígitos na linha digitável\nou 44 no código de barras) e a **guia de arrecadação** (conta de\nconcessionária ou tributo, 48 dígitos na linha ou 44 no código, sempre\ncomeçando por `8`). Os dígitos verificadores de cada bloco são\nconferidos; linha com erro de digitação responde `422`.\n\nSó de sessão, como o resto do pagamento de contas. O identificador que o\nbanco parceiro dá à consulta **nunca** sai desta resposta: quem paga é\nsempre uma nova consulta feita no momento do pagamento.\n\nOs documentos de terceiros (`beneficiaryDocument`,\n`finalBeneficiary.document`) saem **mascarados**.\n", "type": "text/plain" }, "url": { "path": [ "v1", "billets", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"line\": \"con\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "48fe91b2-97a3-4e56-b0d5-238b9a77e6ef", "name": "O título como o banco o conhece agora.", "originalRequest": { "url": { "path": [ "v1", "billets", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"line\": \"con\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"beneficiary\": \"eiusmod ea sunt proident\",\n \"dueDate\": \"aliquip aliqua\",\n \"amountCents\": -5247171,\n \"fineCents\": -37387584,\n \"interestCents\": 37390175,\n \"discountCents\": -70357737,\n \"totalCents\": 29722713,\n \"kind\": \"UTILITY\",\n \"allowChangeValue\": false,\n \"beneficiaryDocument\": \"ex nostrud elit\",\n \"finalBeneficiary\": {\n \"name\": \"exercitation magna ut\",\n \"document\": \"sunt sed exercitation\"\n },\n \"minCents\": -94342285,\n \"maxCents\": 5851354,\n \"cutoff\": {\n \"start\": \"07:00\",\n \"end\": \"20:00\"\n },\n \"settleDate\": \"1958-05-06\",\n \"nextBusinessDay\": \"1976-10-12\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2d6042e1-58fd-48a5-bd47-6cc37b483562", "name": "O corpo é ilegível.", "originalRequest": { "url": { "path": [ "v1", "billets", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"line\": \"con\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2d96e97d-f554-4e17-908e-869da1bf1316", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "billets", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"line\": \"con\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d0a15bc8-f7ab-4d42-afb5-f0d6b9d59dee", "name": "Chave de API (esta rota é só de sessão), ou pagamento de contas\ndesligado nesta instalação (`FEATURE_DISABLED`).\n", "originalRequest": { "url": { "path": [ "v1", "billets", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"line\": \"con\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "98411ea2-1848-438d-bd92-af05b025f425", "name": "Linha digitável inválida ou com dígito verificador errado, título\nsem valor a pagar, ou recusa do banco parceiro com mensagem própria\n(por exemplo, \"hoje não é dia útil\").\n", "originalRequest": { "url": { "path": [ "v1", "billets", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"line\": \"con\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7338755b-6390-4f49-be3a-cbe0b66cd035", "name": "O arranjo de pagamento está indisponível. Tente novamente.", "originalRequest": { "url": { "path": [ "v1", "billets", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"line\": \"con\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "d1b25df2-9b50-4f06-ac99-6643663839bf", "name": "Paga um boleto ou uma conta", "request": { "name": "Paga um boleto ou uma conta", "description": { "content": "Paga a ficha de compensação ou a guia de arrecadação. Dinheiro sai da\nconta: **`Idempotency-Key` é obrigatório**, como em `POST /v1/pix/transfers`.\nA mesma chave com o mesmo corpo devolve a resposta original (marcada com\n`Idempotent-Replay: true`) e o título é pago uma vez só.\n\n**Quem decide o pagamento é o servidor.** Ele consulta o título de novo, no\nmomento de pagar, e confere o horário, o valor e os limites contra essa\nconsulta. O identificador do banco parceiro não passa pelo cliente.\n\n**Valor.**\n\n- Sem `amountCents`, paga o `totalCents` da consulta. `totalCents` é o\n valor que a tela mostrou: se o total mudou desde a consulta, `409` com o\n valor novo, e nada é pago.\n- Com `amountCents`, só para o título que permite alterar o valor\n (`allowChangeValue: true`) e dentro da faixa `minCents` a `maxCents` da\n consulta feita **agora**. Fora dela, ou em título que não permite, `422`.\n\n**Horário.** O banco parceiro só aceita pagamento dentro de `cutoff`\n(horário do fuso da operação). Fora dele o pagamento é **recusado** (`422`),\nantes de reservar o valor: nada é adiado para o próximo dia útil.\n\n**Confirmação.** Segundo fator (`X-Step-Up` com `purpose: transfer`) a\npartir de R$ 1.000,00, ou quando a soma dos pagamentos de contas do dia\nchega a esse valor, e, na instalação cujo banco parceiro o exige, em\n**todo** pagamento de contas, qualquer que seja o valor. Selfie quando a\ninstalação a exige, e a alçada de aprovação conjunta da conta da empresa.\nLimite por boleto (`billetSingleCents`), limite diário de pagamento de\ncontas (`billetDailyCents`) e conta ativa.\n\n**Limite diário e janela noturna.** O pagamento não pode fazer a soma do\ndia (virada no fuso da operação) dos pagamentos de contas em andamento ou\nconcluídos passar de `billetDailyCents`; os falhados e estornados não\nentram na soma. A conferência é refeita dentro da reserva, com a conta\ntravada, de modo que pagamentos simultâneos que juntos estourem o limite\ndeixam passar só o que cabe. Das 20h às 6h (fuso da operação) o pagamento\nde contas também respeita o teto noturno (`pixNightCents`), por operação e\npela soma da janela junto com Pix e TED, e o bloqueio noturno das\npreferências de segurança do titular. O pagamento de contas não fica\nretido para análise. Passar de qualquer um responde\n`422 LIMIT_EXCEEDED`.\n\n**Desfecho.** O envio ao banco sai no máximo uma vez. Prazo esgotado,\nresposta perdida e erro 5xx não são falha: a transação fica `PROCESSING` e\no desfecho vem por evento do banco ou por conciliação. `COMPLETED` pode\nsignificar pagamento aceito e liquidado só no dia útil seguinte\n(`billetReceipt.settleDate`). Recusa do banco (`FAILED`) devolve o valor.\n\nO comprovante (autenticação, data de liquidação e convênio) fica em\n`billetReceipt` no `GET /v1/transactions/{id}`. O texto do comprovante do\nbanco, que traz documentos completos, não é guardado nem devolvido.\n", "type": "text/plain" }, "url": { "path": [ "v1", "billets", "pay" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"line\": \"veniam occaecat reprehenderit consectetur dolore\",\n \"totalCents\": 15000,\n \"amountCents\": 4321,\n \"expectedFeeCents\": 190\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "9c105416-ccec-4886-8816-7ab033417f70", "name": "Aceito. A transação tem `kind: PAYMENT_BILLET`. `status` é\n`PROCESSING` (o normal), `COMPLETED` ou `FAILED` (recusado pelo banco,\nvalor devolvido).\n", "originalRequest": { "url": { "path": [ "v1", "billets", "pay" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"line\": \"veniam occaecat reprehenderit consectetur dolore\",\n \"totalCents\": 15000,\n \"amountCents\": 4321,\n \"expectedFeeCents\": 190\n}", "options": { "raw": { "language": "json" } } } }, "status": "Accepted", "code": 202, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"tx_9f2c1a7b\",\n \"kind\": \"CARD_FEE\",\n \"status\": \"PROCESSING\",\n \"amountCents\": -5000,\n \"description\": \"et adipisicing aliquip ad quis\",\n \"counterparty\": {\n \"name\": \"amet consequat\",\n \"document\": \"Lorem sint fugiat\",\n \"bank\": \"tempor deserunt amet\",\n \"pixKey\": \"commodo exercitation dolor\"\n },\n \"endToEndId\": \"esse enim\",\n \"providerTransactionId\": \"esse\",\n \"riskScore\": 99,\n \"riskSignals\": [\n {\n \"code\": \"NIGHT_WINDOW\",\n \"label\": \"Fora do horário habitual\",\n \"detail\": \"exercitation est commodo velit\",\n \"triggered\": true\n },\n {\n \"code\": \"NIGHT_WINDOW\",\n \"label\": \"Fora do horário habitual\",\n \"detail\": \"sint adipisic\",\n \"triggered\": false\n }\n ],\n \"createdAt\": \"1983-06-13T10:19:34.330Z\",\n \"executedAt\": \"1973-04-03T19:00:12.191Z\",\n \"refundOf\": \"id deserunt reprehenderit est dolor\",\n \"refundableCents\": 47603913,\n \"billetReceipt\": {\n \"kind\": \"BILL\",\n \"authentication\": \"Excepteur id\",\n \"settleDate\": \"1976-04-26\",\n \"convenant\": \"magna anim\"\n },\n \"disputableUntil\": \"1978-02-11T16:12:35.819Z\",\n \"disputeId\": \"laborum\",\n \"ted\": {\n \"bankIspb\": \"18236120\",\n \"branch\": \"0001\",\n \"accountMasked\": \"••••••977\",\n \"accountType\": \"CHECKING\",\n \"holderName\": \"sint\",\n \"holderDocumentMasked\": \"tempor quis magna sit\",\n \"movementId\": \"Duis laborum culpa officia in\",\n \"strControl\": \"commodo sed in labore\"\n },\n \"bankAccount\": {\n \"bankIspb\": \"18236120\",\n \"branch\": \"0001\",\n \"accountMasked\": \"••••••977\",\n \"accountType\": \"CHECKING\",\n \"holderName\": \"dolor aute velit Duis\",\n \"holderDocumentMasked\": \"aliquip in laborum proident\",\n \"movementId\": \"veniam Duis\"\n },\n \"feeCents\": 9892011,\n \"feeTransactionId\": \"fugiat eu do minim\",\n \"feeReason\": \"EXEMPT_BY_RULE\",\n \"feeStatus\": \"FAILED\",\n \"fee\": {\n \"service\": \"irure dolor dolore\",\n \"label\": \"labore\",\n \"feeCents\": 91029077,\n \"reason\": \"COVERED_BY_PLAN\",\n \"status\": \"CHARGED\",\n \"transactionId\": \"aute sint enim ullamco\"\n },\n \"feeOf\": \"enim nisi amet ut\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d922f445-233b-46d2-9bc3-d95d193da310", "name": "Falta o cabeçalho `Idempotency-Key`, ou o corpo é ilegível.", "originalRequest": { "url": { "path": [ "v1", "billets", "pay" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"line\": \"veniam occaecat reprehenderit consectetur dolore\",\n \"totalCents\": 15000,\n \"amountCents\": 4321,\n \"expectedFeeCents\": 190\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3b7b929d-8466-449b-a882-770cdda8cc10", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "billets", "pay" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"line\": \"veniam occaecat reprehenderit consectetur dolore\",\n \"totalCents\": 15000,\n \"amountCents\": 4321,\n \"expectedFeeCents\": 190\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "839edf84-35f0-47e5-8c9c-c7b240610643", "name": "Falta o segundo fator (`STEP_UP_REQUIRED`) ou a selfie\n(`BIOMETRIC_REQUIRED`); conta bloqueada, chave de API (esta rota é só de\nsessão) (`FORBIDDEN`); pagamento de contas desligado nesta instalação\n(`FEATURE_DISABLED`).\n", "originalRequest": { "url": { "path": [ "v1", "billets", "pay" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"line\": \"veniam occaecat reprehenderit consectetur dolore\",\n \"totalCents\": 15000,\n \"amountCents\": 4321,\n \"expectedFeeCents\": 190\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "ec0c8bea-6248-40ae-bc0e-7b96148499c3", "name": "O total mudou desde a consulta (`INVALID_REQUEST`, com o valor novo na\nmensagem); a chave de idempotência foi usada com outro corpo\n(`IDEMPOTENCY_KEY_REUSED`); o pedido ainda está em andamento\n(`IDEMPOTENCY_IN_FLIGHT`); ou a conta já está pagando este mesmo\ntítulo e o primeiro pagamento ainda não teve desfecho (`CONFLICT`):\ncom o banco parceiro que não tem idempotência, o primeiro pode ter\nsaído, e pagar de novo com outra chave seria pagar duas vezes.\n", "originalRequest": { "url": { "path": [ "v1", "billets", "pay" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"line\": \"veniam occaecat reprehenderit consectetur dolore\",\n \"totalCents\": 15000,\n \"amountCents\": 4321,\n \"expectedFeeCents\": 190\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "826b8ef7-17d0-4fc1-9e62-0d1d0d5f426d", "name": "Linha inválida; valor fora da faixa ou título que não permite alterar o\nvalor (`INVALID_REQUEST`); fora do horário de pagamento\n(`INVALID_REQUEST`); acima do limite por boleto, do limite diário de\npagamento de contas, do teto noturno ou com o bloqueio noturno ligado\n(`LIMIT_EXCEEDED`); valor que, somado às saídas do dia, alcança a\nalçada (`APPROVAL_REQUIRED`); saldo insuficiente\n(`INSUFFICIENT_FUNDS`); recusa do banco parceiro (`PROVIDER_ERROR`).\n", "originalRequest": { "url": { "path": [ "v1", "billets", "pay" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"line\": \"veniam occaecat reprehenderit consectetur dolore\",\n \"totalCents\": 15000,\n \"amountCents\": 4321,\n \"expectedFeeCents\": 190\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6d6c9c8e-305f-42dc-88b6-6706cae8eb83", "name": "O arranjo de pagamento está indisponível. Tente novamente.", "originalRequest": { "url": { "path": [ "v1", "billets", "pay" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"line\": \"veniam occaecat reprehenderit consectetur dolore\",\n \"totalCents\": 15000,\n \"amountCents\": 4321,\n \"expectedFeeCents\": 190\n}", "options": { "raw": { "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "f8d19b00-defd-4a76-a81e-8522c0259553", "name": "Agendamentos", "description": { "content": "Agendar um PIX ou o pagamento de um boleto para uma data futura. Quem paga\nna data depende da instalação: o Lume (que refaz as conferências na data) ou\no banco parceiro (que paga com o valor já reservado na conta). Só de sessão:\numa chave de API recebe `403 FORBIDDEN` nestas rotas.\n", "type": "text/plain" }, "item": [ { "id": "fbd4eae9-0b11-4ceb-ae97-626248ac1053", "name": "Lista os agendamentos da conta", "request": { "name": "Lista os agendamentos da conta", "description": { "content": "Os agendamentos de PIX e de pagamento de contas da conta, do mais recente\npara o mais antigo (até 200), inclusive os cancelados e os que falharam:\n\"por que não saiu?\" se responde em `failureReason`.\n\nContinua respondendo com `schedules` desligada: o cliente precisa ver o\nagendamento que falhou e desistir do que ainda espera.\n", "type": "text/plain" }, "url": { "path": [ "v1", "schedules" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "1f71708c-40b4-4780-ba3c-1dc650720981", "name": "Os agendamentos.", "originalRequest": { "url": { "path": [ "v1", "schedules" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"items\": [\n {\n \"id\": \"id sunt\",\n \"kind\": \"billet\",\n \"status\": \"executed\",\n \"amountCents\": 95123972,\n \"scheduledFor\": \"2025-11-17\",\n \"runAt\": \"1984-02-17T21:46:19.949Z\",\n \"counterparty\": {\n \"name\": \"est consectetur dol\",\n \"document\": \"ea sint dolor \",\n \"bank\": \"dolore ut dolore qui\",\n \"pixKey\": \"esse laboris in\"\n },\n \"createdAt\": \"2023-02-07T16:06:08.270Z\",\n \"updatedAt\": \"1966-09-15T21:23:35.019Z\",\n \"bankAccount\": {\n \"bankIspb\": \"18236120\",\n \"branch\": \"0001\",\n \"accountMasked\": \"••••••977\",\n \"accountType\": \"SAVINGS\",\n \"holderName\": \"id in\",\n \"holderDocumentMasked\": \"ut\"\n },\n \"description\": \"veniam dolore irure ad\",\n \"billetDueDate\": \"1996-12-21\",\n \"providerManaged\": true,\n \"transactionId\": \"occaecat\",\n \"transactionStatus\": \"proident ad Excepteur\",\n \"failureReason\": \"adipisicing magna ipsum voluptate nostrud\",\n \"executedAt\": \"1999-04-27T02:03:49.621Z\",\n \"canceledAt\": \"2009-10-17T23:49:12.450Z\"\n },\n {\n \"id\": \"nostrud laboris\",\n \"kind\": \"pix\",\n \"status\": \"executed\",\n \"amountCents\": 43388411,\n \"scheduledFor\": \"2019-06-05\",\n \"runAt\": \"2009-05-29T13:14:54.304Z\",\n \"counterparty\": {\n \"name\": \"id qui voluptate\",\n \"document\": \"pariatur dolore ut quis\",\n \"bank\": \"ipsu\",\n \"pixKey\": \"amet tempor consequat\"\n },\n \"createdAt\": \"1953-01-20T01:49:04.345Z\",\n \"updatedAt\": \"1960-06-07T18:48:29.813Z\",\n \"bankAccount\": {\n \"bankIspb\": \"18236120\",\n \"branch\": \"0001\",\n \"accountMasked\": \"••••••977\",\n \"accountType\": \"PAYMENT\",\n \"holderName\": \"ex Ut\",\n \"holderDocumentMasked\": \"reprehenderit culpa\"\n },\n \"description\": \"deserunt adipisicing reprehenderit\",\n \"billetDueDate\": \"1994-09-12\",\n \"providerManaged\": true,\n \"transactionId\": \"culpa\",\n \"transactionStatus\": \"adipisicing aliquip\",\n \"failureReason\": \"aute culpa in\",\n \"executedAt\": \"1999-10-19T01:42:00.534Z\",\n \"canceledAt\": \"2025-04-09T09:00:19.337Z\"\n }\n ],\n \"runHour\": 8,\n \"maxOpen\": 50\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d07035d9-5148-4525-b59c-90790f6f8748", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "schedules" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "23aa31f0-f2b2-47d3-b78d-e4c32af79ec7", "name": "Chave de API (esta rota é só de sessão) (`FORBIDDEN`).", "originalRequest": { "url": { "path": [ "v1", "schedules" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "d1c211ee-6e68-4b9f-92ea-fbe142eca672", "name": "Agenda um PIX", "request": { "name": "Agenda um PIX", "description": { "content": "Agenda um PIX por chave (`key`) ou por agência e conta (`bankAccount`,\nos mesmos campos do `POST /v1/pix/transfers`; exatamente um dos dois,\nsenão `422 INVALID_REQUEST`) para uma data futura (de amanhã até um\nano). O Lume o executa a partir de `runHour`, e na data o PIX passa por\ntudo o que um PIX de agora passa (saldo, limite, risco, conta ativa e\ntitular da chave). Nada é reservado até a data. **`Idempotency-Key` é\nobrigatório.**\n\nO Pix por agência e conta agendado só existe com as funcionalidades\n`schedules` e `pix_manual` ligadas (`403 FEATURE_DISABLED` sem elas), e\nna data a execução é a do Pix por agência e conta de agora, com as\ntravas do dia (tetos diário e noturno, conta ativa, `pix_manual` ligada,\nalçada, envio idêntico já em andamento). Se alguma recusar, o agendamento\nvira `failed` com o motivo, sem débito; o envio é no máximo uma vez e a\nrotina nunca o repete. Acima da alçada da empresa não se agenda (`422\nAPPROVAL_REQUIRED`; ao agendar vale só o valor da operação, e na data a\nexecução confere a soma daquele dia): não há aprovação conjunta do Pix\npor agência e conta. Nome e documento são os digitados, **não confirmados** pelo banco\nde destino; o documento inteiro fica guardado só até o agendamento sair\nde aberto (executado, falho ou cancelado) e **nunca** volta na resposta.\n\nConfirmação: segundo fator (`X-Step-Up` com `purpose: transfer`) a partir\nde R$ 1.000,00 e selfie quando a instalação a exige. Acima da alçada da\nempresa, agendar é recusado.\n\n**Tarifa.** Com a funcionalidade `service_fees`, o Pix agendado paga a\ntarifa do serviço vigente **no dia da execução** (tabela, cesta do\nplano daquele período e isenções), cobrada junto do envio; nada é\ncobrado ao agendar. Na data, o saldo precisa cobrir valor + tarifa: sem\nisso o agendamento vira `failed`, sem débito. A cotação de\n`GET /v1/fees/quote` no dia de agendar é só informativa.\n\nSó existe quando a funcionalidade `schedules` está ligada.\n", "type": "text/plain" }, "url": { "path": [ "v1", "schedules", "pix" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"amountCents\": 30000,\n \"date\": \"1968-01-14\",\n \"key\": \"laboris ad cul\",\n \"bankAccount\": {\n \"ispb\": \"18236120\",\n \"branch\": \"0001\",\n \"account\": \"919261977\",\n \"accountType\": \"CHECKING\",\n \"holderName\": \"in Ut amet id\",\n \"holderDocument\": \"in sit culpa\"\n },\n \"description\": \"culpa in\",\n \"expectedRecipientRef\": \"anim fugiat\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "bcfc21ac-ae0c-4b11-bfe6-ac43a09f054e", "name": "Agendado.", "originalRequest": { "url": { "path": [ "v1", "schedules", "pix" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 30000,\n \"date\": \"1968-01-14\",\n \"key\": \"laboris ad cul\",\n \"bankAccount\": {\n \"ispb\": \"18236120\",\n \"branch\": \"0001\",\n \"account\": \"919261977\",\n \"accountType\": \"CHECKING\",\n \"holderName\": \"in Ut amet id\",\n \"holderDocument\": \"in sit culpa\"\n },\n \"description\": \"culpa in\",\n \"expectedRecipientRef\": \"anim fugiat\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"aliqua officia\",\n \"kind\": \"billet\",\n \"status\": \"processing\",\n \"amountCents\": 41679449,\n \"scheduledFor\": \"1982-10-14\",\n \"runAt\": \"2003-06-25T15:47:56.402Z\",\n \"counterparty\": {\n \"name\": \"in quis nostrud\",\n \"document\": \"Duis nostrud\",\n \"bank\": \"dolor tempor nisi\",\n \"pixKey\": \"reprehenderit elit veniam laboris\"\n },\n \"createdAt\": \"2005-05-02T17:00:48.891Z\",\n \"updatedAt\": \"2026-02-17T03:28:46.363Z\",\n \"bankAccount\": {\n \"bankIspb\": \"18236120\",\n \"branch\": \"0001\",\n \"accountMasked\": \"••••••977\",\n \"accountType\": \"SAVINGS\",\n \"holderName\": \"ullamco labore\",\n \"holderDocumentMasked\": \"cillum\"\n },\n \"description\": \"exercitation consequat ad et dolore\",\n \"billetDueDate\": \"1949-10-14\",\n \"providerManaged\": false,\n \"transactionId\": \"ut cupidatat elit dolor id\",\n \"transactionStatus\": \"ut commodo cupidatat nulla\",\n \"failureReason\": \"dolore magna exercitation officia\",\n \"executedAt\": \"1997-04-01T14:14:22.351Z\",\n \"canceledAt\": \"2023-04-18T19:51:36.770Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8d90bca9-881b-439d-8a82-1e90c2857c8e", "name": "Falta o cabeçalho `Idempotency-Key`, ou o corpo é ilegível.", "originalRequest": { "url": { "path": [ "v1", "schedules", "pix" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 30000,\n \"date\": \"1968-01-14\",\n \"key\": \"laboris ad cul\",\n \"bankAccount\": {\n \"ispb\": \"18236120\",\n \"branch\": \"0001\",\n \"account\": \"919261977\",\n \"accountType\": \"CHECKING\",\n \"holderName\": \"in Ut amet id\",\n \"holderDocument\": \"in sit culpa\"\n },\n \"description\": \"culpa in\",\n \"expectedRecipientRef\": \"anim fugiat\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "74ed90ef-c480-45af-b7e8-959068fa413d", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "schedules", "pix" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 30000,\n \"date\": \"1968-01-14\",\n \"key\": \"laboris ad cul\",\n \"bankAccount\": {\n \"ispb\": \"18236120\",\n \"branch\": \"0001\",\n \"account\": \"919261977\",\n \"accountType\": \"CHECKING\",\n \"holderName\": \"in Ut amet id\",\n \"holderDocument\": \"in sit culpa\"\n },\n \"description\": \"culpa in\",\n \"expectedRecipientRef\": \"anim fugiat\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ad70cf6a-c107-4b9e-ae5b-aee911f301ce", "name": "Falta o segundo fator (`STEP_UP_REQUIRED`) ou a selfie\n(`BIOMETRIC_REQUIRED`); conta bloqueada; chave de API (`FORBIDDEN`);\nagendamento desligado nesta instalação (`FEATURE_DISABLED`).\n", "originalRequest": { "url": { "path": [ "v1", "schedules", "pix" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 30000,\n \"date\": \"1968-01-14\",\n \"key\": \"laboris ad cul\",\n \"bankAccount\": {\n \"ispb\": \"18236120\",\n \"branch\": \"0001\",\n \"account\": \"919261977\",\n \"accountType\": \"CHECKING\",\n \"holderName\": \"in Ut amet id\",\n \"holderDocument\": \"in sit culpa\"\n },\n \"description\": \"culpa in\",\n \"expectedRecipientRef\": \"anim fugiat\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8a25273d-f58c-4efb-bd26-8c6303e70a5f", "name": "A chave de idempotência foi usada com outro corpo\n(`IDEMPOTENCY_KEY_REUSED`); o pedido ainda está em andamento\n(`IDEMPOTENCY_IN_FLIGHT`); o titular da chave não é o de\n`expectedRecipientRef` (`CONFLICT`, `details.reason`\n`RECIPIENT_CHANGED` ou `RECIPIENT_UNVERIFIED`).\n", "originalRequest": { "url": { "path": [ "v1", "schedules", "pix" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 30000,\n \"date\": \"1968-01-14\",\n \"key\": \"laboris ad cul\",\n \"bankAccount\": {\n \"ispb\": \"18236120\",\n \"branch\": \"0001\",\n \"account\": \"919261977\",\n \"accountType\": \"CHECKING\",\n \"holderName\": \"in Ut amet id\",\n \"holderDocument\": \"in sit culpa\"\n },\n \"description\": \"culpa in\",\n \"expectedRecipientRef\": \"anim fugiat\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d77a1167-cfc9-4615-97b8-175be6c3cdda", "name": "Data fora de \"amanhã até um ano\", chave inválida, destino bancário\ninválido, `key` e `bankAccount` juntos ou nenhum dos dois, conta de\ndestino que é a própria conta, teto de agendamentos em aberto\n(`INVALID_REQUEST`); acima do limite por transferência\n(`LIMIT_EXCEEDED`); acima da alçada (`APPROVAL_REQUIRED`).\n", "originalRequest": { "url": { "path": [ "v1", "schedules", "pix" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"amountCents\": 30000,\n \"date\": \"1968-01-14\",\n \"key\": \"laboris ad cul\",\n \"bankAccount\": {\n \"ispb\": \"18236120\",\n \"branch\": \"0001\",\n \"account\": \"919261977\",\n \"accountType\": \"CHECKING\",\n \"holderName\": \"in Ut amet id\",\n \"holderDocument\": \"in sit culpa\"\n },\n \"description\": \"culpa in\",\n \"expectedRecipientRef\": \"anim fugiat\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c6a770f0-b3e2-4d2f-9f3f-686e86d82fd5", "name": "Agenda o pagamento de um boleto ou de uma conta", "request": { "name": "Agenda o pagamento de um boleto ou de uma conta", "description": { "content": "Agenda o pagamento de uma ficha de compensação ou de uma guia de\narrecadação para uma data futura (de amanhã até um ano e até o\nvencimento, quando ele existe). **`Idempotency-Key` é obrigatório.**\n\n**Quem paga na data depende da instalação.**\n\n- Com `schedules` ligada, o Lume executa o agendamento a partir de\n `runHour`, refazendo a consulta e conferindo valor, limite, risco e conta\n ativa na data. Nada é reservado até lá. Com `service_fees`, a tarifa\n de pagamento de contas é a vigente **no dia da execução** (tabela,\n cesta daquele período e isenções), cobrada junto do pagamento; na\n data o saldo precisa cobrir valor + tarifa, senão o agendamento vira\n `failed` sem débito. `expectedFeeCents` é ignorado nesse caso.\n- Com só `bill_schedule` ligada (a instalação cujo banco parceiro não\n aceita que o Lume pague sem ninguém na tela), o agendamento é criado\n **no banco parceiro**, com você presente, e é o banco quem paga na data\n (`providerManaged: true`). O valor fica **reservado** na conta desde o\n dia de agendar: o saldo disponível cai, e o valor volta se o agendamento\n for cancelado ou falhar. O horário de pagamento do título não se aplica\n ao agendar. O envio ao banco sai no máximo uma vez, e a mesma chave com o\n mesmo corpo devolve o mesmo agendamento sem reservar de novo. Com\n `service_fees`, a tarifa de pagamento de contas é decidida e\n **reservada junto do valor, no dia de agendar** (tabela e cesta do\n plano desse dia), porque é quando o dinheiro sai da conta disponível;\n o cancelamento ou a falha a devolvem com o valor. Mande em\n `expectedFeeCents` a tarifa de `GET /v1/fees/quote`: maior que ela,\n `409` com `details.reason: FEE_CHANGED` e nada reservado.\n\nConfirmação: segundo fator (`X-Step-Up` com `purpose: transfer`), exigido\nem todo valor quando o banco parceiro o exige (a Azify), e selfie quando a\ninstalação a exige. Limite por boleto (`billetSingleCents`), conta ativa e\nalçada da empresa também valem ao agendar. No agendamento feito no banco\nparceiro, que reserva o valor na hora, valem também o limite diário de\npagamento de contas (`billetDailyCents`), o teto noturno e o bloqueio\nnoturno, como em `POST /v1/billets/pay`.\n", "type": "text/plain" }, "url": { "path": [ "v1", "schedules", "billet" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"line\": \"dolor do ad irure\",\n \"date\": \"2004-12-25\",\n \"totalCents\": 65054357,\n \"expectedFeeCents\": 90548990\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "8ddc6816-2d6f-4264-a5cf-4f44b4fc30d8", "name": "Agendado. No agendamento do banco parceiro, `status` é `scheduled` (o\nbanco confirmou) ou `processing` (sem resposta do banco: o valor\nfica reservado e a conciliação confirma).\n", "originalRequest": { "url": { "path": [ "v1", "schedules", "billet" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"line\": \"dolor do ad irure\",\n \"date\": \"2004-12-25\",\n \"totalCents\": 65054357,\n \"expectedFeeCents\": 90548990\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"aliqua officia\",\n \"kind\": \"billet\",\n \"status\": \"processing\",\n \"amountCents\": 41679449,\n \"scheduledFor\": \"1982-10-14\",\n \"runAt\": \"2003-06-25T15:47:56.402Z\",\n \"counterparty\": {\n \"name\": \"in quis nostrud\",\n \"document\": \"Duis nostrud\",\n \"bank\": \"dolor tempor nisi\",\n \"pixKey\": \"reprehenderit elit veniam laboris\"\n },\n \"createdAt\": \"2005-05-02T17:00:48.891Z\",\n \"updatedAt\": \"2026-02-17T03:28:46.363Z\",\n \"bankAccount\": {\n \"bankIspb\": \"18236120\",\n \"branch\": \"0001\",\n \"accountMasked\": \"••••••977\",\n \"accountType\": \"SAVINGS\",\n \"holderName\": \"ullamco labore\",\n \"holderDocumentMasked\": \"cillum\"\n },\n \"description\": \"exercitation consequat ad et dolore\",\n \"billetDueDate\": \"1949-10-14\",\n \"providerManaged\": false,\n \"transactionId\": \"ut cupidatat elit dolor id\",\n \"transactionStatus\": \"ut commodo cupidatat nulla\",\n \"failureReason\": \"dolore magna exercitation officia\",\n \"executedAt\": \"1997-04-01T14:14:22.351Z\",\n \"canceledAt\": \"2023-04-18T19:51:36.770Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "faeaaf4b-8cd4-4c25-8194-95b9436f3669", "name": "Falta o cabeçalho `Idempotency-Key`, ou o corpo é ilegível.", "originalRequest": { "url": { "path": [ "v1", "schedules", "billet" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"line\": \"dolor do ad irure\",\n \"date\": \"2004-12-25\",\n \"totalCents\": 65054357,\n \"expectedFeeCents\": 90548990\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a5179fb4-84d3-4743-9bd2-072e25dd6c3f", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "schedules", "billet" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"line\": \"dolor do ad irure\",\n \"date\": \"2004-12-25\",\n \"totalCents\": 65054357,\n \"expectedFeeCents\": 90548990\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2dbf4cfa-d8cc-4db0-8e30-567f8b56ef69", "name": "Falta o segundo fator (`STEP_UP_REQUIRED`) ou a selfie\n(`BIOMETRIC_REQUIRED`); conta bloqueada; chave de API (`FORBIDDEN`);\nnenhum agendamento de contas disponível nesta instalação\n(`FEATURE_DISABLED`).\n", "originalRequest": { "url": { "path": [ "v1", "schedules", "billet" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"line\": \"dolor do ad irure\",\n \"date\": \"2004-12-25\",\n \"totalCents\": 65054357,\n \"expectedFeeCents\": 90548990\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b12a26f3-a07f-42fc-925b-274670c84bc0", "name": "O total mudou desde a consulta (`INVALID_REQUEST`); a chave foi usada\ncom outro corpo (`IDEMPOTENCY_KEY_REUSED`); o pedido ainda está em\nandamento (`IDEMPOTENCY_IN_FLIGHT`); a conta já tem um pagamento ou\nagendamento deste título sem desfecho (`CONFLICT`); no agendamento\ndo banco parceiro, a tarifa mudou desde a cotação (`CONFLICT` com\n`details.reason: FEE_CHANGED` e `details.feeCents`, nada reservado).\n", "originalRequest": { "url": { "path": [ "v1", "schedules", "billet" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"line\": \"dolor do ad irure\",\n \"date\": \"2004-12-25\",\n \"totalCents\": 65054357,\n \"expectedFeeCents\": 90548990\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c41baa37-c586-439a-8700-2d37d70fda15", "name": "Data fora do prazo, depois do vencimento, linha inválida, teto de\nagendamentos em aberto, ou o banco parceiro não aceitou o agendamento\ne o valor voltou (`INVALID_REQUEST`); repetir com a mesma chave um\nagendamento que não foi aceito também responde `422`; acima do limite\npor boleto, do limite diário de pagamento de contas, do teto noturno\nou com o bloqueio noturno ligado (`LIMIT_EXCEEDED`; os três últimos\nsó no agendamento feito no banco parceiro, que reserva o valor na\nhora); acima da alçada (`APPROVAL_REQUIRED`).\n", "originalRequest": { "url": { "path": [ "v1", "schedules", "billet" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"line\": \"dolor do ad irure\",\n \"date\": \"2004-12-25\",\n \"totalCents\": 65054357,\n \"expectedFeeCents\": 90548990\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "69343898-3117-4973-9565-fe3ccec3da74", "name": "O banco parceiro estava indisponível e o pedido comprovadamente não\nsaiu (`PROVIDER_ERROR`): nenhum valor ficou reservado. Repetir com a\nmesma chave responde `422`; para tentar de novo, use outra chave.\n", "originalRequest": { "url": { "path": [ "v1", "schedules", "billet" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"line\": \"dolor do ad irure\",\n \"date\": \"2004-12-25\",\n \"totalCents\": 65054357,\n \"expectedFeeCents\": 90548990\n}", "options": { "raw": { "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "7e839d01-ff7a-450e-98c1-ff2685d7d181", "name": "Cancela um agendamento que ainda espera", "request": { "name": "Cancela um agendamento que ainda espera", "description": { "content": "Só vale para `status: scheduled`. É POST, e não DELETE, porque o\nagendamento não some: fica no histórico como `canceled`.\n\nNo agendamento do banco parceiro (`providerManaged: true`), o\ncancelamento é feito **no banco** e a reserva volta para a conta, uma vez\nsó. Sem a confirmação do banco (recusa ou queda), a reserva continua e a\nresposta não diz que cancelou. Se o banco já pagou, a reserva é liquidada\ne a resposta é `409`.\n\nAgendamento de outra conta responde `404`, como se não existisse. Não\nexige `Idempotency-Key`: repetir devolve `409`, e nada é devolvido duas\nvezes.\n", "type": "text/plain" }, "url": { "path": [ "v1", "schedules", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "972d7e23-8a13-4f64-b8c5-97f337f565c9", "name": "Cancelado.", "originalRequest": { "url": { "path": [ "v1", "schedules", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"aliqua officia\",\n \"kind\": \"billet\",\n \"status\": \"processing\",\n \"amountCents\": 41679449,\n \"scheduledFor\": \"1982-10-14\",\n \"runAt\": \"2003-06-25T15:47:56.402Z\",\n \"counterparty\": {\n \"name\": \"in quis nostrud\",\n \"document\": \"Duis nostrud\",\n \"bank\": \"dolor tempor nisi\",\n \"pixKey\": \"reprehenderit elit veniam laboris\"\n },\n \"createdAt\": \"2005-05-02T17:00:48.891Z\",\n \"updatedAt\": \"2026-02-17T03:28:46.363Z\",\n \"bankAccount\": {\n \"bankIspb\": \"18236120\",\n \"branch\": \"0001\",\n \"accountMasked\": \"••••••977\",\n \"accountType\": \"SAVINGS\",\n \"holderName\": \"ullamco labore\",\n \"holderDocumentMasked\": \"cillum\"\n },\n \"description\": \"exercitation consequat ad et dolore\",\n \"billetDueDate\": \"1949-10-14\",\n \"providerManaged\": false,\n \"transactionId\": \"ut cupidatat elit dolor id\",\n \"transactionStatus\": \"ut commodo cupidatat nulla\",\n \"failureReason\": \"dolore magna exercitation officia\",\n \"executedAt\": \"1997-04-01T14:14:22.351Z\",\n \"canceledAt\": \"2023-04-18T19:51:36.770Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a9f1aa1c-4285-4389-9ffb-8b561446c2e9", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "schedules", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3f223c30-244f-46a2-94db-0e88fb78ff41", "name": "Chave de API (esta rota é só de sessão) (`FORBIDDEN`).", "originalRequest": { "url": { "path": [ "v1", "schedules", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1f62684b-dde8-4884-823b-ce933685a1ed", "name": "Não existe, ou é de outra conta (`NOT_FOUND`).", "originalRequest": { "url": { "path": [ "v1", "schedules", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "348ceada-ffb1-4c74-8f1a-f32fcf5f219d", "name": "O agendamento já foi executado, já falhou, já foi cancelado, ou o banco\nparceiro não confirmou o cancelamento (`CONFLICT`).\n", "originalRequest": { "url": { "path": [ "v1", "schedules", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "407b2b6d-9ace-429d-8dbe-ba85834938c9", "name": "O banco parceiro não respondeu ao cancelamento (`PROVIDER_ERROR`). Não\nhá prova de que cancelou: **a reserva continua** e o agendamento segue\n`scheduled`. Tente de novo mais tarde.\n", "originalRequest": { "url": { "path": [ "v1", "schedules", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "37d4f35f-46fa-4d08-b09d-0a844137c967", "name": "Segurança", "description": { "content": "Limites em vigor e histórico de eventos da conta.", "type": "text/plain" }, "item": [ { "id": "65e40229-1cc9-46ca-a9a8-10f84f0fd2f1", "name": "Limites em vigor", "request": { "name": "Limites em vigor", "description": { "content": "`stepUpThresholdCents` é o valor a partir do qual a transferência exige\n`X-Step-Up`, mesmo com a sessão aberta. `stepUpDailyThresholdCents` é a\nsoma do dia a partir da qual o envio sem `X-Step-Up` também o exige\n(Pix, pagamento de contas e recarga, cada um com a sua soma), ainda que\nabaixo de `stepUpThresholdCents`.\n\n`pixNightNewPeerCents` é o teto noturno para um contato novo: Pix (por\nchave, por agência e conta ou por QR Code), das 20h às 6h, para uma\nchave ou conta que esta conta não pagou **antes do início da janela**\n(um pagamento feito dentro da própria noite não torna o destino\nconhecido). Vale **por operação e pela soma** do que já saiu ou está\nreservado para esse destino na janela. Passar dele responde `422\nLIMIT_EXCEEDED` (mensagem \"para um contato novo\" ou \"para este contato\nnovo\"), antes de qualquer débito, e vale também ao liberar uma\ntransação retida nessa janela. Depois de um pagamento concluído ao\ndestino antes das 20h, vale só o teto noturno comum.\n\n`pixNightCents` é o teto de envio na janela noturna, das 20h às 6h no\nfuso da operação (Resolução BCB nº 142). Vale **por operação e também\npela soma** do que a conta já enviou ou reservou (retidas incluídas) por\nPix (chave e QR Code) **e TED** nessa janela, que atravessa a\nmeia-noite: vale o mais restritivo dos dois. Passar do teto responde\n`422 LIMIT_EXCEEDED`; a recusa pela soma informa o que resta. Vale\ntambém ao liberar uma transação retida: se passar do teto, a liberação\né recusada e a transação segue retida. O bloqueio noturno das\npreferências de segurança vale para Pix, TED e pagamento de contas. A\nsoma e o teto por operação valem também para o pagamento de contas\n(`POST /v1/billets/pay`); a recarga não entra neste teto.\n\n`tedDailyCents` é a soma de TEDs que a conta pode enviar por dia (virada\ndo dia no fuso da operação), aplicada em `POST /v1/ted/transfers`.\n\n`billetSingleCents`, `billetDailyCents` e `cardDailyCents` descrevem\npolíticas já configuráveis no backoffice. `billetSingleCents` vale por\npagamento de boleto ou de conta (`POST /v1/billets/pay`).\n`billetDailyCents` é a soma de pagamentos de contas que a conta pode\nfazer por dia (virada do dia no fuso da operação), aplicada em\n`POST /v1/billets/pay` e na reserva do agendamento feito no banco\nparceiro. As rotas de cartão (`/v1/cards`) são só de sessão. `cardDailyCents` segue no corpo com a\nfuncionalidade `cards` desligada: desligar não apaga o valor da conta, e\nreligar o devolve.\n\nOs limites que o titular ajusta (`items`) seguem as funcionalidades da\ninstalação: os de Pix somem com `pix_transfer` e `pix_qr_pay`\ndesligadas, o `billet_single` com `bill_payment` e `billet_issue`\ndesligadas, o `billet_daily` com `bill_payment` desligada (ele não limita\na emissão) (o de TED, que só o backoffice ajusta, some lá com `ted`\ndesligada). Os campos `pix*Cents`, `tedDailyCents`,\n`billetSingleCents` e `billetDailyCents` continuam no corpo com o valor da conta, como o\n`cardDailyCents`.\n", "type": "text/plain" }, "url": { "path": [ "v1", "limits" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "fecf9cd5-4d6b-43df-96e2-7323464719a7", "name": "Limites", "originalRequest": { "url": { "path": [ "v1", "limits" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"pixDailyCents\": 500000,\n \"pixSingleCents\": 200000,\n \"pixNightCents\": 100000,\n \"pixNightNewPeerCents\": 10000,\n \"tedDailyCents\": 2000000,\n \"billetSingleCents\": 1000000,\n \"billetDailyCents\": 3000000,\n \"cardDailyCents\": 300000,\n \"stepUpThresholdCents\": 100000,\n \"stepUpDailyThresholdCents\": 100000\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8b72662b-aec7-4cfc-a86a-b6811de04e7b", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "limits" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e9240e45-04b8-4b52-bdc0-804ef29ea66c", "name": "Bloqueia a própria conta", "request": { "name": "Bloqueia a própria conta", "description": { "content": "O titular bloqueia a conta quando perde o aparelho ou desconfia de uso\nindevido. Responde `200` com `{status: \"BLOCKED\"}` e **derruba todas as\nsessões do titular, inclusive a que fez o pedido**: depois da resposta o\ntoken deixa de valer, e a tela deve voltar ao login.\n\nSó com sessão de cliente: **não** aceita chave de API. **Exige\n`X-Step-Up`** com `purpose: account_block`: como só o atendimento\ndesbloqueia, sem o código uma sessão roubada trancaria o dono do lado\nde fora. Quem perdeu o aparelho com o autenticador bloqueia pelo\natendimento. A prova é conferida depois do corpo: um pedido inválido\nresponde `422` sem gastá-la. Conta de empresa: o representante\nbloqueia a conta que escolheu (`X-Account-Id`), e a sessão dele também\ncai.\n\nConta ativa ou em abertura (`PENDING`) bloqueia. Conta já `BLOCKED`\nresponde `200` sem efeito novo (quem bloqueou antes e o motivo ficam como\nestão); por isso a rota não usa `Idempotency-Key`. Conta encerrada\nresponde `409`.\n\n**O cliente não desbloqueia.** O desbloqueio é só pelo atendimento do\nbanco. O bloqueio vale no banco parceiro (motivo de pedido do cliente) e,\nse ele estiver fora do ar, fica pendente e é repetido depois: o bloqueio\nno Lume vale na hora.\n\n`note` é texto livre (até 140 caracteres, sem quebra de linha): fica só\nno histórico de segurança do titular (`ACCOUNT_STATUS`), nunca vai ao\nbanco parceiro nem ao log.\n", "type": "text/plain" }, "url": { "path": [ "v1", "security", "account-block" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"reason\": \"SUSPECTED_MISUSE\",\n \"note\": \"tempor sint voluptate\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "f5db8395-3b7e-40c4-9f1e-fb246de138a4", "name": "Conta bloqueada (ou já estava), e todas as sessões encerradas.", "originalRequest": { "url": { "path": [ "v1", "security", "account-block" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"reason\": \"SUSPECTED_MISUSE\",\n \"note\": \"tempor sint voluptate\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"BLOCKED\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5ebf1ffb-3cc7-4dfc-bdda-aa4eba378b3f", "name": "Requisição malformada ou com dado inválido", "originalRequest": { "url": { "path": [ "v1", "security", "account-block" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"reason\": \"SUSPECTED_MISUSE\",\n \"note\": \"tempor sint voluptate\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "50edf066-6369-4a05-8e78-aa10cd0dc395", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "security", "account-block" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"reason\": \"SUSPECTED_MISUSE\",\n \"note\": \"tempor sint voluptate\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "84cf4330-fe9f-4584-8eb7-a67fcc7407ba", "name": "Falta o `X-Step-Up` com `purpose: account_block`\n(`STEP_UP_REQUIRED`), ou a operação foi tentada com chave de API\n(`FORBIDDEN`).\n", "originalRequest": { "url": { "path": [ "v1", "security", "account-block" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"reason\": \"SUSPECTED_MISUSE\",\n \"note\": \"tempor sint voluptate\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "145db17b-9f46-481e-ad5e-1744c0d39225", "name": "A conta está encerrada, ou mudou de situação durante o pedido (`CONFLICT`).", "originalRequest": { "url": { "path": [ "v1", "security", "account-block" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"reason\": \"SUSPECTED_MISUSE\",\n \"note\": \"tempor sint voluptate\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7ea28d1f-87db-405a-9adc-f1172ade67fc", "name": "Motivo fora da lista, ou observação longa demais (`INVALID_REQUEST`).", "originalRequest": { "url": { "path": [ "v1", "security", "account-block" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"reason\": \"SUSPECTED_MISUSE\",\n \"note\": \"tempor sint voluptate\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "804d90fb-be24-4182-a4ea-f69ce98751f8", "name": "Aparelhos da pessoa", "request": { "name": "Aparelhos da pessoa", "description": { "content": "Os aparelhos em que a pessoa já passou pelo segundo fator, do último\nacesso ao mais antigo. São da pessoa que entrou, e não da conta que ela\nestá operando: quem representa uma empresa vê os próprios aparelhos.\n\n`status` decide o acesso: `ACTIVE` (habilitado), `PENDING` (aguardando\nhabilitação: no modo impor da instalação, não recebe sessão), `REVOKED`\n(desabilitado) ou `BLOCKED` (bloqueado; só o atendimento libera).\n`recognized` é `true` quando `status` é `ACTIVE`, e fica por\ncompatibilidade. `current` marca o aparelho que fez a chamada, pela\nimpressão em `X-Device-Fingerprint`.\n\nOs detalhes (`platform`, `osVersion`, `client`, `clientVersion`,\n`model`, `manufacturer`, `lastIp`) são o retrato do último uso, para a\npessoa reconhecer cada acesso. Vêm do `User-Agent` e dos cabeçalhos\n`X-Device-Model`, `X-Device-Manufacturer` e `X-Device-OS-Version` da\nentrada e da renovação, que o cliente escreve: servem para exibição e\nnão decidem acesso. Vazio é \"não informado\". `lastSeen` muda na entrada\ne em cada renovação; `firstSeen` é a primeira entrada.\n\n`id` é um pseudônimo estável do aparelho, e não a impressão: é ele que\n`DELETE /v1/security/devices/{id}` recebe.\n\nSó com sessão de cliente: **não** aceita chave de API.\n", "type": "text/plain" }, "url": { "path": [ "v1", "security", "devices" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "6b6f7b74-382b-42db-aae0-43254315c411", "name": "Aparelhos", "originalRequest": { "url": { "path": [ "v1", "security", "devices" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"items\": [\n {\n \"id\": \"dev_3f9a1c07b2e48d615a0c9e27\",\n \"label\": \"Android\",\n \"status\": \"PENDING\",\n \"recognized\": true,\n \"lastSeen\": \"1983-04-02T21:33:58.671Z\",\n \"firstSeen\": \"2009-06-14T12:26:00.752Z\",\n \"current\": true,\n \"platform\": \"Android\",\n \"osVersion\": \"14\",\n \"client\": \"App\",\n \"clientVersion\": \"1.4.0\",\n \"model\": \"Galaxy S23 Ultra\",\n \"manufacturer\": \"samsung\",\n \"lastIp\": \"203.0.113.7\"\n },\n {\n \"id\": \"dev_3f9a1c07b2e48d615a0c9e27\",\n \"label\": \"Android\",\n \"status\": \"ACTIVE\",\n \"recognized\": true,\n \"lastSeen\": \"1995-07-07T07:46:14.838Z\",\n \"firstSeen\": \"1958-06-24T00:33:25.371Z\",\n \"current\": false,\n \"platform\": \"Android\",\n \"osVersion\": \"14\",\n \"client\": \"App\",\n \"clientVersion\": \"1.4.0\",\n \"model\": \"Galaxy S23 Ultra\",\n \"manufacturer\": \"samsung\",\n \"lastIp\": \"203.0.113.7\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1c9567a6-e6a4-4ea8-889a-8406f798fb69", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "security", "devices" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "67446c86-744d-4218-9fb1-1b905893ce39", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "security", "devices" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a92799bd-076d-437d-95b7-72b1e41925ad", "name": "Remove um aparelho", "request": { "name": "Remove um aparelho", "description": { "content": "Apaga o aparelho e encerra na hora todas as sessões abertas nele. O\naparelho que faz o pedido não pode ser removido (`400`): para isso\nexiste \"Sair\". Aparelho bloqueado também não (`409`): remover apagaria\no bloqueio, e só o atendimento o desfaz. No modo impor da instalação, o aparelho removido que\nvoltar a entrar é tratado como aparelho novo, e não recebe sessão até\nser habilitado. Fica no histórico de segurança (`LOGOUT`).\n\nPede o segundo fator: `X-Step-Up` com `purpose: devices`. Sem ele,\n`403 STEP_UP_REQUIRED`. A prova é conferida depois do `400`, do `404`\ne do `409`, que não a gastam: a tela pode mandar o pedido sem\n`X-Step-Up` e só pedir o código quando a resposta for `403`.\n\nSó com sessão de cliente: **não** aceita chave de API. Aparelho de\noutra pessoa responde `404`, como aparelho inexistente.\n", "type": "text/plain" }, "url": { "path": [ "v1", "security", "devices", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) O `id` (pseudônimo) devolvido por `GET /v1/security/devices`." } ] }, "header": [ { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "03fa62a7-ab00-4743-ad7c-99204554ff58", "name": "Aparelho removido e sessões dele encerradas", "originalRequest": { "url": { "path": [ "v1", "security", "devices", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) O `id` (pseudônimo) devolvido por `GET /v1/security/devices`." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "bc40a35b-a2f7-4fc6-9fc3-d1dfdd76144d", "name": "Requisição malformada ou com dado inválido", "originalRequest": { "url": { "path": [ "v1", "security", "devices", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) O `id` (pseudônimo) devolvido por `GET /v1/security/devices`." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "708521cd-92ef-4c66-8db7-dc1f455bd774", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "security", "devices", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) O `id` (pseudônimo) devolvido por `GET /v1/security/devices`." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c985c978-59d0-4619-b513-32c2fee39fee", "name": "Falta o segundo fator (`STEP_UP_REQUIRED`), ou a credencial é chave de API (`FORBIDDEN`).", "originalRequest": { "url": { "path": [ "v1", "security", "devices", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) O `id` (pseudônimo) devolvido por `GET /v1/security/devices`." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "77b50d22-0372-45bb-a9de-f432e88401ea", "name": "Registro não encontrado", "originalRequest": { "url": { "path": [ "v1", "security", "devices", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) O `id` (pseudônimo) devolvido por `GET /v1/security/devices`." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "03863da5-920b-4d29-a966-e5a2d0867c75", "name": "O aparelho está bloqueado; só o atendimento o libera ou remove (`CONFLICT`).", "originalRequest": { "url": { "path": [ "v1", "security", "devices", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) O `id` (pseudônimo) devolvido por `GET /v1/security/devices`." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "d50caeb2-337e-4769-b89f-c0a9896914ca", "name": "Preferências de segurança do titular", "request": { "name": "Preferências de segurança do titular", "description": { "content": "Os interruptores de Segurança, como valem agora: `blockPixAtNight`\n(recusa Pix, TED e pagamento entre 20h e 6h), `notifyNewDevice`\n(e-mail quando um aparelho novo conclui o acesso), `notifyTransactions`\n(intenção guardada; o envio por transação ainda não existe) e\n`birthdayEmail`. Quem nunca mexeu recebe o padrão: avisos ligados,\nbloqueio noturno desligado.\n\n`blockPixAtNightOffAt`, quando vem, é quando o desligamento agendado do\nbloqueio noturno passa a valer (RFC 3339); até lá `blockPixAtNight`\ncontinua `true` e o bloqueio continua valendo.\n", "type": "text/plain" }, "url": { "path": [ "v1", "security", "preferences" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "c2a3a6e4-3bf1-40c3-86da-d6205236eb88", "name": "Preferências em vigor", "originalRequest": { "url": { "path": [ "v1", "security", "preferences" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"blockPixAtNight\": true,\n \"blockPixAtNightOffAt\": \"2026-02-10T22:06:58.147Z\",\n \"notifyNewDevice\": false,\n \"notifyTransactions\": false,\n \"birthdayEmail\": false\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a58d0960-98b7-4f5b-87b5-949b09b0e262", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "security", "preferences" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "72b6e788-d923-44c6-a9e4-52e76cb0b1df", "name": "Grava as preferências de segurança", "request": { "name": "Grava as preferências de segurança", "description": { "content": "Grava o conjunto inteiro: mande os três interruptores em toda troca.\n`birthdayEmail` ausente mantém o que está.\n\nLigar vale na hora e só pede a sessão. **Desligar pede o segundo\nfator**: `X-Step-Up` com `purpose: preferences`; sem ele,\n`403 STEP_UP_REQUIRED`. E o bloqueio noturno, que muda o que o dinheiro\npode fazer, não desliga na hora nem com a prova: fica **agendado para\n24 horas depois** (`blockPixAtNightOffAt` na resposta), continua\nvalendo até lá e pode ser cancelado por\n`DELETE /v1/security/preferences/pending`. É o mesmo desenho do aumento\nde limite: quem tomou a sessão não desliga a proteção e transfere no\nmesmo minuto.\n\nMandar `blockPixAtNight: true` enquanto há desligamento agendado não o\ncancela nem o adianta — é o que a tela manda ao mexer em outro\ninterruptor, porque o bloqueio ainda está ligado. Para cancelar, use a\nrota de cancelamento.\n\nO que muda o que a conta aceita fica no histórico de segurança\n(`LIMIT_CHANGE`): ligar, agendar e cancelar o bloqueio noturno, e\ndesligar um aviso.\n", "type": "text/plain" }, "url": { "path": [ "v1", "security", "preferences" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"blockPixAtNight\": true,\n \"notifyNewDevice\": false,\n \"notifyTransactions\": true,\n \"birthdayEmail\": true\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "12ac23a6-f46d-42d2-811e-66e769ad743f", "name": "Preferências como ficaram (o bloqueio noturno, como vale agora)", "originalRequest": { "url": { "path": [ "v1", "security", "preferences" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"blockPixAtNight\": true,\n \"notifyNewDevice\": false,\n \"notifyTransactions\": true,\n \"birthdayEmail\": true\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"blockPixAtNight\": true,\n \"blockPixAtNightOffAt\": \"2026-02-10T22:06:58.147Z\",\n \"notifyNewDevice\": false,\n \"notifyTransactions\": false,\n \"birthdayEmail\": false\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "99fea0e8-0d2d-4d72-a4f1-a035eb5b5b6a", "name": "Requisição malformada ou com dado inválido", "originalRequest": { "url": { "path": [ "v1", "security", "preferences" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"blockPixAtNight\": true,\n \"notifyNewDevice\": false,\n \"notifyTransactions\": true,\n \"birthdayEmail\": true\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c38d031a-5ec8-4877-92c2-fd3a90f6f402", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "security", "preferences" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"blockPixAtNight\": true,\n \"notifyNewDevice\": false,\n \"notifyTransactions\": true,\n \"birthdayEmail\": true\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "40662d66-a11d-4fd1-bae0-e047f10683a2", "name": "Falta o segundo fator para desligar uma proteção ou um aviso (`STEP_UP_REQUIRED`).", "originalRequest": { "url": { "path": [ "v1", "security", "preferences" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Token de `POST /v1/auth/step-up`. Exigido acima do limite de step-up ou\npara liberar uma transferência retida; ignorado nos demais casos.\n", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"blockPixAtNight\": true,\n \"notifyNewDevice\": false,\n \"notifyTransactions\": true,\n \"birthdayEmail\": true\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "fb4fc510-588d-49f6-a991-bffce1d4640f", "name": "Cancela o desligamento agendado do bloqueio noturno", "request": { "name": "Cancela o desligamento agendado do bloqueio noturno", "description": { "content": "Desfaz o agendamento feito por `PATCH /v1/security/preferences`: o\nbloqueio noturno continua ligado, sem prazo. Só a sessão: cancelar é\nvoltar ao estado mais protegido. Sem agendamento, `404`.\n", "type": "text/plain" }, "url": { "path": [ "v1", "security", "preferences", "pending" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "5757f336-9fc1-448d-989e-fc953ad0dc02", "name": "Agendamento cancelado; o bloqueio noturno continua ligado", "originalRequest": { "url": { "path": [ "v1", "security", "preferences", "pending" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "4b258b2b-a7cd-481c-b34a-e70084e1d486", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "security", "preferences", "pending" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8ffae856-c070-4518-9ba8-00d0391a8e0e", "name": "Registro não encontrado", "originalRequest": { "url": { "path": [ "v1", "security", "preferences", "pending" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9e710e7f-cb8c-4542-8a9f-ba456764c05c", "name": "Situação da biometria facial do titular", "request": { "name": "Situação da biometria facial do titular", "description": { "content": "Se a instalação oferece biometria, se o titular tem rosto cadastrado e\nacima de que valor a selfie passa a ser exigida. `pendingChangeAt` é\nquando vale a troca agendada (nulo sem troca agendada); vencido o\nprazo, o rosto novo já aparece em `enrolledAt`.\n", "type": "text/plain" }, "url": { "path": [ "v1", "security", "biometrics" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "0af7e18d-72de-49ce-b297-ac4fdafaf9df", "name": "Situação da biometria", "originalRequest": { "url": { "path": [ "v1", "security", "biometrics" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"available\": true,\n \"simulated\": false,\n \"enrolled\": true,\n \"enrolledAt\": \"1990-03-26T23:17:43.061Z\",\n \"requiredAboveCents\": 79602552,\n \"pendingChangeAt\": \"2020-02-07T21:19:08.191Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0e2eb05c-a99f-4fd3-b4f5-cc147e74ee1a", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "security", "biometrics" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1bd72ad8-a0af-4f5d-9053-1c13af18dcf9", "name": "Cadastra ou troca a biometria facial", "request": { "name": "Cadastra ou troca a biometria facial", "description": { "content": "Envia a selfie que passa a confirmar as operações acima do limite.\nExige `X-Step-Up` com `purpose: biometrics`.\n\n- Sem rosto cadastrado: o código basta, e o rosto vale na hora (`201`).\n- Com rosto cadastrado, a troca na hora exige a prova do rosto atual:\n o `X-Step-Up` emitido com `selfie` (`201`). Só com o código, a\n troca fica **agendada para 24 horas depois** (`202`, com\n `effectiveAt`): até lá vale o rosto cadastrado, e ela pode ser\n cancelada por `DELETE /v1/security/biometrics/pending`; trocar ou\n redefinir a senha também a desfaz. Outro pedido enquanto há um\n agendado: `409`.\n\nO titular recebe um e-mail em toda troca, na hora ou agendada.\n", "type": "text/plain" }, "url": { "path": [ "v1", "security", "biometrics" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"selfie\": \"dolor\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "c32dd162-0f65-4740-9f59-4ddb605cc7c5", "name": "Rosto cadastrado, valendo agora", "originalRequest": { "url": { "path": [ "v1", "security", "biometrics" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"selfie\": \"dolor\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"enrolled\": false,\n \"enrolledAt\": \"1997-02-28T01:27:50.400Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f546d606-b85d-480a-9866-684696619b26", "name": "Troca agendada; o rosto cadastrado vale até `effectiveAt`", "originalRequest": { "url": { "path": [ "v1", "security", "biometrics" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"selfie\": \"dolor\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Accepted", "code": 202, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"enrolled\": false,\n \"pending\": true,\n \"effectiveAt\": \"1946-11-23T14:55:57.473Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "70e377e5-8d7d-4ff2-8383-e0b032419282", "name": "Requisição malformada ou com dado inválido", "originalRequest": { "url": { "path": [ "v1", "security", "biometrics" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"selfie\": \"dolor\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3b8a9e1c-5e03-4bd7-bcf9-b9cb0229ebc2", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "security", "biometrics" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"selfie\": \"dolor\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9d1a99f4-59c7-4fa0-80c4-2eee9ade2e49", "name": "Falta a confirmação de segundo fator (`STEP_UP_REQUIRED`). Chame\n`POST /v1/auth/step-up` e repita com o cabeçalho `X-Step-Up`.\n", "originalRequest": { "url": { "path": [ "v1", "security", "biometrics" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"selfie\": \"dolor\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "95d294a2-ca7d-466a-bbb8-90b02b3b6965", "name": "Já há uma troca agendada (`CONFLICT`)", "originalRequest": { "url": { "path": [ "v1", "security", "biometrics" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"selfie\": \"dolor\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9609be47-3695-4489-b04e-781945f9d7ea", "name": "Biometria indisponível na instalação, imagem inválida ou sem prova de vida", "originalRequest": { "url": { "path": [ "v1", "security", "biometrics" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"selfie\": \"dolor\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ea8956a0-95e3-4536-9788-12f9a8c1b4d6", "name": "Fornecedor de biometria fora do ar (`PROVIDER_ERROR`)", "originalRequest": { "url": { "path": [ "v1", "security", "biometrics" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"selfie\": \"dolor\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8d1309a7-6fa2-4932-9708-c38c1a32c3fa", "name": "Cancela a troca agendada da biometria facial", "request": { "name": "Cancela a troca agendada da biometria facial", "description": { "content": "Desfaz a troca agendada por `POST /v1/security/biometrics`: continua\nvalendo o rosto cadastrado. Só a sessão: cancelar é ficar com o rosto\nque já vale. Sem troca agendada, ou com o prazo já vencido, `404`.\n", "type": "text/plain" }, "url": { "path": [ "v1", "security", "biometrics", "pending" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "28b18371-0b06-422b-bd9f-53a50ad67e3d", "name": "Troca cancelada", "originalRequest": { "url": { "path": [ "v1", "security", "biometrics", "pending" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "a40f5c85-48c5-4233-9479-d36b0a25bd1f", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "security", "biometrics", "pending" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4f5879fe-94cb-4326-b176-ab44327170ad", "name": "Registro não encontrado", "originalRequest": { "url": { "path": [ "v1", "security", "biometrics", "pending" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ce937e43-2b61-4515-b722-5514ee1d1092", "name": "Histórico de segurança da conta", "request": { "name": "Histórico de segurança da conta", "description": { "content": "Acessos, aparelhos novos, tentativas recusadas e confirmações de segundo\nfator. Até 50 eventos, do mais recente para o mais antigo.\n\nO `kind` diz do que se trata: a trilha de acesso (`LOGIN`, `LOGOUT`,\n`FAILED_LOGIN`, `NEW_DEVICE`, `STEP_UP`, `PASSWORD_CHANGE`), alterações\nde limite (`LIMIT_CHANGE`) e de chave Pix (`PIX_KEY`), mudança de\nsituação da conta (`ACCOUNT_STATUS`), cadastro da biometria facial\n(`BIOMETRICS`), envio do informe de rendimentos por e-mail\n(`INCOME_REPORT_EMAIL`), acesso de um representante à conta de uma\nempresa (`ACCOUNT_ACCESS`), cartões (`CARD_ISSUED`, `CARD_STATUS`,\n`CARD_REVEALED`, `CARD_TERMS`), pedidos de aprovação conjunta (`APPROVAL`) e o código\nde verificação da chave Pix de e-mail ou telefone (`CONTACT_CODE_SENT`,\n`CONTACT_VERIFIED`, `CONTACT_VERIFICATION_LOCKED`) e a abertura ou o\ncancelamento de uma contestação de Pix (`PIX_DISPUTE`, com o id da\ncontestação, nunca o relato) e o acesso recusado porque o aparelho não\nestá habilitado (`DEVICE_DENIED`) e a emissão ou a revogação de uma\nchave de API da conta (`API_KEY`, com o prefixo da chave e os escopos,\nnunca o segredo). O servidor pode\nregistrar tipos novos: ignore o que não conhecer.\n", "type": "text/plain" }, "url": { "path": [ "v1", "security", "events" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "6de6513a-4485-48ec-80b1-0089b1e2962a", "name": "Eventos", "originalRequest": { "url": { "path": [ "v1", "security", "events" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"items\": [\n {\n \"id\": \"officia\",\n \"kind\": \"PIX_LOOKUP_LIMIT\",\n \"detail\": \"dolore dolor esse do est\",\n \"device\": \"Windows\",\n \"at\": \"2016-12-19T14:47:19.875Z\"\n },\n {\n \"id\": \"dolor laboris adipisicing \",\n \"kind\": \"LIMIT_CHANGE\",\n \"detail\": \"reprehenderit veniam\",\n \"device\": \"Windows\",\n \"at\": \"2024-07-25T04:33:38.494Z\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b7cb4aad-4a26-4d21-9d24-26b633cc8cc8", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "security", "events" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "988eb4e8-e9e8-443e-85d5-b53357e90363", "name": "Cartões", "description": { "content": "Os cartões da conta. A instalação oferece um produto (`model` em\n`GET /v1/cards`): `CREDIT`, o cartão de crédito com fatura, ou\n`PREPAID`, o pré-pago de um emissor parceiro, em que a compra debita o\nsaldo da conta e aparece no extrato (`CARD_PURCHASE`). No pré-pago o\ncliente aceita o termo, passa pela análise do emissor e pede o cartão\nvirtual; número, validade e código de segurança abrem só numa página\nsegura do emissor (`secure-view`). Só com sessão de cliente: nenhuma\nrota de cartão aceita chave de API.\n", "type": "text/plain" }, "item": [ { "id": "93ad015e-da5d-47b3-88d9-8feca99c20a1", "name": "Cartões da conta", "request": { "name": "Cartões da conta", "description": { "content": "Os cartões da conta, no produto desta instalação (`model`). Só com\nsessão de cliente: **não** aceita chave de API. Leitura: não chama o\nemissor para a análise nem precisa de localização (a lista de termos\nvem do emissor; se ele não responder, vêm os termos já aceitos).\n\n- `CREDIT` (crédito simulado): cada cartão traz `limitCents` e a fatura\n aberta em `invoice`. Não há `onboarding`.\n- `PREPAID` (pré-pago de emissor externo): a compra debita o saldo da\n conta; não há limite nem fatura. `onboarding` diz o que falta para\n pedir um cartão: aceitar o termo (`terms`), passar pela análise do\n emissor (`eligibility`, que pode levar até 3 dias úteis) e estar\n abaixo do teto (`maxVirtual`). `canRequestVirtual` resume tudo.\n\nNenhuma resposta traz número completo nem código de segurança. O\npedido ainda não confirmado pelo emissor aparece como `REQUESTED`.\n", "type": "text/plain" }, "url": { "path": [ "v1", "cards" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "c8497b17-96fd-44fd-8ae4-8a1d12202df8", "name": "Cartões e situação do produto.", "originalRequest": { "url": { "path": [ "v1", "cards" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"model\": \"PREPAID\",\n \"items\": [\n {\n \"id\": \"tempor consequat\",\n \"kind\": \"PHYSICAL\",\n \"status\": \"ACTIVE\",\n \"label\": \"ut\",\n \"holder\": \"aliquip non culpa\",\n \"last4\": \"elit repre\",\n \"masked\": \"nisi\",\n \"brand\": \"culpa aute\",\n \"createdAt\": \"1997-09-28T02:23:40.275Z\",\n \"statusAt\": \"1963-06-30T22:56:00.658Z\",\n \"expiry\": \"consequat commodo\",\n \"blockedBy\": \"null\",\n \"cancelReason\": \"BROKEN\",\n \"limitCents\": -98152682,\n \"invoice\": {}\n },\n {\n \"id\": \"non irure est\",\n \"kind\": \"VIRTUAL\",\n \"status\": \"ACTIVE\",\n \"label\": \"incididunt esse qu\",\n \"holder\": \"eu et dolor ullamco ut\",\n \"last4\": \"anim Lorem elit\",\n \"masked\": \"nulla laborum\",\n \"brand\": \"do\",\n \"createdAt\": \"1953-02-28T03:07:37.178Z\",\n \"statusAt\": \"2003-07-24T10:14:20.864Z\",\n \"expiry\": \"occaecat nostrud voluptate\",\n \"blockedBy\": \"INSTITUTION\",\n \"cancelReason\": \"STOLEN\",\n \"limitCents\": 15409931,\n \"invoice\": {}\n }\n ],\n \"maxVirtual\": 68590298,\n \"designs\": {},\n \"onboarding\": {\n \"terms\": [\n {\n \"id\": \"aliquip ea\",\n \"version\": \"culpa officia\",\n \"providerTerms\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"clientTerms\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"accepted\": false\n },\n {\n \"id\": \"Duis commodo\",\n \"version\": \"quis occaecat minim\",\n \"providerTerms\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"clientTerms\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"accepted\": false\n }\n ],\n \"termsAccepted\": true,\n \"eligibility\": \"MANUAL_REVIEW\",\n \"canRequestVirtual\": true,\n \"eligibilityDetail\": \"aliquip laborum in\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b8804de3-3003-49b0-8b0c-b695500b82cd", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "cards" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cc88b6d2-7497-473c-bb43-c06f068e6c35", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "cards" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "51fd6fd2-e773-43fa-aec9-1acc61897e32", "name": "Pede um cartão virtual", "request": { "name": "Pede um cartão virtual", "description": { "content": "No `CREDIT`, emite na hora; o corpo é opcional e `Idempotency-Key`\ntambém (com ela, repetir devolve o mesmo cartão). A resposta é o\ncartão, com a fatura zerada.\n\nNo `PREPAID`, **`Idempotency-Key` é obrigatória**: o emissor não tem\nchave de idempotência na emissão, e o pedido nunca é repetido pelo\nservidor. Exige o termo aceito (`CARD_TERMS_REQUIRED`), a análise\naprovada (`CARD_ELIGIBILITY_REQUIRED`) e a conta ativa. A resposta é\n`{card}`, `ACTIVE` quando o emissor confirmou, ou `REQUESTED` quando a\nconfirmação chega depois (ou a resposta dele se perdeu: o pedido não é\nrefeito, e o banco confere). Nesta versão só `VIRTUAL`: `PHYSICAL`\nresponde `CARD_KIND_UNAVAILABLE`.\n\nSó com sessão de cliente. Fica no histórico de segurança\n(`CARD_ISSUED`). Operação: leva `X-Client-Location`.\n", "type": "text/plain" }, "url": { "path": [ "v1", "cards" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": true, "description": "Obrigatória no `PREPAID`; opcional no `CREDIT`. De 8 a 128 caracteres.", "key": "Idempotency-Key", "value": "proident" }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"kind\": \"VIRTUAL\",\n \"label\": \"ali\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "2c91e6d6-a677-4c13-a498-57d0b261b286", "name": "Cartão pedido. No `PREPAID`, `{card}`; no `CREDIT`, o cartão\ndireto, com `invoice`.\n", "originalRequest": { "url": { "path": [ "v1", "cards" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Obrigatória no `PREPAID`; opcional no `CREDIT`. De 8 a 128 caracteres.", "key": "Idempotency-Key", "value": "proident" }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"kind\": \"VIRTUAL\",\n \"label\": \"ali\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"card\": {\n \"id\": \"commodo eiusmod aliqua\",\n \"kind\": \"PHYSICAL\",\n \"status\": \"BLOCKED\",\n \"label\": \"velit incididunt ad\",\n \"holder\": \"Ut dolor irure\",\n \"last4\": \"qui labore et\",\n \"masked\": \"cillum consequat nulla non Excepteur\",\n \"brand\": \"ullamco amet laboris velit tempor\",\n \"createdAt\": \"1971-02-23T13:30:33.411Z\",\n \"statusAt\": \"1957-08-18T19:42:44.587Z\",\n \"expiry\": \"ut et nostrud\",\n \"blockedBy\": \"INSTITUTION\",\n \"cancelReason\": \"INSTITUTION\",\n \"limitCents\": 27520484,\n \"invoice\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "777ea790-4760-4bdf-a4b7-57e85498629d", "name": "Requisição malformada ou com dado inválido", "originalRequest": { "url": { "path": [ "v1", "cards" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Obrigatória no `PREPAID`; opcional no `CREDIT`. De 8 a 128 caracteres.", "key": "Idempotency-Key", "value": "proident" }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"kind\": \"VIRTUAL\",\n \"label\": \"ali\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9e4722e2-9d22-4e6b-b7d1-2e82af073d12", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "cards" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Obrigatória no `PREPAID`; opcional no `CREDIT`. De 8 a 128 caracteres.", "key": "Idempotency-Key", "value": "proident" }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"kind\": \"VIRTUAL\",\n \"label\": \"ali\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3e1b9f5d-78a9-40af-a032-a9ba053c72f6", "name": "Conta bloqueada (`FORBIDDEN`), ou a funcionalidade desligada (`FEATURE_DISABLED`).", "originalRequest": { "url": { "path": [ "v1", "cards" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Obrigatória no `PREPAID`; opcional no `CREDIT`. De 8 a 128 caracteres.", "key": "Idempotency-Key", "value": "proident" }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"kind\": \"VIRTUAL\",\n \"label\": \"ali\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8f96cfa8-2321-44a5-8fab-b93a903f909d", "name": "A mesma `Idempotency-Key` com outro corpo (`IDEMPOTENCY_KEY_REUSED`), ou o pedido anterior ainda em andamento (`IDEMPOTENCY_IN_FLIGHT`).", "originalRequest": { "url": { "path": [ "v1", "cards" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Obrigatória no `PREPAID`; opcional no `CREDIT`. De 8 a 128 caracteres.", "key": "Idempotency-Key", "value": "proident" }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"kind\": \"VIRTUAL\",\n \"label\": \"ali\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "befc47cb-85d4-4382-8d99-25776bc79295", "name": "Termo não aceito (`CARD_TERMS_REQUIRED`), análise não aprovada\n(`CARD_ELIGIBILITY_REQUIRED`), tipo indisponível\n(`CARD_KIND_UNAVAILABLE`), teto de cartões virtuais ou apelido\ninválido (`INVALID_REQUEST`).\n", "originalRequest": { "url": { "path": [ "v1", "cards" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Obrigatória no `PREPAID`; opcional no `CREDIT`. De 8 a 128 caracteres.", "key": "Idempotency-Key", "value": "proident" }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"kind\": \"VIRTUAL\",\n \"label\": \"ali\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4819f9ea-54cc-432e-8131-e0d726a5e4b7", "name": "O arranjo de pagamento está indisponível. Tente novamente.", "originalRequest": { "url": { "path": [ "v1", "cards" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Obrigatória no `PREPAID`; opcional no `CREDIT`. De 8 a 128 caracteres.", "key": "Idempotency-Key", "value": "proident" }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"kind\": \"VIRTUAL\",\n \"label\": \"ali\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2581d997-0724-420b-bf32-b5173263d2a6", "name": "Responde ao termo de uso do cartão", "request": { "name": "Responde ao termo de uso do cartão", "description": { "content": "Só no `PREPAID`. Registra a resposta do titular ao termo vigente do\nemissor (`termId` de `onboarding.terms`): primeiro no emissor, depois\nno Lume, com o contexto do aparelho (sem a localização em texto).\nRepetir o aceite é sucesso. Recusar (`accept: false`) fica registrado\ne não deixa pedir cartão.\n\nExige a conta ativa. Fica no histórico de segurança (`CARD_TERMS`).\nOperação: leva `X-Client-Location`. Só com sessão de cliente.\n", "type": "text/plain" }, "url": { "path": [ "v1", "cards", "terms", ":termId", "accept" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "termId", "description": "(Required) " } ] }, "header": [ { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"accept\": false\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "63beb3d2-bc95-4ca1-b6ac-5b46a91413c5", "name": "Resposta registrada.", "originalRequest": { "url": { "path": [ "v1", "cards", "terms", ":termId", "accept" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "termId", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accept\": false\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"onboarding\": {\n \"terms\": [\n {\n \"id\": \"nisi nostrud cupidatat ad est\",\n \"version\": \"ea amet aliqua labore aute\",\n \"providerTerms\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"clientTerms\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"accepted\": false\n },\n {\n \"id\": \"ex nisi mollit in\",\n \"version\": \"Duis voluptate sunt cillum\",\n \"providerTerms\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"clientTerms\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"accepted\": true\n }\n ],\n \"termsAccepted\": true,\n \"eligibility\": \"NOT_STARTED\",\n \"canRequestVirtual\": false,\n \"eligibilityDetail\": \"dolore fugiat sunt ipsum\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e9e1bea7-27ca-4284-b5fb-730816a5bebb", "name": "Requisição malformada ou com dado inválido", "originalRequest": { "url": { "path": [ "v1", "cards", "terms", ":termId", "accept" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "termId", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accept\": false\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "848e5af5-d0f0-488e-8ca6-30ed40910fdd", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "cards", "terms", ":termId", "accept" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "termId", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accept\": false\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8192c924-c4b4-4945-aaa0-b449a0c95070", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "cards", "terms", ":termId", "accept" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "termId", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accept\": false\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "955c1808-6504-4c7e-a924-56c32e662da5", "name": "Termo que o emissor não tem como vigente (`NOT_FOUND`).", "originalRequest": { "url": { "path": [ "v1", "cards", "terms", ":termId", "accept" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "termId", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accept\": false\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1ff71ee6-6558-44d0-aac3-a9ee437413c5", "name": "A instalação não é `PREPAID` (`CONFLICT`).", "originalRequest": { "url": { "path": [ "v1", "cards", "terms", ":termId", "accept" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "termId", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accept\": false\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5322ba94-7c90-4932-8854-1e4a6d63417e", "name": "O arranjo de pagamento está indisponível. Tente novamente.", "originalRequest": { "url": { "path": [ "v1", "cards", "terms", ":termId", "accept" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "termId", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accept\": false\n}", "options": { "raw": { "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "69b29ff5-7d7a-4549-b792-c97f66caa051", "name": "Inicia a análise para ter cartão", "request": { "name": "Inicia a análise para ter cartão", "description": { "content": "Só no `PREPAID`. Pede ao emissor a análise de elegibilidade (ou\nconsulta de novo a que já começou). Sem o termo aceito responde\n`CARD_TERMS_REQUIRED`. A análise pode levar até 3 dias úteis; o\nresultado chega por aviso do emissor e aparece em `GET /v1/cards`.\n\nExige a conta ativa. Operação: leva `X-Client-Location`. Só com sessão\nde cliente.\n", "type": "text/plain" }, "url": { "path": [ "v1", "cards", "onboarding" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "c1bd862f-de52-4183-9eb3-de56b78e15b6", "name": "Situação atualizada.", "originalRequest": { "url": { "path": [ "v1", "cards", "onboarding" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"onboarding\": {\n \"terms\": [\n {\n \"id\": \"nisi nostrud cupidatat ad est\",\n \"version\": \"ea amet aliqua labore aute\",\n \"providerTerms\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"clientTerms\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"accepted\": false\n },\n {\n \"id\": \"ex nisi mollit in\",\n \"version\": \"Duis voluptate sunt cillum\",\n \"providerTerms\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"clientTerms\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"accepted\": true\n }\n ],\n \"termsAccepted\": true,\n \"eligibility\": \"NOT_STARTED\",\n \"canRequestVirtual\": false,\n \"eligibilityDetail\": \"dolore fugiat sunt ipsum\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d8272430-e120-43d8-8353-1d1908ade52f", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "cards", "onboarding" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8a819799-580a-453d-b930-4df49a6b631f", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "cards", "onboarding" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7f935473-6d49-4734-aff9-373c9d2e030b", "name": "A instalação não é `PREPAID` (`CONFLICT`).", "originalRequest": { "url": { "path": [ "v1", "cards", "onboarding" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cf52a486-c364-448b-8dc3-dcfe7349965d", "name": "Termo de uso não aceito (`CARD_TERMS_REQUIRED`).", "originalRequest": { "url": { "path": [ "v1", "cards", "onboarding" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c8eeebae-c948-4ec9-a558-9eb5395b74fd", "name": "O arranjo de pagamento está indisponível. Tente novamente.", "originalRequest": { "url": { "path": [ "v1", "cards", "onboarding" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b2173976-77e1-4121-b2c7-4b26e3f3b514", "name": "Bloqueia ou desbloqueia o cartão", "request": { "name": "Bloqueia ou desbloqueia o cartão", "description": { "content": "`{blocked: true}` bloqueia sem segundo fator, em qualquer situação da\nconta: é a ação de quem perdeu o cartão. `{blocked: false}` desbloqueia\ne **exige `X-Step-Up`** com `purpose: card` e a conta ativa.\n\nNo `PREPAID` a situação só muda depois de o emissor aceitar; o cartão\nbloqueado pela instituição (`blockedBy: INSTITUTION`) não se\ndesbloqueia por aqui (`CARD_BLOCKED_BY_INSTITUTION`). Cartão cancelado\nresponde `409 CONFLICT`. Cartão de outra conta responde `404`, sem\ndistinguir. Fica no histórico de segurança (`CARD_STATUS`).\nOperação: leva `X-Client-Location`. Só com sessão de cliente.\n", "type": "text/plain" }, "url": { "path": [ "v1", "cards", ":id", "block" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "disabled": true, "description": "Exigido só para desbloquear, com `purpose` card.", "key": "X-Step-Up", "value": "consequat" }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"blocked\": false\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "491d1385-10d5-4138-b112-67c67d3b45f1", "name": "O cartão com a situação nova.", "originalRequest": { "url": { "path": [ "v1", "cards", ":id", "block" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Exigido só para desbloquear, com `purpose` card.", "key": "X-Step-Up", "value": "consequat" }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"blocked\": false\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"sed cillum Lorem do\",\n \"kind\": \"PHYSICAL\",\n \"status\": \"CANCELED\",\n \"label\": \"officia labore id\",\n \"holder\": \"qui eiusmod do anim enim\",\n \"last4\": \"aute exercitation veniam m\",\n \"masked\": \"dolor cupidatat aute non\",\n \"brand\": \"minim\",\n \"createdAt\": \"1984-07-09T12:42:38.285Z\",\n \"statusAt\": \"2008-04-23T02:27:47.125Z\",\n \"expiry\": \"velit dolore adipisicing\",\n \"blockedBy\": \"CUSTOMER\",\n \"cancelReason\": \"LOST\",\n \"limitCents\": 41929555,\n \"invoice\": {}\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "acd5039d-8210-45ef-8c51-e948603ef25a", "name": "Requisição malformada ou com dado inválido", "originalRequest": { "url": { "path": [ "v1", "cards", ":id", "block" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Exigido só para desbloquear, com `purpose` card.", "key": "X-Step-Up", "value": "consequat" }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"blocked\": false\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "59650bbf-ab9a-4e6e-8a57-c4918af4a757", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "cards", ":id", "block" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Exigido só para desbloquear, com `purpose` card.", "key": "X-Step-Up", "value": "consequat" }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"blocked\": false\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "000150e8-93f7-4689-b40d-77e4bfc73b64", "name": "Falta o `X-Step-Up` para desbloquear (`STEP_UP_REQUIRED`), ou a conta não está ativa (`FORBIDDEN`).", "originalRequest": { "url": { "path": [ "v1", "cards", ":id", "block" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Exigido só para desbloquear, com `purpose` card.", "key": "X-Step-Up", "value": "consequat" }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"blocked\": false\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "98507bf4-2f82-4acd-af66-7d9ed0685952", "name": "Registro não encontrado", "originalRequest": { "url": { "path": [ "v1", "cards", ":id", "block" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Exigido só para desbloquear, com `purpose` card.", "key": "X-Step-Up", "value": "consequat" }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"blocked\": false\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "df0b6360-a194-4946-9539-484eb850544c", "name": "Cartão cancelado (`CONFLICT`), bloqueado pela instituição\n(`CARD_BLOCKED_BY_INSTITUTION`) ou ainda não confirmado pelo\nemissor (`CARD_NOT_ACTIVE`).\n", "originalRequest": { "url": { "path": [ "v1", "cards", ":id", "block" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Exigido só para desbloquear, com `purpose` card.", "key": "X-Step-Up", "value": "consequat" }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"blocked\": false\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c502113c-7064-4286-8ecb-a9d940d282bb", "name": "O arranjo de pagamento está indisponível. Tente novamente.", "originalRequest": { "url": { "path": [ "v1", "cards", ":id", "block" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": true, "description": "Exigido só para desbloquear, com `purpose` card.", "key": "X-Step-Up", "value": "consequat" }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"blocked\": false\n}", "options": { "raw": { "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f6ca06ed-2de5-462e-8a2f-d7041b05e8e3", "name": "Cancela o cartão", "request": { "name": "Cancela o cartão", "description": { "content": "Cancelamento definitivo, com o motivo: não tem volta. Vale nos dois\nprodutos e em qualquer situação da conta. **Exige `X-Step-Up`** com\n`purpose: card` e `Idempotency-Key`. No `PREPAID` o cancelamento é\nfeito no emissor primeiro; se ele não responder, o cartão fica\nbloqueado (o lado mais restritivo) e a resposta é `503`. Pedido ainda\nnão confirmado pelo emissor responde `CARD_NOT_ACTIVE`. Fica no\nhistórico de segurança (`CARD_STATUS`). Operação: leva\n`X-Client-Location`. Só com sessão de cliente.\n", "type": "text/plain" }, "url": { "path": [ "v1", "cards", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"reason\": \"STOLEN\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "a69e2ed4-4e68-4e5c-9184-5f37bfbed79e", "name": "Cartão cancelado.", "originalRequest": { "url": { "path": [ "v1", "cards", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"reason\": \"STOLEN\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"card\": {\n \"id\": \"commodo eiusmod aliqua\",\n \"kind\": \"PHYSICAL\",\n \"status\": \"BLOCKED\",\n \"label\": \"velit incididunt ad\",\n \"holder\": \"Ut dolor irure\",\n \"last4\": \"qui labore et\",\n \"masked\": \"cillum consequat nulla non Excepteur\",\n \"brand\": \"ullamco amet laboris velit tempor\",\n \"createdAt\": \"1971-02-23T13:30:33.411Z\",\n \"statusAt\": \"1957-08-18T19:42:44.587Z\",\n \"expiry\": \"ut et nostrud\",\n \"blockedBy\": \"INSTITUTION\",\n \"cancelReason\": \"INSTITUTION\",\n \"limitCents\": 27520484,\n \"invoice\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "79b9c11b-98f5-48a7-9cb4-429a12424f1d", "name": "Requisição malformada ou com dado inválido", "originalRequest": { "url": { "path": [ "v1", "cards", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"reason\": \"STOLEN\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e0ddd7ff-2618-460f-80b2-b5f78e337136", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "cards", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"reason\": \"STOLEN\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "deb7a0f3-3563-4cc5-9ec0-871338ecc9cc", "name": "Falta o `X-Step-Up` (`STEP_UP_REQUIRED`), ou a funcionalidade desligada (`FEATURE_DISABLED`).", "originalRequest": { "url": { "path": [ "v1", "cards", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"reason\": \"STOLEN\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "88fce7b8-2279-4ac0-ae3f-36f5d89a1ccc", "name": "Registro não encontrado", "originalRequest": { "url": { "path": [ "v1", "cards", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"reason\": \"STOLEN\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "afba4d3c-00ca-4260-b42c-1875dad21b67", "name": "Cartão já cancelado (`CONFLICT`), pedido ainda não confirmado (`CARD_NOT_ACTIVE`), ou a mesma `Idempotency-Key` com outro corpo (`IDEMPOTENCY_KEY_REUSED`).", "originalRequest": { "url": { "path": [ "v1", "cards", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"reason\": \"STOLEN\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "30fdffb5-9b7a-4c16-b008-4f1231a4b4bb", "name": "Motivo fora da lista (`INVALID_REQUEST`).", "originalRequest": { "url": { "path": [ "v1", "cards", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"reason\": \"STOLEN\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6f8ae6df-dc96-4ef6-874e-1999e7286f10", "name": "O arranjo de pagamento está indisponível. Tente novamente.", "originalRequest": { "url": { "path": [ "v1", "cards", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"reason\": \"STOLEN\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3b38de55-37a6-4c93-b67d-c9b5f0f6f858", "name": "Abre a página segura com os dados do cartão", "request": { "name": "Abre a página segura com os dados do cartão", "description": { "content": "Só no `PREPAID` (no `CREDIT` responde `CARD_USE_REVEAL`). Devolve a URL\nde **uso único** da página segura do emissor, onde aparecem número,\nvalidade e código de segurança: esses dados nunca passam pelo Lume.\nAbra a URL em seguida, numa aba nova ou no navegador do app; vencida\n(`expiresIn`, em segundos) ou já aberta, peça outra.\n\nA URL é credencial: a resposta vem com `Cache-Control: no-store`, e o\nLume não a grava, não a registra em log nem a devolve em erro. **Exige\n`X-Step-Up`** com `purpose: card`, a conta ativa e o cartão `ACTIVE`\n(`CARD_NOT_ACTIVE`). Fica no histórico de segurança\n(`CARD_REVEALED`). Operação: leva `X-Client-Location`. Só com sessão\nde cliente.\n", "type": "text/plain" }, "url": { "path": [ "v1", "cards", ":id", "secure-view" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"purpose\": \"SENSITIVE_DATA\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "bee3e113-c211-493d-a7b1-2c2fae0988e6", "name": "A URL de uso único.", "originalRequest": { "url": { "path": [ "v1", "cards", ":id", "secure-view" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"purpose\": \"SENSITIVE_DATA\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "disabled": true, "key": "Cache-Control", "value": "no-store", "description": "" }, { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"url\": \"https://J.mcpanFPeBNFAJlS+jR1Qnz-n1TBsqYct\",\n \"expiresIn\": 55844075\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cf5abe9c-b448-4dcc-90fa-1d9f41557679", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "cards", ":id", "secure-view" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"purpose\": \"SENSITIVE_DATA\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b7f0586c-fe2b-4672-85d6-59492d3dfae9", "name": "Falta o `X-Step-Up` (`STEP_UP_REQUIRED`), ou a conta não está ativa (`FORBIDDEN`).", "originalRequest": { "url": { "path": [ "v1", "cards", ":id", "secure-view" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"purpose\": \"SENSITIVE_DATA\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dc045b7d-00ed-40d2-a895-73ec91d389b4", "name": "Registro não encontrado", "originalRequest": { "url": { "path": [ "v1", "cards", ":id", "secure-view" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"purpose\": \"SENSITIVE_DATA\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f38c3ab7-d947-4742-acab-07687bd8eda9", "name": "Cartão não ativo (`CARD_NOT_ACTIVE`), cancelado (`CONFLICT`), ou instalação `CREDIT` (`CARD_USE_REVEAL`).", "originalRequest": { "url": { "path": [ "v1", "cards", ":id", "secure-view" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"purpose\": \"SENSITIVE_DATA\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c4a0cea2-c41f-4126-ac45-09889b0d2d46", "name": "Propósito fora da lista (`INVALID_REQUEST`).", "originalRequest": { "url": { "path": [ "v1", "cards", ":id", "secure-view" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"purpose\": \"SENSITIVE_DATA\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fea57fd8-7f8d-44d9-83f4-56996ccda8a9", "name": "O arranjo de pagamento está indisponível. Tente novamente.", "originalRequest": { "url": { "path": [ "v1", "cards", ":id", "secure-view" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Identifica o aparelho de origem. Entra na avaliação de risco: uma\ntransferência de madrugada, de um aparelho nunca visto, para uma chave\nnunca usada é um padrão diferente da mesma transferência de dia.\n", "key": "X-Device-Fingerprint", "value": "b7f3c1e9a2d84f60" }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"purpose\": \"SENSITIVE_DATA\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "530b7953-0170-4dcc-b22f-90f05ac24e07", "name": "Mostra o número do cartão de crédito", "request": { "name": "Mostra o número do cartão de crédito", "description": { "content": "Só no `CREDIT` (no `PREPAID` responde `CARD_USE_SECURE_VIEW`: use\n`secure-view`). Devolve número, código de segurança e validade,\npedidos ao emissor agora e não gravados. **Exige `X-Step-Up`** com\n`purpose: card`, gasto nesta operação. Fica no histórico de segurança\n(`CARD_REVEALED`). Só com sessão de cliente.\n", "type": "text/plain" }, "url": { "path": [ "v1", "cards", ":id", "reveal" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "baab150d-e68f-4ba9-898d-4595ede1111e", "name": "Os dados do cartão.", "originalRequest": { "url": { "path": [ "v1", "cards", ":id", "reveal" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"Lorem mollit ad\",\n \"number\": \"dolore consectetur non commodo\",\n \"cvv\": \"tempor officia sit\",\n \"expiry\": \"09/30\",\n \"holder\": \"sit cillum\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4865fcea-84cc-457a-a180-4d57968197e4", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "cards", ":id", "reveal" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1e4da5b0-e613-4a26-96d6-e53bc782a67d", "name": "Falta a confirmação de segundo fator (`STEP_UP_REQUIRED`). Chame\n`POST /v1/auth/step-up` e repita com o cabeçalho `X-Step-Up`.\n", "originalRequest": { "url": { "path": [ "v1", "cards", ":id", "reveal" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "da25f818-fce6-45fc-9cdc-0744cc806af1", "name": "Registro não encontrado", "originalRequest": { "url": { "path": [ "v1", "cards", ":id", "reveal" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8399819f-5347-4019-b2a9-e0b289683731", "name": "Cartão cancelado ou sem registro no emissor (`CONFLICT`), ou instalação `PREPAID` (`CARD_USE_SECURE_VIEW`).", "originalRequest": { "url": { "path": [ "v1", "cards", ":id", "reveal" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2e11fffd-f94f-488e-97a0-c0f30fe1d019", "name": "O arranjo de pagamento está indisponível. Tente novamente.", "originalRequest": { "url": { "path": [ "v1", "cards", ":id", "reveal" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a85800c2-b7ab-47a9-8efb-b12f205c6bf9", "name": "Compras do cartão", "request": { "name": "Compras do cartão", "description": { "content": "Só no `PREPAID`. As transações do cartão como o emissor avisou, das\nmais recentes, até 50, inclusive as recusadas (`approved: false`, sem\n`transactionId`: não mexeram no saldo). A aprovada que moveu dinheiro\ntraz `transactionId`, a transação do extrato da conta\n(`CARD_PURCHASE`, `CARD_REFUND`; a tarifa de saque é uma `CARD_FEE` à\nparte). Leitura: não precisa de localização. Só com sessão de cliente.\n", "type": "text/plain" }, "url": { "path": [ "v1", "cards", ":id", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "a0dae9bc-e0e9-4e8c-a457-fbecc6d70893", "name": "As compras do cartão.", "originalRequest": { "url": { "path": [ "v1", "cards", ":id", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"items\": [\n {\n \"id\": \"dolor\",\n \"type\": \"nisi exercitation dolor\",\n \"approved\": true,\n \"amountCents\": 61293020,\n \"feeCents\": 11480501,\n \"occurredAt\": \"1968-02-02T13:57:29.022Z\",\n \"statusDetail\": \"la\",\n \"merchant\": \"exercitation Duis repre\",\n \"city\": \"aliqu\",\n \"entryMode\": \"id proident ad sed\",\n \"transactionId\": \"elit do\"\n },\n {\n \"id\": \"pariatur nulla reprehenderit incididunt\",\n \"type\": \"labore sunt consectetur\",\n \"approved\": true,\n \"amountCents\": 50787730,\n \"feeCents\": 73819473,\n \"occurredAt\": \"1994-11-11T04:25:05.009Z\",\n \"statusDetail\": \"nostrud\",\n \"merchant\": \"aliquip Ut tempor\",\n \"city\": \"reprehenderit Excepteur irure\",\n \"entryMode\": \"proident Duis anim cupidatat\",\n \"transactionId\": \"Lorem veniam consectetur aliqua tempor\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2b9144c8-70b0-48bf-80ea-715b41eb8a58", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "cards", ":id", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "29295e81-039e-4335-9da2-90e6c26373e8", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "cards", ":id", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0f9b621b-01a1-45a6-8057-8fd43cca8691", "name": "Registro não encontrado", "originalRequest": { "url": { "path": [ "v1", "cards", ":id", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d7c2c6fc-464e-4c2c-9b0c-a48f2d110c3d", "name": "A instalação não é `PREPAID` (`CONFLICT`).", "originalRequest": { "url": { "path": [ "v1", "cards", ":id", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "38e16f4e-2487-45f0-8636-4e98383a8848", "name": "Notificações", "description": { "content": "O endereço que o provedor financeiro chama. Não é chamado pela sua\nintegração — está aqui porque quem instala o Lume precisa configurá-lo\nno painel do provedor, e porque o formato da assinatura é o que decide\nse a notificação será aceita.\n\n**Os webhooks que o Lume envia para a sua URL** estão na seção\n`webhooks` deste contrato (`transaction.updated` e `ping`). O cadastro\nda URL é feito pelo banco, a pedido: você informa o endereço `https`,\nrecebe o segredo da assinatura uma única vez e passa a receber cada\nmudança de estado das transações da conta, assinada.\n", "type": "text/plain" }, "item": [ { "id": "4cc8bf8c-2222-4603-95e3-facfa7b0b9de", "name": "Recebe uma notificação do provedor financeiro", "request": { "name": "Recebe uma notificação do provedor financeiro", "description": { "content": "Chamado pelo provedor, e nunca pela sua integração. Documentado aqui\nporque quem instala o Lume precisa registrar esta URL no painel do\nprovedor e configurar o mesmo segredo dos dois lados.\n\n`{provider}` precisa ser o provedor configurado nesta instalação;\nqualquer outro nome responde `404`. Não há autenticação por sessão nem\npor chave de API: o que autentica é a assinatura da notificação.\n\n## Assinatura\n\nO esquema de assinatura e o formato da resposta são os do provedor\nconfigurado nesta instalação. Os provedores que assinam o corpo usam\nHMAC-SHA256 do corpo exatamente como trafegou, em hexadecimal, no\ncabeçalho de assinatura do provedor. O corpo entra byte a byte —\nreserializar o JSON antes de assinar muda espaços e ordem de campos, e\na assinatura deixa de bater por um motivo que nada tem a ver com\nautenticidade. O esquema da Azify, que é diferente, está na subseção\nabaixo.\n\nSem segredo configurado, toda notificação é recusada. É deliberado:\nausência de configuração não pode virar endereço aberto, porque esta\nrota altera o estado de transações financeiras.\n\n### Provedor `azify`\n\nCada entrega traz três cabeçalhos:\n\n- `x-nonce`: UUID, único por entrega;\n- `x-timestamp`: milissegundos desde a época, como texto;\n- `x-signature`: 64 caracteres hexadecimais.\n\nA assinatura é o HMAC-SHA256, em hexadecimal, de\n`JSON.stringify(corpo) + x-timestamp + x-nonce`, com `x-timestamp` e\n`x-nonce` no valor literal dos cabeçalhos. O Lume recalcula o\n`JSON.stringify` do corpo recebido, então espaços, ordem de chaves\nnuméricas, `1.0` e escapes unicode não derrubam uma entrega autêntica.\nA comparação é em tempo constante.\n\nUma entrega é recusada com `401` quando falta um dos cabeçalhos, o\n`x-timestamp` está a mais de 5 minutos do relógio do servidor (para\nmais ou para menos), a assinatura não confere, ou o `x-nonce` já foi\nusado, ou quando o corpo não é uma entrega (sem nome de evento, ou com\na chave `success` na raiz, que é o formato das respostas do Lume). O\nnonce só é registrado depois de a assinatura ser válida e fica\nlembrado por 10 minutos, entre instâncias e reinícios.\n\nA resposta também é assinada, pelo mesmo algoritmo e com o mesmo\nsegredo, sobre os bytes do corpo devolvido. Sem ela a Azify considera a\nentrega falha e reenvia. Em todas as respostas (`200`, `400`, `401`,\n`413` e `500`):\n\n- `x-webhook-version: webhook-version-2`;\n- `x-nonce` e `x-timestamp` novos, gerados pelo Lume;\n- `x-signature`.\n\nO corpo é `{\"success\":true,\"message\":\"ok\"}` no `200` (inclusive no\nevento repetido) e `{\"success\":false,\"message\":\"...\"}` nas recusas e\nerros. Falha ao gravar o evento responde `500` assinado, para a Azify\ntentar de novo.\n\nO caminho aceita query string sem efeito sobre a validação, o que\npermite registrar uma URL distinta por contexto\n(`/v1/webhooks/azify?canal=...`).\n\n## O que o `200` promete\n\nQue a notificação foi recebida, autenticada e gravada — e só isso. Se\nela foi aplicada é outra pergunta, respondida depois: o que falhar ao\nser aplicado fica pendente e é repetido. Reenviar o mesmo evento é\nseguro e devolve `duplicate` (nos provedores que respondem com o JSON\nabaixo; a Azify devolve o mesmo corpo de sucesso, assinado). Na Azify\na resposta sai antes de o evento ser aplicado.\n", "type": "text/plain" }, "url": { "path": [ "v1", "webhooks", ":provider" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "celcoin", "key": "provider", "description": "(Required) Nome do provedor configurado na instalação." } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "0fa0826e-1f14-415b-b277-b212ee524c4c", "name": "Recebida e guardada. `duplicate` quando o evento já tinha chegado —\nresponder `200` de novo é o que faz o provedor parar de reenviar.\n\nProvedor `azify`: corpo `{\"success\":true,\"message\":\"ok\"}`, com os\ncabeçalhos `x-webhook-version`, `x-nonce`, `x-timestamp` e\n`x-signature`, no evento novo e no repetido.\n", "originalRequest": { "url": { "path": [ "v1", "webhooks", ":provider" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "celcoin", "key": "provider", "description": "(Required) Nome do provedor configurado na instalação." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"received\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4096a3ec-44b2-4327-aa13-a32ab3de3cad", "name": "Corpo ilegível ou em formato inesperado. Na Azify, o corpo é\n`{\"success\":false,\"message\":\"...\"}`, assinado.\n", "originalRequest": { "url": { "path": [ "v1", "webhooks", ":provider" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "celcoin", "key": "provider", "description": "(Required) Nome do provedor configurado na instalação." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "666345e1-fddb-49af-95cc-556ed9e3e85c", "name": "Assinatura ausente, inválida, ou segredo não configurado nesta\ninstalação. Na Azify, também: cabeçalho ausente ou malformado,\n`x-timestamp` fora de ±5 minutos e `x-nonce` repetido. O corpo é\n`{\"success\":false,\"message\":\"...\"}`, assinado quando há segredo.\n", "originalRequest": { "url": { "path": [ "v1", "webhooks", ":provider" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "celcoin", "key": "provider", "description": "(Required) Nome do provedor configurado na instalação." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d8942c3f-ddaa-41c8-84c0-9ff708283ba5", "name": "O nome não corresponde ao provedor desta instalação.", "originalRequest": { "url": { "path": [ "v1", "webhooks", ":provider" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "celcoin", "key": "provider", "description": "(Required) Nome do provedor configurado na instalação." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ee0e9f87-55c9-4496-9f19-76db2a67c60a", "name": "Corpo acima de 1 MiB (256 KiB na Azify).", "originalRequest": { "url": { "path": [ "v1", "webhooks", ":provider" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "celcoin", "key": "provider", "description": "(Required) Nome do provedor configurado na instalação." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } } }, "status": "Request Entity Too Large", "code": 413, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cb64c292-d2e3-49ca-86bf-6b435afc2671", "name": "Falha ao gravar a notificação. O provedor deve tentar de novo; na\nAzify, a resposta é assinada.\n", "originalRequest": { "url": { "path": [ "v1", "webhooks", ":provider" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "celcoin", "key": "provider", "description": "(Required) Nome do provedor configurado na instalação." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aad8e30d-e39f-44c9-b2ef-7e5a95361fc9", "name": "O provedor configurado não sabe validar a própria assinatura. Um\nadaptador que não valida não recebe notificação — aceitar sem\nverificar seria pior do que não receber.\n", "originalRequest": { "url": { "path": [ "v1", "webhooks", ":provider" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "celcoin", "key": "provider", "description": "(Required) Nome do provedor configurado na instalação." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } } }, "status": "Not Implemented", "code": 501, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "2c2b970b-10fb-469e-803c-35e186678418", "name": "Indicação", "description": { "content": "A rede de indicação de quem está na sessão: resumo, indicados diretos e\nganhos. Só leitura e só de sessão. Indicado indireto aparece só em\nnúmero, nunca com nome.\n", "type": "text/plain" }, "item": [ { "id": "508a1d76-7c11-4abe-bb3d-969afc423b7c", "name": "Código, link e indicações de quem está na sessão", "request": { "name": "Código, link e indicações de quem está na sessão", "description": { "content": "O código de indicação do titular e quem abriu conta por ele. O código é\ncriado na primeira leitura e não muda depois: 8 caracteres de\n`ABCDEFGHJKMNPQRSTUVWXYZ23456789`.\n\n`path` é o **caminho** do convite no internet banking\n(`/abrir-conta?convite=`), relativo ao domínio de quem publica o\nfront; o servidor não devolve URL absoluta. Quem não tem esse domínio\nmostra só o código, que a abertura de conta aceita como\n`referralCode`.\n\n`rewardCents` é o cashback vigente por conta aberta e aprovada; zero\nquando a instalação não paga. `items` traz todas as indicações, da mais\nrecente para a mais antiga, sem paginação; o nome vem abreviado\n(primeiro nome e inicial do último). `rewardCents` de cada item é o\nque foi pago: zero enquanto não aprovada ou quando a instalação não\npaga. `approved` conta as aprovadas e `earnedCents` soma o que elas\npagaram.\n\nSó com sessão de cliente: **não** aceita chave de API. Com a indicação\n(`referrals`) desligada, `403 FEATURE_DISABLED`.\n", "type": "text/plain" }, "url": { "path": [ "v1", "referrals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "c9181872-7db0-4d26-b033-1f35c1d0e1d6", "name": "Código e indicações", "originalRequest": { "url": { "path": [ "v1", "referrals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"K7MZQ2PA\",\n \"path\": \"/abrir-conta?convite=K7MZQ2PA\",\n \"rewardCents\": 59216217,\n \"items\": [\n {\n \"id\": \"tempor fugiat\",\n \"name\": \"Helena B.\",\n \"status\": \"pending\",\n \"rewardCents\": 39605863,\n \"createdAt\": \"1958-01-09T08:09:47.022Z\",\n \"resolvedAt\": \"2008-06-13T00:08:31.430Z\"\n },\n {\n \"id\": \"incididunt\",\n \"name\": \"Helena B.\",\n \"status\": \"pending\",\n \"rewardCents\": 28875692,\n \"createdAt\": \"1969-02-13T03:35:40.013Z\",\n \"resolvedAt\": \"2014-11-19T06:13:55.600Z\"\n }\n ],\n \"approved\": 47233121,\n \"earnedCents\": 29115830\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2f503ce4-6390-4b7f-882b-84255fc87b86", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "referrals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "565f6669-bbd0-47e8-895f-7b9b9626530d", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "referrals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "27d346a9-c109-459a-a6ff-afd935a71acb", "name": "Resumo da rede de indicação", "request": { "name": "Resumo da rede de indicação", "description": { "content": "A rede de quem está na sessão, até dois níveis (`depth: 2`): os\nindicados diretos (que abriram conta pelo link) e os indicados por\neles (indiretos). Diretos vêm por situação da indicação (`pending`,\nem análise; `approved`; `rejected`); indiretos, **só em número**.\n\nNão há contagem de indicados \"ativos\" (nem `activeRule`) nesta\nresposta: com poucos indicados, ela revelaria a situação da conta de\numa pessoa que o cliente vê nomeada na lista. Essa contagem só existe\nno backoffice.\n\n`commissions` soma os ganhos de indicação: `receivedCents` (pagos),\n`toReceiveCents` (a receber; inclui o cashback das indicações em\nanálise, **estimado** pela oferta atual `rewardCents`) e\n`cancelledCents`. O link e o código de indicação estão em\n`GET /v1/referrals`.\n\nNada aqui credita saldo. Só com sessão de cliente: **não** aceita\nchave de API. Com a indicação (`referrals`) ou a rede\n(`affiliate_network`) desligada, `403 FEATURE_DISABLED`.\n", "type": "text/plain" }, "url": { "path": [ "v1", "referrals", "network" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "64bab849-4864-420b-93c0-5bdcfd28b416", "name": "Resumo", "originalRequest": { "url": { "path": [ "v1", "referrals", "network" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"depth\": 2,\n \"direct\": {\n \"total\": 58571738,\n \"pending\": 95699262,\n \"approved\": 343919,\n \"rejected\": 34382193\n },\n \"indirect\": {\n \"total\": 28623747\n },\n \"commissions\": {\n \"receivedCents\": 67143150,\n \"toReceiveCents\": 50165168,\n \"cancelledCents\": 22380514\n },\n \"rewardCents\": 6734792\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3cbfe42c-0bba-4558-8412-caa7c3c4f40f", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "referrals", "network" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "65143009-62a6-467c-beb1-3064c20a185f", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "referrals", "network" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "954b4fcb-eaba-4b1a-ab20-f6601ca1e557", "name": "Indicados diretos", "request": { "name": "Indicados diretos", "description": { "content": "Quem abriu conta pelo link de quem está na sessão, da indicação mais\nrecente para a mais antiga. O nome vem abreviado (primeiro nome e\ninicial do último); documento, contato e a situação da conta da pessoa\nnão vêm (quantos estão ativos está no resumo). `indirectCount` é\nquantas pessoas aquele indicado indicou (só o número). `id` é o da\nindicação, não o da pessoa.\n\nPágina por `limit` (1 a 200, padrão 50) e `offset`; fora da faixa,\n`422 INVALID_REQUEST`. Só com sessão de cliente. Com `referrals` ou\n`affiliate_network` desligada, `403 FEATURE_DISABLED`.\n", "type": "text/plain" }, "url": { "path": [ "v1", "referrals", "network", "direct" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": true, "key": "limit", "value": "50" }, { "disabled": true, "key": "offset", "value": "0" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "e809b131-e65f-44c3-92b3-97942383f7d7", "name": "Página de indicados diretos", "originalRequest": { "url": { "path": [ "v1", "referrals", "network", "direct" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "offset", "value": "0" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"items\": [\n {\n \"id\": \"ex cillum aliquip\",\n \"name\": \"Rosalina A.\",\n \"status\": \"approved\",\n \"indirectCount\": 89519468,\n \"createdAt\": \"1995-05-31T04:27:20.616Z\",\n \"resolvedAt\": \"2005-02-28T10:32:09.866Z\"\n },\n {\n \"id\": \"ea\",\n \"name\": \"Rosalina A.\",\n \"status\": \"approved\",\n \"indirectCount\": 14214189,\n \"createdAt\": \"1986-09-06T06:40:43.390Z\",\n \"resolvedAt\": \"1963-09-13T15:48:32.919Z\"\n }\n ],\n \"total\": 83696127,\n \"limit\": 23520782,\n \"offset\": 50133537\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "431a8ed0-9cf2-4979-b7dc-34f323730743", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "referrals", "network", "direct" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "offset", "value": "0" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ae471a7e-2522-4beb-a7a6-2b07ddcca8d1", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "referrals", "network", "direct" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "offset", "value": "0" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b858d864-d9a0-49ea-979a-9a51d4ba3c3e", "name": "Requisição malformada ou com dado inválido", "originalRequest": { "url": { "path": [ "v1", "referrals", "network", "direct" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "offset", "value": "0" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "d462bc4c-1453-4375-b6f5-db4d6cc9663f", "name": "Ganhos de indicação", "request": { "name": "Ganhos de indicação", "description": { "content": "Os ganhos de indicação de quem está na sessão, do mais recente para o\nmais antigo, e os totais por situação (`totals`, sem o filtro).\n\n`kind` é a origem: `cashback_abertura` (conta aberta e aprovada),\n`produto`, `lucro` ou `tpv`. Hoje só o cashback de abertura gera\nganho; as outras origens estão no contrato e ainda não têm cálculo.\n`status`: `a_receber`, `paga` ou `cancelada`. `estimated: true` marca\no cashback de uma indicação ainda em análise, estimado pela oferta\natual: só vira `paga` se o cadastro for aprovado, e pode não vir.\nIndicação reprovada ou aprovada sem valor não aparece.\n\n`originName` (abreviado) só vem quando quem gerou o ganho é indicado\ndireto. Nada aqui credita saldo: o cashback pago aparece no extrato\ncomo `CASHBACK`.\n\nPágina como em `GET /v1/referrals/network/direct`. Só com sessão de\ncliente. Com `referrals` ou `affiliate_network` desligada,\n`403 FEATURE_DISABLED`.\n", "type": "text/plain" }, "url": { "path": [ "v1", "referrals", "commissions" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": true, "key": "status", "value": "paga" }, { "disabled": true, "key": "limit", "value": "50" }, { "disabled": true, "key": "offset", "value": "0" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "e05c73a9-7267-4b24-ae00-8a001dc9fd2c", "name": "Página de ganhos", "originalRequest": { "url": { "path": [ "v1", "referrals", "commissions" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "status", "value": "paga" }, { "key": "limit", "value": "50" }, { "key": "offset", "value": "0" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"items\": [\n {\n \"id\": \"proident cupidatat magna\",\n \"kind\": \"cashback_abertura\",\n \"status\": \"a_receber\",\n \"amountCents\": 54481255,\n \"estimated\": true,\n \"createdAt\": \"2012-06-28T22:47:49.477Z\",\n \"resolvedAt\": \"1958-01-01T11:33:28.014Z\",\n \"originName\": \"Rosalina A.\"\n },\n {\n \"id\": \"reprehenderit dolore\",\n \"kind\": \"tpv\",\n \"status\": \"paga\",\n \"amountCents\": 47487270,\n \"estimated\": false,\n \"createdAt\": \"1964-12-26T09:29:07.859Z\",\n \"resolvedAt\": \"1977-01-30T12:23:46.312Z\",\n \"originName\": \"Rosalina A.\"\n }\n ],\n \"total\": 35389725,\n \"limit\": 16956496,\n \"offset\": 79269916,\n \"totals\": {\n \"receivedCents\": 9376212,\n \"toReceiveCents\": 94321066,\n \"cancelledCents\": 34189017\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bb17b12f-540a-4034-96b3-cbdea337f9a7", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "referrals", "commissions" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "status", "value": "paga" }, { "key": "limit", "value": "50" }, { "key": "offset", "value": "0" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dda7873b-3a42-4a65-831d-e1f8bdb4fcf4", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "referrals", "commissions" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "status", "value": "paga" }, { "key": "limit", "value": "50" }, { "key": "offset", "value": "0" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2439deba-3547-4013-ae1d-9e1d5ccd60d3", "name": "Requisição malformada ou com dado inválido", "originalRequest": { "url": { "path": [ "v1", "referrals", "commissions" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "status", "value": "paga" }, { "key": "limit", "value": "50" }, { "key": "offset", "value": "0" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "747dcbbe-8271-4965-98a9-f5278042ef82", "name": "Estabelecimento", "description": { "content": "O portal de quem recebe por maquininha ou link (funcionalidade\n`merchant_portal`): resumo de vendas, lista e detalhe das vendas e a\nagenda de recebíveis (lançamentos futuros). Só leitura e só de sessão:\numa chave de API recebe `403 FORBIDDEN`. Com a funcionalidade desligada,\n`403 FEATURE_DISABLED` (`details.feature: merchant_portal`).\n\nAs vendas e os recebíveis são uma cópia do adquirente, atualizada por uma\nrotina a cada poucos minutos (`merchant.lastSyncAt` diz quando foi a\núltima concluída; com muitas vendas, uma cópia pode levar várias\nvoltas). Valores sempre em centavos. Do cartão, no máximo a bandeira e os\nquatro últimos dígitos. A conta que ainda não foi credenciada pelo\natendimento recebe `404 NOT_FOUND` nestas rotas.\n", "type": "text/plain" }, "item": [ { "id": "ec2aac2f-214a-4cbb-a23d-2e7b6eed375b", "name": "Resumo do estabelecimento", "request": { "name": "Resumo do estabelecimento", "description": { "content": "Faturamento de hoje e do mês (só vendas aprovadas, `SUCCEEDED`), a\nprogressão de vendas dia a dia desde o dia 1º, a soma dos lançamentos\nfuturos (recebíveis agendados de hoje em diante) e o saldo da conta,\nque é o saldo do estabelecimento. \"Hoje\" e \"mês\" são no fuso da\noperação. `balance` vem nulo quando o saldo não pôde ser lido agora\n(nulo não é zero).\n", "type": "text/plain" }, "url": { "path": [ "v1", "merchant", "dashboard" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "ec3e2bc5-a07d-4c9a-a7ca-aa32884bf7d8", "name": "Resumo", "originalRequest": { "url": { "path": [ "v1", "merchant", "dashboard" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"merchant\": {\n \"id\": \"sunt velit \",\n \"tradeName\": \"minim reprehenderit\",\n \"status\": \"PENDING\",\n \"cardPresentEnabled\": false,\n \"onlineEnabled\": false,\n \"lastSyncAt\": \"2018-01-28T17:08:23.934Z\"\n },\n \"today\": {\n \"salesCount\": -72653919,\n \"grossCents\": 69190505,\n \"netCents\": 73274795\n },\n \"month\": {\n \"salesCount\": 47636200,\n \"grossCents\": -60952539,\n \"netCents\": -14414304,\n \"from\": \"2001-08-07\",\n \"to\": \"1950-12-17\"\n },\n \"dailySales\": [\n {\n \"date\": \"1955-08-27\",\n \"grossCents\": 56327451,\n \"netCents\": -63327995,\n \"salesCount\": 53261749\n },\n {\n \"date\": \"2013-09-05\",\n \"grossCents\": 82393722,\n \"netCents\": -8986287,\n \"salesCount\": 34217609\n }\n ],\n \"futureReceivables\": {\n \"count\": -98201331,\n \"grossCents\": -49650826,\n \"netCents\": -98574318\n },\n \"balance\": {\n \"balanceCents\": 28293864,\n \"heldCents\": 87599154,\n \"asOf\": \"1974-12-29T22:07:41.035Z\"\n },\n \"asOf\": \"1972-11-14T18:46:21.298Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "778d2008-ae99-4bf1-9fb3-dfb388090fa7", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "merchant", "dashboard" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "165a20a8-90df-4044-8f31-617b02c52489", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "merchant", "dashboard" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ef3d577e-152f-411e-94fd-1256207f791f", "name": "Esta conta não é um estabelecimento (`NOT_FOUND`).", "originalRequest": { "url": { "path": [ "v1", "merchant", "dashboard" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "07d8c27c-e5fe-4ada-95da-087ca3b88731", "name": "O arranjo de pagamento está indisponível. Tente novamente.", "originalRequest": { "url": { "path": [ "v1", "merchant", "dashboard" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5085de66-f52b-4c5a-8660-0ed72b52b0d8", "name": "Vendas do estabelecimento", "request": { "name": "Vendas do estabelecimento", "description": { "content": "Da mais nova para a mais antiga, 50 por página. Sem `from` e `to`, o\nmês corrente até hoje. O período tem no máximo 93 dias.\n", "type": "text/plain" }, "url": { "path": [ "v1", "merchant", "sales" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": true, "key": "from", "value": "2005-09-28", "description": "Primeiro dia (AAAA-MM-DD), no fuso da operação. Exige `to`." }, { "disabled": true, "key": "to", "value": "2005-09-28", "description": "Último dia, inclusive (AAAA-MM-DD). Exige `from`." }, { "disabled": true, "key": "status", "value": "consequat", "description": "Situações separadas por vírgula (`SUCCEEDED,REFUNDED`). Vazio, todas." }, { "disabled": true, "key": "page", "value": "1" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "074a4891-b49e-4a5e-87f2-dba243a0235f", "name": "Página de vendas", "originalRequest": { "url": { "path": [ "v1", "merchant", "sales" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "from", "value": "2005-09-28" }, { "key": "to", "value": "2005-09-28" }, { "key": "status", "value": "consequat" }, { "key": "page", "value": "1" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"items\": [\n {\n \"id\": \"fugiat Excepteur\",\n \"status\": \"SUCCEEDED\",\n \"method\": \"BOLETO\",\n \"channel\": \"ONLINE\",\n \"grossCents\": -65912579,\n \"feeCents\": -76448195,\n \"netCents\": 25997683,\n \"installments\": 95920395,\n \"authorizedAt\": \"1983-04-06T23:39:47.129Z\",\n \"cardBrand\": \"aliqua\",\n \"cardLast4\": \"1755\"\n },\n {\n \"id\": \"veniam labore\",\n \"status\": \"FAILED\",\n \"method\": \"BOLETO\",\n \"channel\": \"ONLINE\",\n \"grossCents\": 74199563,\n \"feeCents\": -1428034,\n \"netCents\": -49282664,\n \"installments\": 85838744,\n \"authorizedAt\": \"1984-11-09T07:32:50.079Z\",\n \"cardBrand\": \"enim labore Ut elit\",\n \"cardLast4\": \"1458\"\n }\n ],\n \"total\": -39857573,\n \"page\": -31000217,\n \"pageSize\": 40591162,\n \"from\": \"1978-03-11\",\n \"to\": \"1991-04-07\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ec91eaee-474a-48a9-b664-60f46015a0c6", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "merchant", "sales" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "from", "value": "2005-09-28" }, { "key": "to", "value": "2005-09-28" }, { "key": "status", "value": "consequat" }, { "key": "page", "value": "1" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f6a60a7c-be42-4195-9f2d-49559b5d7e18", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "merchant", "sales" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "from", "value": "2005-09-28" }, { "key": "to", "value": "2005-09-28" }, { "key": "status", "value": "consequat" }, { "key": "page", "value": "1" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "39cf6c6e-ff48-42c9-9093-ea0f2ef3978d", "name": "Esta conta não é um estabelecimento (`NOT_FOUND`).", "originalRequest": { "url": { "path": [ "v1", "merchant", "sales" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "from", "value": "2005-09-28" }, { "key": "to", "value": "2005-09-28" }, { "key": "status", "value": "consequat" }, { "key": "page", "value": "1" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4e4b1393-abff-4719-9e14-31e9b1184424", "name": "Data ilegível, período invertido ou longo demais, ou situação desconhecida (`INVALID_REQUEST`).", "originalRequest": { "url": { "path": [ "v1", "merchant", "sales" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "from", "value": "2005-09-28" }, { "key": "to", "value": "2005-09-28" }, { "key": "status", "value": "consequat" }, { "key": "page", "value": "1" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a167b25c-22bc-4dd1-8c1d-9876296a85a3", "name": "Detalhe de uma venda", "request": { "name": "Detalhe de uma venda", "description": { "content": "A venda e as parcelas a receber dela. Venda de outro estabelecimento responde como inexistente.", "type": "text/plain" }, "url": { "path": [ "v1", "merchant", "sales", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "98fa45a6-c758-41c9-a84e-1d5e8eafb3b2", "name": "Venda", "originalRequest": { "url": { "path": [ "v1", "merchant", "sales", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"authorizedAt\": \"1988-11-30T06:10:24.513Z\",\n \"channel\": \"ONLINE\",\n \"feeCents\": -8580473,\n \"grossCents\": -21956271,\n \"id\": \"Duis dolor sit\",\n \"installments\": 5191190,\n \"method\": \"BOLETO\",\n \"netCents\": 41389147,\n \"receivables\": [\n {\n \"id\": \"in ea\",\n \"status\": \"SCHEDULED\",\n \"installment\": 25026479,\n \"grossCents\": 77577862,\n \"netCents\": -72587158,\n \"expectedOn\": \"2023-10-25\",\n \"paidAt\": \"1947-09-21T16:04:02.670Z\",\n \"anticipated\": true\n },\n {\n \"id\": \"sed non nulla ullamco\",\n \"status\": \"REFUNDED\",\n \"installment\": 55310832,\n \"grossCents\": -27105403,\n \"netCents\": -84444186,\n \"expectedOn\": \"2024-07-22\",\n \"paidAt\": \"1995-04-22T14:05:53.054Z\",\n \"anticipated\": false\n }\n ],\n \"status\": \"FAILED\",\n \"cardBrand\": \"commodo nisi sint\",\n \"cardLast4\": \"4066\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c071d4f5-f2d1-4a74-b165-dedc7e89e003", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "merchant", "sales", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2ab0fab1-6109-46d7-b7c9-1bf60ec44ede", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "merchant", "sales", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a4b1f0a0-aa78-4b32-ba52-35a021df8771", "name": "Venda não encontrada, ou a conta não é um estabelecimento (`NOT_FOUND`).", "originalRequest": { "url": { "path": [ "v1", "merchant", "sales", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1f5c5713-bc3a-4789-9834-f2ba33923b1c", "name": "Agenda de recebíveis", "request": { "name": "Agenda de recebíveis", "description": { "content": "As parcelas a receber, pela data prevista (a mais próxima primeiro), 50\npor página, com os totais do filtro inteiro em `totals`. Sem `from` e\n`to`, de hoje a 90 dias. O período tem no máximo 93 dias.\n", "type": "text/plain" }, "url": { "path": [ "v1", "merchant", "receivables" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": true, "key": "from", "value": "2005-09-28", "description": "Primeira data prevista (AAAA-MM-DD). Exige `to`." }, { "disabled": true, "key": "to", "value": "2005-09-28", "description": "Última data prevista, inclusive (AAAA-MM-DD). Exige `from`." }, { "disabled": true, "key": "status", "value": "consequat", "description": "Situações separadas por vírgula (`SCHEDULED,PAID`). Vazio, todas." }, { "disabled": true, "key": "page", "value": "1" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "65a22a59-2202-4d48-910c-ad1231c27b0d", "name": "Página da agenda", "originalRequest": { "url": { "path": [ "v1", "merchant", "receivables" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "from", "value": "2005-09-28" }, { "key": "to", "value": "2005-09-28" }, { "key": "status", "value": "consequat" }, { "key": "page", "value": "1" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"items\": [\n {\n \"id\": \"elit tempor\",\n \"status\": \"CANCELED\",\n \"installment\": 93463086,\n \"grossCents\": -62412166,\n \"netCents\": -33215545,\n \"expectedOn\": \"1960-10-29\",\n \"paidAt\": \"1983-03-31T23:27:33.793Z\",\n \"anticipated\": false\n },\n {\n \"id\": \"adipisicing laborum ut\",\n \"status\": \"PAID\",\n \"installment\": 37910038,\n \"grossCents\": -43682333,\n \"netCents\": -86928394,\n \"expectedOn\": \"2023-08-02\",\n \"paidAt\": \"1971-05-17T12:08:39.236Z\",\n \"anticipated\": false\n }\n ],\n \"total\": -84522944,\n \"page\": 40917741,\n \"pageSize\": -85389900,\n \"from\": \"1997-10-31\",\n \"to\": \"2009-06-03\",\n \"totals\": {\n \"count\": 74376069,\n \"grossCents\": -25481025,\n \"netCents\": -24706294\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "84b01af1-6be6-4822-b581-d480db46e7b5", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "merchant", "receivables" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "from", "value": "2005-09-28" }, { "key": "to", "value": "2005-09-28" }, { "key": "status", "value": "consequat" }, { "key": "page", "value": "1" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aeb3ca4e-d67e-4d6f-ab4d-d88fc73122b6", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "merchant", "receivables" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "from", "value": "2005-09-28" }, { "key": "to", "value": "2005-09-28" }, { "key": "status", "value": "consequat" }, { "key": "page", "value": "1" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0d385ded-46ba-4380-9241-7087d0e22dce", "name": "Esta conta não é um estabelecimento (`NOT_FOUND`).", "originalRequest": { "url": { "path": [ "v1", "merchant", "receivables" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "from", "value": "2005-09-28" }, { "key": "to", "value": "2005-09-28" }, { "key": "status", "value": "consequat" }, { "key": "page", "value": "1" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "299edcd3-6606-4970-9a16-7c75339439de", "name": "Data ilegível, período invertido ou longo demais, ou situação desconhecida (`INVALID_REQUEST`).", "originalRequest": { "url": { "path": [ "v1", "merchant", "receivables" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "from", "value": "2005-09-28" }, { "key": "to", "value": "2005-09-28" }, { "key": "status", "value": "consequat" }, { "key": "page", "value": "1" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "016e4b7e-aca4-4791-abb4-a29a9243e685", "name": "Assinaturas", "description": { "content": "Planos mensais pagos com o saldo da conta: escolher um plano, ver a\nmensalidade e o histórico, trocar de plano (vale na próxima\nmensalidade) e cancelar. Só de sessão: uma chave de API\nrecebe `403 FORBIDDEN` nestas rotas. Existe só onde há transferência\ninterna (funcionalidade `subscriptions`); desligada, `403\nFEATURE_DISABLED` — menos ver e cancelar o plano vivo\n(`GET /v1/subscription` e `POST /v1/subscription/cancel`), que\ncontinuam valendo para o cliente poder sair do plano a qualquer momento,\ne desfazer uma troca agendada quando voltar não aumenta a mensalidade\n(`POST /v1/subscription/plan-change/cancel`).\n\nO plano é também uma **cesta de serviços**: cotas por serviço (Pix\nenviado, TED, boletos…) por período pago, de um vencimento ao seguinte\n(`GET /v1/subscription/usage`), e o cliente escolhe o dia de cobrança\n(`POST /v1/subscription/billing-day`). Há planos para pessoa física e\npara empresa: cada conta vê os do seu público.\n", "type": "text/plain" }, "item": [ { "id": "96a53e8c-b7a2-439a-b452-7d8109626314", "name": "Planos à venda para a conta", "request": { "name": "Planos à venda para a conta", "description": { "content": "Os planos ativos para o público da conta (pessoa física vê os planos\n`PF`; empresa, os `PJ`), em ordem de exibição, com o preço em vigor\nhoje (`amountCents`, em centavos), o próximo preço já agendado\n(`scheduledPrice`), quando há, e a composição da cesta de serviços\nvigente hoje (`quotas`: um item por serviço do catálogo; `included`\n0 e `unlimited` falso é \"não incluído\"). Lista vazia é `200`: a tela\ndiz \"nenhum plano disponível\".\n\nSó de sessão: uma chave de API recebe `403 FORBIDDEN`. Com a\nfuncionalidade `subscriptions` desligada, `403 FEATURE_DISABLED`.\n", "type": "text/plain" }, "url": { "path": [ "v1", "subscription-plans" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "2b049a0d-5348-4658-9ced-70f4243cd636", "name": "Os planos.", "originalRequest": { "url": { "path": [ "v1", "subscription-plans" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"items\": [\n {\n \"id\": \"enim\",\n \"name\": \"S4 Standard individual\",\n \"description\": \"non deserunt velit ex\",\n \"benefits\": [\n \"sunt officia aute veniam laboris\",\n \"in i\"\n ],\n \"period\": \"MONTHLY\",\n \"amountCents\": -65593214,\n \"scheduledPrice\": null,\n \"quotas\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"planVersion\": \"2002-03-29\",\n \"scheduledQuotas\": [\n {\n \"effectiveFrom\": {\n \"value\": \"\"\n },\n \"items\": {\n \"value\": \"\"\n }\n },\n {\n \"effectiveFrom\": {\n \"value\": \"\"\n },\n \"items\": {\n \"value\": \"\"\n }\n }\n ]\n },\n {\n \"id\": \"id Ut\",\n \"name\": \"S4 Standard individual\",\n \"description\": \"labore minim ullamco laboris sint\",\n \"benefits\": [\n \"in\",\n \"labore aute dolor in\"\n ],\n \"period\": \"MONTHLY\",\n \"amountCents\": -31998767,\n \"scheduledPrice\": null,\n \"quotas\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"planVersion\": \"1998-03-22\",\n \"scheduledQuotas\": [\n {\n \"effectiveFrom\": {\n \"value\": \"\"\n },\n \"items\": {\n \"value\": \"\"\n }\n },\n {\n \"effectiveFrom\": {\n \"value\": \"\"\n },\n \"items\": {\n \"value\": \"\"\n }\n }\n ]\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a25b9abd-8188-48c8-a817-3548e6e14569", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "subscription-plans" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3f2d4ee6-7276-498c-8166-1123efdcdbad", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "subscription-plans" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "054ace0a-9339-46a9-a32c-5b6d43ea02cd", "name": "A assinatura da conta e se ela pode aderir", "request": { "name": "A assinatura da conta e se ela pode aderir", "description": { "content": "Devolve a assinatura viva ou, sem ela, a cancelada mais recente (para\na tela mostrar \"cancelado em …\"); `subscription: null` quando a conta\nnunca aderiu.\n\n`canSubscribe` diz se a conta pode aderir agora. Com assinatura viva é\n`false`, sem `blockedReason`. Sem ela, `blockedReason` diz por quê:\n`ACCOUNT_NOT_ACTIVE` (conta em análise, bloqueada ou encerrada),\n`UNCOLLECTED_CHARGES` (mensalidade não cobrada em aberto: falar com o\natendimento) ou `PAID_PERIOD_ACTIVE` (o período pago do plano\ncancelado ainda não terminou; `availableFrom` diz a partir de\nquando). `ACCOUNT_TYPE` (conta de empresa) não é mais emitido: a\nempresa adere aos planos `PJ`; servidores anteriores o mandavam.\n\nCom a funcionalidade `subscriptions` desligada esta rota **não** é\nrecusada: devolve a assinatura viva, se houver (com `canSubscribe:\nfalse`), para o cliente poder cancelá-la; sem assinatura viva, `404`.\n", "type": "text/plain" }, "url": { "path": [ "v1", "subscription" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "bdf28c68-1dbb-4a9a-89c8-1cfe4b9d2aef", "name": "A assinatura e a possibilidade de aderir.", "originalRequest": { "url": { "path": [ "v1", "subscription" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"subscription\": {\n \"id\": \"mollit anim\",\n \"status\": \"PAST_DUE\",\n \"plan\": {\n \"id\": \"ven\",\n \"name\": \"proident magna\",\n \"description\": \"ipsum sint do consequat reprehenderit\",\n \"benefits\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"quotas\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ]\n },\n \"billingDay\": 5,\n \"startedAt\": \"1992-04-29T06:59:47.101Z\",\n \"nextDueDate\": \"1973-04-20\",\n \"nextAmountCents\": 71738103,\n \"paidThrough\": \"1951-03-14\",\n \"pendingPlan\": null,\n \"currentCharge\": {\n \"value\": \"\"\n },\n \"canceledAt\": \"2008-10-08T08:22:28.843Z\",\n \"planChangeFrom\": \"2016-05-28\",\n \"planChangeBlockedReason\": \"SUBSCRIPTION_CANCELED\",\n \"pendingBillingDay\": 5,\n \"billingDayChangeFrom\": \"1993-06-01\",\n \"billingDayChangeAmountCents\": 75946036,\n \"graceUntil\": \"1968-05-16\",\n \"canChangeBillingDay\": true,\n \"billingDayChangeBlockedReason\": \"null\"\n },\n \"canSubscribe\": false,\n \"blockedReason\": \"PAID_PERIOD_ACTIVE\",\n \"availableFrom\": \"1968-07-17\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fc739f29-ab8c-41d6-94c3-54b1798739f4", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "subscription" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a0f2e32a-b507-460a-bfb4-5eedd997c590", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "subscription" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d4ef4644-758e-490a-ad8d-11c02ffc4b94", "name": "Funcionalidade desligada e nenhuma assinatura viva (`NOT_FOUND`).", "originalRequest": { "url": { "path": [ "v1", "subscription" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2790e358-9849-47ac-87c6-b71250fbbf3e", "name": "Adere a um plano", "request": { "name": "Adere a um plano", "description": { "content": "Cria a assinatura e **debita a primeira mensalidade na hora**, do\nsaldo, numa operação só: sem saldo para o valor inteiro, responde `422\nINSUFFICIENT_FUNDS` e nada é criado. Não existe débito parcial.\n\nO vencimento é o dia da adesão, todo mês (no último dia do mês, nos\nmeses mais curtos). As mensalidades seguintes são debitadas do saldo no\nvencimento, a partir das 6h; sem saldo, o débito é tentado de novo, no\nmáximo uma vez por hora, até 15 dias depois (`retryUntil`). A\nmensalidade aparece no extrato como `TARIFF`, com a descrição\n`Mensalidade · · MM/AAAA`.\n\nExige **sempre** `X-Step-Up` com `purpose: subscription` e\n`Idempotency-Key`: repetir a mesma chave com o mesmo corpo devolve a\nresposta original (`Idempotent-Replay: true`) e debita uma vez só.\n`expectedAmountCents` é o valor que a tela mostrou: se o preço em vigor\nfor outro, `409` com `details.reason: PRICE_CHANGED` e\n`details.currentAmountCents`; mostre o valor novo, peça confirmação e\nenvie com **outra** chave. `expectedPlanVersion` é a `planVersion` da\nvitrine (a vigência da composição da cesta mostrada; `null` quando o\nplano não tem composição → mande a string vazia): se a composição\nvigente for outra, `409` com `details.reason: PLAN_CHANGED` e\n`details.currentPlanVersion`. Ausente, a composição não é conferida\n(telas anteriores); a fotografia da adesão guarda a vigente, e também\na tabela de tarifas avulsas em vigor para o público da conta (`fees`,\no que o excedente da cesta paga; nula com `service_fees` desligada).\n\nTrocar de plano não é por aqui: é por `POST\n/v1/subscription/plan-change`, e vale na próxima mensalidade.\n", "type": "text/plain" }, "url": { "path": [ "v1", "subscription" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"planId\": \"pln_8f2c1a\",\n \"expectedAmountCents\": 3992,\n \"expectedPlanVersion\": \"2026-09-05\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "dadc5f1f-5c56-4acf-a8b6-e1a3a99bb87b", "name": "Assinatura criada; `currentCharge.status` é `PAID_DEBIT`.", "originalRequest": { "url": { "path": [ "v1", "subscription" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"planId\": \"pln_8f2c1a\",\n \"expectedAmountCents\": 3992,\n \"expectedPlanVersion\": \"2026-09-05\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"laboris proident\",\n \"status\": \"ACTIVE\",\n \"plan\": {\n \"id\": \"Excepteur\",\n \"name\": \"sit ex Ut nulla irure\",\n \"description\": \"Ut ut dolor\",\n \"benefits\": [\n \"sunt aliqua elit eiusmod\",\n \"adip\"\n ],\n \"quotas\": [\n {\n \"service\": \"PIX_OUT\",\n \"label\": \"Pix enviado\",\n \"included\": 95819382,\n \"unlimited\": true\n },\n {\n \"service\": \"PIX_OUT\",\n \"label\": \"Pix enviado\",\n \"included\": 45279547,\n \"unlimited\": true\n }\n ]\n },\n \"billingDay\": 24,\n \"startedAt\": \"1951-04-08T03:56:31.669Z\",\n \"nextDueDate\": \"2004-07-09\",\n \"nextAmountCents\": 20125036,\n \"paidThrough\": \"2010-04-17\",\n \"pendingPlan\": null,\n \"currentCharge\": {\n \"id\": \"nulla irure cillu\",\n \"competence\": \"2026-11\",\n \"dueDate\": \"1971-02-15\",\n \"amountCents\": 8477492,\n \"status\": \"PAID_BILLET\",\n \"retryUntil\": \"2022-05-28\",\n \"paidAt\": \"1956-04-02T06:53:23.588Z\",\n \"transactionId\": \"eiusmod ut ex dolor\",\n \"billet\": null,\n \"kind\": \"PRORATA\",\n \"periodStart\": \"2020-07-27\"\n },\n \"canceledAt\": \"2019-06-10T08:35:28.499Z\",\n \"planChangeFrom\": \"2025-03-10\",\n \"planChangeBlockedReason\": \"FEATURE_DISABLED\",\n \"pendingBillingDay\": 23,\n \"billingDayChangeFrom\": \"2008-07-08\",\n \"billingDayChangeAmountCents\": -29182294,\n \"graceUntil\": \"2000-06-06\",\n \"canChangeBillingDay\": false,\n \"billingDayChangeBlockedReason\": \"SUBSCRIPTION_CANCELED\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9ae8fd09-450d-45e0-adf9-ba022927901c", "name": "Falta `planId`, `expectedAmountCents` ou o cabeçalho `Idempotency-Key` (`INVALID_REQUEST`).", "originalRequest": { "url": { "path": [ "v1", "subscription" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"planId\": \"pln_8f2c1a\",\n \"expectedAmountCents\": 3992,\n \"expectedPlanVersion\": \"2026-09-05\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e1b7b579-e458-4f70-b255-f69a6e729828", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "subscription" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"planId\": \"pln_8f2c1a\",\n \"expectedAmountCents\": 3992,\n \"expectedPlanVersion\": \"2026-09-05\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7e999d46-771f-47bf-8505-56145179dfce", "name": "Falta o segundo fator com `purpose: subscription`\n(`STEP_UP_REQUIRED`) ou a selfie, acima do limiar de biometria\n(`BIOMETRIC_REQUIRED`); a conta não está ativa (`FORBIDDEN`); a\nfuncionalidade está desligada (`FEATURE_DISABLED`).\n", "originalRequest": { "url": { "path": [ "v1", "subscription" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"planId\": \"pln_8f2c1a\",\n \"expectedAmountCents\": 3992,\n \"expectedPlanVersion\": \"2026-09-05\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ae40adbf-db0b-4416-b8d7-51dff619f05b", "name": "Plano inexistente, inativo ou de outro público (`NOT_FOUND`).", "originalRequest": { "url": { "path": [ "v1", "subscription" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"planId\": \"pln_8f2c1a\",\n \"expectedAmountCents\": 3992,\n \"expectedPlanVersion\": \"2026-09-05\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "503e142d-e022-4cf8-afb0-c6a54f350913", "name": "`CONFLICT` com `details.reason`: `ALREADY_SUBSCRIBED` (a conta já\ntem plano), `PRICE_CHANGED` (com `details.currentAmountCents`),\n`PLAN_CHANGED` (a composição da cesta mudou; com\n`details.currentPlanVersion`), `UNCOLLECTED_CHARGES` (mensalidade\nnão cobrada em aberto) ou `PAID_PERIOD_ACTIVE` (com\n`details.availableFrom`). Ou a chave de\nidempotência já usada com outro corpo ou numa adesão que já foi\ncancelada (`IDEMPOTENCY_KEY_REUSED`), ou a operação anterior ainda\nem curso (`IDEMPOTENCY_IN_FLIGHT`).\n", "originalRequest": { "url": { "path": [ "v1", "subscription" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"planId\": \"pln_8f2c1a\",\n \"expectedAmountCents\": 3992,\n \"expectedPlanVersion\": \"2026-09-05\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6d714ee7-d923-4b4b-8125-2180bf1df5fc", "name": "Saldo insuficiente para a primeira mensalidade\n(`INSUFFICIENT_FUNDS`); conta de empresa (`INVALID_REQUEST` com\n`details.reason: ACCOUNT_TYPE`).\n", "originalRequest": { "url": { "path": [ "v1", "subscription" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "disabled": true, "description": "Localização do cliente, `latitude,longitude` em graus decimais, com\nponto e até sete casas. O provedor financeiro a exige em toda chamada\nfeita em nome da pessoa, para o antifraude dele. Ausente ou mal formada\nvale como \"sem localização\": não há `400` por causa deste cabeçalho, mas\na operação que precisa do provedor não sai e volta `PROVIDER_ERROR`\n(HTTP 503) com `details.reason: LOCATION_REQUIRED` — nada foi enviado\nao banco. A leitura que só complementa com o provedor (o saldo e as\nlistas que o atualizam) leva a localização quando o cliente já a tem\nsem perguntar (permissão concedida), e sem ela segue com o dado do\nLume. O servidor a arredonda a 4 casas decimais (cerca de 11 m,\nmetade para longe do zero) antes de usá-la ou repassá-la ao provedor: a\nprecisão acima disso não segue. O Lume guarda só a **última**\nlocalização de uma operação que saiu (não retida), por conta e pessoa\nque operou, arredondada a **1 casa decimal** (cerca de 11 km),\nsubstituída a cada operação e apagada depois de **90 dias** sem\noperação nova ou com a conta encerrada; usa-a apenas para o sinal\n`LOCATION` da análise de risco (pedido a mais de 300 km dela), e ela\nnão aparece em nenhuma resposta. Guarda também, com 4 casas, junto do\npedido que pode ser reenviado ao provedor, a localização da operação\npor até 30 minutos (ou até a conciliação decidir uma tentativa em\nenvio), e só para esse reenvio. No Pix retido para análise (por chave\nou por agência e conta), com o provedor que exige o contexto da pessoa,\nguarda com 4 casas a localização do pedido até a decisão da retida (no\nmáximo 72 h), para repassá-la ao provedor se o operador liberar o Pix.\n", "key": "X-Client-Location", "value": "-15.7939,-47.8828" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"planId\": \"pln_8f2c1a\",\n \"expectedAmountCents\": 3992,\n \"expectedPlanVersion\": \"2026-09-05\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "de05c043-15e1-4a84-ab1d-7cfc4c0b2ba5", "name": "Mensalidades da conta", "request": { "name": "Mensalidades da conta", "description": { "content": "Da competência mais recente para a mais antiga, de todas as assinaturas da conta.", "type": "text/plain" }, "url": { "path": [ "v1", "subscription", "charges" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": true, "key": "limit", "value": "12", "description": "De 1 a 36; fora disso, `400`." } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "0651e6d9-b79e-4441-a9fb-67e3ae0a43bf", "name": "As mensalidades.", "originalRequest": { "url": { "path": [ "v1", "subscription", "charges" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "12" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"items\": [\n {\n \"id\": \"sed fugiat dolor dolore\",\n \"competence\": \"2026-11\",\n \"dueDate\": \"1947-04-02\",\n \"amountCents\": 7709141,\n \"status\": \"PAID_BILLET\",\n \"retryUntil\": \"1964-03-25\",\n \"paidAt\": \"1985-05-22T01:30:51.816Z\",\n \"transactionId\": \"velit dolor culpa officia\",\n \"billet\": null,\n \"kind\": \"MONTHLY\",\n \"periodStart\": \"1971-03-24\"\n },\n {\n \"id\": \"cillum ut voluptate\",\n \"competence\": \"2026-11\",\n \"dueDate\": \"1947-06-11\",\n \"amountCents\": 99226373,\n \"status\": \"PAID_BILLET\",\n \"retryUntil\": \"1979-07-11\",\n \"paidAt\": \"2009-10-14T02:28:26.112Z\",\n \"transactionId\": \"dolor amet\",\n \"billet\": null,\n \"kind\": \"MONTHLY\",\n \"periodStart\": \"1954-04-19\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c39c3d92-15ba-486a-a672-6b50842f5261", "name": "Requisição malformada ou com dado inválido", "originalRequest": { "url": { "path": [ "v1", "subscription", "charges" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "12" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "34730a07-1d8a-4889-9a78-8427e397044d", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "subscription", "charges" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "12" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "528ce604-c8c6-45df-ac9d-73d5f77209de", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "subscription", "charges" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "12" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "201b4e15-6a01-4269-8ec0-64fcb4ddcd73", "name": "Cancela o plano", "request": { "name": "Cancela o plano", "description": { "content": "Cancela a assinatura viva da conta, na hora: as mensalidades em aberto\ndeixam de ser cobradas, e o valor já pago **não é devolvido**. Um plano\nnovo pode ser escolhido a partir do fim do período pago\n(`paidThrough`). O titular recebe um e-mail de aviso.\n\nExige **sempre** `X-Step-Up` com `purpose: subscription` e\n`Idempotency-Key`. Conta bloqueada pode cancelar. Corpo vazio ou `{}`.\nVale também com a funcionalidade `subscriptions` desligada\n(Decreto 11.034/2022): cancelar não move dinheiro, e o plano vivo\nvoltaria a ser cobrado quando ela fosse religada.\n\nCom o boleto de uma mensalidade em aberto, o cancelamento espera a\nbaixa do título: `409` com `details.reason: BILLET_CANCEL_PENDING`;\ntente de novo mais tarde. Com a funcionalidade desligada e a emissão do\nboleto ainda sem resposta do banco, cancela na hora: o boleto, se sair,\né um depósito na sua própria conta, e a cobrança se resolve quando o\nserviço voltar.\n\nCancelar **não apaga dívida**: a mensalidade não cobrada continua\ndevida, e também a mensalidade cujo boleto já foi pago e ainda não\ndebitada (o pagamento caiu na sua própria conta). Enquanto houver\ndívida, um plano novo é recusado com `UNCOLLECTED_CHARGES`; o\natendimento pode emitir um boleto para quitá-la.\n", "type": "text/plain" }, "url": { "path": [ "v1", "subscription", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "bd58cec9-76d6-4cda-a756-68f4946a0036", "name": "Cancelada; `status` é `CANCELED`.", "originalRequest": { "url": { "path": [ "v1", "subscription", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"laboris proident\",\n \"status\": \"ACTIVE\",\n \"plan\": {\n \"id\": \"Excepteur\",\n \"name\": \"sit ex Ut nulla irure\",\n \"description\": \"Ut ut dolor\",\n \"benefits\": [\n \"sunt aliqua elit eiusmod\",\n \"adip\"\n ],\n \"quotas\": [\n {\n \"service\": \"PIX_OUT\",\n \"label\": \"Pix enviado\",\n \"included\": 95819382,\n \"unlimited\": true\n },\n {\n \"service\": \"PIX_OUT\",\n \"label\": \"Pix enviado\",\n \"included\": 45279547,\n \"unlimited\": true\n }\n ]\n },\n \"billingDay\": 24,\n \"startedAt\": \"1951-04-08T03:56:31.669Z\",\n \"nextDueDate\": \"2004-07-09\",\n \"nextAmountCents\": 20125036,\n \"paidThrough\": \"2010-04-17\",\n \"pendingPlan\": null,\n \"currentCharge\": {\n \"id\": \"nulla irure cillu\",\n \"competence\": \"2026-11\",\n \"dueDate\": \"1971-02-15\",\n \"amountCents\": 8477492,\n \"status\": \"PAID_BILLET\",\n \"retryUntil\": \"2022-05-28\",\n \"paidAt\": \"1956-04-02T06:53:23.588Z\",\n \"transactionId\": \"eiusmod ut ex dolor\",\n \"billet\": null,\n \"kind\": \"PRORATA\",\n \"periodStart\": \"2020-07-27\"\n },\n \"canceledAt\": \"2019-06-10T08:35:28.499Z\",\n \"planChangeFrom\": \"2025-03-10\",\n \"planChangeBlockedReason\": \"FEATURE_DISABLED\",\n \"pendingBillingDay\": 23,\n \"billingDayChangeFrom\": \"2008-07-08\",\n \"billingDayChangeAmountCents\": -29182294,\n \"graceUntil\": \"2000-06-06\",\n \"canChangeBillingDay\": false,\n \"billingDayChangeBlockedReason\": \"SUBSCRIPTION_CANCELED\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2a3a533d-0211-4409-b08d-31850b2654c3", "name": "Requisição malformada ou com dado inválido", "originalRequest": { "url": { "path": [ "v1", "subscription", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "648476fe-a509-415b-83bb-b6fccf5ad3f4", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "subscription", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4bbfd1d3-9aab-4742-8897-af2b8080ab60", "name": "Falta o segundo fator com `purpose: subscription` (`STEP_UP_REQUIRED`).\n", "originalRequest": { "url": { "path": [ "v1", "subscription", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fbfb19f9-2458-4883-bc14-0c39f307ac49", "name": "Não há plano vivo para cancelar (`NOT_FOUND`).", "originalRequest": { "url": { "path": [ "v1", "subscription", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "47389ca8-a4e8-40fb-a391-48b8b288fcaf", "name": "`CONFLICT` com `details.reason: BILLET_CANCEL_PENDING`; ou\n`IDEMPOTENCY_KEY_REUSED` / `IDEMPOTENCY_IN_FLIGHT`.\n", "originalRequest": { "url": { "path": [ "v1", "subscription", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "31a75e05-60db-4ebb-8888-38e790b1ed41", "name": "Pede a troca de plano", "request": { "name": "Pede a troca de plano", "description": { "content": "Agenda a troca do plano da assinatura viva para outro plano à venda,\nmais caro ou mais barato. A troca **vale na próxima mensalidade**\ngerada (`planChangeFrom` de `GET /v1/subscription` diz quando), sem\ncobrança proporcional e sem débito na hora; até lá, nada muda. A\nmensalidade já gerada (em aberto, inclusive em atraso) continua no\nplano dela. Pedir outro plano antes de a troca valer substitui a troca\nagendada. O titular recebe um e-mail de aviso.\n\nExige **sempre** `X-Step-Up` com `purpose: subscription` e\n`Idempotency-Key`; com a mensalidade do plano novo (na data em que\nvale) acima do limiar de biometria, o step-up precisa incluir a selfie,\ncomo na adesão (`403 BIOMETRIC_REQUIRED`, que não fica gravado sob a\nchave). `expectedAmountCents` é a mensalidade do plano novo\n**na data em que a troca vale**, como a tela mostrou: se for outra,\n`409` com `details.reason: PRICE_CHANGED`,\n`details.currentAmountCents` e `details.effectiveFrom`; mostre o valor\nnovo, peça confirmação e envie com **outra** chave.\n`expectedPlanVersion` (opcional) é o `planVersion` do plano novo que a\nvitrine mostrou (a vigência da composição da cesta, ou `\"\"` sem\ncomposição), como na adesão: se a cesta mudou, `409` com\n`details.reason: PLAN_CHANGED` e `details.currentPlanVersion`.\n\nRecusada (`409 CONFLICT` com `details.reason`) com a assinatura\ncancelada (`SUBSCRIPTION_CANCELED`), inadimplente ou com mensalidade\nnão cobrada na conta (`UNCOLLECTED_CHARGES`), com a mensalidade da\ntroca agendada já gerada (`ALREADY_GENERATED`: uma nova mudança só\ndepois de ela ser paga), para plano inexistente, inativo ou sem preço\nna data (`PLAN_UNAVAILABLE`), para o plano atual (`SAME_PLAN`) ou para\no já agendado (`ALREADY_SCHEDULED`). A assinatura que mudou durante o\npedido (a mensalidade foi gerada no meio, por exemplo) responde\n`SUBSCRIPTION_CHANGED` e nada é gravado: releia e confirme de novo.\n", "type": "text/plain" }, "url": { "path": [ "v1", "subscription", "plan-change" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"planId\": \"pln_8f2c1a\",\n \"expectedAmountCents\": 10392,\n \"expectedPlanVersion\": \"dolor \"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "37793a34-3372-4725-aa17-020b0d10bcb3", "name": "Troca agendada; `pendingPlan` traz o plano novo, a data e a mensalidade.", "originalRequest": { "url": { "path": [ "v1", "subscription", "plan-change" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"planId\": \"pln_8f2c1a\",\n \"expectedAmountCents\": 10392,\n \"expectedPlanVersion\": \"dolor \"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"laboris proident\",\n \"status\": \"ACTIVE\",\n \"plan\": {\n \"id\": \"Excepteur\",\n \"name\": \"sit ex Ut nulla irure\",\n \"description\": \"Ut ut dolor\",\n \"benefits\": [\n \"sunt aliqua elit eiusmod\",\n \"adip\"\n ],\n \"quotas\": [\n {\n \"service\": \"PIX_OUT\",\n \"label\": \"Pix enviado\",\n \"included\": 95819382,\n \"unlimited\": true\n },\n {\n \"service\": \"PIX_OUT\",\n \"label\": \"Pix enviado\",\n \"included\": 45279547,\n \"unlimited\": true\n }\n ]\n },\n \"billingDay\": 24,\n \"startedAt\": \"1951-04-08T03:56:31.669Z\",\n \"nextDueDate\": \"2004-07-09\",\n \"nextAmountCents\": 20125036,\n \"paidThrough\": \"2010-04-17\",\n \"pendingPlan\": null,\n \"currentCharge\": {\n \"id\": \"nulla irure cillu\",\n \"competence\": \"2026-11\",\n \"dueDate\": \"1971-02-15\",\n \"amountCents\": 8477492,\n \"status\": \"PAID_BILLET\",\n \"retryUntil\": \"2022-05-28\",\n \"paidAt\": \"1956-04-02T06:53:23.588Z\",\n \"transactionId\": \"eiusmod ut ex dolor\",\n \"billet\": null,\n \"kind\": \"PRORATA\",\n \"periodStart\": \"2020-07-27\"\n },\n \"canceledAt\": \"2019-06-10T08:35:28.499Z\",\n \"planChangeFrom\": \"2025-03-10\",\n \"planChangeBlockedReason\": \"FEATURE_DISABLED\",\n \"pendingBillingDay\": 23,\n \"billingDayChangeFrom\": \"2008-07-08\",\n \"billingDayChangeAmountCents\": -29182294,\n \"graceUntil\": \"2000-06-06\",\n \"canChangeBillingDay\": false,\n \"billingDayChangeBlockedReason\": \"SUBSCRIPTION_CANCELED\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4b6047bb-9c4c-44e2-b89a-1f4a4a7fcec8", "name": "Falta `planId`, `expectedAmountCents` ou o cabeçalho `Idempotency-Key` (`INVALID_REQUEST`).", "originalRequest": { "url": { "path": [ "v1", "subscription", "plan-change" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"planId\": \"pln_8f2c1a\",\n \"expectedAmountCents\": 10392,\n \"expectedPlanVersion\": \"dolor \"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "34ae6290-d424-4f9f-9863-e5dcbfdf77ff", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "subscription", "plan-change" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"planId\": \"pln_8f2c1a\",\n \"expectedAmountCents\": 10392,\n \"expectedPlanVersion\": \"dolor \"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "274aa324-af2b-4e5e-9edb-9453b934a30d", "name": "Falta o segundo fator com `purpose: subscription`\n(`STEP_UP_REQUIRED`) ou a selfie, com a mensalidade acima do\nlimiar de biometria (`BIOMETRIC_REQUIRED`); a conta não está ativa\n(`FORBIDDEN` com `details.reason: ACCOUNT_NOT_ACTIVE`); a\nfuncionalidade está desligada (`FEATURE_DISABLED`).\n", "originalRequest": { "url": { "path": [ "v1", "subscription", "plan-change" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"planId\": \"pln_8f2c1a\",\n \"expectedAmountCents\": 10392,\n \"expectedPlanVersion\": \"dolor \"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ac0131c7-6fe8-4830-a544-97bff85f970e", "name": "A conta não tem plano (`NOT_FOUND`).", "originalRequest": { "url": { "path": [ "v1", "subscription", "plan-change" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"planId\": \"pln_8f2c1a\",\n \"expectedAmountCents\": 10392,\n \"expectedPlanVersion\": \"dolor \"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c4792e44-9283-4098-8613-b252ca2c242c", "name": "`CONFLICT` com `details.reason`: `PRICE_CHANGED` (com\n`details.currentAmountCents` e `details.effectiveFrom`),\n`PLAN_CHANGED` (com `details.currentPlanVersion`),\n`SUBSCRIPTION_CANCELED`, `UNCOLLECTED_CHARGES`, `ALREADY_GENERATED`,\n`PLAN_UNAVAILABLE`, `SAME_PLAN`, `ALREADY_SCHEDULED` ou\n`SUBSCRIPTION_CHANGED`. Ou `IDEMPOTENCY_KEY_REUSED` /\n`IDEMPOTENCY_IN_FLIGHT`.\n", "originalRequest": { "url": { "path": [ "v1", "subscription", "plan-change" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"planId\": \"pln_8f2c1a\",\n \"expectedAmountCents\": 10392,\n \"expectedPlanVersion\": \"dolor \"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c27fac66-49d6-41d3-b53c-73efafd56765", "name": "Desfaz a troca de plano agendada", "request": { "name": "Desfaz a troca de plano agendada", "description": { "content": "Desfaz a troca agendada (pedida pelo cliente ou pelo atendimento): o\nplano atual continua valendo. Só enquanto a mensalidade em que a troca\nvale não foi gerada (ela é gerada 10 dias antes do vencimento);\ndepois, `409` com `details.reason: ALREADY_GENERATED`. O titular\nrecebe um e-mail de aviso.\n\nDesfazer muda o que se paga: `expectedAmountCents` é a mensalidade do\nplano atual na data em que a troca valeria, como a tela mostrou\n(`pendingPlan.undoAmountCents` de `GET /v1/subscription`); outra, `409`\ncom `details.reason: PRICE_CHANGED`, `details.currentAmountCents` e\n`details.effectiveFrom`, e o pedido de novo vai com **outra** chave.\n\nExige **sempre** `X-Step-Up` com `purpose: subscription` e\n`Idempotency-Key`; com a mensalidade do plano atual (para onde se\nvolta) acima do limiar de biometria, também a selfie\n(`403 BIOMETRIC_REQUIRED`, que não fica gravado sob a chave).\n\n**Fora do portão da funcionalidade**, como o cancelamento: com\n`subscriptions` desligada, a conta não ativa ou mensalidade não\ncobrada, desfazer ainda vale quando voltar **não aumenta** a\nmensalidade (o plano atual custa o mesmo ou menos que o da troca\nagendada); quando aumenta, é recusado com o motivo da porta fechada\n(`FEATURE_DISABLED`, `FORBIDDEN` com `ACCOUNT_NOT_ACTIVE` ou `409\nUNCOLLECTED_CHARGES`). `pendingPlan.canUndo` diz se o desfazer é aceito\nagora.\n", "type": "text/plain" }, "url": { "path": [ "v1", "subscription", "plan-change", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"expectedAmountCents\": 10392\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "c84c9b76-8ad8-4d65-9f48-711ec4ba2e32", "name": "Troca desfeita; `pendingPlan` é `null`.", "originalRequest": { "url": { "path": [ "v1", "subscription", "plan-change", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"expectedAmountCents\": 10392\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"laboris proident\",\n \"status\": \"ACTIVE\",\n \"plan\": {\n \"id\": \"Excepteur\",\n \"name\": \"sit ex Ut nulla irure\",\n \"description\": \"Ut ut dolor\",\n \"benefits\": [\n \"sunt aliqua elit eiusmod\",\n \"adip\"\n ],\n \"quotas\": [\n {\n \"service\": \"PIX_OUT\",\n \"label\": \"Pix enviado\",\n \"included\": 95819382,\n \"unlimited\": true\n },\n {\n \"service\": \"PIX_OUT\",\n \"label\": \"Pix enviado\",\n \"included\": 45279547,\n \"unlimited\": true\n }\n ]\n },\n \"billingDay\": 24,\n \"startedAt\": \"1951-04-08T03:56:31.669Z\",\n \"nextDueDate\": \"2004-07-09\",\n \"nextAmountCents\": 20125036,\n \"paidThrough\": \"2010-04-17\",\n \"pendingPlan\": null,\n \"currentCharge\": {\n \"id\": \"nulla irure cillu\",\n \"competence\": \"2026-11\",\n \"dueDate\": \"1971-02-15\",\n \"amountCents\": 8477492,\n \"status\": \"PAID_BILLET\",\n \"retryUntil\": \"2022-05-28\",\n \"paidAt\": \"1956-04-02T06:53:23.588Z\",\n \"transactionId\": \"eiusmod ut ex dolor\",\n \"billet\": null,\n \"kind\": \"PRORATA\",\n \"periodStart\": \"2020-07-27\"\n },\n \"canceledAt\": \"2019-06-10T08:35:28.499Z\",\n \"planChangeFrom\": \"2025-03-10\",\n \"planChangeBlockedReason\": \"FEATURE_DISABLED\",\n \"pendingBillingDay\": 23,\n \"billingDayChangeFrom\": \"2008-07-08\",\n \"billingDayChangeAmountCents\": -29182294,\n \"graceUntil\": \"2000-06-06\",\n \"canChangeBillingDay\": false,\n \"billingDayChangeBlockedReason\": \"SUBSCRIPTION_CANCELED\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9707f9d2-298f-4f7f-8545-1897e956f582", "name": "Falta `expectedAmountCents` ou o cabeçalho `Idempotency-Key` (`INVALID_REQUEST`).", "originalRequest": { "url": { "path": [ "v1", "subscription", "plan-change", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"expectedAmountCents\": 10392\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f37e2be8-cc4a-4e19-884e-2a932afb5d0d", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "subscription", "plan-change", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"expectedAmountCents\": 10392\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c493a48a-e17a-41de-a74b-d6bc8606dd27", "name": "Falta o segundo fator com `purpose: subscription`\n(`STEP_UP_REQUIRED`) ou a selfie, com a mensalidade acima do\nlimiar de biometria (`BIOMETRIC_REQUIRED`); voltar aumentaria a\nmensalidade com a conta não ativa (`FORBIDDEN` com\n`details.reason: ACCOUNT_NOT_ACTIVE`) ou com a funcionalidade\ndesligada (`FEATURE_DISABLED`).\n", "originalRequest": { "url": { "path": [ "v1", "subscription", "plan-change", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"expectedAmountCents\": 10392\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1213aa8d-2101-4bc2-9842-695b39516cf1", "name": "A conta não tem plano (`NOT_FOUND`).", "originalRequest": { "url": { "path": [ "v1", "subscription", "plan-change", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"expectedAmountCents\": 10392\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5251216b-2ac5-4f5a-9941-60bf273d2c2c", "name": "`CONFLICT` com `details.reason`: `PRICE_CHANGED` (com\n`details.currentAmountCents` e `details.effectiveFrom`),\n`NO_PENDING_CHANGE`, `ALREADY_GENERATED`, `SUBSCRIPTION_CANCELED`,\n`UNCOLLECTED_CHARGES` (voltar aumentaria a mensalidade com dívida\nem aberto), `PLAN_UNAVAILABLE` (o plano atual sem preço na data) ou\n`SUBSCRIPTION_CHANGED`. Ou `IDEMPOTENCY_KEY_REUSED` /\n`IDEMPOTENCY_IN_FLIGHT`.\n", "originalRequest": { "url": { "path": [ "v1", "subscription", "plan-change", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"expectedAmountCents\": 10392\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8ca0f78d-87cc-42f5-9373-2b6688c8920e", "name": "A cesta de serviços no período corrente", "request": { "name": "A cesta de serviços no período corrente", "description": { "content": "O período pago corrente da assinatura viva (de um vencimento ao\nseguinte) e, por serviço do catálogo, a cota incluída (`included`,\nou `unlimited`), o que já foi usado (`used`) e o que resta\n(`remaining`, nulo no ilimitado). A cota zera a cada período e não\nacumula. `status`: `ACTIVE` (a cesta vale), `SUSPENDED` (cesta\ndesativada: a mensalidade ficou sem pagamento depois da carência;\npaga, volta a valer até o fim do período) ou `NONE` (nenhum período\ncobre hoje; `periodStart`/`periodEnd` nulos e `items` vazio).\n\n`excessPrice` é a tarifa avulsa do excedente: a linha de `GET /v1/fees`\ndo serviço para o público da conta (preço vigente hoje; `FREE` sem\npreço ou isento por norma). `feesPaidInPeriodCents` é o total de\ntarifas avulsas cobradas da conta nos dias do período (as estornadas\nnão contam). Com a funcionalidade `service_fees` desligada,\n`excessPrice` vem nulo e `feesPaidInPeriodCents` zero.\n\nA assinatura cancelada mantém a cesta do período já pago até o fim\ndele, e as operações continuam consumindo a cota: enquanto esse\nperíodo vale, a resposta é `200` com ele e `subscriptionStatus:\nCANCELED`. `404` só quando não há período consumível (sem assinatura,\nou cancelada sem período pago em curso). Só de sessão; com a\nfuncionalidade `subscriptions` desligada, `403 FEATURE_DISABLED`.\n", "type": "text/plain" }, "url": { "path": [ "v1", "subscription", "usage" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "6986045a-03f1-4fad-920b-52c8faae6b6b", "name": "O período corrente e o uso.", "originalRequest": { "url": { "path": [ "v1", "subscription", "usage" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"subscriptionId\": \"qui sed non quis\",\n \"subscriptionStatus\": \"ACTIVE\",\n \"periodStart\": \"2021-03-26\",\n \"periodEnd\": \"1969-07-10\",\n \"status\": \"SUSPENDED\",\n \"items\": [\n {\n \"service\": \"amet laboris occaecat\",\n \"label\": \"in qui commodo\",\n \"included\": -81911154,\n \"unlimited\": false,\n \"used\": 62383721,\n \"remaining\": -6508293,\n \"excessPrice\": null\n },\n {\n \"service\": \"et aliqua id Ut\",\n \"label\": \"pariatur e\",\n \"included\": -63730949,\n \"unlimited\": false,\n \"used\": -68319911,\n \"remaining\": -96081805,\n \"excessPrice\": null\n }\n ],\n \"feesPaidInPeriodCents\": -53450033\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5897bdcd-dd95-4d9e-b3a5-90a8316a50dc", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "subscription", "usage" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2ce52eac-f101-485c-847f-8c3b06b1796f", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "subscription", "usage" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dc431aca-cba9-48ee-b671-c690e7784f9c", "name": "A conta não tem período consumível da cesta (`NOT_FOUND`).", "originalRequest": { "url": { "path": [ "v1", "subscription", "usage" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9a177dd7-5e8a-4b7d-ad89-9930581d14e8", "name": "Pede a troca do dia de cobrança", "request": { "name": "Pede a troca do dia de cobrança", "description": { "content": "Agenda o dia de cobrança escolhido pelo titular (`day`, de 1 a 28).\nVale **na próxima mensalidade ainda não gerada**\n(`billingDayChangeFrom` da resposta e de `GET /v1/subscription`):\nessa mensalidade sai **proporcional**, vencendo no dia antigo (V1) e\ncobrindo até a primeira ocorrência do dia novo (V2), por\n`floor(preço × dias(V1, V2) / dias(V1, V1 + 1 mês))`\n(`billingDayChangeAmountCents`), com a cota da cesta proporcional\n(arredondada para cima); a seguinte, em V2, é mensal normal. Nunca há\ncobrança retroativa nem devolução, e nada é debitado agora. **Uma\ntroca por período**; desfazer (`/billing-day/cancel`) libera outra.\n\nExige **sempre** `X-Step-Up` com `purpose: subscription` e\n`Idempotency-Key`. Fora de 1–28, `422 INVALID_REQUEST`. Recusada\n(`409 CONFLICT` com `details.reason`) com `SAME_DAY` (o dia atual),\n`ALREADY_CHANGED_THIS_PERIOD` (a cobrança proporcional da troca deste\nperíodo já foi gerada), `ALREADY_SCHEDULED` (há troca pendente:\ndesfaça-a antes), `SUBSCRIPTION_CANCELED`, `UNCOLLECTED_CHARGES`\n(assinatura inadimplente, mensalidade no boleto ou não cobrada na\nconta) ou `SUBSCRIPTION_CHANGED` (mudou durante o pedido: releia).\n`canChangeBillingDay` e `billingDayChangeBlockedReason` de\n`GET /v1/subscription` antecipam a resposta.\n", "type": "text/plain" }, "url": { "path": [ "v1", "subscription", "billing-day" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"day\": 10\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "967ee821-7d7c-410c-9b53-10494a917790", "name": "Troca agendada; `pendingBillingDay`, `billingDayChangeFrom` e `billingDayChangeAmountCents` dizem o dia, quando e quanto.", "originalRequest": { "url": { "path": [ "v1", "subscription", "billing-day" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"day\": 10\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"laboris proident\",\n \"status\": \"ACTIVE\",\n \"plan\": {\n \"id\": \"Excepteur\",\n \"name\": \"sit ex Ut nulla irure\",\n \"description\": \"Ut ut dolor\",\n \"benefits\": [\n \"sunt aliqua elit eiusmod\",\n \"adip\"\n ],\n \"quotas\": [\n {\n \"service\": \"PIX_OUT\",\n \"label\": \"Pix enviado\",\n \"included\": 95819382,\n \"unlimited\": true\n },\n {\n \"service\": \"PIX_OUT\",\n \"label\": \"Pix enviado\",\n \"included\": 45279547,\n \"unlimited\": true\n }\n ]\n },\n \"billingDay\": 24,\n \"startedAt\": \"1951-04-08T03:56:31.669Z\",\n \"nextDueDate\": \"2004-07-09\",\n \"nextAmountCents\": 20125036,\n \"paidThrough\": \"2010-04-17\",\n \"pendingPlan\": null,\n \"currentCharge\": {\n \"id\": \"nulla irure cillu\",\n \"competence\": \"2026-11\",\n \"dueDate\": \"1971-02-15\",\n \"amountCents\": 8477492,\n \"status\": \"PAID_BILLET\",\n \"retryUntil\": \"2022-05-28\",\n \"paidAt\": \"1956-04-02T06:53:23.588Z\",\n \"transactionId\": \"eiusmod ut ex dolor\",\n \"billet\": null,\n \"kind\": \"PRORATA\",\n \"periodStart\": \"2020-07-27\"\n },\n \"canceledAt\": \"2019-06-10T08:35:28.499Z\",\n \"planChangeFrom\": \"2025-03-10\",\n \"planChangeBlockedReason\": \"FEATURE_DISABLED\",\n \"pendingBillingDay\": 23,\n \"billingDayChangeFrom\": \"2008-07-08\",\n \"billingDayChangeAmountCents\": -29182294,\n \"graceUntil\": \"2000-06-06\",\n \"canChangeBillingDay\": false,\n \"billingDayChangeBlockedReason\": \"SUBSCRIPTION_CANCELED\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4d71461e-796d-4084-b39d-99b7968310d9", "name": "Falta `day` ou o cabeçalho `Idempotency-Key` (`INVALID_REQUEST`).", "originalRequest": { "url": { "path": [ "v1", "subscription", "billing-day" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"day\": 10\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "556fa15c-965b-42c8-8911-e5140531a523", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "subscription", "billing-day" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"day\": 10\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d747d3a5-c991-4f2e-ac94-d027a6e0e518", "name": "Falta o segundo fator com `purpose: subscription`\n(`STEP_UP_REQUIRED`); a conta não está ativa (`FORBIDDEN` com\n`details.reason: ACCOUNT_NOT_ACTIVE`); a funcionalidade está\ndesligada (`FEATURE_DISABLED`).\n", "originalRequest": { "url": { "path": [ "v1", "subscription", "billing-day" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"day\": 10\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7845c21d-1fe5-4c6a-83e4-f70a2eba7250", "name": "A conta não tem plano (`NOT_FOUND`).", "originalRequest": { "url": { "path": [ "v1", "subscription", "billing-day" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"day\": 10\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1e2db0a7-484e-42f3-85a9-e445c64c9210", "name": "`CONFLICT` com `details.reason`: `SAME_DAY`,\n`ALREADY_CHANGED_THIS_PERIOD`, `ALREADY_SCHEDULED`,\n`SUBSCRIPTION_CANCELED`, `UNCOLLECTED_CHARGES` ou\n`SUBSCRIPTION_CHANGED`. Ou `IDEMPOTENCY_KEY_REUSED` /\n`IDEMPOTENCY_IN_FLIGHT`.\n", "originalRequest": { "url": { "path": [ "v1", "subscription", "billing-day" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"day\": 10\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6fd1166d-8db7-40bf-921d-e1ca616ffd66", "name": "Dia fora de 1 a 28 (`INVALID_REQUEST`).", "originalRequest": { "url": { "path": [ "v1", "subscription", "billing-day" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"day\": 10\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "cb4519b0-df02-40d7-acfe-c0b69bb4e25c", "name": "Desfaz a troca do dia de cobrança", "request": { "name": "Desfaz a troca do dia de cobrança", "description": { "content": "Desfaz a troca agendada enquanto a cobrança proporcional com o dia\nnovo não foi gerada; depois disso, `409` com `details.reason:\nALREADY_GENERATED`. Sem troca agendada, `NO_PENDING_CHANGE`. Desfazer\nlibera uma nova troca no mesmo período.\n\nExige **sempre** `X-Step-Up` com `purpose: subscription` e\n`Idempotency-Key`. Corpo vazio (`{}`).\n", "type": "text/plain" }, "url": { "path": [ "v1", "subscription", "billing-day", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "df91959a-62d5-4a61-a84c-f6f16f4e78b7", "name": "Troca desfeita; `pendingBillingDay` volta a ser nulo.", "originalRequest": { "url": { "path": [ "v1", "subscription", "billing-day", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"laboris proident\",\n \"status\": \"ACTIVE\",\n \"plan\": {\n \"id\": \"Excepteur\",\n \"name\": \"sit ex Ut nulla irure\",\n \"description\": \"Ut ut dolor\",\n \"benefits\": [\n \"sunt aliqua elit eiusmod\",\n \"adip\"\n ],\n \"quotas\": [\n {\n \"service\": \"PIX_OUT\",\n \"label\": \"Pix enviado\",\n \"included\": 95819382,\n \"unlimited\": true\n },\n {\n \"service\": \"PIX_OUT\",\n \"label\": \"Pix enviado\",\n \"included\": 45279547,\n \"unlimited\": true\n }\n ]\n },\n \"billingDay\": 24,\n \"startedAt\": \"1951-04-08T03:56:31.669Z\",\n \"nextDueDate\": \"2004-07-09\",\n \"nextAmountCents\": 20125036,\n \"paidThrough\": \"2010-04-17\",\n \"pendingPlan\": null,\n \"currentCharge\": {\n \"id\": \"nulla irure cillu\",\n \"competence\": \"2026-11\",\n \"dueDate\": \"1971-02-15\",\n \"amountCents\": 8477492,\n \"status\": \"PAID_BILLET\",\n \"retryUntil\": \"2022-05-28\",\n \"paidAt\": \"1956-04-02T06:53:23.588Z\",\n \"transactionId\": \"eiusmod ut ex dolor\",\n \"billet\": null,\n \"kind\": \"PRORATA\",\n \"periodStart\": \"2020-07-27\"\n },\n \"canceledAt\": \"2019-06-10T08:35:28.499Z\",\n \"planChangeFrom\": \"2025-03-10\",\n \"planChangeBlockedReason\": \"FEATURE_DISABLED\",\n \"pendingBillingDay\": 23,\n \"billingDayChangeFrom\": \"2008-07-08\",\n \"billingDayChangeAmountCents\": -29182294,\n \"graceUntil\": \"2000-06-06\",\n \"canChangeBillingDay\": false,\n \"billingDayChangeBlockedReason\": \"SUBSCRIPTION_CANCELED\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1a0fd236-f51d-40b1-978c-d3374079ead8", "name": "Falta o cabeçalho `Idempotency-Key` (`INVALID_REQUEST`).", "originalRequest": { "url": { "path": [ "v1", "subscription", "billing-day", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "decf1911-1ac4-4b08-86d1-bc5287ff905c", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "subscription", "billing-day", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3395074f-8dd4-4d54-b1b7-9b28e22f1186", "name": "Falta o segundo fator com `purpose: subscription`\n(`STEP_UP_REQUIRED`); a conta não está ativa; a funcionalidade\nestá desligada (`FEATURE_DISABLED`).\n", "originalRequest": { "url": { "path": [ "v1", "subscription", "billing-day", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d6aba436-093a-4668-aa61-a2d31a2de344", "name": "A conta não tem plano (`NOT_FOUND`).", "originalRequest": { "url": { "path": [ "v1", "subscription", "billing-day", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3aa67442-8bb1-42f9-be69-441c7021a92e", "name": "`CONFLICT` com `details.reason`: `ALREADY_GENERATED`,\n`NO_PENDING_CHANGE`, `SUBSCRIPTION_CANCELED`,\n`UNCOLLECTED_CHARGES` ou `SUBSCRIPTION_CHANGED`.\n", "originalRequest": { "url": { "path": [ "v1", "subscription", "billing-day", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "ac1433a3-2d50-4223-aada-98a64de9350a", "name": "Benefícios", "description": { "content": "A vitrine de benefícios de quem está na sessão (funcionalidade\n`marketplace`): banners de novidades, ofertas de parceiros (\"mimos\")\nagrupadas por categoria e o link da loja. Só leitura e só de sessão:\numa chave de API recebe `403 FORBIDDEN`. Com a funcionalidade desligada,\n`403 FEATURE_DISABLED` (`details.feature: marketplace`).\n\nNada aqui move dinheiro. \"Cashback\" de oferta (`cashback_informativo`) é\no que o PARCEIRO promete; o banco não credita valor nenhum. Ofertas e\nbanners podem ser só para assinantes de alguns planos: a vitrine já vem\nfiltrada para a conta da sessão.\n", "type": "text/plain" }, "item": [ { "id": "90efaeda-b139-42a0-95af-b06c98ca24a2", "name": "Vitrine de benefícios", "request": { "name": "Vitrine de benefícios", "description": { "content": "O que está no ar hoje (data civil no fuso da operação, `today`) para a\nconta da sessão:\n\n- `banners`: na ordem de exibição, até 10 por lugar. `destination`\n diz o que o toque faz: `nenhum` (só informativo), `interna` (abre a\n tela da chave `route`) ou `externa` (abre `url`, sempre https, de um\n domínio que a instituição permitiu). Chaves de `route`: `pix`,\n `cobrar`, `pagar`, `ted`, `recarga`, `cartoes`, `indique`,\n `informes`, `plano`, `vitrine`; banner para tela desligada não vem.\n Ignore a chave que não conhecer.\n `placements` diz em que telas o banner **aparece** (separado de para\n onde ele leva): mostre em cada tela só os banners que a trazem. Vem\n só com os lugares cuja tela está ligada nesta instalação. Sem\n `placements=all` na consulta, vêm só os banners de `inicio` e\n `beneficios`, até 10 (o que um cliente que não conhece o campo\n mostra). `theme`, `backgroundColor` e `textColor` dão as cores do\n banner (iguais no modo claro e no escuro; nulas, o visual padrão\n do app), e `imageUrl`, quando há, é o caminho **relativo à API** da\n imagem (`GET /v1/marketplace/banners/{id}/image`), decorativa, na\n posição `imagePosition`.\n- `categories`: as ofertas elegíveis agrupadas pela categoria do\n parceiro, na ordem `farmacia`, `mobilidade`, `saude`, `compras`,\n `servicos`, `outros` (categoria sem oferta não vem). `couponCode`\n só nas ofertas `cupom`. `url`, quando há, é https de domínio\n permitido. `endsOn` é o último dia da oferta. `partner.logoUrl`,\n quando o parceiro tem logo, é o caminho **relativo à API** da\n imagem (`GET /v1/marketplace/partners/{id}/logo`); some o endereço\n da API à frente. Nulo ou ausente: mostre as iniciais do nome.\n- `storeUrl`: o link da loja, ou nulo.\n\nListas vazias são 200. Só com sessão de cliente: **não** aceita chave\nde API.\n", "type": "text/plain" }, "url": { "path": [ "v1", "marketplace" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": true, "key": "placements", "value": "all", "description": "`all`: os banners de todos os lugares (até 10 por lugar). Ausente:\nsó os de `inicio` e `beneficios`, até 10 no total.\n" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "3cbe7636-0285-4a87-973a-4e03b3550c54", "name": "Vitrine", "originalRequest": { "url": { "path": [ "v1", "marketplace" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "placements", "value": "all" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"today\": \"1966-05-22\",\n \"storeUrl\": \"https://BecyZXubsHlKOORNMLerBTEqZ.erohi9B1NdnEseE6W-1UD\",\n \"banners\": [\n {\n \"id\": \"cupidatat\",\n \"title\": \"ea culpa \",\n \"text\": \"dolor culpa anim\",\n \"destination\": \"interna\",\n \"route\": \"ex ad\",\n \"url\": \"http://VkHpGMnEFOMNMWbZvRnyvCsWHj.uesXBmzJA8NdDQOtPBgK,9mlUtj5,C4wSN9lmcvyez,\",\n \"placements\": [\n \"indique\"\n ],\n \"theme\": \"laranja\",\n \"backgroundColor\": \"#2750E4\",\n \"textColor\": \"#92938C\",\n \"imageUrl\": \"in laboris et\",\n \"imagePosition\": \"fundo\"\n },\n {\n \"id\": \"cupidatat\",\n \"title\": \"amet Except\",\n \"text\": \"incididunt quis id\",\n \"destination\": \"interna\",\n \"route\": \"ex mollit\",\n \"url\": \"http://MZEoJFgkaKSdrqtQPGdphRneKKnRfB.byQ8dwzzFQo+ji+NCvvVY62HELvEo+MEJ5\",\n \"placements\": [\n \"pix\"\n ],\n \"theme\": \"laranja\",\n \"backgroundColor\": \"#E4EAA1\",\n \"textColor\": \"#DDD2D4\",\n \"imageUrl\": \"dolor dolore\",\n \"imagePosition\": \"fundo\"\n }\n ],\n \"categories\": [\n {\n \"category\": \"farmacia\",\n \"offers\": [\n {\n \"id\": {\n \"value\": \"\"\n },\n \"title\": {\n \"value\": \"\"\n },\n \"description\": {\n \"value\": \"\"\n },\n \"kind\": {\n \"value\": \"\"\n },\n \"benefit\": {\n \"value\": \"\"\n },\n \"couponCode\": {\n \"value\": \"\"\n },\n \"url\": {\n \"value\": \"\"\n },\n \"endsOn\": {\n \"value\": \"\"\n },\n \"partner\": {\n \"value\": \"\"\n }\n },\n {\n \"id\": {\n \"value\": \"\"\n },\n \"title\": {\n \"value\": \"\"\n },\n \"description\": {\n \"value\": \"\"\n },\n \"kind\": {\n \"value\": \"\"\n },\n \"benefit\": {\n \"value\": \"\"\n },\n \"couponCode\": {\n \"value\": \"\"\n },\n \"url\": {\n \"value\": \"\"\n },\n \"endsOn\": {\n \"value\": \"\"\n },\n \"partner\": {\n \"value\": \"\"\n }\n }\n ]\n },\n {\n \"category\": \"outros\",\n \"offers\": [\n {\n \"id\": {\n \"value\": \"\"\n },\n \"title\": {\n \"value\": \"\"\n },\n \"description\": {\n \"value\": \"\"\n },\n \"kind\": {\n \"value\": \"\"\n },\n \"benefit\": {\n \"value\": \"\"\n },\n \"couponCode\": {\n \"value\": \"\"\n },\n \"url\": {\n \"value\": \"\"\n },\n \"endsOn\": {\n \"value\": \"\"\n },\n \"partner\": {\n \"value\": \"\"\n }\n },\n {\n \"id\": {\n \"value\": \"\"\n },\n \"title\": {\n \"value\": \"\"\n },\n \"description\": {\n \"value\": \"\"\n },\n \"kind\": {\n \"value\": \"\"\n },\n \"benefit\": {\n \"value\": \"\"\n },\n \"couponCode\": {\n \"value\": \"\"\n },\n \"url\": {\n \"value\": \"\"\n },\n \"endsOn\": {\n \"value\": \"\"\n },\n \"partner\": {\n \"value\": \"\"\n }\n }\n ]\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bacfa8fc-ec7d-4bdf-9337-57ab4b1b5489", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "marketplace" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "placements", "value": "all" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "72337231-a34b-4289-8531-8ee8bc862dbe", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "marketplace" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "placements", "value": "all" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b3e5cad0-7211-48d5-9e90-acef6710e409", "name": "Logo do parceiro da vitrine", "request": { "name": "Logo do parceiro da vitrine", "description": { "content": "A imagem do logo de um parceiro, para usar direto num ``. O\ncaminho vem pronto em `partner.logoUrl` de `GET /v1/marketplace`\n(com `?v=`, que muda quando o logo muda); não monte o endereço.\n\n**Sem sessão**: a tag `` do navegador não envia o token de\nacesso, e o logo de um parceiro não é dado pessoal. Continua sujeita\nà funcionalidade `marketplace` (`403 FEATURE_DISABLED` desligada).\n\nSempre `Content-Type: image/png` (o servidor regrava a imagem\nenviada pelo operador em PNG), com `X-Content-Type-Options: nosniff`,\n`Cache-Control: public, max-age=300` e `ETag` (o sha256 do PNG):\ncom `If-None-Match` igual, `304` sem corpo. Parceiro inexistente ou\nsem logo: `404`.\n", "type": "text/plain" }, "url": { "path": [ "v1", "marketplace", "partners", ":id", "logo" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": true, "key": "v", "value": "consequat", "description": "Marca da versão do logo, ignorada pelo servidor (só muda o endereço no cache)." } ], "variable": [ { "disabled": false, "type": "any", "value": "culpa ad laboris ut", "key": "id", "description": "(Required) " } ] }, "header": [ { "disabled": true, "key": "If-None-Match", "value": "consequat", "description": "" }, { "key": "Accept", "value": "image/png" } ], "method": "GET", "auth": null }, "response": [ { "id": "aeeb48ac-6fc6-4bb7-bc16-3fde12118c84", "name": "O logo em PNG", "originalRequest": { "url": { "path": [ "v1", "marketplace", "partners", ":id", "logo" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "v", "value": "consequat" } ], "variable": [ { "disabled": false, "type": "any", "value": "culpa ad laboris ut", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "key": "If-None-Match", "value": "consequat", "description": "" }, { "key": "Accept", "value": "image/png" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "disabled": true, "key": "ETag", "value": "consequat", "description": "" }, { "disabled": true, "key": "Cache-Control", "value": "consequat", "description": "" }, { "key": "Content-Type", "value": "image/png" } ], "body": "consequat", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "16aebc0e-86e2-4dda-8165-3fb02bded181", "name": "O `ETag` de `If-None-Match` ainda vale; sem corpo.", "originalRequest": { "url": { "path": [ "v1", "marketplace", "partners", ":id", "logo" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "v", "value": "consequat" } ], "variable": [ { "disabled": false, "type": "any", "value": "culpa ad laboris ut", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "key": "If-None-Match", "value": "consequat", "description": "" } ], "method": "GET", "body": {} }, "status": "Not Modified", "code": 304, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "a305862a-2453-440a-9ee8-033733dc9eac", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "marketplace", "partners", ":id", "logo" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "v", "value": "consequat" } ], "variable": [ { "disabled": false, "type": "any", "value": "culpa ad laboris ut", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "key": "If-None-Match", "value": "consequat", "description": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7856c767-dc63-464f-8360-2bd6b7cf9ab3", "name": "Registro não encontrado", "originalRequest": { "url": { "path": [ "v1", "marketplace", "partners", ":id", "logo" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "v", "value": "consequat" } ], "variable": [ { "disabled": false, "type": "any", "value": "culpa ad laboris ut", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "key": "If-None-Match", "value": "consequat", "description": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "0bf6d42c-d038-4de0-bdd1-880bb9af2edf", "name": "Imagem do banner da vitrine", "request": { "name": "Imagem do banner da vitrine", "description": { "content": "A imagem de um banner, para usar direto num ``. O caminho vem\npronto em `imageUrl` do banner em `GET /v1/marketplace` (com `?v=`,\nque muda quando a imagem muda); não monte o endereço. A imagem é\ndecorativa: o título do banner já a descreve.\n\n**Sem sessão**, como o logo do parceiro: a tag `` não envia o\ntoken de acesso, e a imagem de um banner não é dado pessoal.\nContinua sujeita à funcionalidade `marketplace` (`403\nFEATURE_DISABLED` desligada).\n\nSempre `Content-Type: image/png` (o servidor regrava a imagem\nenviada pelo operador em PNG), com `X-Content-Type-Options: nosniff`,\n`Cache-Control: public, max-age=300` e `ETag` (o sha256 do PNG):\ncom `If-None-Match` igual, `304` sem corpo. Banner inexistente ou\nsem imagem: `404`. Se a imagem falhar, mostre o banner sem ela.\n", "type": "text/plain" }, "url": { "path": [ "v1", "marketplace", "banners", ":id", "image" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": true, "key": "v", "value": "consequat", "description": "Marca da versão da imagem, ignorada pelo servidor (só muda o endereço no cache)." } ], "variable": [ { "disabled": false, "type": "any", "value": "culpa ad laboris ut", "key": "id", "description": "(Required) " } ] }, "header": [ { "disabled": true, "key": "If-None-Match", "value": "consequat", "description": "" }, { "key": "Accept", "value": "image/png" } ], "method": "GET", "auth": null }, "response": [ { "id": "02704af9-721d-4f82-829f-efecd83b054f", "name": "A imagem em PNG", "originalRequest": { "url": { "path": [ "v1", "marketplace", "banners", ":id", "image" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "v", "value": "consequat" } ], "variable": [ { "disabled": false, "type": "any", "value": "culpa ad laboris ut", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "key": "If-None-Match", "value": "consequat", "description": "" }, { "key": "Accept", "value": "image/png" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "disabled": true, "key": "ETag", "value": "consequat", "description": "" }, { "disabled": true, "key": "Cache-Control", "value": "consequat", "description": "" }, { "key": "Content-Type", "value": "image/png" } ], "body": "consequat", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "94103d2a-e7ec-41b6-bc07-fa6fab9c0184", "name": "O `ETag` de `If-None-Match` ainda vale; sem corpo.", "originalRequest": { "url": { "path": [ "v1", "marketplace", "banners", ":id", "image" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "v", "value": "consequat" } ], "variable": [ { "disabled": false, "type": "any", "value": "culpa ad laboris ut", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "key": "If-None-Match", "value": "consequat", "description": "" } ], "method": "GET", "body": {} }, "status": "Not Modified", "code": 304, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "15c6e4b7-02ec-4fb7-a24b-31c9385c01ee", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "marketplace", "banners", ":id", "image" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "v", "value": "consequat" } ], "variable": [ { "disabled": false, "type": "any", "value": "culpa ad laboris ut", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "key": "If-None-Match", "value": "consequat", "description": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0ee70c85-5dc3-4ca3-bd6a-c24321d1c263", "name": "Registro não encontrado", "originalRequest": { "url": { "path": [ "v1", "marketplace", "banners", ":id", "image" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "v", "value": "consequat" } ], "variable": [ { "disabled": false, "type": "any", "value": "culpa ad laboris ut", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "disabled": true, "key": "If-None-Match", "value": "consequat", "description": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "25f3fd2e-9772-4808-9504-9f86c1c09350", "name": "Tarifas", "description": { "content": "Tarifas por serviço (funcionalidade `service_fees`): a tabela vigente\npara o público da conta (pessoa física ou jurídica) e a cotação da\ntarifa de uma operação antes de confirmá-la. Catálogo fechado de oito\nserviços: `PIX_OUT`, `PIX_IN_QR`, `TED_OUT`, `INTERNAL_OUT`,\n`BILLET_ISSUE`, `BILLET_SETTLED`, `BILL_PAYMENT`, `TOPUP`. Preço fixo\nou percentual (pontos-base, piso e teto, arredondado para baixo);\nisenções legais de pessoa física travadas no servidor (Pix enviado\nsempre isento; as duas primeiras transferências internas do mês civil).\nA tarifa é lançada junto da operação, como linha própria no extrato\n(`kind: TARIFF`, `feeOf` aponta para a operação), e estornada junto\nquando a operação falha. Split da receita: a instituição pode\nratear a tarifa (e a mensalidade do plano) com contas de clientes da\nlista de destinos aprovada pelo backoffice; o destino recebe uma linha\nprópria no extrato (`kind: FEE_SHARE_RECEIVED`, \"Repasse · \"),\nsem identificar o pagador, e o estorno da tarifa estorna o repasse. A\ntabela e a cotação servem à sessão e à chave de API com `accounts:read`\ne, nas saídas por chave, `expectedFeeCents` é obrigatório. Com a\nfuncionalidade desligada, `403 FEATURE_DISABLED` (`details.feature:\nservice_fees`), nenhuma operação cobra tarifa e nada é repassado.\n", "type": "text/plain" }, "item": [ { "id": "fcdd288e-1069-40f6-9780-a93eeea5ff10", "name": "Tabela de tarifas da conta", "request": { "name": "Tabela de tarifas da conta", "description": { "content": "A tabela vigente para o público da conta (`audience`: `PF` ou\n`PJ`): uma linha por serviço do catálogo, sempre as oito, com o preço\nem vigor hoje (`pricing: FREE` quando não há preço ou ele é zero), a\nisenção por norma quando houver (`exemptByRule`, `exemptionRule`,\n`freeFirstPerMonth`) e o próximo preço já agendado (`scheduled`, ou\nnulo). Sem preço cadastrado nada é cobrado.\n", "type": "text/plain" }, "url": { "path": [ "v1", "fees" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "c14fb623-6a39-43b7-a7e0-cd1b6424524e", "name": "A tabela.", "originalRequest": { "url": { "path": [ "v1", "fees" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"audience\": \"PJ\",\n \"items\": [\n {\n \"service\": \"INTERNAL_OUT\",\n \"name\": \"Pix enviado\",\n \"label\": \"Tarifa · Pix enviado\",\n \"audience\": \"PF\",\n \"pricing\": \"FIXED\",\n \"amountCents\": 50710519,\n \"percentBps\": 244,\n \"minCents\": 18240253,\n \"maxCents\": 55115093,\n \"exemptByRule\": false,\n \"scheduled\": {\n \"value\": \"\"\n },\n \"freeFirstPerMonth\": 62522015,\n \"exemptionRule\": \"Res. BCB 19/2020, art. 3º, I\"\n },\n {\n \"service\": \"TOPUP\",\n \"name\": \"Pix enviado\",\n \"label\": \"Tarifa · Pix enviado\",\n \"audience\": \"PJ\",\n \"pricing\": \"FREE\",\n \"amountCents\": 85672510,\n \"percentBps\": 4203,\n \"minCents\": 28633738,\n \"maxCents\": 42266441,\n \"exemptByRule\": true,\n \"scheduled\": {\n \"value\": \"\"\n },\n \"freeFirstPerMonth\": 92528826,\n \"exemptionRule\": \"Res. BCB 19/2020, art. 3º, I\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "56f3e94b-9606-459f-b19e-6aff5ae1903c", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "fees" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e0f11a77-84ac-43d9-9c2d-fdc7fba51829", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "fees" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "7de7431b-3730-4205-a8ac-af70d610ddbf", "name": "Cotação da tarifa de uma operação", "request": { "name": "Cotação da tarifa de uma operação", "description": { "content": "Quanto a conta pagaria de tarifa por executar `service` com\n`amountCents` agora, na mesma ordem da cobrança: isenção por norma,\ncesta do plano (quando a conta tem plano com cota para o serviço),\ntabela, isento. **Não grava nada**: a cota consultada é devolvida. O\ncliente mostra `feeCents` e `totalCents` na confirmação e envia\n`feeCents` como `expectedFeeCents` na operação; se a tarifa real\nfor maior na hora (a cota acabou, o preço virou), a operação responde\n`409 FEE_CHANGED` e a tela refaz a cotação. Chave de API com\n`accounts:read` também cota (e a tabela, `GET /v1/fees`): nas saídas\npor chave com `service_fees` ligada, `expectedFeeCents` é obrigatório.\n", "type": "text/plain" }, "url": { "path": [ "v1", "fees", "quote" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "service", "value": "TED_OUT", "description": "(Required) " }, { "disabled": false, "key": "amountCents", "value": "59256098", "description": "(Required) O valor da operação, em centavos (base do preço percentual)." } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "b3b666d8-59c2-4e2d-811b-7e170af42514", "name": "A cotação.", "originalRequest": { "url": { "path": [ "v1", "fees", "quote" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "service", "value": "TED_OUT" }, { "key": "amountCents", "value": "59256098" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"service\": \"labo\",\n \"label\": \"dolore ea\",\n \"amountCents\": 79015461,\n \"feeCents\": 70390526,\n \"reason\": \"FREE\",\n \"coveredByPlan\": true,\n \"planUsage\": {\n \"used\": 64178204,\n \"included\": 293056,\n \"unlimited\": true\n },\n \"totalCents\": 45443003\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c48d40d9-730b-4622-af5c-cf4c1376c337", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "fees", "quote" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "service", "value": "TED_OUT" }, { "key": "amountCents", "value": "59256098" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7276ae8d-9cc0-44b2-85d3-b2f56544f67d", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "fees", "quote" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "service", "value": "TED_OUT" }, { "key": "amountCents", "value": "59256098" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e7286bd5-9e68-417d-a1a1-9a9fceee281e", "name": "Serviço desconhecido ou valor inválido (`INVALID_REQUEST`).", "originalRequest": { "url": { "path": [ "v1", "fees", "quote" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "service", "value": "TED_OUT" }, { "key": "amountCents", "value": "59256098" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "fd53ce27-f17e-4753-b331-c28ec4ed04d8", "name": "Recarga", "description": { "content": "Recarga de celular (funcionalidade `topup`). As rotas existiam fora do\ncontrato; entram aqui porque a tarifa `TOPUP` (funcionalidade\n`service_fees`) passou por elas: `POST /v1/topups` aceita\n`expectedFeeCents`, responde `409 FEE_CHANGED` e `422` como as demais\noperações de saída, e devolve a tarifa em `transaction` (`feeCents`,\n`feeTransactionId`, `feeReason`, `feeStatus`). Só de sessão. Sem\nfornecedor de recarga configurado, a lista responde `available: false`\ne as demais rotas `503`.\n", "type": "text/plain" }, "item": [ { "id": "51e2ee93-b725-4507-911c-4014f55d2f90", "name": "Recargas recentes da conta", "request": { "name": "Recargas recentes da conta", "description": { "content": "As últimas recargas, para repetir. `available: false` quando a\ninstalação não tem fornecedor de recarga (a tela diz \"ainda não\ndisponível\"); `simulated` diz se o fornecedor é o simulado.\n", "type": "text/plain" }, "url": { "path": [ "v1", "topups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "ff1456d7-1af6-42a7-acbf-5badd86b8f7f", "name": "As recargas.", "originalRequest": { "url": { "path": [ "v1", "topups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"items\": [\n {\n \"id\": \"ut consequat\",\n \"status\": \"labore laborum sint Duis eu\",\n \"amountCents\": 4566852,\n \"phone\": \"culpa\",\n \"phoneMasked\": \"deserunt veniam commodo\",\n \"phoneFormatted\": \"aliquip aute\",\n \"operatorId\": \"culpa\",\n \"operatorName\": \"a\",\n \"createdAt\": \"1964-02-08T08:07:25.045Z\",\n \"transaction\": {\n \"description\": \"A transação da reserva, com `feeCents`, `feeTransactionId`, `feeReason` e `feeStatus` quando a tarifa `TOPUP` foi decidida.\",\n \"value\": \"\"\n }\n },\n {\n \"id\": \"nisi Ut elit qui ullamco\",\n \"status\": \"fugiat sit\",\n \"amountCents\": 39142262,\n \"phone\": \"in magna\",\n \"phoneMasked\": \"reprehenderit nisi\",\n \"phoneFormatted\": \"in pariatur\",\n \"operatorId\": \"ad dolor\",\n \"operatorName\": \"tempor Ut ex Duis\",\n \"createdAt\": \"1964-12-14T04:36:22.480Z\",\n \"transaction\": {\n \"description\": \"A transação da reserva, com `feeCents`, `feeTransactionId`, `feeReason` e `feeStatus` quando a tarifa `TOPUP` foi decidida.\",\n \"value\": \"\"\n }\n }\n ],\n \"available\": true,\n \"simulated\": false\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "adfd1f12-6c71-4d71-8456-5816648a29bd", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "topups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4f25df35-456b-448c-adb7-f705682bfdc2", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "topups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "12e9a88e-0887-4699-88f5-97061f0322df", "name": "Recarregar um celular", "request": { "name": "Recarregar um celular", "description": { "content": "Debita o valor da recarga (e a tarifa `TOPUP`, quando há) e pede a\nrecarga à operadora. Exige `Idempotency-Key`; a partir do limiar de\nvalor, ou quando a soma das recargas do dia chega a ele, segundo fator\n(`purpose: transfer`). A resposta é `202`: a\nrecarga foi aceita e o desfecho vem pela consulta\n(`GET /v1/topups/{id}`). A transação da reserva está em `transaction`,\ncom a tarifa.\n", "type": "text/plain" }, "url": { "path": [ "v1", "topups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"phone\": \"reprehenderit labore eu\",\n \"operatorId\": \"ex quis id elit\",\n \"amountCents\": 91087947,\n \"expectedFeeCents\": 90038650\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "d1225440-ade9-4887-8736-9d39bd3a9916", "name": "Recarga aceita.", "originalRequest": { "url": { "path": [ "v1", "topups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"phone\": \"reprehenderit labore eu\",\n \"operatorId\": \"ex quis id elit\",\n \"amountCents\": 91087947,\n \"expectedFeeCents\": 90038650\n}", "options": { "raw": { "language": "json" } } } }, "status": "Accepted", "code": 202, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"dolore Excepteur fugiat\",\n \"status\": \"ad reprehenderit sunt dolor\",\n \"amountCents\": 85844328,\n \"phone\": \"proident in\",\n \"phoneMasked\": \"esse do aliquip\",\n \"phoneFormatted\": \"ad elit mollit\",\n \"operatorId\": \"amet\",\n \"operatorName\": \"ea in Excepteur ipsum \",\n \"createdAt\": \"1963-12-31T08:52:18.718Z\",\n \"transaction\": {\n \"id\": \"tx_9f2c1a7b\",\n \"kind\": \"TED_RECEIVED\",\n \"status\": \"REVERSED\",\n \"amountCents\": -5000,\n \"description\": \"sunt dolore\",\n \"counterparty\": {\n \"name\": \"aut\",\n \"document\": \"anim\",\n \"bank\": \"laboris ea\",\n \"pixKey\": \"quis et\"\n },\n \"endToEndId\": \"venia\",\n \"providerTransactionId\": \"id aliquip esse ullamco\",\n \"riskScore\": 32,\n \"riskSignals\": [\n {\n \"code\": {\n \"value\": \"\"\n },\n \"label\": {\n \"value\": \"\"\n },\n \"detail\": {\n \"value\": \"\"\n },\n \"triggered\": {\n \"value\": \"\"\n }\n },\n {\n \"code\": {\n \"value\": \"\"\n },\n \"label\": {\n \"value\": \"\"\n },\n \"detail\": {\n \"value\": \"\"\n },\n \"triggered\": {\n \"value\": \"\"\n }\n }\n ],\n \"createdAt\": \"2008-02-21T11:49:35.640Z\",\n \"executedAt\": \"1956-02-01T16:50:27.991Z\",\n \"refundOf\": \"se\",\n \"refundableCents\": 16687668,\n \"billetReceipt\": {\n \"description\": \"O comprovante de um pagamento de contas (`kind: PAYMENT_BILLET`): só a\\nautenticação, a data de liquidação e o convênio. Só no detalhe, e só\\nquando o banco já devolveu a confirmação.\\n\",\n \"value\": \"\"\n },\n \"disputableUntil\": \"2024-11-20T03:31:44.306Z\",\n \"disputeId\": \"consequat minim aute\",\n \"ted\": {\n \"bankIspb\": \"18236120\",\n \"branch\": \"0001\",\n \"accountMasked\": \"••••••977\",\n \"accountType\": \"CHECKING\",\n \"holderName\": \"elit\",\n \"holderDocumentMasked\": \"exercitation eu\",\n \"movementId\": \"esse Duis commodo\",\n \"strControl\": \"ullamco veniam min\"\n },\n \"bankAccount\": {\n \"bankIspb\": \"18236120\",\n \"branch\": \"0001\",\n \"accountMasked\": \"••••••977\",\n \"accountType\": \"PAYMENT\",\n \"holderName\": \"ea exercitation deserunt voluptate do\",\n \"holderDocumentMasked\": \"am\",\n \"movementId\": \"Duis reprehenderit eu irure\"\n },\n \"feeCents\": 76073809,\n \"feeTransactionId\": \"Ut\",\n \"feeReason\": \"TABLE\",\n \"feeStatus\": \"PENDING\",\n \"fee\": {\n \"description\": \"A tarifa desta operação, só no detalhe (`GET /v1/transactions/{id}`).\",\n \"value\": \"\"\n },\n \"feeOf\": \"incididunt sint exercitation dolore\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2d6da2c8-e9c9-42da-aeb7-36ef01b4c855", "name": "Falta o cabeçalho `Idempotency-Key`, ou o corpo é ilegível.", "originalRequest": { "url": { "path": [ "v1", "topups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"phone\": \"reprehenderit labore eu\",\n \"operatorId\": \"ex quis id elit\",\n \"amountCents\": 91087947,\n \"expectedFeeCents\": 90038650\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a04843e3-d6c4-4ddf-8bbf-93e9ea4d8ebd", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "topups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"phone\": \"reprehenderit labore eu\",\n \"operatorId\": \"ex quis id elit\",\n \"amountCents\": 91087947,\n \"expectedFeeCents\": 90038650\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "297244ca-0439-41cd-af88-2d54b13c5e40", "name": "Segundo fator exigido (`STEP_UP_REQUIRED`), conta bloqueada, ou funcionalidade desligada (`FEATURE_DISABLED`).", "originalRequest": { "url": { "path": [ "v1", "topups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"phone\": \"reprehenderit labore eu\",\n \"operatorId\": \"ex quis id elit\",\n \"amountCents\": 91087947,\n \"expectedFeeCents\": 90038650\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "17cdddc2-c35a-4d09-97ec-1e2fd4511c7f", "name": "Tarifa maior que a esperada (`CONFLICT`, `details.reason: FEE_CHANGED`), ou chave de idempotência reaproveitada.", "originalRequest": { "url": { "path": [ "v1", "topups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"phone\": \"reprehenderit labore eu\",\n \"operatorId\": \"ex quis id elit\",\n \"amountCents\": 91087947,\n \"expectedFeeCents\": 90038650\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0d69b00a-ae61-43c0-868f-e73db2240d9b", "name": "Número, operadora ou valor inválidos (`INVALID_REQUEST`); saldo insuficiente (`INSUFFICIENT_FUNDS`, com `details.amountCents/feeCents/totalCents`); limite excedido (`LIMIT_EXCEEDED`).", "originalRequest": { "url": { "path": [ "v1", "topups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"phone\": \"reprehenderit labore eu\",\n \"operatorId\": \"ex quis id elit\",\n \"amountCents\": 91087947,\n \"expectedFeeCents\": 90038650\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2102900f-bd8e-42bf-b1a4-f645c0cc0478", "name": "O arranjo de pagamento está indisponível. Tente novamente.", "originalRequest": { "url": { "path": [ "v1", "topups" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) De 8 a 128 caracteres, único por operação. Um UUID v4 serve.\n\nGuarde-o antes de enviar a requisição, não depois: a chave só protege se\nsobreviver ao processo que caiu no meio.\n\nA chave é lembrada por 90 dias a partir da primeira requisição. Repetir\ndepois disso conta como operação nova.\n", "key": "Idempotency-Key", "value": "6f1e2a94-7c3d-4b58-9e21-0a8c5d3f7b62" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"phone\": \"reprehenderit labore eu\",\n \"operatorId\": \"ex quis id elit\",\n \"amountCents\": 91087947,\n \"expectedFeeCents\": 90038650\n}", "options": { "raw": { "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1ff46e5d-2d5c-4c13-b718-0287a3e90f19", "name": "Operadoras e valores para um número", "request": { "name": "Operadoras e valores para um número", "description": {}, "url": { "path": [ "v1", "topups", "offers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"phone\": \"mollit ut\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "8b3087a6-68a3-46c1-9d5e-d53f46e46dad", "name": "As operadoras que atendem o número, com os valores em centavos.", "originalRequest": { "url": { "path": [ "v1", "topups", "offers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"phone\": \"mollit ut\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"operators\": [\n {\n \"id\": \"ut sit\",\n \"name\": \"magna commodo\",\n \"valuesCents\": [\n 46629849,\n 29244733\n ]\n },\n {\n \"id\": \"occaecat adipisicing elit pariatur sed\",\n \"name\": \"Excepteur aliquip nisi consectetur voluptate\",\n \"valuesCents\": [\n 73815874,\n 65104584\n ]\n }\n ],\n \"phoneMasked\": \"qui labore ut\",\n \"phoneFormatted\": \"aliquip\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fedd5bfd-a4e5-4fb2-bc30-c9315d32cb68", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "topups", "offers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"phone\": \"mollit ut\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8b40144c-463a-4856-83c2-01bd14841c64", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "topups", "offers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"phone\": \"mollit ut\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d1093bfa-14ea-4235-9960-6615cbe4b124", "name": "Número inválido (`INVALID_REQUEST`).", "originalRequest": { "url": { "path": [ "v1", "topups", "offers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"phone\": \"mollit ut\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "78600710-a860-44ed-9bf5-43e87a7f6291", "name": "O arranjo de pagamento está indisponível. Tente novamente.", "originalRequest": { "url": { "path": [ "v1", "topups", "offers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"phone\": \"mollit ut\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e2cadeff-fa6d-4a4a-bcd4-bbd632086fdc", "name": "Situação de uma recarga", "request": { "name": "Situação de uma recarga", "description": {}, "url": { "path": [ "v1", "topups", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) O id da recarga (o da transação da reserva)." } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "bfd6281c-9bec-4c8a-a33e-af61b7d9fafe", "name": "A recarga, com a transação e a tarifa.", "originalRequest": { "url": { "path": [ "v1", "topups", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) O id da recarga (o da transação da reserva)." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"dolore Excepteur fugiat\",\n \"status\": \"ad reprehenderit sunt dolor\",\n \"amountCents\": 85844328,\n \"phone\": \"proident in\",\n \"phoneMasked\": \"esse do aliquip\",\n \"phoneFormatted\": \"ad elit mollit\",\n \"operatorId\": \"amet\",\n \"operatorName\": \"ea in Excepteur ipsum \",\n \"createdAt\": \"1963-12-31T08:52:18.718Z\",\n \"transaction\": {\n \"id\": \"tx_9f2c1a7b\",\n \"kind\": \"TED_RECEIVED\",\n \"status\": \"REVERSED\",\n \"amountCents\": -5000,\n \"description\": \"sunt dolore\",\n \"counterparty\": {\n \"name\": \"aut\",\n \"document\": \"anim\",\n \"bank\": \"laboris ea\",\n \"pixKey\": \"quis et\"\n },\n \"endToEndId\": \"venia\",\n \"providerTransactionId\": \"id aliquip esse ullamco\",\n \"riskScore\": 32,\n \"riskSignals\": [\n {\n \"code\": {\n \"value\": \"\"\n },\n \"label\": {\n \"value\": \"\"\n },\n \"detail\": {\n \"value\": \"\"\n },\n \"triggered\": {\n \"value\": \"\"\n }\n },\n {\n \"code\": {\n \"value\": \"\"\n },\n \"label\": {\n \"value\": \"\"\n },\n \"detail\": {\n \"value\": \"\"\n },\n \"triggered\": {\n \"value\": \"\"\n }\n }\n ],\n \"createdAt\": \"2008-02-21T11:49:35.640Z\",\n \"executedAt\": \"1956-02-01T16:50:27.991Z\",\n \"refundOf\": \"se\",\n \"refundableCents\": 16687668,\n \"billetReceipt\": {\n \"description\": \"O comprovante de um pagamento de contas (`kind: PAYMENT_BILLET`): só a\\nautenticação, a data de liquidação e o convênio. Só no detalhe, e só\\nquando o banco já devolveu a confirmação.\\n\",\n \"value\": \"\"\n },\n \"disputableUntil\": \"2024-11-20T03:31:44.306Z\",\n \"disputeId\": \"consequat minim aute\",\n \"ted\": {\n \"bankIspb\": \"18236120\",\n \"branch\": \"0001\",\n \"accountMasked\": \"••••••977\",\n \"accountType\": \"CHECKING\",\n \"holderName\": \"elit\",\n \"holderDocumentMasked\": \"exercitation eu\",\n \"movementId\": \"esse Duis commodo\",\n \"strControl\": \"ullamco veniam min\"\n },\n \"bankAccount\": {\n \"bankIspb\": \"18236120\",\n \"branch\": \"0001\",\n \"accountMasked\": \"••••••977\",\n \"accountType\": \"PAYMENT\",\n \"holderName\": \"ea exercitation deserunt voluptate do\",\n \"holderDocumentMasked\": \"am\",\n \"movementId\": \"Duis reprehenderit eu irure\"\n },\n \"feeCents\": 76073809,\n \"feeTransactionId\": \"Ut\",\n \"feeReason\": \"TABLE\",\n \"feeStatus\": \"PENDING\",\n \"fee\": {\n \"description\": \"A tarifa desta operação, só no detalhe (`GET /v1/transactions/{id}`).\",\n \"value\": \"\"\n },\n \"feeOf\": \"incididunt sint exercitation dolore\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2290600d-5a76-4425-bb50-1e5303c61622", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "topups", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) O id da recarga (o da transação da reserva)." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e0cc5d45-4a7f-40b8-8019-32f81cc3d137", "name": "Autenticado, mas sem permissão para esta operação (`FORBIDDEN`), ou a\nfuncionalidade está desligada nesta instalação (`FEATURE_DISABLED`,\ncom `details.feature`).\n", "originalRequest": { "url": { "path": [ "v1", "topups", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) O id da recarga (o da transação da reserva)." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "81181d32-77d9-45b8-8bfd-b1dc707b50c4", "name": "Registro não encontrado", "originalRequest": { "url": { "path": [ "v1", "topups", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) O id da recarga (o da transação da reserva)." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "3cbec97c-033c-4449-8a1d-8162292ffec6", "name": "Aprovação conjunta", "description": { "content": "Aprovação conjunta da conta PJ (funcionalidade `approvals`). As rotas\nexistiam fora do contrato; a de aprovar entra aqui porque a tarifa\n(funcionalidade `service_fees`) passou por ela: quem aprova vê a\ntarifa da execução e a confirma em `expectedFeeCents`. Só de sessão.\n", "type": "text/plain" }, "item": [ { "id": "d535883c-558c-4282-8130-6e0b215c377e", "name": "Aprova e executa um pedido da conta PJ", "request": { "name": "Aprova e executa um pedido da conta PJ", "description": { "content": "O segundo representante aprova o Pix ou o pagamento de boleto pedido\npor outro, e o servidor executa na hora, pelo mesmo caminho da\noperação imediata. A resposta `200` traz o pedido no desfecho:\nexecutado, executado e retido pela análise de risco, ou falho com o\nmotivo (sem débito).\n\n**Tarifa.** Com a funcionalidade `service_fees`, a execução cobra a\ntarifa do serviço (`PIX_OUT` no Pix, `BILL_PAYMENT` no boleto) vigente\n**na hora da aprovação**, sobre o valor do pedido. Quem aprova cota\nantes (`GET /v1/fees/quote`) e manda o que viu em\n`expectedFeeCents`. Se a tarifa da execução for maior que ela, ou se o\ncampo vier ausente e a tarifa for maior que zero, a resposta é `409`\ncom `details.reason: FEE_CHANGED` e `details.feeCents` (a tarifa\natual): nada é executado, o pedido continua esperando e a aprovação\npode ser refeita com a tarifa nova (e um novo segundo fator). Com a\nfuncionalidade desligada, o campo é ignorado.\n\nExige `X-Step-Up` com `purpose: transfer` e, quando a instalação a\nexige, selfie.\n", "type": "text/plain" }, "url": { "path": [ "v1", "approvals", ":id", "approve" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"expectedFeeCents\": 49582668\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "0daf98b1-9f83-434e-b7ad-636bea7fa487", "name": "O pedido no desfecho (executado, retido ou falho).", "originalRequest": { "url": { "path": [ "v1", "approvals", ":id", "approve" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"expectedFeeCents\": 49582668\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"mollit997\": \"ad\",\n \"Duis9d\": 11651543\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4ec012ba-ae5c-4f2a-961b-d142e35d3769", "name": "Credencial ausente, inválida, expirada ou de outro ambiente. No modo\nimpor da instalação, também a sessão cujo aparelho deixou de estar\nhabilitado (`DEVICE_NOT_ENABLED`, com `details.deviceStatus`): a tela\nde bloqueio substitui a volta ao login.\n", "originalRequest": { "url": { "path": [ "v1", "approvals", ":id", "approve" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"expectedFeeCents\": 49582668\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1024f2ed-d1a9-4cce-8027-1961ec8ba25e", "name": "Falta o segundo fator (`STEP_UP_REQUIRED`) ou a selfie\n(`BIOMETRIC_REQUIRED`); quem aprova é quem pediu ou não representa\na empresa (`FORBIDDEN`); a funcionalidade está desligada\n(`FEATURE_DISABLED`).\n", "originalRequest": { "url": { "path": [ "v1", "approvals", ":id", "approve" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"expectedFeeCents\": 49582668\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "80e4ec91-cf74-4ab5-b9b9-182af2e24d78", "name": "Registro não encontrado", "originalRequest": { "url": { "path": [ "v1", "approvals", ":id", "approve" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"expectedFeeCents\": 49582668\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3596b372-d8e3-4ec6-9239-54af0f753a8b", "name": "O pedido já foi decidido ou expirou (`CONFLICT`); a tarifa da\nexecução é maior que `expectedFeeCents` (`CONFLICT` com\n`details.reason: FEE_CHANGED`, `details.feeCents` e\n`details.expectedFeeCents`).\n", "originalRequest": { "url": { "path": [ "v1", "approvals", ":id", "approve" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"expectedFeeCents\": 49582668\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c8d0926a-2415-4cbe-815e-544d59ae96cb", "name": "`expectedFeeCents` negativo (`INVALID_REQUEST`).", "originalRequest": { "url": { "path": [ "v1", "approvals", ":id", "approve" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "consequat", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) Token de `POST /v1/auth/step-up`, com o `purpose` desta operação.", "key": "X-Step-Up", "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"expectedFeeCents\": 49582668\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"APPROVAL_REQUIRED\",\n \"message\": \"Saldo insuficiente para esta operação.\",\n \"requestId\": \"quis reprehenderit\",\n \"details\": {\n \"consectetura44\": \"voluptate laborum\",\n \"adipisicing91\": \"eu velit\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] } ], "event": [ { "listen": "prerequest", "script": { "type": "text/javascript", "exec": [ "if (pm.request.headers.has('Idempotency-Key')) {", " pm.request.headers.upsert({", " key: 'Idempotency-Key',", " value: pm.variables.replaceIn('{{$guid}}'),", " })", "}" ] } } ], "variable": [ { "key": "baseUrl", "value": "{{base_url}}", "type": "string" }, { "key": "base_url", "value": "https://sandbox.api.lumecoding.com", "type": "string" }, { "key": "api_key", "value": "", "type": "string" } ], "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-API-Key", "type": "string" }, { "key": "value", "value": "{{api_key}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "info": { "_postman_id": "49d16d1f-d22a-4f9b-9aed-05b95df7df5a", "name": "Lume — API bancária (sandbox)", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "description": "Coleção gerada a partir do openapi.yaml da API Lume. Não edite à mão: a\npróxima geração sobrescreve.\n\nAntes de rodar: abra o ambiente \"Lume — sandbox\" e cole sua chave em\n`api_key`. Peça uma em POST /v1/sandbox/keys, que é a única requisição desta\ncoleção que funciona sem chave." } }