{ "item": [ { "id": "8b1cf9a2-aca1-4ba8-bcd4-bbfd0fad47b6", "name": "Health Checks", "description": { "content": "Verificação do status e saúde da API", "type": "text/plain" }, "item": [ { "id": "4226e4b6-b88e-45dc-9059-5eb22fc7e8b5", "name": "Verificar conectividade com a API", "request": { "name": "Verificar conectividade com a API", "description": { "content": "Verifica a conectividade com a API.", "type": "text/plain" }, "url": { "path": [ "health", "ping" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "6dc1adf4-012b-4cfe-b063-9c74519ec56b", "name": "Conectividade verificada com sucesso", "originalRequest": { "url": { "path": [ "health", "ping" ], "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": "\"string\"", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "323ff340-c5ca-4856-b12a-068faf2c4e54", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "health", "ping" ], "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": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e6e730b8-a63e-4352-8e1b-2a890f326dc9", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "health", "ping" ], "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 \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a1c8beea-1f46-464c-8528-04dc0308c644", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "health", "ping" ], "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 \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "adb17c0c-5151-4c7a-a6a0-50b007f33c25", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "health", "ping" ], "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "40ec8991-9ac1-46d4-8c2f-4df210691334", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "health", "ping" ], "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "eca5d2e2-72d4-433f-8be7-b855effe5d0d", "name": "Autenticação", "description": { "content": "Endpoints de login, logout e gerenciamento de tokens", "type": "text/plain" }, "item": [ { "id": "80df09cc-fc4a-44c4-b56c-367094192d2c", "name": "Autenticar API Key", "request": { "name": "Autenticar API Key", "description": { "content": "Endpoint principal para autenticação de parceiros e integradores via API Key. Destinado exclusivamente para acesso programático (server-to-server).\n\n**Formato da API Key:**\n`sk_{ambiente}.{identificador}.{secret}`\n\n**Ambientes disponíveis:**\n\n**`sk_test.*`**\nAmbiente de desenvolvimento/testes para integração e homologação.\n\n**`sk_live.*`**\nAmbiente de produção para operações reais.\n\n**Token retornado:**\nJWT de acesso com validade de 10 minutos, vinculado às permissões da API Key. Use este token no header Authorization para demais chamadas à API.", "type": "text/plain" }, "url": { "path": [ "auth", "api-key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "9cb92fc4-acd1-48c0-9b19-4730cd8ab346", "name": "Autenticação bem-sucedida. Token JWT de acesso gerado com validade de 10 minutos.", "originalRequest": { "url": { "path": [ "auth", "api-key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "disabled": false, "description": "(Required) Chave de API do client, no formato `Bearer `.", "key": "authorization", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"access_token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiYWRtaW4iOnRydWUsImlhdCI6MTUxNjIzOTAyMn0.KMUFsIDTnFmyG3nMiGM6H9FNFUROf3wh7SmqJp-QV30\",\n \"token_type\": \"Bearer\",\n \"expires_in\": 3600\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "74c62ede-71cd-4d44-8861-1de612ec7ce9", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "auth", "api-key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "disabled": false, "description": "(Required) Chave de API do client, no formato `Bearer `.", "key": "authorization", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9c9edde2-1c7d-48bf-b367-a9989813b06c", "name": "API Key inválida, expirada ou revogada", "originalRequest": { "url": { "path": [ "auth", "api-key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "disabled": false, "description": "(Required) Chave de API do client, no formato `Bearer `.", "key": "authorization", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 401,\n \"code\": \"INVALID_API_KEY\",\n \"message\": \"API Key inválida, expirada ou revogada\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c79bf684-533a-4d03-a0ea-6f90f176129d", "name": "API Key válida, mas sem permissões para este recurso", "originalRequest": { "url": { "path": [ "auth", "api-key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "disabled": false, "description": "(Required) Chave de API do client, no formato `Bearer `.", "key": "authorization", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"INSUFFICIENT_PERMISSIONS\",\n \"message\": \"API Key válida, mas sem permissões para este recurso\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "056a969c-e9eb-44c2-9d50-047951a14f7a", "name": "Entidade não pode ser processada - verifique os dados", "originalRequest": { "url": { "path": [ "auth", "api-key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "disabled": false, "description": "(Required) Chave de API do client, no formato `Bearer `.", "key": "authorization", "value": "string" }, { "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 \"status_code\": 422,\n \"code\": \"UNPROCESSABLE_ENTITY\",\n \"message\": \"Entidade não pode ser processada - verifique os dados\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true,\n \"key_2\": \"string\",\n \"key_3\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a851d52d-c99e-4ece-8e4a-c7540ac28f64", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "auth", "api-key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "disabled": false, "description": "(Required) Chave de API do client, no formato `Bearer `.", "key": "authorization", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "eca52027-a82e-46cb-be85-530b9f7f8695", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "auth", "api-key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "disabled": false, "description": "(Required) Chave de API do client, no formato `Bearer `.", "key": "authorization", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5d121516-f472-4aef-bb87-e3b4938e7ef5", "name": "OAuth2 - Troca de Tokens", "request": { "name": "OAuth2 - Troca de Tokens", "description": { "content": "Segunda etapa do fluxo OAuth2. Converte códigos de autorização em tokens de acesso ou renova tokens expirados. Implementa grant types conforme RFC 6749.\n\n**Grant Types suportados:**\n\n**`authorization_code`**\nTroca código de autorização por tokens iniciais. Use após receber o código do endpoint `/oauth/authorize`.\n\n**`refresh_token`**\nRenova access token expirado usando refresh token válido. Implementa rotação de refresh tokens.\n\n**Validade dos tokens:**\n• **Access Token**: 10 minutos\n• **Refresh Token**: 30 dias (renovado a cada uso)", "type": "text/plain" }, "url": { "path": [ "oauth", "token" ], "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": "Authorization" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] }, "body": { "mode": "raw", "raw": "{\n \"grant_type\": \"urn:meioo:params:oauth:grant-type:delegation\",\n \"client_id\": \"meioo-partner-app\",\n \"client_assertion_type\": \"urn:ietf:params:oauth:client-assertion-type:jwt-bearer\",\n \"client_assertion\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\n \"code\": \"SplxlOBeZQQYbYS6WxSbIA\",\n \"redirect_uri\": \"https://client.example.com/cb\",\n \"code_verifier\": \"dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk\",\n \"delegation_id\": \"1234567890\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "bb5c27a4-a988-4fd1-9fa7-b18cc3172fbe", "name": "Tokens gerados com sucesso. Novos access_token (1h) e refresh_token (30d) fornecidos.", "originalRequest": { "url": { "path": [ "oauth", "token" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"grant_type\": \"urn:meioo:params:oauth:grant-type:delegation\",\n \"client_id\": \"meioo-partner-app\",\n \"client_assertion_type\": \"urn:ietf:params:oauth:client-assertion-type:jwt-bearer\",\n \"client_assertion\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\n \"code\": \"SplxlOBeZQQYbYS6WxSbIA\",\n \"redirect_uri\": \"https://client.example.com/cb\",\n \"code_verifier\": \"dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk\",\n \"delegation_id\": \"1234567890\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"access_token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiYWRtaW4iOnRydWUsImlhdCI6MTUxNjIzOTAyMn0.KMUFsIDTnFmyG3nMiGM6H9FNFUROf3wh7SmqJp-QV30\",\n \"token_type\": \"Bearer\",\n \"expires_in\": 3600,\n \"refresh_token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiYWRtaW4iOnRydWUsImlhdCI6MTUxNjIzOTAyMn0.KMUFsIDTnFmyG3nMiGM6H9FNFUROf3wh7SmqJp-QV30\",\n \"scopes\": [\n \"account:read\",\n \"bank-slips:read\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cd57498b-ebe5-4dcd-a6fa-2bb8d1b19f20", "name": "Grant type não suportado. Use 'authorization_code' ou 'refresh_token'", "originalRequest": { "url": { "path": [ "oauth", "token" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"grant_type\": \"urn:meioo:params:oauth:grant-type:delegation\",\n \"client_id\": \"meioo-partner-app\",\n \"client_assertion_type\": \"urn:ietf:params:oauth:client-assertion-type:jwt-bearer\",\n \"client_assertion\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\n \"code\": \"SplxlOBeZQQYbYS6WxSbIA\",\n \"redirect_uri\": \"https://client.example.com/cb\",\n \"code_verifier\": \"dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk\",\n \"delegation_id\": \"1234567890\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"UNSUPPORTED_GRANT_TYPE\",\n \"message\": \"Grant type não suportado. Use 'authorization_code' ou 'refresh_token'\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": 4048.895636357435\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ae40d9ca-b05f-4c26-8485-5d6dbc98ec16", "name": "Código de autorização ou refresh token inválido/expirado", "originalRequest": { "url": { "path": [ "oauth", "token" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"grant_type\": \"urn:meioo:params:oauth:grant-type:delegation\",\n \"client_id\": \"meioo-partner-app\",\n \"client_assertion_type\": \"urn:ietf:params:oauth:client-assertion-type:jwt-bearer\",\n \"client_assertion\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\n \"code\": \"SplxlOBeZQQYbYS6WxSbIA\",\n \"redirect_uri\": \"https://client.example.com/cb\",\n \"code_verifier\": \"dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk\",\n \"delegation_id\": \"1234567890\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 401,\n \"code\": \"INVALID_TOKEN_OR_CODE\",\n \"message\": \"Código de autorização ou refresh token inválido/expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 1039.3515002167208\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c04de07c-1bd4-4ce5-a32e-95c0f830d90e", "name": "client_id/client_secret inválidos ou aplicação não autorizada", "originalRequest": { "url": { "path": [ "oauth", "token" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"grant_type\": \"urn:meioo:params:oauth:grant-type:delegation\",\n \"client_id\": \"meioo-partner-app\",\n \"client_assertion_type\": \"urn:ietf:params:oauth:client-assertion-type:jwt-bearer\",\n \"client_assertion\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\n \"code\": \"SplxlOBeZQQYbYS6WxSbIA\",\n \"redirect_uri\": \"https://client.example.com/cb\",\n \"code_verifier\": \"dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk\",\n \"delegation_id\": \"1234567890\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"CLIENT_AUTHENTICATION_FAILED\",\n \"message\": \"client_id/client_secret inválidos ou aplicação não autorizada\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 2161\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4f1d3187-e896-43c3-9e79-cdc3e6a445b4", "name": "Código de autorização já foi utilizado ou expirou", "originalRequest": { "url": { "path": [ "oauth", "token" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"grant_type\": \"urn:meioo:params:oauth:grant-type:delegation\",\n \"client_id\": \"meioo-partner-app\",\n \"client_assertion_type\": \"urn:ietf:params:oauth:client-assertion-type:jwt-bearer\",\n \"client_assertion\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\n \"code\": \"SplxlOBeZQQYbYS6WxSbIA\",\n \"redirect_uri\": \"https://client.example.com/cb\",\n \"code_verifier\": \"dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk\",\n \"delegation_id\": \"1234567890\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 422,\n \"code\": \"INVALID_AUTHORIZATION_CODE\",\n \"message\": \"Código de autorização já foi utilizado ou expirou\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 7263,\n \"key_1\": 8722,\n \"key_2\": \"string\",\n \"key_3\": 2643.1635439399347\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2ff98d1d-fd31-4a43-8658-65fb009cab16", "name": "Limite de requisições excedido - tente novamente em alguns minutos", "originalRequest": { "url": { "path": [ "oauth", "token" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"grant_type\": \"urn:meioo:params:oauth:grant-type:delegation\",\n \"client_id\": \"meioo-partner-app\",\n \"client_assertion_type\": \"urn:ietf:params:oauth:client-assertion-type:jwt-bearer\",\n \"client_assertion\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\n \"code\": \"SplxlOBeZQQYbYS6WxSbIA\",\n \"redirect_uri\": \"https://client.example.com/cb\",\n \"code_verifier\": \"dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk\",\n \"delegation_id\": \"1234567890\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Limite de requisições excedido - tente novamente em alguns minutos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 6390.802837204974\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "12bbf79d-9210-4c08-8ddf-332063dd67c1", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "oauth", "token" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"grant_type\": \"urn:meioo:params:oauth:grant-type:delegation\",\n \"client_id\": \"meioo-partner-app\",\n \"client_assertion_type\": \"urn:ietf:params:oauth:client-assertion-type:jwt-bearer\",\n \"client_assertion\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\n \"code\": \"SplxlOBeZQQYbYS6WxSbIA\",\n \"redirect_uri\": \"https://client.example.com/cb\",\n \"code_verifier\": \"dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk\",\n \"delegation_id\": \"1234567890\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "b0f9d00a-2a79-4e3a-997d-8886e6f06864", "name": "Contas", "description": { "content": "Gestão de contas digitais, saldos e configurações", "type": "text/plain" }, "item": [ { "id": "8aec363a-b927-47ad-adf1-1c61f755bf08", "name": "Consultar saldo da conta", "request": { "name": "Consultar saldo da conta", "description": { "content": "Retorna o saldo atual da conta digital em tempo real, incluindo detalhamento de valores disponíveis e bloqueados.\n\n**Informações de saldo:**\n\n**Saldo Disponível**\nValor imediatamente disponível para transações.\n\n**Saldo Bloqueado**\nValores temporariamente indisponíveis (reservas, pre-autorizações).\n\n**Limites**\nInformações sobre limites diários, mensais e de transação configurados.\n\n**Atualização:** Os valores são consultados em tempo real no sistema bancário.", "type": "text/plain" }, "url": { "path": [ "accounts", "balance" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "9955741f-67a8-43c4-b4fb-dd032fcf3855", "name": "Saldo consultado com sucesso", "originalRequest": { "url": { "path": [ "accounts", "balance" ], "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 \"current_balance\": 1000000,\n \"available_balance\": 950000,\n \"blocked_balance\": 50000,\n \"scheduled_balance\": 15000,\n \"last_update\": \"2025-01-15T14:30:00-03:00\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a964422d-f9cc-415c-976c-7232e5118e95", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "balance" ], "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": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5584c222-b637-40f2-8424-32d9c1034d20", "name": "Token inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "balance" ], "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 \"status_code\": 401,\n \"code\": \"INVALID_CREDENTIALS\",\n \"message\": \"Token inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 1532,\n \"key_1\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e4afbfae-18d1-4adb-8121-7081a53d510d", "name": "Acesso negado - permissões insuficientes para este recurso", "originalRequest": { "url": { "path": [ "accounts", "balance" ], "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 \"status_code\": 403,\n \"code\": \"ACCESS_DENIED\",\n \"message\": \"Acesso negado - permissões insuficientes para este recurso\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 8207.703686566874\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f80fcfad-4044-4e3f-af70-5e58636b3afa", "name": "Conta não encontrada ou sem saldo disponível", "originalRequest": { "url": { "path": [ "accounts", "balance" ], "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 \"status_code\": 404,\n \"code\": \"ACCOUNT_NOT_FOUND\",\n \"message\": \"Conta não encontrada ou sem saldo disponível\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": 6677.623934265984,\n \"key_2\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4f81b014-be91-484b-9cb6-1440e8065e12", "name": "Entidade não pode ser processada - verifique os dados", "originalRequest": { "url": { "path": [ "accounts", "balance" ], "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 \"status_code\": 422,\n \"code\": \"UNPROCESSABLE_ENTITY\",\n \"message\": \"Entidade não pode ser processada - verifique os dados\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true,\n \"key_2\": \"string\",\n \"key_3\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "27f833cf-d0ec-4bc5-8d31-f91d9f94fdd3", "name": "Limite de requisições excedido - tente novamente em alguns minutos", "originalRequest": { "url": { "path": [ "accounts", "balance" ], "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Limite de requisições excedido - tente novamente em alguns minutos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 6390.802837204974\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "53c02b9b-41bf-4e43-aedd-c47c3d71e3a7", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "balance" ], "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e920614b-c82c-41a4-9e2a-7e429fdb8bbc", "name": "Consultar tarifas da conta", "request": { "name": "Consultar tarifas da conta", "description": { "content": "Retorna as tarifas aplicáveis à conta do correntista autenticado, resolvidas pela hierarquia de planos (Conta → Grupo → Parceiro → Global PF/PJ).\n\n**Informações retornadas:**\n\n**Nome do plano de tarifas**\nPlano efetivo atribuído à conta.\n\n**Regras de tarifação**\nValor fixo (FLAT) ou percentual (PERCENTAGE) por tipo de serviço.\n\n**Response 204:** Nenhum plano de tarifas atribuído à conta.", "type": "text/plain" }, "url": { "path": [ "accounts", "fees" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "2dde4fe7-8095-4745-a4f7-78963e434af7", "name": "Tarifas consultadas com sucesso", "originalRequest": { "url": { "path": [ "accounts", "fees" ], "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 \"plan_name\": \"Plano Padrao PF\",\n \"rules\": [\n {\n \"service\": \"PIX_SENT\",\n \"service_label\": \"Pix enviado\",\n \"calculation_type\": \"FLAT\",\n \"amount\": 100,\n \"percentage_rate\": 100,\n \"minimum_amount\": 500,\n \"maximum_amount\": 5000\n },\n {\n \"service\": \"PIX_SENT\",\n \"service_label\": \"Pix enviado\",\n \"calculation_type\": \"FLAT\",\n \"amount\": 100,\n \"percentage_rate\": 100,\n \"minimum_amount\": 500,\n \"maximum_amount\": 5000\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fab8fedb-cc3b-465d-8375-ea3ca78882b0", "name": "Nenhum plano de tarifas atribuído à conta", "originalRequest": { "url": { "path": [ "accounts", "fees" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "No Content", "code": 204, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "a7202a1f-392f-4acc-9a62-51985362fe97", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "fees" ], "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": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "29da86b1-24b0-48e0-926d-de51c6f51217", "name": "Token inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "fees" ], "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 \"status_code\": 401,\n \"code\": \"INVALID_CREDENTIALS\",\n \"message\": \"Token inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 1532,\n \"key_1\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "70028dad-be29-4f14-8e00-f232c29a3db9", "name": "Acesso negado - permissões insuficientes para este recurso", "originalRequest": { "url": { "path": [ "accounts", "fees" ], "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 \"status_code\": 403,\n \"code\": \"ACCESS_DENIED\",\n \"message\": \"Acesso negado - permissões insuficientes para este recurso\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 8207.703686566874\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "91786d80-8882-40e9-9490-29887d8d5740", "name": "Entidade não pode ser processada - verifique os dados", "originalRequest": { "url": { "path": [ "accounts", "fees" ], "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 \"status_code\": 422,\n \"code\": \"UNPROCESSABLE_ENTITY\",\n \"message\": \"Entidade não pode ser processada - verifique os dados\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true,\n \"key_2\": \"string\",\n \"key_3\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8ce65298-610a-4cf6-83fb-06da6c78c57d", "name": "Limite de requisições excedido - tente novamente em alguns minutos", "originalRequest": { "url": { "path": [ "accounts", "fees" ], "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Limite de requisições excedido - tente novamente em alguns minutos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 6390.802837204974\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "83c268f4-8dac-469e-b019-90da967d12b6", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "fees" ], "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "39bd78d3-f855-498e-8f4c-6ffebe3f1f36", "name": "Consultar limites da conta", "request": { "name": "Consultar limites da conta", "description": { "content": "Retorna os limites transacionais aplicáveis à conta do correntista autenticado, incluindo consumo diário em tempo real.\n\n**Informações retornadas:**\n\n**Nome do perfil de limites**\nPerfil efetivo atribuído à conta.\n\n**Período noturno**\nHorários de início e fim do período com restrição noturna.\n\n**Regras de limite**\nMáximo por transação, diário e noturno por tipo de serviço, com consumo e disponível hoje.\n\n**Response 204:** Nenhum perfil de limites atribuído à conta.", "type": "text/plain" }, "url": { "path": [ "accounts", "limits" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "f412f2b7-55c4-4774-860d-77b4208cef5b", "name": "Limites consultados com sucesso", "originalRequest": { "url": { "path": [ "accounts", "limits" ], "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 \"profile_name\": \"Limites Padrão PF\",\n \"night_period\": {\n \"start\": \"20:00\",\n \"end\": \"06:00\"\n },\n \"rules\": [\n {\n \"service\": \"PIX_SENT\",\n \"service_label\": \"Pix enviado\",\n \"max_per_transaction\": 500000,\n \"max_daily\": 1000000,\n \"daily_consumed\": 350000,\n \"daily_available\": 650000,\n \"max_nightly\": 100000\n },\n {\n \"service\": \"PIX_SENT\",\n \"service_label\": \"Pix enviado\",\n \"max_per_transaction\": 500000,\n \"max_daily\": 1000000,\n \"daily_consumed\": 350000,\n \"daily_available\": 650000,\n \"max_nightly\": 100000\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "62fed0b0-e226-4e9a-81af-ed0b19c69800", "name": "Nenhum perfil de limites atribuído à conta", "originalRequest": { "url": { "path": [ "accounts", "limits" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "No Content", "code": 204, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "c15b6a82-4ea4-49dd-a764-c8b0cec41baf", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "limits" ], "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": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "708f2283-775a-4e10-966e-10ebd7a5fd80", "name": "Token inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "limits" ], "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 \"status_code\": 401,\n \"code\": \"INVALID_CREDENTIALS\",\n \"message\": \"Token inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 1532,\n \"key_1\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fa7a2ab9-4236-4e98-ba95-02424fa3ff49", "name": "Acesso negado - permissões insuficientes para este recurso", "originalRequest": { "url": { "path": [ "accounts", "limits" ], "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 \"status_code\": 403,\n \"code\": \"ACCESS_DENIED\",\n \"message\": \"Acesso negado - permissões insuficientes para este recurso\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 8207.703686566874\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3b154e7d-f55a-4a2b-bb6b-552084584ad1", "name": "Entidade não pode ser processada - verifique os dados", "originalRequest": { "url": { "path": [ "accounts", "limits" ], "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 \"status_code\": 422,\n \"code\": \"UNPROCESSABLE_ENTITY\",\n \"message\": \"Entidade não pode ser processada - verifique os dados\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true,\n \"key_2\": \"string\",\n \"key_3\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "94775c35-53fd-4c0d-a8bc-e41325c23bbc", "name": "Limite de requisições excedido - tente novamente em alguns minutos", "originalRequest": { "url": { "path": [ "accounts", "limits" ], "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Limite de requisições excedido - tente novamente em alguns minutos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 6390.802837204974\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "01135c35-4571-43fc-90ff-9cf41ce2546f", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "limits" ], "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e8026009-6a4e-44e8-b2d4-2a9a76fb8158", "name": "Consultar extrato da conta", "request": { "name": "Consultar extrato da conta", "description": { "content": "Retorna o histórico detalhado de transações concluídas da conta. Ideal para conciliação e relatórios financeiros.\n\n**O período é opcional.** Sem `start_date`/`end_date`, a resposta traz as **últimas `limit` transações**, independente de quando ocorreram — é o que evita a tela vazia numa conta parada há meses. A rolagem para o passado continua pelo `cursor`, igual.\n\n## Parâmetros\n\n| Parâmetro | Obrigatório | Descrição | Exemplo |\n|---|---|---|---|\n| `start_date` | Não* | Data inicial do período (BRT, `yyyy-MM-dd`) | `2026-05-01` |\n| `end_date` | Não* | Data final do período (BRT, `yyyy-MM-dd`) | `2026-05-24` |\n| `types` | Não | Filtrar por tipo de transação: `PIX`, `BANK_SLIP`, `TED`, `TEF`, `FEE`, `REVERSAL`, `SPLIT`, `CARD_PURCHASE` | `?types=PIX&types=TED` |\n| `directions` | Não | Filtrar por direção: `CREDIT`, `DEBIT` | `?directions=CREDIT` |\n| `limit` | Não | Quantidade por página (padrão: 100, máximo: 500) | `?limit=50` |\n| `cursor` | Não | Token **opaco** da próxima página — reenvie o valor de `page_info.next_cursor` (não construa) | `?cursor=eyJjcmVhdGVkQXQiOi...` |\n\n\\* **É ambos ou nenhum:** enviar só uma das duas datas responde `400`.\n\nNa resposta, `start_date` e `end_date` **ecoam o período pedido** quando ele é informado; sem período, são derivados da página (a data da transação mais antiga e da mais recente devolvidas) e vêm **nulos** quando a página sai vazia.\n\nA resposta inclui `page_info { next_cursor, has_next_page }`. Veja o guia de **Paginação** na introdução da API.", "type": "text/plain" }, "url": { "path": [ "accounts", "statement" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "start_date", "value": "2026-05-01", "description": "Data inicial do período, pela **data econômica** da transação (liquidação/`processed_at`, não a data de criação). Formato: yyyy-MM-dd, interpretada como BRT. O extrato lista apenas transações concluídas, ordenadas pela data econômica (saldo que fecha linha a linha).\n\n**Opcional, mas é AMBOS ou NENHUM** — enviar só uma das duas datas responde 400. Sem período, o extrato traz as últimas `limit` transações concluídas, independente de quando ocorreram; a rolagem para o passado continua pelo `cursor`, igual." }, { "disabled": false, "key": "end_date", "value": "2026-05-23", "description": "Data final do período, pela **data econômica** da transação (liquidação/`processed_at`). Formato: yyyy-MM-dd, interpretada como BRT. Opcional — ver `start_date`." }, { "disabled": false, "key": "types", "value": "PIX", "description": "Filtrar por tipo de transação" }, { "disabled": false, "key": "types", "value": "TED", "description": "Filtrar por tipo de transação" }, { "disabled": false, "key": "directions", "value": "CREDIT", "description": "Filtrar por direção" }, { "disabled": false, "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=", "description": "Cursor da próxima página. Use exatamente o valor retornado em `page_info.next_cursor` da resposta anterior — é um token **opaco** (não construa nem interprete). Omita na primeira página." }, { "disabled": false, "key": "limit", "value": "100", "description": "Quantidade por página (default 100, max 500)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "af388d36-0320-4d4b-9b65-12c06e9d9f37", "name": "Extrato consultado com sucesso", "originalRequest": { "url": { "path": [ "accounts", "statement" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-23" }, { "key": "types", "value": "PIX" }, { "key": "types", "value": "TED" }, { "key": "directions", "value": "CREDIT" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "limit", "value": "100" } ], "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 \"statement_date\": \"2026-05-24T14:30:00-03:00\",\n \"start_date\": \"2026-05-01T00:00:00-03:00\",\n \"end_date\": \"2026-05-24T00:00:00-03:00\",\n \"start_date_balance\": 15000.5,\n \"end_date_balance\": 18750.25,\n \"blocked_balance\": 500,\n \"current_balance\": 18250.25,\n \"transactions\": [\n {\n \"id\": \"c4aa46cc-e3fc-...\",\n \"type\": \"BANK_SLIP\",\n \"direction\": \"CREDIT\",\n \"status\": \"COMPLETED\",\n \"occurred_at\": \"2026-04-24T08:14:09-03:00\",\n \"amount\": 15000,\n \"operation_description\": \"PAGAMENTO BOLETO\",\n \"end_of_day_balance\": 133072,\n \"requested_channel\": \"BACKOFFICE\",\n \"approved_channel\": \"BACKOFFICE\",\n \"provider_transaction_id\": \"23903e9a-0a35-...\",\n \"provider_movement_id\": \"bfe899aa-75e6-...\",\n \"fee_amount\": 50,\n \"description\": \"Nosso Número: 371\",\n \"reference_id\": \"OP_001234\",\n \"counterparty_name\": \"João Silva\",\n \"counterparty_document\": \"85831877540\",\n \"counterparty_bank_code\": \"274\",\n \"counterparty_branch_code\": \"0001\",\n \"counterparty_account_number\": \"02381705\",\n \"pix_key\": \"joao@email.com\",\n \"barcode\": \"23793381286...\",\n \"end_to_end_id\": \"E90400888...\",\n \"nsu\": \"123456\",\n \"is_pix_qr_code\": false,\n \"control_number\": \"00000000001\"\n },\n {\n \"id\": \"c4aa46cc-e3fc-...\",\n \"type\": \"BANK_SLIP\",\n \"direction\": \"CREDIT\",\n \"status\": \"COMPLETED\",\n \"occurred_at\": \"2026-04-24T08:14:09-03:00\",\n \"amount\": 15000,\n \"operation_description\": \"PAGAMENTO BOLETO\",\n \"end_of_day_balance\": 133072,\n \"requested_channel\": \"WEB\",\n \"approved_channel\": \"INTERNAL\",\n \"provider_transaction_id\": \"23903e9a-0a35-...\",\n \"provider_movement_id\": \"bfe899aa-75e6-...\",\n \"fee_amount\": 50,\n \"description\": \"Nosso Número: 371\",\n \"reference_id\": \"OP_001234\",\n \"counterparty_name\": \"João Silva\",\n \"counterparty_document\": \"85831877540\",\n \"counterparty_bank_code\": \"274\",\n \"counterparty_branch_code\": \"0001\",\n \"counterparty_account_number\": \"02381705\",\n \"pix_key\": \"joao@email.com\",\n \"barcode\": \"23793381286...\",\n \"end_to_end_id\": \"E90400888...\",\n \"nsu\": \"123456\",\n \"is_pix_qr_code\": false,\n \"control_number\": \"00000000001\"\n }\n ],\n \"page_info\": {\n \"next_cursor\": {},\n \"has_next_page\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "45abcc16-38a2-4c24-b552-0dabb785d39a", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "statement" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-23" }, { "key": "types", "value": "PIX" }, { "key": "types", "value": "TED" }, { "key": "directions", "value": "CREDIT" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "limit", "value": "100" } ], "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 \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ee2d8e8e-743f-485f-b4c8-e853b3514445", "name": "Token inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "statement" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-23" }, { "key": "types", "value": "PIX" }, { "key": "types", "value": "TED" }, { "key": "directions", "value": "CREDIT" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "limit", "value": "100" } ], "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 \"status_code\": 401,\n \"code\": \"INVALID_CREDENTIALS\",\n \"message\": \"Token inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 1532,\n \"key_1\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d558d87a-c06f-409d-8c72-1acb6d021ec1", "name": "Acesso negado - permissões insuficientes para este recurso", "originalRequest": { "url": { "path": [ "accounts", "statement" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-23" }, { "key": "types", "value": "PIX" }, { "key": "types", "value": "TED" }, { "key": "directions", "value": "CREDIT" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "limit", "value": "100" } ], "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 \"status_code\": 403,\n \"code\": \"ACCESS_DENIED\",\n \"message\": \"Acesso negado - permissões insuficientes para este recurso\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 8207.703686566874\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3e796197-264e-43ad-9160-dd8dfe552f4a", "name": "Entidade não pode ser processada - verifique os dados", "originalRequest": { "url": { "path": [ "accounts", "statement" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-23" }, { "key": "types", "value": "PIX" }, { "key": "types", "value": "TED" }, { "key": "directions", "value": "CREDIT" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "limit", "value": "100" } ], "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 \"status_code\": 422,\n \"code\": \"UNPROCESSABLE_ENTITY\",\n \"message\": \"Entidade não pode ser processada - verifique os dados\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true,\n \"key_2\": \"string\",\n \"key_3\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4f11852b-545c-4001-b7eb-832464aa98c7", "name": "Limite de requisições excedido - tente novamente em alguns minutos", "originalRequest": { "url": { "path": [ "accounts", "statement" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-23" }, { "key": "types", "value": "PIX" }, { "key": "types", "value": "TED" }, { "key": "directions", "value": "CREDIT" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "limit", "value": "100" } ], "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Limite de requisições excedido - tente novamente em alguns minutos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 6390.802837204974\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6cffdcdc-d5ae-4823-a55d-597006c63cdd", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "statement" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-23" }, { "key": "types", "value": "PIX" }, { "key": "types", "value": "TED" }, { "key": "directions", "value": "CREDIT" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "limit", "value": "100" } ], "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f53ef839-e879-4365-b302-c0f5fa939281", "name": "Exportar extrato da conta", "request": { "name": "Exportar extrato da conta", "description": { "content": "Gera e retorna o extrato da conta em formato de arquivo para download. Suporta PDF (visualizacao), CSV (processamento) e OFX (importacao em softwares contabeis).\n\n## Formatos disponíveis\n\n| Formato | Content-Type | Uso |\n|---|---|---|\n| PDF | application/pdf | Visualizacao e compartilhamento |\n| CSV | text/csv | Processamento em planilhas |\n| OFX | application/x-ofx | Importacao em softwares contabeis |\n\n## Parametros\n\n| Parametro | Obrigatorio | Descricao | Exemplo |\n|---|---|---|---|\n| `format` | Sim | Formato do arquivo: `PDF`, `CSV`, `OFX` | `?format=PDF` |\n| `start_date` | Sim | Data inicial do período (BRT, formato ISO 8601) | `2026-05-01` |\n| `end_date` | Sim | Data final do período (BRT, formato ISO 8601) | `2026-05-25` |\n| `types` | Não | Filtrar por tipo de transação: `PIX`, `BANK_SLIP`, `TED`, `TEF`, `FEE`, `REVERSAL`, `SPLIT`, `CARD_PURCHASE` | `?types=PIX&types=TED` |\n| `directions` | Não | Filtrar por direcao: `CREDIT`, `DEBIT` | `?directions=CREDIT` |\n\n**Período máximo:** 90 dias por exportação.", "type": "text/plain" }, "url": { "path": [ "accounts", "statement", "export" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "format", "value": "PDF", "description": "(Required) Formato do arquivo de exportação" }, { "disabled": false, "key": "start_date", "value": "2026-05-01", "description": "(Required) Data inicial do período (formato: yyyy-MM-dd, interpretada como BRT)" }, { "disabled": false, "key": "end_date", "value": "2026-05-25", "description": "(Required) Data final do período (formato: yyyy-MM-dd, interpretada como BRT)" }, { "disabled": false, "key": "types", "value": "PIX", "description": "Filtrar por tipo de transação" }, { "disabled": false, "key": "types", "value": "TED", "description": "Filtrar por tipo de transação" }, { "disabled": false, "key": "directions", "value": "CREDIT", "description": "Filtrar por direção" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "d9c1a15d-4f55-47b8-806c-505882e33c9d", "name": "Arquivo gerado com sucesso. Content-Type varia conforme formato solicitado: application/pdf (PDF), text/csv (CSV), application/x-ofx (OFX).", "originalRequest": { "url": { "path": [ "accounts", "statement", "export" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "format", "value": "PDF" }, { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-25" }, { "key": "types", "value": "PIX" }, { "key": "types", "value": "TED" }, { "key": "directions", "value": "CREDIT" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "6b2a50d4-82b2-4c00-ae74-30f1284cfdb0", "name": "Periodo superior a 90 dias", "originalRequest": { "url": { "path": [ "accounts", "statement", "export" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "format", "value": "PDF" }, { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-25" }, { "key": "types", "value": "PIX" }, { "key": "types", "value": "TED" }, { "key": "directions", "value": "CREDIT" } ], "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 \"status_code\": 400,\n \"code\": \"INVALID_DATE_RANGE\",\n \"message\": \"Periodo superior a 90 dias\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 3462.6351711747593,\n \"key_1\": 5134\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7fb68be8-fb84-4c9c-951d-bc4f144ddb1b", "name": "Token inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "statement", "export" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "format", "value": "PDF" }, { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-25" }, { "key": "types", "value": "PIX" }, { "key": "types", "value": "TED" }, { "key": "directions", "value": "CREDIT" } ], "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 \"status_code\": 401,\n \"code\": \"INVALID_CREDENTIALS\",\n \"message\": \"Token inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 1532,\n \"key_1\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a0965251-bdfa-4f2d-bd6a-1fac3dde2764", "name": "Acesso negado - permissões insuficientes para este recurso", "originalRequest": { "url": { "path": [ "accounts", "statement", "export" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "format", "value": "PDF" }, { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-25" }, { "key": "types", "value": "PIX" }, { "key": "types", "value": "TED" }, { "key": "directions", "value": "CREDIT" } ], "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 \"status_code\": 403,\n \"code\": \"ACCESS_DENIED\",\n \"message\": \"Acesso negado - permissões insuficientes para este recurso\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 8207.703686566874\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2b9e250d-cb88-475e-9998-e8c6b0213113", "name": "Conta nao encontrada", "originalRequest": { "url": { "path": [ "accounts", "statement", "export" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "format", "value": "PDF" }, { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-25" }, { "key": "types", "value": "PIX" }, { "key": "types", "value": "TED" }, { "key": "directions", "value": "CREDIT" } ], "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 \"status_code\": 404,\n \"code\": \"ACCOUNT_NOT_FOUND\",\n \"message\": \"Conta nao encontrada\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": 6372,\n \"key_2\": \"string\",\n \"key_3\": 911\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "977697b3-5179-4d50-8809-532962c931c7", "name": "Entidade não pode ser processada - verifique os dados", "originalRequest": { "url": { "path": [ "accounts", "statement", "export" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "format", "value": "PDF" }, { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-25" }, { "key": "types", "value": "PIX" }, { "key": "types", "value": "TED" }, { "key": "directions", "value": "CREDIT" } ], "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 \"status_code\": 422,\n \"code\": \"UNPROCESSABLE_ENTITY\",\n \"message\": \"Entidade não pode ser processada - verifique os dados\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true,\n \"key_2\": \"string\",\n \"key_3\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "78b66b02-a705-4738-9232-4dbbda92d422", "name": "Limite de requisições excedido - tente novamente em alguns minutos", "originalRequest": { "url": { "path": [ "accounts", "statement", "export" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "format", "value": "PDF" }, { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-25" }, { "key": "types", "value": "PIX" }, { "key": "types", "value": "TED" }, { "key": "directions", "value": "CREDIT" } ], "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Limite de requisições excedido - tente novamente em alguns minutos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 6390.802837204974\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b99f900e-69c1-4d5b-a9e1-a3e381704463", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "statement", "export" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "format", "value": "PDF" }, { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-25" }, { "key": "types", "value": "PIX" }, { "key": "types", "value": "TED" }, { "key": "directions", "value": "CREDIT" } ], "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f4b261cd-f00e-4430-b73e-ff357d96e8da", "name": "Consultar recibo de transação", "request": { "name": "Consultar recibo de transação", "description": { "content": "Gera e retorna o recibo oficial de uma transação específica. Útil para comprovação e auditoria de operações financeiras.\n\n**Recibo inclui:**\n\n**Dados completos da transação**\nValor, origem, destino, método de pagamento e status.\n\n**Informações de autenticação**\nDados do usuário, dispositivo e método de autorização.\n\n**Timestamps e identificadores únicos**\nDatas de criação, processamento e IDs de rastreamento.\n\n**Hash de verificação de integridade**\nAssinatura digital para validação da autenticidade.\n\n**Formatos disponíveis:**\n\n**JSON estruturado**\nFormato ideal para integração e processamento automatizado.\n\n**PDF para impressão**\nFormato visual para comprovação física (quando solicitado).\n\n**Validade:** Recibos são válidos indefinidamente para fins de auditoria.", "type": "text/plain" }, "url": { "path": [ "accounts", "transactions", ":transaction_id", "receipt" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "transaction_id", "description": "(Required) ID da transação a ser consultada" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "1c5f2027-0d29-49f1-97ed-2b83c38e3460", "name": "Recibo consultado com sucesso", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "receipt" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "transaction_id", "description": "(Required) ID da transação a ser consultada" } ] }, "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\": \"c4aa46cc-e3fc-...\",\n \"type\": \"PIX\",\n \"direction\": \"DEBIT\",\n \"status\": \"COMPLETED\",\n \"amount\": 15000,\n \"occurred_at\": \"2025-01-15T11:30:00-03:00\",\n \"provider_transaction_id\": \"23903e9a-0a35-...\",\n \"provider_movement_id\": \"c4aa46cc-e3fc-...\",\n \"fee_amount\": 50,\n \"auth_code\": \"e36c4123-b4a7-...\",\n \"nsu\": \"000123456789\",\n \"end_to_end_id\": \"E12345678202501151430000000001\",\n \"txid\": \"REC1234567890\",\n \"pix_key\": \"maria@email.com\",\n \"pix_key_type\": \"EMAIL\",\n \"refund_reason\": \"Solicitação do pagador\",\n \"barcode\": \"23793381286...\",\n \"digitable_line\": \"23793.38128 60080...\",\n \"operation_description\": \"Pix enviado\",\n \"description\": \"Pagamento aluguel\",\n \"reference_id\": \"ORDER-2025-0042\",\n \"amount_due\": 15000,\n \"interest_amount\": 250,\n \"fine_amount\": 500,\n \"discount_amount\": 1000,\n \"rebate_amount\": 300,\n \"due_date\": \"2025-08-30\",\n \"beneficiary_name\": \"Empresa Exemplo LTDA\",\n \"beneficiary_document\": \"12345678000190\",\n \"issuer_name\": \"Empresa Exemplo LTDA\",\n \"issuer_document\": \"12345678000190\",\n \"issuer_bank_code\": \"001\",\n \"our_number\": \"00000001234\",\n \"document_number\": \"000001\",\n \"purpose_code\": 10,\n \"purpose_description\": \"Pagamento de salários\",\n \"initiation_type\": \"DICT\",\n \"additional_info\": \"Pagamento referente ao pedido 123\",\n \"return_detail\": \"Conta encerrada\",\n \"reversal_of_id\": \"01JZWY347BXD9X4F294HTPX1VE\",\n \"balance_after\": 250000,\n \"from\": {\n \"holder_name\": \"João Silva Santos\",\n \"holder_document\": \"12345678900\",\n \"bank_code\": \"274\",\n \"bank_ispb\": \"11581339\",\n \"bank_name\": \"Banco Exemplo S.A.\",\n \"branch_code\": \"0001\",\n \"branch_digit\": \"8\",\n \"account_number\": \"238170\",\n \"account_digit\": \"5\",\n \"account_type\": \"PAYMENT\"\n },\n \"to\": {\n \"holder_name\": \"João Silva Santos\",\n \"holder_document\": \"12345678900\",\n \"bank_code\": \"274\",\n \"bank_ispb\": \"11581339\",\n \"bank_name\": \"Banco Exemplo S.A.\",\n \"branch_code\": \"0001\",\n \"branch_digit\": \"8\",\n \"account_number\": \"238170\",\n \"account_digit\": \"5\",\n \"account_type\": \"PAYMENT\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6f9404b7-08c6-47c6-8396-e23eceadf192", "name": "Dados inválidos ou não informados", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "receipt" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "transaction_id", "description": "(Required) ID da transação a ser consultada" } ] }, "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 \"status_code\": 400,\n \"code\": \"INVALID_INPUT\",\n \"message\": \"Dados inválidos ou não informados\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 3405,\n \"key_1\": 1312.7345250032497,\n \"key_2\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ac5e78a0-e38a-43cb-94eb-e6218d2b56f8", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "receipt" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "transaction_id", "description": "(Required) ID da transação a ser consultada" } ] }, "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 \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2b8e7f76-2e34-4f7d-9050-ce0a2a090c4a", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "receipt" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "transaction_id", "description": "(Required) ID da transação a ser consultada" } ] }, "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 \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "12e82bd9-9faf-4504-bc51-5daa1ec40e28", "name": "Transação não encontrada", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "receipt" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "transaction_id", "description": "(Required) ID da transação a ser consultada" } ] }, "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 \"status_code\": 404,\n \"code\": \"TRANSACTION_NOT_FOUND\",\n \"message\": \"Transação não encontrada\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 6851,\n \"key_1\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "342cc345-5712-487b-baa7-9c71e953259c", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "receipt" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "transaction_id", "description": "(Required) ID da transação a ser consultada" } ] }, "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "83cfed55-98ed-4d3c-a967-d6e1193ae8b2", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "receipt" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "transaction_id", "description": "(Required) ID da transação a ser consultada" } ] }, "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "af00b8af-79df-45a7-963d-ab6fb28faa5a", "name": "Gerar PDF do recibo de transação", "request": { "name": "Gerar PDF do recibo de transação", "description": { "content": "Gera e retorna o recibo de transação em formato PDF, pronto para impressão ou envio.\n\n**Inclui:** valor, data/hora, dados do remetente e destinatário, código de autenticação, NSU e campos específicos do tipo de operação (end_to_end_id para Pix, linha digitável para boleto, etc.).\n\n**Disponível apenas para transações com status COMPLETED.**\n\n**Content-Type da resposta:** `application/pdf`", "type": "text/plain" }, "url": { "path": [ "accounts", "transactions", ":transaction_id", "receipt", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "transaction_id", "description": "(Required) ID da transação" } ] }, "header": [ { "key": "Accept", "value": "application/pdf" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "f72fc255-b83a-4ee8-b2b3-dfbefd43a389", "name": "PDF do comprovante gerado com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "receipt", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "transaction_id", "description": "(Required) ID da transação" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/pdf" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/pdf" } ], "body": "string", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "7fb768b8-2a3f-4ce3-9a11-1d8e68fc660f", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "receipt", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "transaction_id", "description": "(Required) ID da transação" } ] }, "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 \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2dd48df8-2966-444c-8c9c-46c61211fee4", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "receipt", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "transaction_id", "description": "(Required) ID da transação" } ] }, "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 \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d02ec794-fae2-432e-954f-0685fa528523", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "receipt", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "transaction_id", "description": "(Required) ID da transação" } ] }, "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 \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b097af9b-eaa7-47bd-b082-0b8bf1bec6d0", "name": "Transação não encontrada", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "receipt", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "transaction_id", "description": "(Required) ID da transação" } ] }, "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 \"status_code\": 404,\n \"code\": \"TRANSACTION_NOT_FOUND\",\n \"message\": \"Transação não encontrada\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 6851,\n \"key_1\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f3ef7fd7-cb0b-46a7-a3fa-e5dc9f3fa427", "name": "Comprovante disponível apenas para transações concluídas", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "receipt", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "transaction_id", "description": "(Required) ID da transação" } ] }, "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 \"status_code\": 422,\n \"code\": \"INVALID_INPUT\",\n \"message\": \"Comprovante disponível apenas para transações concluídas\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 9157.58584384357\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f459c4fa-c789-4ad1-bd8d-0a6321dd4f07", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "receipt", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "transaction_id", "description": "(Required) ID da transação" } ] }, "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "47a83abc-cadd-4aad-840d-8fc435b4b3d6", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "receipt", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "transaction_id", "description": "(Required) ID da transação" } ] }, "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4626055c-61bb-40d7-879e-00ad28e50a63", "name": "Consultar detalhes de transação", "request": { "name": "Consultar detalhes de transação", "description": { "content": "Retorna informações detalhadas e técnicas de uma transação específica. Fornece dados completos para análise e troubleshooting.\n\n**Informações detalhadas:**\n\n**Dados da transação**\nValores, moeda, método de pagamento, status atual.\n\n**Dados técnicos**\nIDs de sistema, códigos de resposta, tempos de processamento.\n\n**Histórico de status**\nCronologia completa desde iniciação até finalização.\n\n**Dados de segurança**\nIPs, dispositivos, tokens de autenticação utilizados.", "type": "text/plain" }, "url": { "path": [ "accounts", "transactions", ":transaction_id", "details" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "transaction_id", "description": "(Required) ID da transação a ser consultada" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "2ccef9fb-4f48-43aa-b980-501113013eed", "name": "Detalhes da transação consultados com sucesso", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "details" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "transaction_id", "description": "(Required) ID da transação a ser consultada" } ] }, "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\": \"01KRHX6B1RA7VXF25HS3S7NVY4\",\n \"type\": \"PIX\",\n \"direction\": \"DEBIT\",\n \"status\": \"COMPLETED\",\n \"amount\": 10000,\n \"occurred_at\": \"2026-05-14T10:06:16-03:00\",\n \"created_at\": \"2026-05-30T11:00:00-03:00\",\n \"updated_at\": \"2026-05-30T11:30:00-03:00\",\n \"requested_channel\": \"INTERNAL\",\n \"approved_channel\": \"MOBILE\",\n \"fee_amount\": 100,\n \"auth_code\": \"1095448f-b2df-4c65-8f86-37173def9f43\",\n \"nsu\": \"6578270\",\n \"operation_description\": \"TEF enviada\",\n \"description\": \"Pagamento de teste\",\n \"reference_id\": \"TRANSACAO_1515\",\n \"counterparty_name\": \"JULIANA MARINA REBECA DA SILVA\",\n \"counterparty_document\": \"33259371796\",\n \"provider_transaction_id\": \"823bb42d-775c-44fe-80ba-36daf1cf8d50\",\n \"provider_movement_id\": \"0ec5bab1-8ca2-4b10-9ca1-fdf7b5e7dab1\",\n \"end_to_end_id\": \"E12345678202605141430000000001\",\n \"pix_key\": \"joao@email.com\",\n \"pix_key_type\": \"EMAIL\",\n \"operation_number\": \"E90400888202605140001\",\n \"txid\": \"abc123def456\",\n \"barcode\": \"23793381286...\",\n \"digitable_line\": \"23793.38128 60080...\",\n \"due_date\": \"2026-08-30\",\n \"beneficiary_name\": \"Empresa XYZ Ltda\",\n \"beneficiary_document\": \"12345678000195\",\n \"purpose_code\": 10,\n \"counterparty_bank_code\": \"274\",\n \"counterparty_bank_ispb\": \"11581339\",\n \"counterparty_bank_name\": \"Banco Exemplo S.A.\",\n \"counterparty_branch\": \"0001\",\n \"counterparty_branch_digit\": \"8\",\n \"counterparty_account_number\": \"02381705\",\n \"counterparty_account_digit\": \"5\",\n \"counterparty_account_type\": \"PAYMENT\",\n \"balance_after\": 150000,\n \"amount_due\": 15000,\n \"interest_amount\": 250,\n \"fine_amount\": 500,\n \"discount_amount\": 1000,\n \"rebate_amount\": 300,\n \"issuer_name\": \"Empresa Exemplo LTDA\",\n \"issuer_document\": \"12345678000190\",\n \"issuer_bank_code\": \"001\",\n \"our_number\": \"00000001234\",\n \"document_number\": \"000001\",\n \"wallet_number\": 109,\n \"paid_at\": \"2026-05-30T11:30:00-03:00\",\n \"payment_limit_date\": \"2026-09-30\",\n \"is_hybrid\": false,\n \"initiation_type\": \"DICT\",\n \"refund_reason\": \"Solicitação do pagador\",\n \"rejection_reason\": \"AB03\",\n \"rejection_description\": \"Saldo insuficiente na conta do recebedor\",\n \"additional_info\": \"Pagamento referente ao pedido 123\",\n \"purpose_description\": \"Pagamento de salários\",\n \"return_detail\": \"Conta encerrada\",\n \"reversal_of_id\": \"01JZWY347BXD9X4F294HTPX1VE\",\n \"processed_at\": \"2026-05-30T11:30:00-03:00\",\n \"scheduled_at\": \"2026-06-01T08:00:00-03:00\",\n \"failed_at\": \"2026-05-30T11:31:00-03:00\",\n \"reversed_at\": \"2026-05-31T09:00:00-03:00\",\n \"requested_by\": \"01JZWY347BXD9X4F294HTPX1VE\",\n \"approved_at\": \"2026-05-30T11:15:00-03:00\",\n \"approved_by\": \"01JZWY347BXD9X4F294HTPX1VE\",\n \"rejected_at\": \"2026-05-30T11:15:00-03:00\",\n \"rejected_by\": \"01JZWY347BXD9X4F294HTPX1VE\",\n \"expires_at\": \"2026-05-22T14:00:00-03:00\",\n \"expires_in_seconds\": 82800\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "275c0e70-0680-4b72-a8d0-ce287f8f635d", "name": "Dados inválidos ou não informados", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "details" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "transaction_id", "description": "(Required) ID da transação a ser consultada" } ] }, "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 \"status_code\": 400,\n \"code\": \"INVALID_INPUT\",\n \"message\": \"Dados inválidos ou não informados\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 3405,\n \"key_1\": 1312.7345250032497,\n \"key_2\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e3f8df81-ed7a-4980-bc13-42684c030de7", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "details" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "transaction_id", "description": "(Required) ID da transação a ser consultada" } ] }, "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 \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0e694e77-84b8-4e3b-ac13-23f8fa8d5ab4", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "details" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "transaction_id", "description": "(Required) ID da transação a ser consultada" } ] }, "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 \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5014342a-8cbf-49d9-973c-b95c5e894aaf", "name": "Transação não encontrada", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "details" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "transaction_id", "description": "(Required) ID da transação a ser consultada" } ] }, "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 \"status_code\": 404,\n \"code\": \"TRANSACTION_NOT_FOUND\",\n \"message\": \"Transação não encontrada\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 6851,\n \"key_1\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d1379048-f70a-4d79-877d-0b85832c5eda", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "details" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "transaction_id", "description": "(Required) ID da transação a ser consultada" } ] }, "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "058d8f4b-5f25-481e-9581-856d0b3c0239", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "details" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "transaction_id", "description": "(Required) ID da transação a ser consultada" } ] }, "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "ceaef032-0901-48ac-bc30-d9bce830b5bb", "name": "Transferências", "description": { "content": "Transferências entre contas, TED e histórico", "type": "text/plain" }, "item": [ { "id": "3a9a4634-758c-43a7-be27-e0539f6b2072", "name": "Transferir para conta Meioo (TEF)", "request": { "name": "Transferir para conta Meioo (TEF)", "description": { "content": "Realiza uma transferência entre contas dentro da plataforma Meioo (Transferência Eletrônica de Fundos). A liquidação é imediata, independente do horário.\n\n**Características:**\n• Liquidação instantânea, 24/7\n• Disponível para contas PF e PJ na plataforma\n• Sem janela operacional restritiva\n\n**Fluxo de aprovação:** A transação é criada com status `AWAITING_APPROVAL`. A aprovação deve ser feita via `PATCH /accounts/approvals/transactions/{id}` com autenticação step-up.", "type": "text/plain" }, "url": { "path": [ "accounts", "transfers", "tef" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "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 \"account_number\": \"08690148\",\n \"amount\": 10000,\n \"purpose\": \"ACCOUNT_CREDIT\",\n \"reference_id\": \"TRANSACAO_123\",\n \"description\": \"Pagamento de contas\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "408dff35-920b-4006-938e-3dc02f7f17b9", "name": "Transferência TEF criada com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "transfers", "tef" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"account_number\": \"08690148\",\n \"amount\": 10000,\n \"purpose\": \"ACCOUNT_CREDIT\",\n \"reference_id\": \"TRANSACAO_123\",\n \"description\": \"Pagamento de contas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"01K8RPN86DS9D1KZ5ZBGJKF53M\",\n \"status\": \"PROCESSING\",\n \"amount\": 10000,\n \"destination_account\": {\n \"account_number\": \"08690148\",\n \"branch_code\": \"0001\"\n },\n \"fee_amount\": 100\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "08845934-1757-43da-98ac-dc81bb8bcbbe", "name": "Dados da transferência inválidos ou incompletos", "originalRequest": { "url": { "path": [ "accounts", "transfers", "tef" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"account_number\": \"08690148\",\n \"amount\": 10000,\n \"purpose\": \"ACCOUNT_CREDIT\",\n \"reference_id\": \"TRANSACAO_123\",\n \"description\": \"Pagamento de contas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados da transferência inválidos ou incompletos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 2915.2737104598937,\n \"key_1\": 6322.163170310378,\n \"key_2\": 5153.476386524771\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7551c9a2-b870-44c8-81f3-4ce4099e71d3", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "transfers", "tef" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"account_number\": \"08690148\",\n \"amount\": 10000,\n \"purpose\": \"ACCOUNT_CREDIT\",\n \"reference_id\": \"TRANSACAO_123\",\n \"description\": \"Pagamento de contas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "abdf4dff-6dae-4d25-9f0c-a1f7cade216f", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "transfers", "tef" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"account_number\": \"08690148\",\n \"amount\": 10000,\n \"purpose\": \"ACCOUNT_CREDIT\",\n \"reference_id\": \"TRANSACAO_123\",\n \"description\": \"Pagamento de contas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bf0c37ca-c4c5-45d8-88d5-a043edfef6c7", "name": "Conta de destino não encontrada na plataforma Meioo", "originalRequest": { "url": { "path": [ "accounts", "transfers", "tef" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"account_number\": \"08690148\",\n \"amount\": 10000,\n \"purpose\": \"ACCOUNT_CREDIT\",\n \"reference_id\": \"TRANSACAO_123\",\n \"description\": \"Pagamento de contas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 404,\n \"code\": \"DESTINATION_ACCOUNT_NOT_FOUND\",\n \"message\": \"Conta de destino não encontrada na plataforma Meioo\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 3282.08080616186\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "96bfc299-441e-4617-95f8-92f91975e55f", "name": "Já existe uma transação com o mesmo reference_id para esta conta, ou a chave de idempotência já foi utilizada", "originalRequest": { "url": { "path": [ "accounts", "transfers", "tef" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"account_number\": \"08690148\",\n \"amount\": 10000,\n \"purpose\": \"ACCOUNT_CREDIT\",\n \"reference_id\": \"TRANSACAO_123\",\n \"description\": \"Pagamento de contas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 409,\n \"code\": \"RESOURCE_CONFLICT\",\n \"message\": \"Já existe uma transação com o mesmo reference_id para esta conta, ou a chave de idempotência já foi utilizada\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 2211.3957762870464\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c36c8ed6-7391-434d-b7d5-df6750f1caef", "name": "Transferência para a própria conta não é permitida", "originalRequest": { "url": { "path": [ "accounts", "transfers", "tef" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"account_number\": \"08690148\",\n \"amount\": 10000,\n \"purpose\": \"ACCOUNT_CREDIT\",\n \"reference_id\": \"TRANSACAO_123\",\n \"description\": \"Pagamento de contas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 422,\n \"code\": \"SAME_ACCOUNT_TRANSFER\",\n \"message\": \"Transferência para a própria conta não é permitida\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 3315.9576229663658,\n \"key_1\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5c967c95-2e06-44cf-b804-dc0565173b2b", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "transfers", "tef" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"account_number\": \"08690148\",\n \"amount\": 10000,\n \"purpose\": \"ACCOUNT_CREDIT\",\n \"reference_id\": \"TRANSACAO_123\",\n \"description\": \"Pagamento de contas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e8ceb7bf-2975-4254-b8bf-738c22c8736f", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "transfers", "tef" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"account_number\": \"08690148\",\n \"amount\": 10000,\n \"purpose\": \"ACCOUNT_CREDIT\",\n \"reference_id\": \"TRANSACAO_123\",\n \"description\": \"Pagamento de contas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9b1f4115-fe57-4b0c-8397-93f28482b46f", "name": "Transferir para outras instituições (TED)", "request": { "name": "Transferir para outras instituições (TED)", "description": { "content": "Realiza uma transferência bancária para contas em outras instituições financeiras via TED.\n\n**Janela operacional:**\nTEDs processadas fora do horário bancário são agendadas para o próximo dia útil.\n\n**Fluxo de aprovação:** A transação é criada com status `AWAITING_APPROVAL`. A aprovação deve ser feita via `PATCH /accounts/approvals/transactions/{id}` com autenticação step-up.", "type": "text/plain" }, "url": { "path": [ "accounts", "transfers", "ted" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "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 \"beneficiary\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"12345678900\",\n \"bank_code\": \"274\",\n \"branch_code\": \"0001\",\n \"branch_digit\": \"1\",\n \"account_number\": \"02381705\",\n \"account_type\": \"PAYMENT\",\n \"account_digit\": \"5\"\n },\n \"amount\": 10000,\n \"purpose\": \"ACCOUNT_CREDIT\",\n \"reference_id\": \"TRANSACAO_123\",\n \"description\": \"Pagamento de contas\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "1981992b-5160-4e24-b444-47b44480a650", "name": "Transferência TED criada com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "transfers", "ted" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"beneficiary\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"12345678900\",\n \"bank_code\": \"274\",\n \"branch_code\": \"0001\",\n \"branch_digit\": \"1\",\n \"account_number\": \"02381705\",\n \"account_type\": \"PAYMENT\",\n \"account_digit\": \"5\"\n },\n \"amount\": 10000,\n \"purpose\": \"ACCOUNT_CREDIT\",\n \"reference_id\": \"TRANSACAO_123\",\n \"description\": \"Pagamento de contas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"01K8RPN86DS9D1KZ5ZBGJKF53M\",\n \"status\": \"PROCESSING\",\n \"amount\": 10000,\n \"beneficiary\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"12345678900\",\n \"bank_code\": \"274\",\n \"branch_code\": \"0001\",\n \"account_number\": \"02381705\",\n \"branch_digit\": \"8\",\n \"account_digit\": \"5\"\n },\n \"fee_amount\": 100\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aaf02304-204a-49eb-86d1-c518769694b9", "name": "Dados bancários inválidos ou incompletos", "originalRequest": { "url": { "path": [ "accounts", "transfers", "ted" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"beneficiary\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"12345678900\",\n \"bank_code\": \"274\",\n \"branch_code\": \"0001\",\n \"branch_digit\": \"1\",\n \"account_number\": \"02381705\",\n \"account_type\": \"PAYMENT\",\n \"account_digit\": \"5\"\n },\n \"amount\": 10000,\n \"purpose\": \"ACCOUNT_CREDIT\",\n \"reference_id\": \"TRANSACAO_123\",\n \"description\": \"Pagamento de contas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados bancários inválidos ou incompletos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 9023.932277241729\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e5016f7b-0b66-4753-8666-04ef7980a0c5", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "transfers", "ted" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"beneficiary\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"12345678900\",\n \"bank_code\": \"274\",\n \"branch_code\": \"0001\",\n \"branch_digit\": \"1\",\n \"account_number\": \"02381705\",\n \"account_type\": \"PAYMENT\",\n \"account_digit\": \"5\"\n },\n \"amount\": 10000,\n \"purpose\": \"ACCOUNT_CREDIT\",\n \"reference_id\": \"TRANSACAO_123\",\n \"description\": \"Pagamento de contas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f5b3e1c7-1f01-456f-b6b6-08a9a6f1362a", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "transfers", "ted" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"beneficiary\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"12345678900\",\n \"bank_code\": \"274\",\n \"branch_code\": \"0001\",\n \"branch_digit\": \"1\",\n \"account_number\": \"02381705\",\n \"account_type\": \"PAYMENT\",\n \"account_digit\": \"5\"\n },\n \"amount\": 10000,\n \"purpose\": \"ACCOUNT_CREDIT\",\n \"reference_id\": \"TRANSACAO_123\",\n \"description\": \"Pagamento de contas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "141f2f61-7adf-4f56-9400-3692032b3488", "name": "Já existe uma transação com o mesmo reference_id para esta conta, ou a chave de idempotência já foi utilizada", "originalRequest": { "url": { "path": [ "accounts", "transfers", "ted" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"beneficiary\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"12345678900\",\n \"bank_code\": \"274\",\n \"branch_code\": \"0001\",\n \"branch_digit\": \"1\",\n \"account_number\": \"02381705\",\n \"account_type\": \"PAYMENT\",\n \"account_digit\": \"5\"\n },\n \"amount\": 10000,\n \"purpose\": \"ACCOUNT_CREDIT\",\n \"reference_id\": \"TRANSACAO_123\",\n \"description\": \"Pagamento de contas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 409,\n \"code\": \"RESOURCE_CONFLICT\",\n \"message\": \"Já existe uma transação com o mesmo reference_id para esta conta, ou a chave de idempotência já foi utilizada\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 2211.3957762870464\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cd0dc048-d0f8-49a4-b230-089c7393478f", "name": "Dados bancários do destinatário inválidos", "originalRequest": { "url": { "path": [ "accounts", "transfers", "ted" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"beneficiary\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"12345678900\",\n \"bank_code\": \"274\",\n \"branch_code\": \"0001\",\n \"branch_digit\": \"1\",\n \"account_number\": \"02381705\",\n \"account_type\": \"PAYMENT\",\n \"account_digit\": \"5\"\n },\n \"amount\": 10000,\n \"purpose\": \"ACCOUNT_CREDIT\",\n \"reference_id\": \"TRANSACAO_123\",\n \"description\": \"Pagamento de contas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 422,\n \"code\": \"INVALID_BANK_ACCOUNT\",\n \"message\": \"Dados bancários do destinatário inválidos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 7622\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a357d2f4-d57f-4690-9013-d01f14d91581", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "transfers", "ted" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"beneficiary\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"12345678900\",\n \"bank_code\": \"274\",\n \"branch_code\": \"0001\",\n \"branch_digit\": \"1\",\n \"account_number\": \"02381705\",\n \"account_type\": \"PAYMENT\",\n \"account_digit\": \"5\"\n },\n \"amount\": 10000,\n \"purpose\": \"ACCOUNT_CREDIT\",\n \"reference_id\": \"TRANSACAO_123\",\n \"description\": \"Pagamento de contas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9d3a005c-15f7-4ac6-8a5a-9919d22a7adf", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "transfers", "ted" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"beneficiary\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"12345678900\",\n \"bank_code\": \"274\",\n \"branch_code\": \"0001\",\n \"branch_digit\": \"1\",\n \"account_number\": \"02381705\",\n \"account_type\": \"PAYMENT\",\n \"account_digit\": \"5\"\n },\n \"amount\": 10000,\n \"purpose\": \"ACCOUNT_CREDIT\",\n \"reference_id\": \"TRANSACAO_123\",\n \"description\": \"Pagamento de contas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "8954b449-1418-422f-bd44-bbdc49d6aa42", "name": "Pix", "description": { "content": "Pagamentos instantâneos Pix - chaves, QR codes e devoluções", "type": "text/plain" }, "item": [ { "id": "d8435860-ac01-431a-a414-4c43e17c245c", "name": "Consultar chave Pix", "request": { "name": "Consultar chave Pix", "description": { "content": "Consulta uma chave Pix diretamente no DICT (Diretório de Identificadores de Contas Transacionais) do Banco Central. Útil para validar o destinatário antes de realizar uma transferência.\n\n**Tipos de chave suportados:**\n\n**CPF / CNPJ**\nDocumento do titular da conta (somente dígitos).\n\n**E-mail**\nEndereço de e-mail cadastrado como chave.\n\n**Telefone**\nNúmero no formato E.164: `+5511999990000`.\n\n**Chave aleatória (EVP)**\nUUID gerado pela plataforma, sem vínculo com dados pessoais.\n\n**Resposta:** Retorna os dados da conta associada à chave (titular, instituição, agência, conta). Chaves inativas ou não registradas no DICT retornam 404.", "type": "text/plain" }, "url": { "path": [ "accounts", "pix", "keys", "dict", ":key" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "pix_key", "value": "nome@email.com", "description": "(Required) Chave Pix a ser consultada no DICT" } ], "variable": [ { "disabled": false, "type": "any", "value": "usuario@meioo.com.br", "key": "key", "description": "(Required) Chave Pix a consultar no DICT (CPF/CNPJ, e-mail, telefone ou chave aleatória)" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "b07b74a6-e6ed-4b38-9551-ebebd2d339e8", "name": "Chave ativa encontrada no DICT.", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", "dict", ":key" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "pix_key", "value": "nome@email.com" } ], "variable": [ { "disabled": false, "type": "any", "value": "usuario@meioo.com.br", "key": "key", "description": "(Required) Chave Pix a consultar no DICT (CPF/CNPJ, e-mail, telefone ou chave aleatória)" } ] }, "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 \"pix_key\": \"0fc8781d-3c1e-4b9b-bdb1-8fa34455799c\",\n \"pix_key_type\": \"CPF\",\n \"holder_name\": \"João da Silva\",\n \"ticket\": \"1b2eb2d5-d1ee-442c-a11c-d779e21321c9\",\n \"holder_document\": \"***456789**\",\n \"person_type\": \"INDIVIDUAL\",\n \"trade_name\": \"Meioo Pagamentos\",\n \"account\": {\n \"branch_code\": \"0001\",\n \"account_number\": \"1234567\",\n \"account_type\": \"CACC\"\n },\n \"bank\": {\n \"bank_name\": \"Banco Exemplo S.A.\",\n \"bank_code\": \"274\",\n \"bank_ispb\": \"11581339\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1b94c799-e6c4-49f0-8f8a-add10ededb50", "name": "Formato de chave Pix inválido", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", "dict", ":key" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "pix_key", "value": "nome@email.com" } ], "variable": [ { "disabled": false, "type": "any", "value": "usuario@meioo.com.br", "key": "key", "description": "(Required) Chave Pix a consultar no DICT (CPF/CNPJ, e-mail, telefone ou chave aleatória)" } ] }, "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 \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Formato de chave Pix inválido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ab740cca-df59-4acc-88ff-488e08a35a92", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", "dict", ":key" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "pix_key", "value": "nome@email.com" } ], "variable": [ { "disabled": false, "type": "any", "value": "usuario@meioo.com.br", "key": "key", "description": "(Required) Chave Pix a consultar no DICT (CPF/CNPJ, e-mail, telefone ou chave aleatória)" } ] }, "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 \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "964a351a-4661-4060-9f3e-3c49d3bc66c8", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", "dict", ":key" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "pix_key", "value": "nome@email.com" } ], "variable": [ { "disabled": false, "type": "any", "value": "usuario@meioo.com.br", "key": "key", "description": "(Required) Chave Pix a consultar no DICT (CPF/CNPJ, e-mail, telefone ou chave aleatória)" } ] }, "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 \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9a3ac53c-3a60-408f-b303-40c7a39eece2", "name": "Chave Pix não encontrada no DICT ou inativa", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", "dict", ":key" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "pix_key", "value": "nome@email.com" } ], "variable": [ { "disabled": false, "type": "any", "value": "usuario@meioo.com.br", "key": "key", "description": "(Required) Chave Pix a consultar no DICT (CPF/CNPJ, e-mail, telefone ou chave aleatória)" } ] }, "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 \"status_code\": 404,\n \"code\": \"PIX_KEY_NOT_FOUND\",\n \"message\": \"Chave Pix não encontrada no DICT ou inativa\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": false,\n \"key_2\": 7812\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "951e3b2c-e03a-4a23-9a6e-f940d840951c", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", "dict", ":key" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "pix_key", "value": "nome@email.com" } ], "variable": [ { "disabled": false, "type": "any", "value": "usuario@meioo.com.br", "key": "key", "description": "(Required) Chave Pix a consultar no DICT (CPF/CNPJ, e-mail, telefone ou chave aleatória)" } ] }, "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3fdbe5df-7061-4cc6-b7b1-66ca9f4666f7", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", "dict", ":key" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "pix_key", "value": "nome@email.com" } ], "variable": [ { "disabled": false, "type": "any", "value": "usuario@meioo.com.br", "key": "key", "description": "(Required) Chave Pix a consultar no DICT (CPF/CNPJ, e-mail, telefone ou chave aleatória)" } ] }, "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c0503e83-9025-4086-8c89-afc2cc30a033", "name": "Cadastrar chave Pix", "request": { "name": "Cadastrar chave Pix", "description": { "content": "Registra uma nova chave Pix para a conta autenticada no DICT do Banco Central. A chave fica disponível para recebimento de transferências Pix após o registro.\n\n**Tipos de chave disponíveis:**\n\n**CPF / CNPJ**\nVincula o documento do titular à conta. Cada CPF/CNPJ pode ter uma única chave por tipo de conta.\n\n**E-mail**\nDeve ser confirmado via código de verificação.\n\n**Telefone**\nNúmero no formato E.164 (`+5511999990000`). Deve ser confirmado via SMS.\n\n**Chave aleatória (EVP)**\nGerada automaticamente pela plataforma. Não requer confirmação.\n\n**Fluxo com MFA:** Para tipos que exigem confirmação, solicite o código via `POST /accounts/pix/mfa` antes de registrar a chave.", "type": "text/plain" }, "url": { "path": [ "accounts", "pix", "keys" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "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 \"pix_key_type\": \"CPF\",\n \"pix_key\": \"+5511999998888\",\n \"auth_code\": \"123456\",\n \"mfa_code\": \"123456\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "6a25f13d-c8a8-4ba3-8a58-e1e3a035bb5a", "name": "Chave Pix registrada com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"pix_key_type\": \"CPF\",\n \"pix_key\": \"+5511999998888\",\n \"auth_code\": \"123456\",\n \"mfa_code\": \"123456\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "de7fcb78-638a-4047-a58e-d14179e07fa8", "name": "Formato de chave inválido ou dados incompletos", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"pix_key_type\": \"CPF\",\n \"pix_key\": \"+5511999998888\",\n \"auth_code\": \"123456\",\n \"mfa_code\": \"123456\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Formato de chave inválido ou dados incompletos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "de77cee7-ec1c-4a78-be0f-6438608989fb", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"pix_key_type\": \"CPF\",\n \"pix_key\": \"+5511999998888\",\n \"auth_code\": \"123456\",\n \"mfa_code\": \"123456\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "18901ca6-b9fb-45d7-9e74-9a5d3f6e6d9a", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"pix_key_type\": \"CPF\",\n \"pix_key\": \"+5511999998888\",\n \"auth_code\": \"123456\",\n \"mfa_code\": \"123456\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5950b387-73f0-4d24-8740-66ab85db82ae", "name": "Chave Pix já cadastrada nesta ou em outra conta", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"pix_key_type\": \"CPF\",\n \"pix_key\": \"+5511999998888\",\n \"auth_code\": \"123456\",\n \"mfa_code\": \"123456\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 409,\n \"code\": \"PIX_KEY_ALREADY_EXISTS\",\n \"message\": \"Chave Pix já cadastrada nesta ou em outra conta\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5659,\n \"key_1\": 868.2550899398777\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "430647a4-759f-4913-b0ed-1611606fc6f1", "name": "Limite máximo de chaves Pix para esta conta atingido", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"pix_key_type\": \"CPF\",\n \"pix_key\": \"+5511999998888\",\n \"auth_code\": \"123456\",\n \"mfa_code\": \"123456\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 422,\n \"code\": \"PIX_KEY_LIMIT_REACHED\",\n \"message\": \"Limite máximo de chaves Pix para esta conta atingido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5955.029482472767\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2b7437d8-f87d-4f2b-8eec-c430d63913de", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"pix_key_type\": \"CPF\",\n \"pix_key\": \"+5511999998888\",\n \"auth_code\": \"123456\",\n \"mfa_code\": \"123456\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "be7717b5-e4a6-4549-85f1-f900819ae777", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"pix_key_type\": \"CPF\",\n \"pix_key\": \"+5511999998888\",\n \"auth_code\": \"123456\",\n \"mfa_code\": \"123456\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "de46c583-4854-49c1-a51d-616c37cacf94", "name": "Listar chaves Pix", "request": { "name": "Listar chaves Pix", "description": { "content": "Retorna todas as chaves Pix cadastradas para a conta autenticada. A conta é identificada pelo token Bearer — nenhum parâmetro adicional é necessário.\n\n**Informações retornadas por chave:**\n• Tipo e valor da chave\n• Status (ativa, pendente de confirmação, removida)\n• Data de cadastro", "type": "text/plain" }, "url": { "path": [ "accounts", "pix", "keys" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "5f0ef53c-1e7f-44d5-8bc1-55adc329dca8", "name": "Lista de chaves Pix retornada com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys" ], "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 {\n \"pix_key\": \"0fc8781d-3c1e-4b9b-bdb1-8fa34455799c\",\n \"pix_key_type\": \"EVP\",\n \"holder_name\": \"João da Silva\",\n \"holder_document\": \"858.***.***-40\",\n \"person_type\": \"INDIVIDUAL\",\n \"pix_emv\": \"00020126580014BR.GOV.BCB.PIX...\",\n \"pix_qr_code\": \"data:image/png;base64,iVBORw0KGgo...\"\n },\n {\n \"pix_key\": \"0fc8781d-3c1e-4b9b-bdb1-8fa34455799c\",\n \"pix_key_type\": \"EVP\",\n \"holder_name\": \"João da Silva\",\n \"holder_document\": \"858.***.***-40\",\n \"person_type\": \"INDIVIDUAL\",\n \"pix_emv\": \"00020126580014BR.GOV.BCB.PIX...\",\n \"pix_qr_code\": \"data:image/png;base64,iVBORw0KGgo...\"\n }\n]", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ed977109-a3cd-439e-8202-443bd73f49f2", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys" ], "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": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fb821168-8e16-4d2a-8296-b7652d8adf6d", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys" ], "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 \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c6f4fe43-58c3-4476-93c4-995a133c8737", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys" ], "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 \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d0f770ad-c6b3-4da8-b421-e46c02f0a94f", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys" ], "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d06f9088-f42b-46f6-8afb-33e13b868d28", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys" ], "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "fff5835a-287b-44e0-92df-45486768897e", "name": "Excluir chave Pix", "request": { "name": "Excluir chave Pix", "description": { "content": "Remove uma chave Pix da conta, excluindo seu registro do DICT do Banco Central. Após a remoção, transferências enviadas para esta chave serão recusadas pelo DICT.\n\n**Importante:**\n• A remoção é imediata e irreversível\n• QR Codes estáticos vinculados à chave removida deixam de funcionar\n• A chave poderá ser recadastrada posteriormente, se necessário", "type": "text/plain" }, "url": { "path": [ "accounts", "pix", "keys", ":pix_key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "nome@email.com", "key": "pix_key", "description": "(Required) Chave Pix a ser removida (valor da chave, não o ID)" } ] }, "header": [ { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "5eb87204-c558-4228-a320-c0196539dd07", "name": "Chave Pix removida com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", ":pix_key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "nome@email.com", "key": "pix_key", "description": "(Required) Chave Pix a ser removida (valor da chave, não o ID)" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "c2599c32-8124-4988-afb8-8ecc8b7a9375", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", ":pix_key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "nome@email.com", "key": "pix_key", "description": "(Required) Chave Pix a ser removida (valor da chave, não o ID)" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c278af6b-3c5e-442a-99bf-1be3c1eae654", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", ":pix_key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "nome@email.com", "key": "pix_key", "description": "(Required) Chave Pix a ser removida (valor da chave, não o ID)" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4fb5f445-c0b8-4464-9482-80af5ed034c7", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", ":pix_key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "nome@email.com", "key": "pix_key", "description": "(Required) Chave Pix a ser removida (valor da chave, não o ID)" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "102c8307-e312-4b0f-8edf-cea308eaa517", "name": "Chave Pix não encontrada ou não pertence à conta", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", ":pix_key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "nome@email.com", "key": "pix_key", "description": "(Required) Chave Pix a ser removida (valor da chave, não o ID)" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 404,\n \"code\": \"PIX_KEY_NOT_FOUND\",\n \"message\": \"Chave Pix não encontrada ou não pertence à conta\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 2130.65503007414,\n \"key_2\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0bdd9993-a0a5-46fb-8f2a-612dd3ba9235", "name": "Chave não pode ser removida no estado atual", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", ":pix_key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "nome@email.com", "key": "pix_key", "description": "(Required) Chave Pix a ser removida (valor da chave, não o ID)" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "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 \"status_code\": 422,\n \"code\": \"PIX_KEY_REMOVAL_NOT_ALLOWED\",\n \"message\": \"Chave não pode ser removida no estado atual\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "05f1b295-8c48-46aa-9858-7c150fead016", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", ":pix_key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "nome@email.com", "key": "pix_key", "description": "(Required) Chave Pix a ser removida (valor da chave, não o ID)" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5791e926-7917-4427-86b0-f508c2236f3e", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", ":pix_key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "nome@email.com", "key": "pix_key", "description": "(Required) Chave Pix a ser removida (valor da chave, não o ID)" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a80cd7f8-d59e-4732-ba32-62ebcb24338a", "name": "Gerar QR Code de chave Pix", "request": { "name": "Gerar QR Code de chave Pix", "description": { "content": "Gera ou regenera o QR Code estático associado a uma chave Pix existente da conta. Útil para chaves que foram criadas sem QR Code ou para atualizar o QR Code após alterações.\n\n**Comportamento:**\n• Se a chave já possui QR Code, ele é regenerado e atualizado\n• Se a chave não possui QR Code, um novo é gerado e associado\n• A chave deve pertencer à conta autenticada\n\n**Retorno:** Dados da chave com `pix_emv` (payload copia e cola) e `pix_qr_code` (imagem em base64 PNG).", "type": "text/plain" }, "url": { "path": [ "accounts", "pix", "keys", ":pix_key", "qrcode" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "0fc8781d-3c1e-4b9b-bdb1-8fa34455799c", "key": "pix_key", "description": "(Required) Valor da chave Pix (CPF, CNPJ, e-mail, telefone ou UUID)" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "2cc5c930-48c2-4e7d-9471-8f0f88f0260c", "name": "QR Code gerado com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", ":pix_key", "qrcode" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "0fc8781d-3c1e-4b9b-bdb1-8fa34455799c", "key": "pix_key", "description": "(Required) Valor da chave Pix (CPF, CNPJ, e-mail, telefone ou UUID)" } ] }, "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 \"pix_key\": \"0fc8781d-3c1e-4b9b-bdb1-8fa34455799c\",\n \"pix_key_type\": \"EVP\",\n \"pix_emv\": \"00020126580014BR.GOV.BCB.PIX...\",\n \"pix_qr_code\": \"data:image/png;base64,iVBORw0KGgo...\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3268385e-84e5-4280-8192-6071eda43504", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", ":pix_key", "qrcode" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "0fc8781d-3c1e-4b9b-bdb1-8fa34455799c", "key": "pix_key", "description": "(Required) Valor da chave Pix (CPF, CNPJ, e-mail, telefone ou UUID)" } ] }, "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 Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "346be534-1adb-492d-b5de-b584b44a4c93", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", ":pix_key", "qrcode" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "0fc8781d-3c1e-4b9b-bdb1-8fa34455799c", "key": "pix_key", "description": "(Required) Valor da chave Pix (CPF, CNPJ, e-mail, telefone ou UUID)" } ] }, "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 \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c7197016-61e7-4d48-9f8d-9826f8308aaf", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", ":pix_key", "qrcode" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "0fc8781d-3c1e-4b9b-bdb1-8fa34455799c", "key": "pix_key", "description": "(Required) Valor da chave Pix (CPF, CNPJ, e-mail, telefone ou UUID)" } ] }, "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 \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "66dd08ba-f1ed-4548-be0e-4f22cd141f63", "name": "Chave Pix não encontrada para esta conta", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", ":pix_key", "qrcode" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "0fc8781d-3c1e-4b9b-bdb1-8fa34455799c", "key": "pix_key", "description": "(Required) Valor da chave Pix (CPF, CNPJ, e-mail, telefone ou UUID)" } ] }, "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 \"status_code\": 404,\n \"code\": \"PIX_KEY_NOT_FOUND\",\n \"message\": \"Chave Pix não encontrada para esta conta\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9e087253-1e84-4b3c-a4fe-bc84cf8c5f83", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", ":pix_key", "qrcode" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "0fc8781d-3c1e-4b9b-bdb1-8fa34455799c", "key": "pix_key", "description": "(Required) Valor da chave Pix (CPF, CNPJ, e-mail, telefone ou UUID)" } ] }, "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": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1ea6867b-cab8-4371-9c4f-3266f6cbd666", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", ":pix_key", "qrcode" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "0fc8781d-3c1e-4b9b-bdb1-8fa34455799c", "key": "pix_key", "description": "(Required) Valor da chave Pix (CPF, CNPJ, e-mail, telefone ou UUID)" } ] }, "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "cab96df4-8f69-4183-a68e-191a0745aad0", "name": "Solicitar MFA para chave Pix", "request": { "name": "Solicitar MFA para chave Pix", "description": { "content": "Solicita o envio de um código de verificação (MFA) necessário para registrar chaves Pix que exigem confirmação, como e-mail e telefone.\n\n**Quando usar:**\n• Antes de registrar uma chave Pix do tipo e-mail ou telefone\n• O código recebido deve ser incluído no payload de `POST /accounts/pix/keys`\n\n**Canais de envio:**\n• E-mail: código enviado para o endereço informado\n• Telefone: código enviado via SMS para o número informado", "type": "text/plain" }, "url": { "path": [ "accounts", "pix", "mfa" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "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 \"type\": \"EMAIL\",\n \"send_to\": \"nome@email.com.br\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "053ddf58-a938-457c-8dff-321be06678c7", "name": "Código de verificação enviado com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "pix", "mfa" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"EMAIL\",\n \"send_to\": \"nome@email.com.br\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"auth_code\": \"123456\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "13cbb4ff-0810-46a2-bbfe-b4ad2e4ea149", "name": "Tipo de chave inválido ou dados incorretos", "originalRequest": { "url": { "path": [ "accounts", "pix", "mfa" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"EMAIL\",\n \"send_to\": \"nome@email.com.br\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Tipo de chave inválido ou dados incorretos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 4893\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "061dd724-0cba-4152-8fe0-42cbf4029f18", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "pix", "mfa" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"EMAIL\",\n \"send_to\": \"nome@email.com.br\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "657640db-c8af-4922-b95e-66865507a039", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "pix", "mfa" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"EMAIL\",\n \"send_to\": \"nome@email.com.br\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3e34c902-a808-4938-8e26-4e56882b17f8", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "pix", "mfa" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"EMAIL\",\n \"send_to\": \"nome@email.com.br\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7c69c859-86c6-460b-a917-7f23081d06fb", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "pix", "mfa" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"EMAIL\",\n \"send_to\": \"nome@email.com.br\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "daa6c086-0da0-4279-8a5c-3bcef3fa0e05", "name": "Criar QR-Code estático", "request": { "name": "Criar QR-Code estático", "description": { "content": "Gera um QR Code Pix estático, ideal para cobranças com valor fixo e recorrentes. O mesmo QR Code pode ser utilizado múltiplas vezes.\n\n**Características:**\n• Valor fixo definido na criação (ou sem valor, para o pagador preencher)\n• Reutilizável — pode ser pago quantas vezes for necessário\n• Sem data de vencimento\n• Ideal para: mensalidades, doações, cobranças recorrentes com valor fixo\n\n**Retorno:** Payload EMV do QR Code e imagem em base64 para exibição.", "type": "text/plain" }, "url": { "path": [ "accounts", "pix", "qrcodes", "static" ], "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 \"pix_key\": \"nome@email.com.br\",\n \"pix_key_type\": \"EMAIL\",\n \"amount\": 5000,\n \"txid\": \"9876543210123456744\",\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code estático\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "73c4cdea-8a00-4738-865b-16c3c3ddda1b", "name": "QR Code estático gerado com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "static" ], "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 \"pix_key\": \"nome@email.com.br\",\n \"pix_key_type\": \"EMAIL\",\n \"amount\": 5000,\n \"txid\": \"9876543210123456744\",\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code estático\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"pix_emv\": \"00020126580014BR.GOV.BCB.PIX...\",\n \"pix_qr_code\": \"data:image/png;base64,iVBORw0KGgo...\",\n \"id\": \"01JY05224X1WGAH75F5404HXMF\",\n \"txid\": \"pixcobrança2026051401\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8d5ff17e-db81-4eb0-b131-df212b29ffdc", "name": "Dados do QR Code inválidos", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "static" ], "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 \"pix_key\": \"nome@email.com.br\",\n \"pix_key_type\": \"EMAIL\",\n \"amount\": 5000,\n \"txid\": \"9876543210123456744\",\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code estático\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados do QR Code inválidos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 3300.351220205424,\n \"key_1\": 9695.756482887486\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7b6c6e0a-bb89-408d-948d-2a2accbf6c46", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "static" ], "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 \"pix_key\": \"nome@email.com.br\",\n \"pix_key_type\": \"EMAIL\",\n \"amount\": 5000,\n \"txid\": \"9876543210123456744\",\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code estático\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "24926a40-34d3-4827-bef3-a411631ddf8a", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "static" ], "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 \"pix_key\": \"nome@email.com.br\",\n \"pix_key_type\": \"EMAIL\",\n \"amount\": 5000,\n \"txid\": \"9876543210123456744\",\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code estático\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "96592bf7-b12a-4fe9-a0a9-795d1b078548", "name": "Nenhuma chave Pix ativa cadastrada para a conta", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "static" ], "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 \"pix_key\": \"nome@email.com.br\",\n \"pix_key_type\": \"EMAIL\",\n \"amount\": 5000,\n \"txid\": \"9876543210123456744\",\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code estático\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 422,\n \"code\": \"NO_PIX_KEY_REGISTERED\",\n \"message\": \"Nenhuma chave Pix ativa cadastrada para a conta\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5016.335262068578\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cdcaa91c-7bfd-47fd-90aa-ad8540f68a31", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "static" ], "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 \"pix_key\": \"nome@email.com.br\",\n \"pix_key_type\": \"EMAIL\",\n \"amount\": 5000,\n \"txid\": \"9876543210123456744\",\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code estático\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "333ababf-6b94-4616-b528-60a3d8331978", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "static" ], "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 \"pix_key\": \"nome@email.com.br\",\n \"pix_key_type\": \"EMAIL\",\n \"amount\": 5000,\n \"txid\": \"9876543210123456744\",\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code estático\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "36ee5a26-651e-4d2f-b7d5-ee0ca56b4e2e", "name": "Criar QR-Code dinâmico", "request": { "name": "Criar QR-Code dinâmico", "description": { "content": "Gera um QR Code Pix dinâmico para uma cobrança específica de uso único. Recomendado para transações individuais que exigem rastreabilidade.\n\n**Características:**\n• Uso único — expira após o primeiro pagamento ou na data definida\n• Permite identificar o pagador via campo de informação adicional\n• Rastreável por `txid` para conciliação automatizada\n• Suporta data e hora de expiração\n\n**Ideal para:** cobranças pontuais, e-commerce, checkouts.", "type": "text/plain" }, "url": { "path": [ "accounts", "pix", "qrcodes", "dynamic" ], "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 \"pix_key\": \"12345678900\",\n \"pix_key_type\": \"CPF\",\n \"txid\": \"01KH3JQFGK0HV3GMMAGX8V7XQE\",\n \"amount\": 5000,\n \"rebate_amount\": 5000,\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code dinâmico\",\n \"payer_name\": \"Fulano da Silva\",\n \"payer_document\": \"12345678900\",\n \"payer_type\": \"INDIVIDUAL\",\n \"expires_at\": \"2026-05-08T23:59:00-03:00\",\n \"expires_in\": 1800\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "86e71427-7b1a-440f-9aa3-91a6d69234b4", "name": "QR Code dinâmico gerado com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "dynamic" ], "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 \"pix_key\": \"12345678900\",\n \"pix_key_type\": \"CPF\",\n \"txid\": \"01KH3JQFGK0HV3GMMAGX8V7XQE\",\n \"amount\": 5000,\n \"rebate_amount\": 5000,\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code dinâmico\",\n \"payer_name\": \"Fulano da Silva\",\n \"payer_document\": \"12345678900\",\n \"payer_type\": \"INDIVIDUAL\",\n \"expires_at\": \"2026-05-08T23:59:00-03:00\",\n \"expires_in\": 1800\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"pix_emv\": \"00020126580014BR.GOV.BCB.PIX...\",\n \"pix_qr_code\": \"data:image/png;base64,iVBORw0KGgo...\",\n \"id\": \"01JY05224X1WGAH75F5404HXMF\",\n \"txid\": \"pixcobrança2026051401\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ada13be8-f7b8-4ef9-8a89-95a49e4d8cbf", "name": "Dados do QR Code inválidos", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "dynamic" ], "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 \"pix_key\": \"12345678900\",\n \"pix_key_type\": \"CPF\",\n \"txid\": \"01KH3JQFGK0HV3GMMAGX8V7XQE\",\n \"amount\": 5000,\n \"rebate_amount\": 5000,\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code dinâmico\",\n \"payer_name\": \"Fulano da Silva\",\n \"payer_document\": \"12345678900\",\n \"payer_type\": \"INDIVIDUAL\",\n \"expires_at\": \"2026-05-08T23:59:00-03:00\",\n \"expires_in\": 1800\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados do QR Code inválidos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 3300.351220205424,\n \"key_1\": 9695.756482887486\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "59a33cba-d7fd-4ba1-a360-68be56544cc1", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "dynamic" ], "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 \"pix_key\": \"12345678900\",\n \"pix_key_type\": \"CPF\",\n \"txid\": \"01KH3JQFGK0HV3GMMAGX8V7XQE\",\n \"amount\": 5000,\n \"rebate_amount\": 5000,\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code dinâmico\",\n \"payer_name\": \"Fulano da Silva\",\n \"payer_document\": \"12345678900\",\n \"payer_type\": \"INDIVIDUAL\",\n \"expires_at\": \"2026-05-08T23:59:00-03:00\",\n \"expires_in\": 1800\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "edb83125-8546-43e4-b4b0-f1cf21447373", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "dynamic" ], "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 \"pix_key\": \"12345678900\",\n \"pix_key_type\": \"CPF\",\n \"txid\": \"01KH3JQFGK0HV3GMMAGX8V7XQE\",\n \"amount\": 5000,\n \"rebate_amount\": 5000,\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code dinâmico\",\n \"payer_name\": \"Fulano da Silva\",\n \"payer_document\": \"12345678900\",\n \"payer_type\": \"INDIVIDUAL\",\n \"expires_at\": \"2026-05-08T23:59:00-03:00\",\n \"expires_in\": 1800\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "79ea42dd-fbcc-4b96-9917-fbe7e8e84ddf", "name": "Nenhuma chave Pix ativa cadastrada para a conta", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "dynamic" ], "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 \"pix_key\": \"12345678900\",\n \"pix_key_type\": \"CPF\",\n \"txid\": \"01KH3JQFGK0HV3GMMAGX8V7XQE\",\n \"amount\": 5000,\n \"rebate_amount\": 5000,\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code dinâmico\",\n \"payer_name\": \"Fulano da Silva\",\n \"payer_document\": \"12345678900\",\n \"payer_type\": \"INDIVIDUAL\",\n \"expires_at\": \"2026-05-08T23:59:00-03:00\",\n \"expires_in\": 1800\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 422,\n \"code\": \"NO_PIX_KEY_REGISTERED\",\n \"message\": \"Nenhuma chave Pix ativa cadastrada para a conta\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5016.335262068578\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "41473fbd-20b9-411e-8077-786fab9c55e2", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "dynamic" ], "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 \"pix_key\": \"12345678900\",\n \"pix_key_type\": \"CPF\",\n \"txid\": \"01KH3JQFGK0HV3GMMAGX8V7XQE\",\n \"amount\": 5000,\n \"rebate_amount\": 5000,\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code dinâmico\",\n \"payer_name\": \"Fulano da Silva\",\n \"payer_document\": \"12345678900\",\n \"payer_type\": \"INDIVIDUAL\",\n \"expires_at\": \"2026-05-08T23:59:00-03:00\",\n \"expires_in\": 1800\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f1b91ea7-25ec-4d9d-b84b-5eeb968b05d0", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "dynamic" ], "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 \"pix_key\": \"12345678900\",\n \"pix_key_type\": \"CPF\",\n \"txid\": \"01KH3JQFGK0HV3GMMAGX8V7XQE\",\n \"amount\": 5000,\n \"rebate_amount\": 5000,\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code dinâmico\",\n \"payer_name\": \"Fulano da Silva\",\n \"payer_document\": \"12345678900\",\n \"payer_type\": \"INDIVIDUAL\",\n \"expires_at\": \"2026-05-08T23:59:00-03:00\",\n \"expires_in\": 1800\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f2932039-08d4-4a3d-9f5e-fef872df4a58", "name": "Criar QR-Code de cobrança", "request": { "name": "Criar QR-Code de cobrança", "description": { "content": "Gera um QR Code Pix de cobrança com suporte a regras financeiras avançadas: desconto por antecipação, multa e juros por atraso.\n\n**Recursos disponíveis:**\n\n**Desconto**\nRedução percentual ou valor fixo para pagamentos antecipados.\n\n**Multa por atraso**\nPercentual aplicado sobre o valor principal após o vencimento.\n\n**Juros**\nTaxa diária ou mensal aplicada após o vencimento.\n\n**Ideal para:** faturas, mensalidades com políticas de desconto e multa.", "type": "text/plain" }, "url": { "path": [ "accounts", "pix", "qrcodes", "billing" ], "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 \"pix_key\": \"12345678900\",\n \"pix_key_type\": \"CPF\",\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code estático\",\n \"amount\": 5000,\n \"rebate_amount\": 5000,\n \"payer_name\": \"Fulano da Silva\",\n \"payer_document\": \"12345678900\",\n \"payer_type\": \"INDIVIDUAL\",\n \"due_date\": \"2026-05-14\",\n \"discount\": {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"interest\": {\n \"code\": \"PERCENTAGE_PER_MONTH\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"fine\": {\n \"code\": \"PERCENTAGE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"txid\": \"pixcobrança20260514abcdefgh\",\n \"expires_at\": \"2026-05-08T23:59:00-03:00\",\n \"expires_in\": 86400\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "2b0191e6-66d0-4690-bbd8-e39985d65c62", "name": "QR Code de cobrança gerado com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "billing" ], "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 \"pix_key\": \"12345678900\",\n \"pix_key_type\": \"CPF\",\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code estático\",\n \"amount\": 5000,\n \"rebate_amount\": 5000,\n \"payer_name\": \"Fulano da Silva\",\n \"payer_document\": \"12345678900\",\n \"payer_type\": \"INDIVIDUAL\",\n \"due_date\": \"2026-05-14\",\n \"discount\": {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"interest\": {\n \"code\": \"PERCENTAGE_PER_MONTH\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"fine\": {\n \"code\": \"PERCENTAGE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"txid\": \"pixcobrança20260514abcdefgh\",\n \"expires_at\": \"2026-05-08T23:59:00-03:00\",\n \"expires_in\": 86400\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"pix_emv\": \"00020126580014BR.GOV.BCB.PIX...\",\n \"pix_qr_code\": \"data:image/png;base64,iVBORw0KGgo...\",\n \"id\": \"01JY05224X1WGAH75F5404HXMF\",\n \"txid\": \"pixcobrança2026051401\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b3c92696-94be-4832-81b0-8324bbb3a1bc", "name": "Dados da cobrança inválidos", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "billing" ], "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 \"pix_key\": \"12345678900\",\n \"pix_key_type\": \"CPF\",\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code estático\",\n \"amount\": 5000,\n \"rebate_amount\": 5000,\n \"payer_name\": \"Fulano da Silva\",\n \"payer_document\": \"12345678900\",\n \"payer_type\": \"INDIVIDUAL\",\n \"due_date\": \"2026-05-14\",\n \"discount\": {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"interest\": {\n \"code\": \"PERCENTAGE_PER_MONTH\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"fine\": {\n \"code\": \"PERCENTAGE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"txid\": \"pixcobrança20260514abcdefgh\",\n \"expires_at\": \"2026-05-08T23:59:00-03:00\",\n \"expires_in\": 86400\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados da cobrança inválidos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1816.214715365594,\n \"key_2\": 388.0545606436758\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ac041a7e-558b-4470-a955-bf7c8fe4eaf5", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "billing" ], "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 \"pix_key\": \"12345678900\",\n \"pix_key_type\": \"CPF\",\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code estático\",\n \"amount\": 5000,\n \"rebate_amount\": 5000,\n \"payer_name\": \"Fulano da Silva\",\n \"payer_document\": \"12345678900\",\n \"payer_type\": \"INDIVIDUAL\",\n \"due_date\": \"2026-05-14\",\n \"discount\": {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"interest\": {\n \"code\": \"PERCENTAGE_PER_MONTH\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"fine\": {\n \"code\": \"PERCENTAGE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"txid\": \"pixcobrança20260514abcdefgh\",\n \"expires_at\": \"2026-05-08T23:59:00-03:00\",\n \"expires_in\": 86400\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "021ec747-3e2c-42d5-824e-206539e32c0f", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "billing" ], "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 \"pix_key\": \"12345678900\",\n \"pix_key_type\": \"CPF\",\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code estático\",\n \"amount\": 5000,\n \"rebate_amount\": 5000,\n \"payer_name\": \"Fulano da Silva\",\n \"payer_document\": \"12345678900\",\n \"payer_type\": \"INDIVIDUAL\",\n \"due_date\": \"2026-05-14\",\n \"discount\": {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"interest\": {\n \"code\": \"PERCENTAGE_PER_MONTH\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"fine\": {\n \"code\": \"PERCENTAGE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"txid\": \"pixcobrança20260514abcdefgh\",\n \"expires_at\": \"2026-05-08T23:59:00-03:00\",\n \"expires_in\": 86400\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bfe4e241-6f11-4b6f-8637-46b6ad956abb", "name": "Nenhuma chave Pix ativa cadastrada para a conta", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "billing" ], "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 \"pix_key\": \"12345678900\",\n \"pix_key_type\": \"CPF\",\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code estático\",\n \"amount\": 5000,\n \"rebate_amount\": 5000,\n \"payer_name\": \"Fulano da Silva\",\n \"payer_document\": \"12345678900\",\n \"payer_type\": \"INDIVIDUAL\",\n \"due_date\": \"2026-05-14\",\n \"discount\": {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"interest\": {\n \"code\": \"PERCENTAGE_PER_MONTH\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"fine\": {\n \"code\": \"PERCENTAGE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"txid\": \"pixcobrança20260514abcdefgh\",\n \"expires_at\": \"2026-05-08T23:59:00-03:00\",\n \"expires_in\": 86400\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 422,\n \"code\": \"NO_PIX_KEY_REGISTERED\",\n \"message\": \"Nenhuma chave Pix ativa cadastrada para a conta\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5016.335262068578\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d4d75151-3c86-4990-abf8-126aa69d2fba", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "billing" ], "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 \"pix_key\": \"12345678900\",\n \"pix_key_type\": \"CPF\",\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code estático\",\n \"amount\": 5000,\n \"rebate_amount\": 5000,\n \"payer_name\": \"Fulano da Silva\",\n \"payer_document\": \"12345678900\",\n \"payer_type\": \"INDIVIDUAL\",\n \"due_date\": \"2026-05-14\",\n \"discount\": {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"interest\": {\n \"code\": \"PERCENTAGE_PER_MONTH\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"fine\": {\n \"code\": \"PERCENTAGE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"txid\": \"pixcobrança20260514abcdefgh\",\n \"expires_at\": \"2026-05-08T23:59:00-03:00\",\n \"expires_in\": 86400\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6212bede-730e-4f79-998b-ae2d20ef21fb", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "billing" ], "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 \"pix_key\": \"12345678900\",\n \"pix_key_type\": \"CPF\",\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code estático\",\n \"amount\": 5000,\n \"rebate_amount\": 5000,\n \"payer_name\": \"Fulano da Silva\",\n \"payer_document\": \"12345678900\",\n \"payer_type\": \"INDIVIDUAL\",\n \"due_date\": \"2026-05-14\",\n \"discount\": {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"interest\": {\n \"code\": \"PERCENTAGE_PER_MONTH\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"fine\": {\n \"code\": \"PERCENTAGE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"txid\": \"pixcobrança20260514abcdefgh\",\n \"expires_at\": \"2026-05-08T23:59:00-03:00\",\n \"expires_in\": 86400\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "474013a9-1e9f-4a0a-926c-87950b880389", "name": "Ler QR-Code", "request": { "name": "Ler QR-Code", "description": { "content": "Decodifica o payload EMV de um QR Code Pix e retorna as informações da cobrança associada. Utilize antes de confirmar um pagamento para exibir os dados ao usuário.\n\n**Informações retornadas:**\n• Dados do recebedor (nome, CPF/CNPJ, instituição)\n• Valor e tipo (estático, dinâmico ou cobrança)\n• Data de vencimento, quando aplicável\n• `txid` para rastreamento da transação\n\n**Parâmetro `emv`:** String completa do payload EMV do QR Code lido pelo dispositivo.", "type": "text/plain" }, "url": { "path": [ "accounts", "pix", "qrcodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "emv", "value": "00020126580014br.gov.bcb.pix0136123e4567-e12b-12d1-a456-426655440000...", "description": "(Required) Payload EMV completo do QR Code Pix" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "f4cd7dd9-fc5b-4f71-827f-714f3b2efe82", "name": "QR Code decodificado com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "emv", "value": "00020126580014br.gov.bcb.pix0136123e4567-e12b-12d1-a456-426655440000..." } ], "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 \"read_id\": \"01JY05224X1WGAH75F5404HXMF\",\n \"qrcode_type\": \"DYNAMIC\",\n \"pix_key\": \"joao.silva@exemplo.com\",\n \"reusable\": false,\n \"amount\": 15000,\n \"txid\": \"pixcobrança2026051401\",\n \"holder_document\": \"12345678900\",\n \"additional_info\": \"Pagamento ref #12345\",\n \"merchant_name\": \"Meioo Pagamentos\",\n \"merchant_city\": \"Sao Paulo\",\n \"url\": \"https://qr.cornerpix.com.br/...\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aac8511a-bb90-4dd0-ad1b-0acad2595420", "name": "Payload EMV inválido ou mal formatado", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "emv", "value": "00020126580014br.gov.bcb.pix0136123e4567-e12b-12d1-a456-426655440000..." } ], "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 \"status_code\": 400,\n \"code\": \"INVALID_QR_CODE\",\n \"message\": \"Payload EMV inválido ou mal formatado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5780,\n \"key_1\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "18dc8956-072f-4e59-9d83-0f17377428b6", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "emv", "value": "00020126580014br.gov.bcb.pix0136123e4567-e12b-12d1-a456-426655440000..." } ], "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 \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9e23dfaa-4f93-4d13-bbbc-1910af03f9f9", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "emv", "value": "00020126580014br.gov.bcb.pix0136123e4567-e12b-12d1-a456-426655440000..." } ], "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 \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c18b9a34-2566-43f7-a131-22c4839e2e7a", "name": "QR Code expirado ou já utilizado", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "emv", "value": "00020126580014br.gov.bcb.pix0136123e4567-e12b-12d1-a456-426655440000..." } ], "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 \"status_code\": 422,\n \"code\": \"QR_CODE_EXPIRED\",\n \"message\": \"QR Code expirado ou já utilizado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true,\n \"key_2\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1f7592aa-fb8c-4cfa-8cbd-913b15e8b253", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "emv", "value": "00020126580014br.gov.bcb.pix0136123e4567-e12b-12d1-a456-426655440000..." } ], "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9d343818-157e-4a1d-8a47-49fde0668559", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "emv", "value": "00020126580014br.gov.bcb.pix0136123e4567-e12b-12d1-a456-426655440000..." } ], "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1df8cbe9-30a4-488f-8a93-20af77a12d5b", "name": "Consultar situação de QR-Code", "request": { "name": "Consultar situação de QR-Code", "description": { "content": "Consulta o status atual de um QR Code gerado pela plataforma Meioo a partir do seu ID interno. Permite verificar se o QR Code foi pago, está pendente ou expirou.\n\n**Status possíveis:**\n\n**ACTIVE**\nAguardando pagamento.\n\n**PAID**\nPagamento confirmado. Inclui dados da transação liquidada.\n\n**EXPIRED**\nPrazo de validade encerrado sem pagamento.\n\n**O `id`** é retornado no campo `id` da resposta dos endpoints de criação de QR Code.", "type": "text/plain" }, "url": { "path": [ "accounts", "pix", "qrcodes", ":id", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID interno do QR Code (retornado na criação)" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "8793e31c-a20d-4fa2-a7a5-79a207191cdf", "name": "Status do QR Code retornado com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", ":id", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID interno do QR Code (retornado na criação)" } ] }, "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\": \"01JY05224X1WGAH75F5404HXMF\",\n \"qrcode_type\": \"DYNAMIC\",\n \"txid\": \"pixcobrança2026051401\",\n \"status\": \"ACTIVE\",\n \"amount\": 15000,\n \"pix_key\": \"joao.silva@exemplo.com\",\n \"additional_info\": \"Pagamento ref #12345\",\n \"reference_id\": \"REF-20260514-001\",\n \"payer_name\": \"Ana Carolina Lima\",\n \"payer_document\": \"00011122233\",\n \"paid_amount\": 15000,\n \"paid_at\": \"2026-05-14T14:30:00-03:00\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "79c25201-0250-4e7f-9695-e6c8565770bd", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", ":id", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID interno do QR Code (retornado na criação)" } ] }, "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 \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d838b383-65be-442b-bc1d-b75fdc32fe4c", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", ":id", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID interno do QR Code (retornado na criação)" } ] }, "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 \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c175344b-9615-4c47-ad78-d55226bba81d", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", ":id", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID interno do QR Code (retornado na criação)" } ] }, "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 \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "50ac3786-80ed-4b86-aad9-ad465dff5192", "name": "QR Code não encontrado ou não pertence à conta", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", ":id", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID interno do QR Code (retornado na criação)" } ] }, "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 \"status_code\": 404,\n \"code\": \"QR_CODE_NOT_FOUND\",\n \"message\": \"QR Code não encontrado ou não pertence à conta\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4968.003835962322,\n \"key_1\": 8355.238763800755\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f55f4c0f-19d7-462f-a679-6a8d8062a8ae", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", ":id", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID interno do QR Code (retornado na criação)" } ] }, "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7cab2b12-29c9-4a27-a31f-444006ebe27f", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", ":id", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID interno do QR Code (retornado na criação)" } ] }, "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f707ed16-cd83-4b09-af49-c41d824c656d", "name": "Transferir via Pix", "request": { "name": "Transferir via Pix", "description": { "content": "Realiza uma transferência instantânea via Pix. A liquidação ocorre em tempo real, 24 horas por dia, 7 dias por semana.\n\n**Formas de endereçamento:**\n\n**Por chave Pix**\nCPF, CNPJ, e-mail, telefone ou chave aleatória do destinatário.\n\n**Por QR Code**\nPayload EMV lido e validado via `GET /accounts/pix/qrcodes`.\n\n**Dados bancários**\nAgência, conta, tipo de conta e ISPB da instituição destinatária.\n\n**SLA de liquidação:** Máximo de 10 segundos conforme regulação BACEN.\n\n**Fluxo de aprovação:**\nA transação é criada com status `AWAITING_APPROVAL`. A aprovação deve ser feita via `PATCH /accounts/approvals/transactions/{id}` com autenticação step-up.", "type": "text/plain" }, "url": { "path": [ "accounts", "pix", "transfers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "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 \"pix_transfer_type\": \"KEY\",\n \"pix_key\": \"000.000.000-00\",\n \"pix_qrcode_emv\": \"00020126850014BR.GOV.BCB.PIX2563qr.cornerpix.com.br/new/11581339/v2/cobv/d8z7CCHxatKYreSvrw3UpE5204000053039865802BR5914BMP Money Plus6009SAO PAULO62070503***63046FE1\",\n \"pix_account\": {\n \"holder_name\": \"Fulano da Silva\",\n \"holder_document\": \"12345678900\",\n \"branch_code\": \"0001\",\n \"account_number\": \"02381705\",\n \"ispb\": \"11581339\",\n \"account_type\": \"PAYMENT\",\n \"branch_digit\": \"8\",\n \"account_digit\": \"5\",\n \"account_model\": \"MOVEMENT\"\n },\n \"amount\": 5313.71765446526,\n \"reference_id\": \"21a888e9-e36b-47ef-b365-5268314a04d0\",\n \"description\": \"Pagamento de contas\",\n \"additional_info\": \"Transferência Pix\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "d8bf7cba-949d-4c52-9674-3e0d7eaacecb", "name": "Transferência Pix realizada com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "pix", "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"pix_transfer_type\": \"KEY\",\n \"pix_key\": \"000.000.000-00\",\n \"pix_qrcode_emv\": \"00020126850014BR.GOV.BCB.PIX2563qr.cornerpix.com.br/new/11581339/v2/cobv/d8z7CCHxatKYreSvrw3UpE5204000053039865802BR5914BMP Money Plus6009SAO PAULO62070503***63046FE1\",\n \"pix_account\": {\n \"holder_name\": \"Fulano da Silva\",\n \"holder_document\": \"12345678900\",\n \"branch_code\": \"0001\",\n \"account_number\": \"02381705\",\n \"ispb\": \"11581339\",\n \"account_type\": \"PAYMENT\",\n \"branch_digit\": \"8\",\n \"account_digit\": \"5\",\n \"account_model\": \"MOVEMENT\"\n },\n \"amount\": 5313.71765446526,\n \"reference_id\": \"21a888e9-e36b-47ef-b365-5268314a04d0\",\n \"description\": \"Pagamento de contas\",\n \"additional_info\": \"Transferência Pix\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"01JXYZ...\",\n \"type\": \"PIX\",\n \"status\": \"PENDING\",\n \"amount\": 10000,\n \"occurred_at\": \"2026-05-14T14:00:00-03:00\",\n \"fee_amount\": 50\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "608ad851-737c-4b7d-a0e8-2c01d95c49fd", "name": "Dados da transferência inválidos ou incompletos", "originalRequest": { "url": { "path": [ "accounts", "pix", "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"pix_transfer_type\": \"KEY\",\n \"pix_key\": \"000.000.000-00\",\n \"pix_qrcode_emv\": \"00020126850014BR.GOV.BCB.PIX2563qr.cornerpix.com.br/new/11581339/v2/cobv/d8z7CCHxatKYreSvrw3UpE5204000053039865802BR5914BMP Money Plus6009SAO PAULO62070503***63046FE1\",\n \"pix_account\": {\n \"holder_name\": \"Fulano da Silva\",\n \"holder_document\": \"12345678900\",\n \"branch_code\": \"0001\",\n \"account_number\": \"02381705\",\n \"ispb\": \"11581339\",\n \"account_type\": \"PAYMENT\",\n \"branch_digit\": \"8\",\n \"account_digit\": \"5\",\n \"account_model\": \"MOVEMENT\"\n },\n \"amount\": 5313.71765446526,\n \"reference_id\": \"21a888e9-e36b-47ef-b365-5268314a04d0\",\n \"description\": \"Pagamento de contas\",\n \"additional_info\": \"Transferência Pix\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados da transferência inválidos ou incompletos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 2915.2737104598937,\n \"key_1\": 6322.163170310378,\n \"key_2\": 5153.476386524771\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b3b9468c-1837-44f0-a99a-5f2dacf8aacb", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "pix", "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"pix_transfer_type\": \"KEY\",\n \"pix_key\": \"000.000.000-00\",\n \"pix_qrcode_emv\": \"00020126850014BR.GOV.BCB.PIX2563qr.cornerpix.com.br/new/11581339/v2/cobv/d8z7CCHxatKYreSvrw3UpE5204000053039865802BR5914BMP Money Plus6009SAO PAULO62070503***63046FE1\",\n \"pix_account\": {\n \"holder_name\": \"Fulano da Silva\",\n \"holder_document\": \"12345678900\",\n \"branch_code\": \"0001\",\n \"account_number\": \"02381705\",\n \"ispb\": \"11581339\",\n \"account_type\": \"PAYMENT\",\n \"branch_digit\": \"8\",\n \"account_digit\": \"5\",\n \"account_model\": \"MOVEMENT\"\n },\n \"amount\": 5313.71765446526,\n \"reference_id\": \"21a888e9-e36b-47ef-b365-5268314a04d0\",\n \"description\": \"Pagamento de contas\",\n \"additional_info\": \"Transferência Pix\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6f3aa150-841b-4cca-8b8c-7e04ab72b2ec", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "pix", "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"pix_transfer_type\": \"KEY\",\n \"pix_key\": \"000.000.000-00\",\n \"pix_qrcode_emv\": \"00020126850014BR.GOV.BCB.PIX2563qr.cornerpix.com.br/new/11581339/v2/cobv/d8z7CCHxatKYreSvrw3UpE5204000053039865802BR5914BMP Money Plus6009SAO PAULO62070503***63046FE1\",\n \"pix_account\": {\n \"holder_name\": \"Fulano da Silva\",\n \"holder_document\": \"12345678900\",\n \"branch_code\": \"0001\",\n \"account_number\": \"02381705\",\n \"ispb\": \"11581339\",\n \"account_type\": \"PAYMENT\",\n \"branch_digit\": \"8\",\n \"account_digit\": \"5\",\n \"account_model\": \"MOVEMENT\"\n },\n \"amount\": 5313.71765446526,\n \"reference_id\": \"21a888e9-e36b-47ef-b365-5268314a04d0\",\n \"description\": \"Pagamento de contas\",\n \"additional_info\": \"Transferência Pix\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cd35778a-b508-460a-9e0f-2ddd0fa4df1e", "name": "Chave Pix do destinatário não encontrada no DICT", "originalRequest": { "url": { "path": [ "accounts", "pix", "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"pix_transfer_type\": \"KEY\",\n \"pix_key\": \"000.000.000-00\",\n \"pix_qrcode_emv\": \"00020126850014BR.GOV.BCB.PIX2563qr.cornerpix.com.br/new/11581339/v2/cobv/d8z7CCHxatKYreSvrw3UpE5204000053039865802BR5914BMP Money Plus6009SAO PAULO62070503***63046FE1\",\n \"pix_account\": {\n \"holder_name\": \"Fulano da Silva\",\n \"holder_document\": \"12345678900\",\n \"branch_code\": \"0001\",\n \"account_number\": \"02381705\",\n \"ispb\": \"11581339\",\n \"account_type\": \"PAYMENT\",\n \"branch_digit\": \"8\",\n \"account_digit\": \"5\",\n \"account_model\": \"MOVEMENT\"\n },\n \"amount\": 5313.71765446526,\n \"reference_id\": \"21a888e9-e36b-47ef-b365-5268314a04d0\",\n \"description\": \"Pagamento de contas\",\n \"additional_info\": \"Transferência Pix\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 404,\n \"code\": \"PIX_KEY_NOT_FOUND\",\n \"message\": \"Chave Pix do destinatário não encontrada no DICT\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 2866,\n \"key_2\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e690ea67-bcae-4680-bc04-48d5e88457b9", "name": "Já existe uma transação com o mesmo reference_id para esta conta, ou a chave de idempotência já foi utilizada", "originalRequest": { "url": { "path": [ "accounts", "pix", "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"pix_transfer_type\": \"KEY\",\n \"pix_key\": \"000.000.000-00\",\n \"pix_qrcode_emv\": \"00020126850014BR.GOV.BCB.PIX2563qr.cornerpix.com.br/new/11581339/v2/cobv/d8z7CCHxatKYreSvrw3UpE5204000053039865802BR5914BMP Money Plus6009SAO PAULO62070503***63046FE1\",\n \"pix_account\": {\n \"holder_name\": \"Fulano da Silva\",\n \"holder_document\": \"12345678900\",\n \"branch_code\": \"0001\",\n \"account_number\": \"02381705\",\n \"ispb\": \"11581339\",\n \"account_type\": \"PAYMENT\",\n \"branch_digit\": \"8\",\n \"account_digit\": \"5\",\n \"account_model\": \"MOVEMENT\"\n },\n \"amount\": 5313.71765446526,\n \"reference_id\": \"21a888e9-e36b-47ef-b365-5268314a04d0\",\n \"description\": \"Pagamento de contas\",\n \"additional_info\": \"Transferência Pix\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 409,\n \"code\": \"RESOURCE_CONFLICT\",\n \"message\": \"Já existe uma transação com o mesmo reference_id para esta conta, ou a chave de idempotência já foi utilizada\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 2211.3957762870464\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9fdf70c7-fb5b-4ce4-941f-7de5add2a186", "name": "Limite diário de transferências Pix atingido", "originalRequest": { "url": { "path": [ "accounts", "pix", "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"pix_transfer_type\": \"KEY\",\n \"pix_key\": \"000.000.000-00\",\n \"pix_qrcode_emv\": \"00020126850014BR.GOV.BCB.PIX2563qr.cornerpix.com.br/new/11581339/v2/cobv/d8z7CCHxatKYreSvrw3UpE5204000053039865802BR5914BMP Money Plus6009SAO PAULO62070503***63046FE1\",\n \"pix_account\": {\n \"holder_name\": \"Fulano da Silva\",\n \"holder_document\": \"12345678900\",\n \"branch_code\": \"0001\",\n \"account_number\": \"02381705\",\n \"ispb\": \"11581339\",\n \"account_type\": \"PAYMENT\",\n \"branch_digit\": \"8\",\n \"account_digit\": \"5\",\n \"account_model\": \"MOVEMENT\"\n },\n \"amount\": 5313.71765446526,\n \"reference_id\": \"21a888e9-e36b-47ef-b365-5268314a04d0\",\n \"description\": \"Pagamento de contas\",\n \"additional_info\": \"Transferência Pix\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 422,\n \"code\": \"DAILY_LIMIT_EXCEEDED\",\n \"message\": \"Limite diário de transferências Pix atingido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 8041.990995341935,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "78a3e271-da7b-4978-98bb-d836af49505c", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "pix", "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"pix_transfer_type\": \"KEY\",\n \"pix_key\": \"000.000.000-00\",\n \"pix_qrcode_emv\": \"00020126850014BR.GOV.BCB.PIX2563qr.cornerpix.com.br/new/11581339/v2/cobv/d8z7CCHxatKYreSvrw3UpE5204000053039865802BR5914BMP Money Plus6009SAO PAULO62070503***63046FE1\",\n \"pix_account\": {\n \"holder_name\": \"Fulano da Silva\",\n \"holder_document\": \"12345678900\",\n \"branch_code\": \"0001\",\n \"account_number\": \"02381705\",\n \"ispb\": \"11581339\",\n \"account_type\": \"PAYMENT\",\n \"branch_digit\": \"8\",\n \"account_digit\": \"5\",\n \"account_model\": \"MOVEMENT\"\n },\n \"amount\": 5313.71765446526,\n \"reference_id\": \"21a888e9-e36b-47ef-b365-5268314a04d0\",\n \"description\": \"Pagamento de contas\",\n \"additional_info\": \"Transferência Pix\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ae9a6f71-4048-4439-ad91-888997891f63", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "pix", "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"pix_transfer_type\": \"KEY\",\n \"pix_key\": \"000.000.000-00\",\n \"pix_qrcode_emv\": \"00020126850014BR.GOV.BCB.PIX2563qr.cornerpix.com.br/new/11581339/v2/cobv/d8z7CCHxatKYreSvrw3UpE5204000053039865802BR5914BMP Money Plus6009SAO PAULO62070503***63046FE1\",\n \"pix_account\": {\n \"holder_name\": \"Fulano da Silva\",\n \"holder_document\": \"12345678900\",\n \"branch_code\": \"0001\",\n \"account_number\": \"02381705\",\n \"ispb\": \"11581339\",\n \"account_type\": \"PAYMENT\",\n \"branch_digit\": \"8\",\n \"account_digit\": \"5\",\n \"account_model\": \"MOVEMENT\"\n },\n \"amount\": 5313.71765446526,\n \"reference_id\": \"21a888e9-e36b-47ef-b365-5268314a04d0\",\n \"description\": \"Pagamento de contas\",\n \"additional_info\": \"Transferência Pix\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6b96aff8-ab4a-4713-a724-6d6cbe4f0623", "name": "Sistema Pix (SPI) temporariamente indisponível", "originalRequest": { "url": { "path": [ "accounts", "pix", "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"pix_transfer_type\": \"KEY\",\n \"pix_key\": \"000.000.000-00\",\n \"pix_qrcode_emv\": \"00020126850014BR.GOV.BCB.PIX2563qr.cornerpix.com.br/new/11581339/v2/cobv/d8z7CCHxatKYreSvrw3UpE5204000053039865802BR5914BMP Money Plus6009SAO PAULO62070503***63046FE1\",\n \"pix_account\": {\n \"holder_name\": \"Fulano da Silva\",\n \"holder_document\": \"12345678900\",\n \"branch_code\": \"0001\",\n \"account_number\": \"02381705\",\n \"ispb\": \"11581339\",\n \"account_type\": \"PAYMENT\",\n \"branch_digit\": \"8\",\n \"account_digit\": \"5\",\n \"account_model\": \"MOVEMENT\"\n },\n \"amount\": 5313.71765446526,\n \"reference_id\": \"21a888e9-e36b-47ef-b365-5268314a04d0\",\n \"description\": \"Pagamento de contas\",\n \"additional_info\": \"Transferência Pix\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 503,\n \"code\": \"PIX_SERVICE_UNAVAILABLE\",\n \"message\": \"Sistema Pix (SPI) temporariamente indisponível\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": 7686,\n \"key_2\": 6015,\n \"key_3\": 4414\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8be3d056-e3b9-429b-8532-77dbe659c004", "name": "Devolver Pix recebido", "request": { "name": "Devolver Pix recebido", "description": { "content": "Realiza a devolução total ou parcial de uma transferência Pix recebida. O valor é devolvido ao remetente original de forma instantânea.\n\n**Regras:**\n• Devoluções devem ser solicitadas em até 90 dias após o recebimento\n• Devolução parcial: o valor devolvido não pode ser superior ao valor recebido\n• Múltiplas devoluções parciais são permitidas até o limite do valor original\n\n**Rastreamento:** O `id` retornado no response identifica a devolução. A confirmação da liquidação é assíncrona e pode ser acompanhada via webhook.\n\n**Fluxo de aprovação:**\nA transação é criada com status `AWAITING_APPROVAL`. A aprovação deve ser feita via `PATCH /accounts/approvals/transactions/{id}` com autenticação step-up.", "type": "text/plain" }, "url": { "path": [ "accounts", "pix", "refunds" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "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 \"transaction_id\": \"01KRE4P8B10YB2DY9SPGZCZK23\",\n \"amount\": 500,\n \"additional_info\": \"Pagamento ref #12345\",\n \"description\": \"Estorno solicitado pelo cliente\",\n \"reference_id\": \"DEV-2026-000123\",\n \"refund_reason\": \"PAYER_REQUEST\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "052911c4-d1ae-42bb-8bc3-674433adb33d", "name": "Devolução Pix iniciada com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "pix", "refunds" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"transaction_id\": \"01KRE4P8B10YB2DY9SPGZCZK23\",\n \"amount\": 500,\n \"additional_info\": \"Pagamento ref #12345\",\n \"description\": \"Estorno solicitado pelo cliente\",\n \"reference_id\": \"DEV-2026-000123\",\n \"refund_reason\": \"PAYER_REQUEST\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"01JY05224X1WGAH75F5404HXMF\",\n \"type\": \"PIX_REFUND\",\n \"status\": \"COMPLETED\",\n \"amount\": 15000,\n \"occurred_at\": \"2026-05-14T14:00:00-03:00\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "33bf7be4-045e-48fe-b2e3-f9f6aaaa481f", "name": "Dados da devolução inválidos", "originalRequest": { "url": { "path": [ "accounts", "pix", "refunds" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"transaction_id\": \"01KRE4P8B10YB2DY9SPGZCZK23\",\n \"amount\": 500,\n \"additional_info\": \"Pagamento ref #12345\",\n \"description\": \"Estorno solicitado pelo cliente\",\n \"reference_id\": \"DEV-2026-000123\",\n \"refund_reason\": \"PAYER_REQUEST\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados da devolução inválidos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 9168.325055195892,\n \"key_1\": 2062\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9e138872-50df-4ea0-880e-6589222cf5c7", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "pix", "refunds" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"transaction_id\": \"01KRE4P8B10YB2DY9SPGZCZK23\",\n \"amount\": 500,\n \"additional_info\": \"Pagamento ref #12345\",\n \"description\": \"Estorno solicitado pelo cliente\",\n \"reference_id\": \"DEV-2026-000123\",\n \"refund_reason\": \"PAYER_REQUEST\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1770e795-a9b2-4e9b-b095-29e278af0cde", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "pix", "refunds" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"transaction_id\": \"01KRE4P8B10YB2DY9SPGZCZK23\",\n \"amount\": 500,\n \"additional_info\": \"Pagamento ref #12345\",\n \"description\": \"Estorno solicitado pelo cliente\",\n \"reference_id\": \"DEV-2026-000123\",\n \"refund_reason\": \"PAYER_REQUEST\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1b0e0f3c-9e68-45f6-85b1-65e85419ea18", "name": "Transação Pix original não encontrada", "originalRequest": { "url": { "path": [ "accounts", "pix", "refunds" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"transaction_id\": \"01KRE4P8B10YB2DY9SPGZCZK23\",\n \"amount\": 500,\n \"additional_info\": \"Pagamento ref #12345\",\n \"description\": \"Estorno solicitado pelo cliente\",\n \"reference_id\": \"DEV-2026-000123\",\n \"refund_reason\": \"PAYER_REQUEST\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 404,\n \"code\": \"TRANSACTION_NOT_FOUND\",\n \"message\": \"Transação Pix original não encontrada\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2e24efa3-d4e9-4a21-bf54-e261cbc672ad", "name": "Já existe uma transação com o mesmo reference_id para esta conta, ou a chave de idempotência já foi utilizada", "originalRequest": { "url": { "path": [ "accounts", "pix", "refunds" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"transaction_id\": \"01KRE4P8B10YB2DY9SPGZCZK23\",\n \"amount\": 500,\n \"additional_info\": \"Pagamento ref #12345\",\n \"description\": \"Estorno solicitado pelo cliente\",\n \"reference_id\": \"DEV-2026-000123\",\n \"refund_reason\": \"PAYER_REQUEST\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 409,\n \"code\": \"RESOURCE_CONFLICT\",\n \"message\": \"Já existe uma transação com o mesmo reference_id para esta conta, ou a chave de idempotência já foi utilizada\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 2211.3957762870464\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e73ad184-7700-4d6e-8684-fb03c2dafcf4", "name": "Prazo de 90 dias para devolução expirado", "originalRequest": { "url": { "path": [ "accounts", "pix", "refunds" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"transaction_id\": \"01KRE4P8B10YB2DY9SPGZCZK23\",\n \"amount\": 500,\n \"additional_info\": \"Pagamento ref #12345\",\n \"description\": \"Estorno solicitado pelo cliente\",\n \"reference_id\": \"DEV-2026-000123\",\n \"refund_reason\": \"PAYER_REQUEST\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 422,\n \"code\": \"REFUND_DEADLINE_EXCEEDED\",\n \"message\": \"Prazo de 90 dias para devolução expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cbf796e4-9d6c-4ff8-82b7-031c6bec5615", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "pix", "refunds" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"transaction_id\": \"01KRE4P8B10YB2DY9SPGZCZK23\",\n \"amount\": 500,\n \"additional_info\": \"Pagamento ref #12345\",\n \"description\": \"Estorno solicitado pelo cliente\",\n \"reference_id\": \"DEV-2026-000123\",\n \"refund_reason\": \"PAYER_REQUEST\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7e3c6372-c419-4ddb-aeb4-b2277bff0691", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "pix", "refunds" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"transaction_id\": \"01KRE4P8B10YB2DY9SPGZCZK23\",\n \"amount\": 500,\n \"additional_info\": \"Pagamento ref #12345\",\n \"description\": \"Estorno solicitado pelo cliente\",\n \"reference_id\": \"DEV-2026-000123\",\n \"refund_reason\": \"PAYER_REQUEST\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "9ec2fb45-81d2-426c-8cdb-cac7b391fe6a", "name": "Boletos", "description": { "content": "Emissão, consulta, pagamento e cancelamento de boletos. Gestão de cedentes e carteiras", "type": "text/plain" }, "item": [ { "id": "096998ab-4f23-4ca1-befe-ae6a55d459f4", "name": "Consultar boleto para pagamento", "request": { "name": "Consultar boleto para pagamento", "description": { "content": "Consulta os dados de qualquer boleto a partir do seu código de barras ou linha digitável, independente da instituição emissora. Útil para validar os dados antes de efetuar o pagamento.\n\n**Parâmetros (ao menos um é obrigatório):**\n\n**barcode**\nCódigo de barras numérico do boleto (44 dígitos).\n\n**digitable_line**\nLinha digitável do boleto (47 ou 48 dígitos, formatada ou sem formatação).\n\n**Informações retornadas:** valor, vencimento, cedente, sacado e status de pagabilidade.", "type": "text/plain" }, "url": { "path": [ "accounts", "bank-slips", "consult" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "digitable_line", "value": "27490001011000000000969023817005311480000100000", "description": "Linha digitável do boleto. Informe pelo menos um: digitable_line ou barcode." }, { "disabled": false, "key": "barcode", "value": "27495114800000100000001010000000003202381700", "description": "Código de barras do boleto. Informe pelo menos um: digitable_line ou barcode." } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "858f7f45-bae3-4b4c-863e-1cd4fa0dae25", "name": "Dados do boleto consultados com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "consult" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "digitable_line", "value": "27490001011000000000969023817005311480000100000" }, { "key": "barcode", "value": "27495114800000100000001010000000003202381700" } ], "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 \"barcode\": \"27495114800001000000001010000000007102381700\",\n \"digitable_line\": \"27490001011000000000971023817001511480000100000\",\n \"amount\": 10000,\n \"due_date\": \"2025-11-30\",\n \"issuer\": {\n \"person_type\": \"INDIVIDUAL\",\n \"document_number\": \"12345678901\",\n \"name\": \"João da Silva\",\n \"trade_name\": \"Empresa Exemplo LTDA\",\n \"bank_code\": \"001\",\n \"ispb\": \"123456789\"\n },\n \"payer\": {\n \"person_type\": \"INDIVIDUAL\",\n \"document_number\": \"12345678901\",\n \"name\": \"Maria da Silva\"\n },\n \"rebate_amount\": 0,\n \"amount_due\": 10500,\n \"issue_date\": \"2025-10-31\",\n \"payment_limit_date\": \"2025-12-31\",\n \"dda_control_number\": \"0000012345678\",\n \"status\": \"OPEN\",\n \"guarantor\": {\n \"type\": \"CPF\",\n \"document\": \"78823832012\",\n \"name\": \"João da Silva\"\n },\n \"interest\": {\n \"value\": 1000,\n \"code\": \"1\",\n \"date\": \"2025-01-01\",\n \"percentage\": 2.5\n },\n \"fine\": {\n \"value\": 1000,\n \"code\": \"1\",\n \"date\": \"2025-01-01\",\n \"percentage\": 2.5\n },\n \"discounts\": [\n {\n \"value\": 1000,\n \"code\": \"1\",\n \"date\": \"2025-01-01\",\n \"percentage\": 2.5\n },\n {\n \"value\": 1000,\n \"code\": \"1\",\n \"date\": \"2025-01-01\",\n \"percentage\": 2.5\n }\n ],\n \"validations\": [\n {\n \"message\": \"Boleto já baixado\"\n },\n {\n \"message\": \"Boleto já baixado\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "55cc7a7f-5311-4e1c-988f-0104de675d5c", "name": "Nenhum código informado ou formato inválido", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "consult" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "digitable_line", "value": "27490001011000000000969023817005311480000100000" }, { "key": "barcode", "value": "27495114800000100000001010000000003202381700" } ], "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 \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Nenhum código informado ou formato inválido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 6171\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cf1df19b-5a9a-4cde-a9f2-93862279434f", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "consult" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "digitable_line", "value": "27490001011000000000969023817005311480000100000" }, { "key": "barcode", "value": "27495114800000100000001010000000003202381700" } ], "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 \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "08eab06a-f961-4258-9e8b-30eb45c89e56", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "consult" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "digitable_line", "value": "27490001011000000000969023817005311480000100000" }, { "key": "barcode", "value": "27495114800000100000001010000000003202381700" } ], "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 \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9bab02b6-54ab-4a4f-9ad5-ba19c43290d6", "name": "Boleto não encontrado ou não reconhecido", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "consult" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "digitable_line", "value": "27490001011000000000969023817005311480000100000" }, { "key": "barcode", "value": "27495114800000100000001010000000003202381700" } ], "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 \"status_code\": 404,\n \"code\": \"BANK_SLIP_NOT_FOUND\",\n \"message\": \"Boleto não encontrado ou não reconhecido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a6b96143-fd11-40db-ad85-1d2d0fefe01f", "name": "Boleto vencido, já pago ou cancelado", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "consult" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "digitable_line", "value": "27490001011000000000969023817005311480000100000" }, { "key": "barcode", "value": "27495114800000100000001010000000003202381700" } ], "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 \"status_code\": 422,\n \"code\": \"BANK_SLIP_NOT_PAYABLE\",\n \"message\": \"Boleto vencido, já pago ou cancelado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c50e36a7-0f86-4ba0-ac4f-9c84c013035e", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "consult" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "digitable_line", "value": "27490001011000000000969023817005311480000100000" }, { "key": "barcode", "value": "27495114800000100000001010000000003202381700" } ], "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "55edf945-81be-4df4-9667-0199798463b0", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "consult" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "digitable_line", "value": "27490001011000000000969023817005311480000100000" }, { "key": "barcode", "value": "27495114800000100000001010000000003202381700" } ], "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "876c43fa-1c7c-4914-bc09-d41c9a00a0b9", "name": "Pagar boleto", "request": { "name": "Pagar boleto", "description": { "content": "Realiza o pagamento de um boleto bancário de qualquer instituição a partir dos dados fornecidos.\n\n**Janela operacional:**\nPagamentos processados dentro do horário bancário são liquidados no mesmo dia. Pagamentos fora do horário são agendados para o próximo dia útil.\n\n**Boletos com vencimento:**\n• Boletos vencidos há até 60 dias podem ser pagos com multa e juros calculados automaticamente\n• Verifique o valor atualizado via `GET /accounts/bank-slips/consult` antes de confirmar o pagamento\n\n**Fluxo de aprovação:** A transação é criada com status `AWAITING_APPROVAL`. A aprovação deve ser feita via `PATCH /accounts/approvals/transactions/{id}` com autenticação step-up.", "type": "text/plain" }, "url": { "path": [ "accounts", "bank-slips", "payments" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "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 \"due_date\": \"2023-12-31\",\n \"amount\": 10000,\n \"payment_amount\": 9500,\n \"digitable_line\": \"27490001011000000000971023817001511480000100000\",\n \"barcode\": \"27495114800001000000001010000000007102381700\",\n \"reference_id\": \"1234567890\",\n \"description\": \"Pagamento do boleto 1234567890\",\n \"payment_limit_date\": \"2026-01-10\",\n \"rebate_amount\": 0,\n \"dda_control_number\": \"0000012345678\",\n \"issuer\": {\n \"name\": \"Empresa Exemplo LTDA\",\n \"document_number\": \"12345678000190\",\n \"bank_code\": \"274\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "2e1f1adc-e75a-4f0c-b667-2a3b75779bfe", "name": "Pagamento do boleto realizado com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "payments" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"due_date\": \"2023-12-31\",\n \"amount\": 10000,\n \"payment_amount\": 9500,\n \"digitable_line\": \"27490001011000000000971023817001511480000100000\",\n \"barcode\": \"27495114800001000000001010000000007102381700\",\n \"reference_id\": \"1234567890\",\n \"description\": \"Pagamento do boleto 1234567890\",\n \"payment_limit_date\": \"2026-01-10\",\n \"rebate_amount\": 0,\n \"dda_control_number\": \"0000012345678\",\n \"issuer\": {\n \"name\": \"Empresa Exemplo LTDA\",\n \"document_number\": \"12345678000190\",\n \"bank_code\": \"274\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"01HK6XQVZ8R9YJ7N2P5KMQB1XZ\",\n \"status\": \"PROCESSING\",\n \"amount\": 10000,\n \"digitable_line\": \"27490001011000000000971023817001511480000100000\",\n \"barcode\": \"27495114800001000000001010000000007102381700\",\n \"fee_amount\": 200\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "23057736-8e3e-4017-b0ab-7e0695da28f4", "name": "Dados do boleto inválidos ou incompletos", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "payments" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"due_date\": \"2023-12-31\",\n \"amount\": 10000,\n \"payment_amount\": 9500,\n \"digitable_line\": \"27490001011000000000971023817001511480000100000\",\n \"barcode\": \"27495114800001000000001010000000007102381700\",\n \"reference_id\": \"1234567890\",\n \"description\": \"Pagamento do boleto 1234567890\",\n \"payment_limit_date\": \"2026-01-10\",\n \"rebate_amount\": 0,\n \"dda_control_number\": \"0000012345678\",\n \"issuer\": {\n \"name\": \"Empresa Exemplo LTDA\",\n \"document_number\": \"12345678000190\",\n \"bank_code\": \"274\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados do boleto inválidos ou incompletos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 1693\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "498dcaf6-9149-46f3-a647-ac08b34e4ca4", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "payments" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"due_date\": \"2023-12-31\",\n \"amount\": 10000,\n \"payment_amount\": 9500,\n \"digitable_line\": \"27490001011000000000971023817001511480000100000\",\n \"barcode\": \"27495114800001000000001010000000007102381700\",\n \"reference_id\": \"1234567890\",\n \"description\": \"Pagamento do boleto 1234567890\",\n \"payment_limit_date\": \"2026-01-10\",\n \"rebate_amount\": 0,\n \"dda_control_number\": \"0000012345678\",\n \"issuer\": {\n \"name\": \"Empresa Exemplo LTDA\",\n \"document_number\": \"12345678000190\",\n \"bank_code\": \"274\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ad4c08f9-6287-416f-9edd-65aacfb12117", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "payments" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"due_date\": \"2023-12-31\",\n \"amount\": 10000,\n \"payment_amount\": 9500,\n \"digitable_line\": \"27490001011000000000971023817001511480000100000\",\n \"barcode\": \"27495114800001000000001010000000007102381700\",\n \"reference_id\": \"1234567890\",\n \"description\": \"Pagamento do boleto 1234567890\",\n \"payment_limit_date\": \"2026-01-10\",\n \"rebate_amount\": 0,\n \"dda_control_number\": \"0000012345678\",\n \"issuer\": {\n \"name\": \"Empresa Exemplo LTDA\",\n \"document_number\": \"12345678000190\",\n \"bank_code\": \"274\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aacc3d96-43a3-4a70-bde2-ae8c6ffca30f", "name": "Já existe uma transação com o mesmo reference_id para esta conta, ou a chave de idempotência já foi utilizada", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "payments" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"due_date\": \"2023-12-31\",\n \"amount\": 10000,\n \"payment_amount\": 9500,\n \"digitable_line\": \"27490001011000000000971023817001511480000100000\",\n \"barcode\": \"27495114800001000000001010000000007102381700\",\n \"reference_id\": \"1234567890\",\n \"description\": \"Pagamento do boleto 1234567890\",\n \"payment_limit_date\": \"2026-01-10\",\n \"rebate_amount\": 0,\n \"dda_control_number\": \"0000012345678\",\n \"issuer\": {\n \"name\": \"Empresa Exemplo LTDA\",\n \"document_number\": \"12345678000190\",\n \"bank_code\": \"274\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 409,\n \"code\": \"RESOURCE_CONFLICT\",\n \"message\": \"Já existe uma transação com o mesmo reference_id para esta conta, ou a chave de idempotência já foi utilizada\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 2211.3957762870464\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1190ced1-ce2c-4b23-9219-a4af4e986d50", "name": "Limite diário de pagamentos atingido", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "payments" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"due_date\": \"2023-12-31\",\n \"amount\": 10000,\n \"payment_amount\": 9500,\n \"digitable_line\": \"27490001011000000000971023817001511480000100000\",\n \"barcode\": \"27495114800001000000001010000000007102381700\",\n \"reference_id\": \"1234567890\",\n \"description\": \"Pagamento do boleto 1234567890\",\n \"payment_limit_date\": \"2026-01-10\",\n \"rebate_amount\": 0,\n \"dda_control_number\": \"0000012345678\",\n \"issuer\": {\n \"name\": \"Empresa Exemplo LTDA\",\n \"document_number\": \"12345678000190\",\n \"bank_code\": \"274\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 422,\n \"code\": \"DAILY_LIMIT_EXCEEDED\",\n \"message\": \"Limite diário de pagamentos atingido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 8102\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4e2e405b-8a3f-443f-bd40-06b37dc8f9e9", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "payments" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"due_date\": \"2023-12-31\",\n \"amount\": 10000,\n \"payment_amount\": 9500,\n \"digitable_line\": \"27490001011000000000971023817001511480000100000\",\n \"barcode\": \"27495114800001000000001010000000007102381700\",\n \"reference_id\": \"1234567890\",\n \"description\": \"Pagamento do boleto 1234567890\",\n \"payment_limit_date\": \"2026-01-10\",\n \"rebate_amount\": 0,\n \"dda_control_number\": \"0000012345678\",\n \"issuer\": {\n \"name\": \"Empresa Exemplo LTDA\",\n \"document_number\": \"12345678000190\",\n \"bank_code\": \"274\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "99502797-b63f-4bc9-a8ef-3bafeef5b6bf", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "payments" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"due_date\": \"2023-12-31\",\n \"amount\": 10000,\n \"payment_amount\": 9500,\n \"digitable_line\": \"27490001011000000000971023817001511480000100000\",\n \"barcode\": \"27495114800001000000001010000000007102381700\",\n \"reference_id\": \"1234567890\",\n \"description\": \"Pagamento do boleto 1234567890\",\n \"payment_limit_date\": \"2026-01-10\",\n \"rebate_amount\": 0,\n \"dda_control_number\": \"0000012345678\",\n \"issuer\": {\n \"name\": \"Empresa Exemplo LTDA\",\n \"document_number\": \"12345678000190\",\n \"bank_code\": \"274\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "465281da-7dc3-4b6f-8d94-91494cdfb660", "name": "Registrar boleto", "request": { "name": "Registrar boleto", "description": { "content": "Emite um novo boleto bancário e o registra automaticamente na CIP (Câmara Interbancária de Pagamentos). Boletos registrados são aceitos em qualquer banco.\n\n**Campos configuráveis:**\n\n**Vencimento**\nData de vencimento do boleto.\n\n**Desconto**\nPercentual ou valor fixo de desconto para pagamento antecipado.\n\n**Multa e Juros**\nPercentuais de multa e juros aplicados após o vencimento.\n\n**Instruções**\nTexto livre exibido no boleto para orientação ao pagador.\n\n**Retorno:** Dados completos do boleto registrado, incluindo linha digitável, código de barras e PDF disponível via `GET /accounts/bank-slips/{id}/pdf`.", "type": "text/plain" }, "url": { "path": [ "accounts", "bank-slips" ], "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 \"issue_date\": \"2025-10-31\",\n \"due_date\": \"2025-11-30\",\n \"payment_limit_date\": \"2025-12-31\",\n \"amount\": 10000,\n \"rebate_amount\": 100,\n \"document_number\": \"123456\",\n \"our_number\": \"123456\",\n \"payer\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"78823832012\",\n \"person_type\": \"INDIVIDUAL\",\n \"trade_name\": \"Padaria do João\",\n \"email\": \"joao@email.com\",\n \"phone_number\": \"31999999999\",\n \"address\": {\n \"street\": \"Rua da Bahia\",\n \"number\": \"500\",\n \"complement\": \"Apto 101\",\n \"neighborhood\": \"Centro\",\n \"city\": \"Belo Horizonte\",\n \"state\": \"MG\",\n \"zip_code\": \"30111300\"\n }\n },\n \"guarantor\": {\n \"type\": \"CNPJ\",\n \"document\": \"12345678000199\",\n \"name\": \"Empresa Garantidora SA\"\n },\n \"interest\": {\n \"code\": \"PERCENTAGE_PER_MONTH\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"fine\": {\n \"code\": \"PERCENTAGE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"instructions\": [\n \"Não receber após o vencimento\"\n ],\n \"reference_id\": \"REF-2026-001\",\n \"portfolio_number\": 1,\n \"description\": \"Mensalidade junho/2026\",\n \"discounts\": [\n {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n }\n ],\n \"recurrence\": {\n \"model\": \"DUPLICATE\",\n \"type\": \"MONTHLY\",\n \"quantity\": 12,\n \"fixed_day\": 15\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "4e929568-4c32-4173-8314-32513f6289db", "name": "Boleto emitido e registrado com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "bank-slips" ], "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 \"issue_date\": \"2025-10-31\",\n \"due_date\": \"2025-11-30\",\n \"payment_limit_date\": \"2025-12-31\",\n \"amount\": 10000,\n \"rebate_amount\": 100,\n \"document_number\": \"123456\",\n \"our_number\": \"123456\",\n \"payer\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"78823832012\",\n \"person_type\": \"INDIVIDUAL\",\n \"trade_name\": \"Padaria do João\",\n \"email\": \"joao@email.com\",\n \"phone_number\": \"31999999999\",\n \"address\": {\n \"street\": \"Rua da Bahia\",\n \"number\": \"500\",\n \"complement\": \"Apto 101\",\n \"neighborhood\": \"Centro\",\n \"city\": \"Belo Horizonte\",\n \"state\": \"MG\",\n \"zip_code\": \"30111300\"\n }\n },\n \"guarantor\": {\n \"type\": \"CNPJ\",\n \"document\": \"12345678000199\",\n \"name\": \"Empresa Garantidora SA\"\n },\n \"interest\": {\n \"code\": \"PERCENTAGE_PER_MONTH\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"fine\": {\n \"code\": \"PERCENTAGE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"instructions\": [\n \"Não receber após o vencimento\"\n ],\n \"reference_id\": \"REF-2026-001\",\n \"portfolio_number\": 1,\n \"description\": \"Mensalidade junho/2026\",\n \"discounts\": [\n {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n }\n ],\n \"recurrence\": {\n \"model\": \"DUPLICATE\",\n \"type\": \"MONTHLY\",\n \"quantity\": 12,\n \"fixed_day\": 15\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"01JZ8B37N8NPBSSD59JBCNFX6J\",\n \"registration_code\": \"REG123456\",\n \"issuer_number\": \"123456789\",\n \"issue_date\": \"2025-07-31\",\n \"due_date\": \"2025-08-10\",\n \"our_number\": \"123456\",\n \"document_number\": \"DOC123456789\",\n \"identification_code\": \"ID123\",\n \"barcode\": \"27492114800000010000001010000000002002381700\",\n \"digitable_line\": \"27490001011000000000920023817008211480000001000\",\n \"amount\": 100,\n \"payment_limit_date\": \"2025-08-10\",\n \"rebate_amount\": 100,\n \"status\": \"REGISTERED\",\n \"portfolio_number\": \"109\",\n \"payer\": {\n \"person_type\": \"INDIVIDUAL\",\n \"document_number\": \"12345678901\",\n \"name\": \"João Silva\",\n \"phone_number\": \"+5511999999999\",\n \"email\": \"joao@example.com\",\n \"address\": {\n \"street\": \"Rua das Flores\",\n \"number\": \"123\",\n \"neighborhood\": \"Centro\",\n \"city\": \"São Paulo\",\n \"state\": \"SP\",\n \"zip_code\": \"01000-000\",\n \"complement\": \"Apto 101\"\n },\n \"trade_name\": \"João's Store\"\n },\n \"pdf_url\": \"https://api.meioo.com.br/accounts/bank-slips/01KSG8PEVHX28ZXMQE4QZKVG8Q/pdf\",\n \"payment_date\": \"2025-08-11\",\n \"payment_amount\": 100,\n \"credit_date\": \"2025-08-12\",\n \"credit_amount\": 100,\n \"guarantor\": {\n \"type\": \"CNPJ\",\n \"document\": \"12345678000199\",\n \"name\": \"Empresa Garantidora SA\"\n },\n \"interest\": {\n \"date\": \"2025-08-01\",\n \"code\": \"01\",\n \"value\": 100\n },\n \"fine\": {\n \"date\": \"2025-08-01\",\n \"code\": \"01\",\n \"value\": 100\n },\n \"discounts\": [\n {\n \"date\": \"2025-08-01\",\n \"code\": \"02\",\n \"value\": 100\n },\n {\n \"date\": \"2025-08-01\",\n \"code\": \"02\",\n \"value\": 100\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "50263b8d-999c-483a-b3f6-05a38fe1f880", "name": "Dados do boleto inválidos ou incompletos", "originalRequest": { "url": { "path": [ "accounts", "bank-slips" ], "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 \"issue_date\": \"2025-10-31\",\n \"due_date\": \"2025-11-30\",\n \"payment_limit_date\": \"2025-12-31\",\n \"amount\": 10000,\n \"rebate_amount\": 100,\n \"document_number\": \"123456\",\n \"our_number\": \"123456\",\n \"payer\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"78823832012\",\n \"person_type\": \"INDIVIDUAL\",\n \"trade_name\": \"Padaria do João\",\n \"email\": \"joao@email.com\",\n \"phone_number\": \"31999999999\",\n \"address\": {\n \"street\": \"Rua da Bahia\",\n \"number\": \"500\",\n \"complement\": \"Apto 101\",\n \"neighborhood\": \"Centro\",\n \"city\": \"Belo Horizonte\",\n \"state\": \"MG\",\n \"zip_code\": \"30111300\"\n }\n },\n \"guarantor\": {\n \"type\": \"CNPJ\",\n \"document\": \"12345678000199\",\n \"name\": \"Empresa Garantidora SA\"\n },\n \"interest\": {\n \"code\": \"PERCENTAGE_PER_MONTH\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"fine\": {\n \"code\": \"PERCENTAGE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"instructions\": [\n \"Não receber após o vencimento\"\n ],\n \"reference_id\": \"REF-2026-001\",\n \"portfolio_number\": 1,\n \"description\": \"Mensalidade junho/2026\",\n \"discounts\": [\n {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n }\n ],\n \"recurrence\": {\n \"model\": \"DUPLICATE\",\n \"type\": \"MONTHLY\",\n \"quantity\": 12,\n \"fixed_day\": 15\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados do boleto inválidos ou incompletos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 1693\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7662a334-c48e-42f6-8abd-c9f03ed89f8e", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "bank-slips" ], "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 \"issue_date\": \"2025-10-31\",\n \"due_date\": \"2025-11-30\",\n \"payment_limit_date\": \"2025-12-31\",\n \"amount\": 10000,\n \"rebate_amount\": 100,\n \"document_number\": \"123456\",\n \"our_number\": \"123456\",\n \"payer\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"78823832012\",\n \"person_type\": \"INDIVIDUAL\",\n \"trade_name\": \"Padaria do João\",\n \"email\": \"joao@email.com\",\n \"phone_number\": \"31999999999\",\n \"address\": {\n \"street\": \"Rua da Bahia\",\n \"number\": \"500\",\n \"complement\": \"Apto 101\",\n \"neighborhood\": \"Centro\",\n \"city\": \"Belo Horizonte\",\n \"state\": \"MG\",\n \"zip_code\": \"30111300\"\n }\n },\n \"guarantor\": {\n \"type\": \"CNPJ\",\n \"document\": \"12345678000199\",\n \"name\": \"Empresa Garantidora SA\"\n },\n \"interest\": {\n \"code\": \"PERCENTAGE_PER_MONTH\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"fine\": {\n \"code\": \"PERCENTAGE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"instructions\": [\n \"Não receber após o vencimento\"\n ],\n \"reference_id\": \"REF-2026-001\",\n \"portfolio_number\": 1,\n \"description\": \"Mensalidade junho/2026\",\n \"discounts\": [\n {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n }\n ],\n \"recurrence\": {\n \"model\": \"DUPLICATE\",\n \"type\": \"MONTHLY\",\n \"quantity\": 12,\n \"fixed_day\": 15\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3932a107-8d58-4afc-aadc-8cc8cd14bad8", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "bank-slips" ], "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 \"issue_date\": \"2025-10-31\",\n \"due_date\": \"2025-11-30\",\n \"payment_limit_date\": \"2025-12-31\",\n \"amount\": 10000,\n \"rebate_amount\": 100,\n \"document_number\": \"123456\",\n \"our_number\": \"123456\",\n \"payer\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"78823832012\",\n \"person_type\": \"INDIVIDUAL\",\n \"trade_name\": \"Padaria do João\",\n \"email\": \"joao@email.com\",\n \"phone_number\": \"31999999999\",\n \"address\": {\n \"street\": \"Rua da Bahia\",\n \"number\": \"500\",\n \"complement\": \"Apto 101\",\n \"neighborhood\": \"Centro\",\n \"city\": \"Belo Horizonte\",\n \"state\": \"MG\",\n \"zip_code\": \"30111300\"\n }\n },\n \"guarantor\": {\n \"type\": \"CNPJ\",\n \"document\": \"12345678000199\",\n \"name\": \"Empresa Garantidora SA\"\n },\n \"interest\": {\n \"code\": \"PERCENTAGE_PER_MONTH\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"fine\": {\n \"code\": \"PERCENTAGE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"instructions\": [\n \"Não receber após o vencimento\"\n ],\n \"reference_id\": \"REF-2026-001\",\n \"portfolio_number\": 1,\n \"description\": \"Mensalidade junho/2026\",\n \"discounts\": [\n {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n }\n ],\n \"recurrence\": {\n \"model\": \"DUPLICATE\",\n \"type\": \"MONTHLY\",\n \"quantity\": 12,\n \"fixed_day\": 15\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "36778d91-4479-43c7-a24f-62f6c5720403", "name": "Falha no registro do boleto na CIP", "originalRequest": { "url": { "path": [ "accounts", "bank-slips" ], "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 \"issue_date\": \"2025-10-31\",\n \"due_date\": \"2025-11-30\",\n \"payment_limit_date\": \"2025-12-31\",\n \"amount\": 10000,\n \"rebate_amount\": 100,\n \"document_number\": \"123456\",\n \"our_number\": \"123456\",\n \"payer\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"78823832012\",\n \"person_type\": \"INDIVIDUAL\",\n \"trade_name\": \"Padaria do João\",\n \"email\": \"joao@email.com\",\n \"phone_number\": \"31999999999\",\n \"address\": {\n \"street\": \"Rua da Bahia\",\n \"number\": \"500\",\n \"complement\": \"Apto 101\",\n \"neighborhood\": \"Centro\",\n \"city\": \"Belo Horizonte\",\n \"state\": \"MG\",\n \"zip_code\": \"30111300\"\n }\n },\n \"guarantor\": {\n \"type\": \"CNPJ\",\n \"document\": \"12345678000199\",\n \"name\": \"Empresa Garantidora SA\"\n },\n \"interest\": {\n \"code\": \"PERCENTAGE_PER_MONTH\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"fine\": {\n \"code\": \"PERCENTAGE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"instructions\": [\n \"Não receber após o vencimento\"\n ],\n \"reference_id\": \"REF-2026-001\",\n \"portfolio_number\": 1,\n \"description\": \"Mensalidade junho/2026\",\n \"discounts\": [\n {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n }\n ],\n \"recurrence\": {\n \"model\": \"DUPLICATE\",\n \"type\": \"MONTHLY\",\n \"quantity\": 12,\n \"fixed_day\": 15\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 422,\n \"code\": \"BANK_SLIP_REGISTRATION_FAILED\",\n \"message\": \"Falha no registro do boleto na CIP\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 829\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5061317d-80c1-4f88-b59f-545367dd8bc9", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "bank-slips" ], "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 \"issue_date\": \"2025-10-31\",\n \"due_date\": \"2025-11-30\",\n \"payment_limit_date\": \"2025-12-31\",\n \"amount\": 10000,\n \"rebate_amount\": 100,\n \"document_number\": \"123456\",\n \"our_number\": \"123456\",\n \"payer\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"78823832012\",\n \"person_type\": \"INDIVIDUAL\",\n \"trade_name\": \"Padaria do João\",\n \"email\": \"joao@email.com\",\n \"phone_number\": \"31999999999\",\n \"address\": {\n \"street\": \"Rua da Bahia\",\n \"number\": \"500\",\n \"complement\": \"Apto 101\",\n \"neighborhood\": \"Centro\",\n \"city\": \"Belo Horizonte\",\n \"state\": \"MG\",\n \"zip_code\": \"30111300\"\n }\n },\n \"guarantor\": {\n \"type\": \"CNPJ\",\n \"document\": \"12345678000199\",\n \"name\": \"Empresa Garantidora SA\"\n },\n \"interest\": {\n \"code\": \"PERCENTAGE_PER_MONTH\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"fine\": {\n \"code\": \"PERCENTAGE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"instructions\": [\n \"Não receber após o vencimento\"\n ],\n \"reference_id\": \"REF-2026-001\",\n \"portfolio_number\": 1,\n \"description\": \"Mensalidade junho/2026\",\n \"discounts\": [\n {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n }\n ],\n \"recurrence\": {\n \"model\": \"DUPLICATE\",\n \"type\": \"MONTHLY\",\n \"quantity\": 12,\n \"fixed_day\": 15\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0a36b087-6640-41c8-885c-e00fe0486ab0", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "bank-slips" ], "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 \"issue_date\": \"2025-10-31\",\n \"due_date\": \"2025-11-30\",\n \"payment_limit_date\": \"2025-12-31\",\n \"amount\": 10000,\n \"rebate_amount\": 100,\n \"document_number\": \"123456\",\n \"our_number\": \"123456\",\n \"payer\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"78823832012\",\n \"person_type\": \"INDIVIDUAL\",\n \"trade_name\": \"Padaria do João\",\n \"email\": \"joao@email.com\",\n \"phone_number\": \"31999999999\",\n \"address\": {\n \"street\": \"Rua da Bahia\",\n \"number\": \"500\",\n \"complement\": \"Apto 101\",\n \"neighborhood\": \"Centro\",\n \"city\": \"Belo Horizonte\",\n \"state\": \"MG\",\n \"zip_code\": \"30111300\"\n }\n },\n \"guarantor\": {\n \"type\": \"CNPJ\",\n \"document\": \"12345678000199\",\n \"name\": \"Empresa Garantidora SA\"\n },\n \"interest\": {\n \"code\": \"PERCENTAGE_PER_MONTH\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"fine\": {\n \"code\": \"PERCENTAGE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"instructions\": [\n \"Não receber após o vencimento\"\n ],\n \"reference_id\": \"REF-2026-001\",\n \"portfolio_number\": 1,\n \"description\": \"Mensalidade junho/2026\",\n \"discounts\": [\n {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n }\n ],\n \"recurrence\": {\n \"model\": \"DUPLICATE\",\n \"type\": \"MONTHLY\",\n \"quantity\": 12,\n \"fixed_day\": 15\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "71ef8486-7c52-40a9-9cc4-9e4bf2a2cbcc", "name": "Consultar boletos", "request": { "name": "Consultar boletos", "description": { "content": "Retorna a lista de boletos registrados pela conta, ordenada do mais recente para o mais antigo. Todos os filtros são opcionais e combináveis.\n\n**Filtros disponíveis:**\n- `status`: situação do boleto (REGISTERED, PAID, CANCELLED, ...).\n- `portfolio`: número da carteira do cedente.\n- `from_date` / `to_date`: período de **registro** no sistema (`created_at`).\n- `from_issue_date` / `to_issue_date`: período de **emissão** declarado no boleto (`issue_date`).\n- `from_due_date` / `to_due_date`: período de **vencimento** (`due_date`).\n\nDatas no formato `yyyy-MM-dd`.\n\n**Paginação por cursor:** informe `limit` (tamanho da página) e, para avançar, o `cursor` retornado em `page_info.next_cursor` da resposta anterior. Enquanto houver mais páginas, `page_info.has_next_page` é `true`.", "type": "text/plain" }, "url": { "path": [ "accounts", "bank-slips" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "limit", "value": "20", "description": "Quantidade de itens por página (paginação por cursor). 1–100, default 10." }, { "disabled": false, "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=", "description": "Cursor da próxima página. Use exatamente o valor retornado em `page_info.next_cursor` da resposta anterior — é um token **opaco** (não construa nem interprete). Omita na primeira página." }, { "disabled": false, "key": "status", "value": "REGISTERED", "description": "Situação do boleto registrado" }, { "disabled": false, "key": "portfolio", "value": "9", "description": "Número da carteira. 1: Simples, 9: CNAB" }, { "disabled": false, "key": "from_date", "value": "2023-01-01", "description": "Data de registro inicial (quando o boleto foi registrado no sistema)" }, { "disabled": false, "key": "to_date", "value": "2023-01-31", "description": "Data de registro final (quando o boleto foi registrado no sistema)" }, { "disabled": false, "key": "from_issue_date", "value": "2023-01-01", "description": "Data de emissão inicial (issue_date declarada no boleto)" }, { "disabled": false, "key": "to_issue_date", "value": "2023-01-31", "description": "Data de emissão final (issue_date declarada no boleto)" }, { "disabled": false, "key": "from_due_date", "value": "2023-01-01", "description": "Data de vencimento inicial" }, { "disabled": false, "key": "to_due_date", "value": "2023-01-31", "description": "Data de vencimento final" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "be9ea068-f7b9-4b69-ad9b-4f9b8da15531", "name": "Lista de boletos retornada com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "bank-slips" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "20" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "status", "value": "REGISTERED" }, { "key": "portfolio", "value": "9" }, { "key": "from_date", "value": "2023-01-01" }, { "key": "to_date", "value": "2023-01-31" }, { "key": "from_issue_date", "value": "2023-01-01" }, { "key": "to_issue_date", "value": "2023-01-31" }, { "key": "from_due_date", "value": "2023-01-01" }, { "key": "to_due_date", "value": "2023-01-31" } ], "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 \"payer\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"78823832012\",\n \"person_type\": \"INDIVIDUAL\",\n \"trade_name\": \"Padaria do João\",\n \"email\": \"joao@email.com\",\n \"phone_number\": \"31999999999\",\n \"address\": {\n \"street\": \"Rua da Bahia\",\n \"number\": \"500\",\n \"complement\": \"Apto 101\",\n \"neighborhood\": \"Centro\",\n \"city\": \"Belo Horizonte\",\n \"state\": \"MG\",\n \"zip_code\": \"30111300\"\n }\n },\n \"id\": \"1234567890\",\n \"pdf_url\": \"https://api.meioo.com.br/accounts/bank-slips/01KSK.../pdf\",\n \"registration_code\": {},\n \"issuer_number\": {},\n \"issuer_code\": {},\n \"issue_date\": {},\n \"due_date\": {},\n \"payment_limit_date\": {},\n \"our_number\": {},\n \"document_number\": {},\n \"barcode\": {},\n \"digitable_line\": {},\n \"amount\": {},\n \"rebate_amount\": {},\n \"status\": \"REGISTERED\",\n \"portfolio_number\": {},\n \"payment_date\": {},\n \"payment_amount\": {},\n \"credit_date\": {},\n \"credit_amount\": {},\n \"interest\": {\n \"code\": \"123\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"fine\": {\n \"code\": \"123\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"discounts\": [\n {\n \"code\": \"123\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n {\n \"code\": \"123\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n }\n ],\n \"instructions\": [\n \"Após o vencimento cobrar multa de 2%.\",\n \"Pagar preferencialmente na Meioo.\"\n ],\n \"guarantor\": {\n \"type\": \"CPF\",\n \"document\": \"78823832012\",\n \"name\": \"João da Silva\"\n },\n \"registration_date\": {},\n \"title_species\": {},\n \"payment_blocked\": {},\n \"is_hybrid\": {},\n \"pix_emv\": {},\n \"pix_qr_code\": {}\n },\n {\n \"payer\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"78823832012\",\n \"person_type\": \"INDIVIDUAL\",\n \"trade_name\": \"Padaria do João\",\n \"email\": \"joao@email.com\",\n \"phone_number\": \"31999999999\",\n \"address\": {\n \"street\": \"Rua da Bahia\",\n \"number\": \"500\",\n \"complement\": \"Apto 101\",\n \"neighborhood\": \"Centro\",\n \"city\": \"Belo Horizonte\",\n \"state\": \"MG\",\n \"zip_code\": \"30111300\"\n }\n },\n \"id\": \"1234567890\",\n \"pdf_url\": \"https://api.meioo.com.br/accounts/bank-slips/01KSK.../pdf\",\n \"registration_code\": {},\n \"issuer_number\": {},\n \"issuer_code\": {},\n \"issue_date\": {},\n \"due_date\": {},\n \"payment_limit_date\": {},\n \"our_number\": {},\n \"document_number\": {},\n \"barcode\": {},\n \"digitable_line\": {},\n \"amount\": {},\n \"rebate_amount\": {},\n \"status\": \"REGISTERED\",\n \"portfolio_number\": {},\n \"payment_date\": {},\n \"payment_amount\": {},\n \"credit_date\": {},\n \"credit_amount\": {},\n \"interest\": {\n \"code\": \"123\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"fine\": {\n \"code\": \"123\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"discounts\": [\n {\n \"code\": \"123\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n {\n \"code\": \"123\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n }\n ],\n \"instructions\": [\n \"Após o vencimento cobrar multa de 2%.\",\n \"Pagar preferencialmente na Meioo.\"\n ],\n \"guarantor\": {\n \"type\": \"CPF\",\n \"document\": \"78823832012\",\n \"name\": \"João da Silva\"\n },\n \"registration_date\": {},\n \"title_species\": {},\n \"payment_blocked\": {},\n \"is_hybrid\": {},\n \"pix_emv\": {},\n \"pix_qr_code\": {}\n }\n ],\n \"page_info\": {\n \"next_cursor\": {},\n \"has_next_page\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "02c7e49a-9b45-4888-abc1-d4a0e5b00507", "name": "Parâmetros de filtro ausentes ou inválidos", "originalRequest": { "url": { "path": [ "accounts", "bank-slips" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "20" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "status", "value": "REGISTERED" }, { "key": "portfolio", "value": "9" }, { "key": "from_date", "value": "2023-01-01" }, { "key": "to_date", "value": "2023-01-31" }, { "key": "from_issue_date", "value": "2023-01-01" }, { "key": "to_issue_date", "value": "2023-01-31" }, { "key": "from_due_date", "value": "2023-01-01" }, { "key": "to_due_date", "value": "2023-01-31" } ], "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 \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Parâmetros de filtro ausentes ou inválidos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "11c81dcf-c53d-41ab-b16e-07c8c40feb5d", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "bank-slips" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "20" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "status", "value": "REGISTERED" }, { "key": "portfolio", "value": "9" }, { "key": "from_date", "value": "2023-01-01" }, { "key": "to_date", "value": "2023-01-31" }, { "key": "from_issue_date", "value": "2023-01-01" }, { "key": "to_issue_date", "value": "2023-01-31" }, { "key": "from_due_date", "value": "2023-01-01" }, { "key": "to_due_date", "value": "2023-01-31" } ], "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 \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d486c44c-9d38-4010-aa36-af807858e384", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "bank-slips" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "20" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "status", "value": "REGISTERED" }, { "key": "portfolio", "value": "9" }, { "key": "from_date", "value": "2023-01-01" }, { "key": "to_date", "value": "2023-01-31" }, { "key": "from_issue_date", "value": "2023-01-01" }, { "key": "to_issue_date", "value": "2023-01-31" }, { "key": "from_due_date", "value": "2023-01-01" }, { "key": "to_due_date", "value": "2023-01-31" } ], "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 \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4d9f5333-0ca7-461e-835d-9c99e5e07c86", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "bank-slips" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "20" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "status", "value": "REGISTERED" }, { "key": "portfolio", "value": "9" }, { "key": "from_date", "value": "2023-01-01" }, { "key": "to_date", "value": "2023-01-31" }, { "key": "from_issue_date", "value": "2023-01-01" }, { "key": "to_issue_date", "value": "2023-01-31" }, { "key": "from_due_date", "value": "2023-01-01" }, { "key": "to_due_date", "value": "2023-01-31" } ], "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "36320e78-2866-4cbc-a877-6c616c8b7df3", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "bank-slips" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "20" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "status", "value": "REGISTERED" }, { "key": "portfolio", "value": "9" }, { "key": "from_date", "value": "2023-01-01" }, { "key": "to_date", "value": "2023-01-31" }, { "key": "from_issue_date", "value": "2023-01-01" }, { "key": "to_issue_date", "value": "2023-01-31" }, { "key": "from_due_date", "value": "2023-01-01" }, { "key": "to_due_date", "value": "2023-01-31" } ], "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "55d5de1b-aedd-42e0-922f-5a04817bd5f9", "name": "Consultar boleto por ID", "request": { "name": "Consultar boleto por ID", "description": { "content": "Retorna os dados completos de um boleto registrado a partir do seu ID interno. Inclui status atual, dados de pagamento (quando aplicável) e informações do sacado.", "type": "text/plain" }, "url": { "path": [ "accounts", "bank-slips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "a1513742-f835-41ab-9017-6345b660e3a7", "name": "Dados do boleto retornados com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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 \"payer\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"78823832012\",\n \"person_type\": \"INDIVIDUAL\",\n \"trade_name\": \"Padaria do João\",\n \"email\": \"joao@email.com\",\n \"phone_number\": \"31999999999\",\n \"address\": {\n \"street\": \"Rua da Bahia\",\n \"number\": \"500\",\n \"complement\": \"Apto 101\",\n \"neighborhood\": \"Centro\",\n \"city\": \"Belo Horizonte\",\n \"state\": \"MG\",\n \"zip_code\": \"30111300\"\n }\n },\n \"id\": \"1234567890\",\n \"pdf_url\": \"https://api.meioo.com.br/accounts/bank-slips/01KSK.../pdf\",\n \"registration_code\": {},\n \"issuer_number\": {},\n \"issuer_code\": {},\n \"issue_date\": {},\n \"due_date\": {},\n \"payment_limit_date\": {},\n \"our_number\": {},\n \"document_number\": {},\n \"barcode\": {},\n \"digitable_line\": {},\n \"amount\": {},\n \"rebate_amount\": {},\n \"status\": \"REGISTERED\",\n \"portfolio_number\": {},\n \"payment_date\": {},\n \"payment_amount\": {},\n \"credit_date\": {},\n \"credit_amount\": {},\n \"interest\": {\n \"code\": \"123\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"fine\": {\n \"code\": \"123\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"discounts\": [\n {\n \"code\": \"123\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n {\n \"code\": \"123\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n }\n ],\n \"instructions\": [\n \"Após o vencimento cobrar multa de 2%.\",\n \"Pagar preferencialmente na Meioo.\"\n ],\n \"guarantor\": {\n \"type\": \"CPF\",\n \"document\": \"78823832012\",\n \"name\": \"João da Silva\"\n },\n \"registration_date\": {},\n \"title_species\": {},\n \"payment_blocked\": {},\n \"is_hybrid\": {},\n \"pix_emv\": {},\n \"pix_qr_code\": {}\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "71fbc2c6-1af4-41de-917f-51ab9eb503f4", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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 \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "46a36ed9-e445-4a5a-83a8-628af8fd76f3", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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 \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f8ddd442-db09-4e4c-92b4-67c660bf9bea", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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 \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "187a852d-7939-417c-98d3-5ea62ef05ffd", "name": "Boleto não encontrado ou não pertence à conta", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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 \"status_code\": 404,\n \"code\": \"BANK_SLIP_NOT_FOUND\",\n \"message\": \"Boleto não encontrado ou não pertence à conta\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 7793,\n \"key_1\": 1239\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d8e524d5-90d6-41d1-9606-4af6f2d3bcad", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a123e0c3-2439-4b6a-8981-9739456f57c7", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "dcad3956-ce57-446d-bd36-aeb31a5f7255", "name": "Cancelar boleto registrado", "request": { "name": "Cancelar boleto registrado", "description": { "content": "Cancela um boleto registrado, tornando-o inválido para pagamento. O cancelamento é propagado para a CIP.\n\n**Regras:**\n• Somente boletos com status `REGISTERED` ou `PENDING` podem ser cancelados\n• Boletos já pagos não podem ser cancelados — utilize o reembolso\n• O cancelamento é irreversível", "type": "text/plain" }, "url": { "path": [ "accounts", "bank-slips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto a ser cancelado" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "48ca0775-bfe3-4715-8048-3b3480faa686", "name": "Boleto cancelado com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto a ser cancelado" } ] }, "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": "4db1be3f-a913-453d-9a48-ea543cf522a1", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto a ser cancelado" } ] }, "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": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6ac5ac5a-8154-4f1a-a6f8-a84c47a1fc0c", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto a ser cancelado" } ] }, "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 \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6d22576f-7875-4aca-87de-682aafb84ac6", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto a ser cancelado" } ] }, "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": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a1f61cac-af9b-4505-bae5-32919987d976", "name": "Boleto não encontrado ou não pertence à conta", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto a ser cancelado" } ] }, "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 \"status_code\": 404,\n \"code\": \"BANK_SLIP_NOT_FOUND\",\n \"message\": \"Boleto não encontrado ou não pertence à conta\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 7793,\n \"key_1\": 1239\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a8dcb9a0-3ce1-4836-90f1-a8fe3c205afb", "name": "Boleto no estado atual não permite cancelamento", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto a ser cancelado" } ] }, "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": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 422,\n \"code\": \"BANK_SLIP_CANCELLATION_NOT_ALLOWED\",\n \"message\": \"Boleto no estado atual não permite cancelamento\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ec2f4927-ab29-44f0-a504-78c4fef5c9ca", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto a ser cancelado" } ] }, "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "01f042f2-e444-4b9c-a3d0-523a2dc85fe1", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto a ser cancelado" } ] }, "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "30ac5c21-59f4-495f-8f59-28d34234a5a8", "name": "Gerar PDF de boleto", "request": { "name": "Gerar PDF de boleto", "description": { "content": "Gera e retorna o PDF do boleto registrado, pronto para impressão ou envio ao pagador. O arquivo segue o layout padrão FEBRABAN.\n\n**Content-Type da resposta:** `application/pdf`\n\n**Disponibilidade:** O PDF fica disponível após o registro bem-sucedido do boleto.", "type": "text/plain" }, "url": { "path": [ "accounts", "bank-slips", ":id", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "header": [ { "key": "Accept", "value": "application/pdf" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "8d0e165c-c8f9-4142-85e0-aaa223aad6d2", "name": "PDF do boleto gerado com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/pdf" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/pdf" } ], "body": "string", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "9d10cf86-ef76-492f-bbee-56515b34880d", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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 \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ea96b8e9-d2ae-41a9-a4f1-f12519ebe857", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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 \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bd3e48fe-d4bb-41bc-a9d4-6eada8189016", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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 \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "06c2ecea-ef90-4a9a-8890-60faa2485d41", "name": "Boleto não encontrado ou não pertence à conta", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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 \"status_code\": 404,\n \"code\": \"BANK_SLIP_NOT_FOUND\",\n \"message\": \"Boleto não encontrado ou não pertence à conta\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 7793,\n \"key_1\": 1239\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b3886db8-a5e7-45d1-952a-41634bbbdc72", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a564e89f-6ed6-4f13-8c6d-f01c734c153b", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "87033843-b8ce-4887-a0be-c3a1f1a601df", "name": "Gerar link público para PDF do boleto", "request": { "name": "Gerar link público para PDF do boleto", "description": { "content": "Gera uma URL pública e temporária para acesso ao PDF do boleto sem autenticação. Ideal para enviar ao pagador por e-mail, SMS ou WhatsApp.\n\n**Segurança:**\n• O link é um token opaco (UUID) sem informações sensíveis\n• Expira automaticamente\n• Boletos cancelados retornam 404 mesmo com link válido\n\n**Múltiplos links:** Cada chamada gera um novo link independente. Links anteriores permanecem válidos até expirar.", "type": "text/plain" }, "url": { "path": [ "accounts", "bank-slips", ":id", "pdf", "link" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "222857a7-8eed-481a-865d-bf9304da4e05", "name": "Link público gerado com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id", "pdf", "link" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"url\": \"https://api.meioo.com.br/public/bank-slips/pdf/b44617f4-cf27-470e-8555-bcb68bbe9fd1\",\n \"expires_at\": \"2026-06-03T15:30:00-03:00\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ba10fe17-2a04-4eb0-9b53-19510caff9d0", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id", "pdf", "link" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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 Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "36a36ddd-257d-408c-801c-f9373fbdb79d", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id", "pdf", "link" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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 \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "23af95c8-5a55-4bf9-a9eb-1acbdcd26462", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id", "pdf", "link" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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 \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c83e76ae-4eb1-492f-8277-162e76ef8a1f", "name": "Boleto não encontrado ou não pertence à conta", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id", "pdf", "link" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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 \"status_code\": 404,\n \"code\": \"BANK_SLIP_NOT_FOUND\",\n \"message\": \"Boleto não encontrado ou não pertence à conta\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 7793,\n \"key_1\": 1239\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ac88a898-8042-4afd-9b4f-e09fe93bff8f", "name": "Boleto cancelado, link não pode ser gerado", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id", "pdf", "link" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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 \"status_code\": 409,\n \"code\": \"BANK_SLIP_CANCELLED\",\n \"message\": \"Boleto cancelado, link não pode ser gerado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "68c75e53-68cd-47ae-990b-aa321ab4e68f", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id", "pdf", "link" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2b39822d-7048-4f15-a66f-e37bb1cf9aee", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id", "pdf", "link" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "435ea122-0e69-4fca-bf9a-bc6904f72fda", "name": "Cadastrar cedente", "request": { "name": "Cadastrar cedente", "description": { "content": "Cadastra a conta como cedente de boletos bancários junto ao provider. O cadastro é pré-requisito para emissão de boletos próprios.\n\n**Regras:**\n• Cada conta pode ter apenas um cedente\n• O cedente é ativado automaticamente após confirmação do provider\n• Requer papel de MASTER na conta", "type": "text/plain" }, "url": { "path": [ "accounts", "bank-slips", "issuers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "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 \"portfolio_type\": \"SIMPLE\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "533a350b-7a6b-462b-9335-87630f650db6", "name": "Cedente cadastrado e ativado com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"portfolio_type\": \"SIMPLE\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"01JZWY347BXD9X4F294HTPX1VE\",\n \"issuer_number\": \"123456789\",\n \"status\": \"ACTIVE\",\n \"activated_at\": \"2026-05-26T14:30:00-03:00\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ccf1ee77-344f-48e4-8827-8b222e123793", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"portfolio_type\": \"SIMPLE\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "84782a3a-f9d3-46c0-86ed-1a981672378e", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"portfolio_type\": \"SIMPLE\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "97085b4e-64e6-4d0a-9fda-5c024d0d06ac", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"portfolio_type\": \"SIMPLE\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "747255e0-ecd9-4c7c-8b04-565297176762", "name": "Conta já possui cedente cadastrado", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"portfolio_type\": \"SIMPLE\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 409,\n \"code\": \"ISSUER_ALREADY_EXISTS\",\n \"message\": \"Conta já possui cedente cadastrado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5df3e7d0-aa0c-4ace-920a-abd8f0148ae0", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"portfolio_type\": \"SIMPLE\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2544582b-25b0-46d9-ac95-ee9fab0f466b", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"portfolio_type\": \"SIMPLE\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e916e9f8-6c2d-4842-8b52-0261dcf1c6b7", "name": "Consultar cedente", "request": { "name": "Consultar cedente", "description": { "content": "Retorna os dados do cedente da conta, incluindo número do cedente e status.", "type": "text/plain" }, "url": { "path": [ "accounts", "bank-slips", "issuers", "current" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "bfbc7470-baac-4b87-8ec0-793366fffb9f", "name": "Dados do cedente retornados com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current" ], "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 \"id\": \"01JZWY347BXD9X4F294HTPX1VE\",\n \"issuer_number\": \"123456789\",\n \"status\": \"ACTIVE\",\n \"created_at\": \"2026-05-26T14:00:00-03:00\",\n \"portfolios\": [\n {\n \"id\": \"01JZWY347BXD9X4F294HTPX1VE\",\n \"portfolio_number\": 17,\n \"portfolio_type\": \"SIMPLE\",\n \"status\": \"ACTIVE\",\n \"title_species\": 99,\n \"interest_code\": \"FIXED_PER_DAY\",\n \"interest_value\": 100,\n \"fine_code\": \"PERCENTAGE\",\n \"fine_value\": 200,\n \"discount_code\": \"EXEMPT\",\n \"payment_type\": \"DUE_DATE\",\n \"our_number_origin\": \"PROVIDER\",\n \"payment_limit_days\": 30,\n \"is_hybrid\": true,\n \"cnab_enabled\": false,\n \"cnab_company_code\": \"00012345\"\n },\n {\n \"id\": \"01JZWY347BXD9X4F294HTPX1VE\",\n \"portfolio_number\": 17,\n \"portfolio_type\": \"SIMPLE\",\n \"status\": \"ACTIVE\",\n \"title_species\": 99,\n \"interest_code\": \"FIXED_PER_DAY\",\n \"interest_value\": 100,\n \"fine_code\": \"PERCENTAGE\",\n \"fine_value\": 200,\n \"discount_code\": \"EXEMPT\",\n \"payment_type\": \"DUE_DATE\",\n \"our_number_origin\": \"PROVIDER\",\n \"payment_limit_days\": 30,\n \"is_hybrid\": true,\n \"cnab_enabled\": false,\n \"cnab_company_code\": \"00012345\"\n }\n ],\n \"activated_at\": \"2026-05-26T14:30:00-03:00\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2d57f0ab-be9b-4c33-95af-17f9da8c4c6d", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current" ], "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": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "58944461-a3a5-4901-8918-2b320dc58f55", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current" ], "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 \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a7d1fea0-0fe7-4eaa-a55d-3af65451d46f", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current" ], "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 \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7077a72a-f877-4e7a-b2de-49355c5e7e02", "name": "Conta não possui cedente cadastrado", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current" ], "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 \"status_code\": 404,\n \"code\": \"ISSUER_NOT_FOUND\",\n \"message\": \"Conta não possui cedente cadastrado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 2989,\n \"key_1\": 4172.696148583239,\n \"key_2\": \"string\",\n \"key_3\": 9518.274140774618,\n \"key_4\": 8086\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a471f2e4-4315-4dbf-8bdf-cafcdc230d19", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current" ], "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6b4d6e92-d9e9-46c1-a9ec-e89cd96eb204", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current" ], "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "d13a3192-8f7f-4561-aa94-01dcaa532bc9", "name": "Desativar cedente", "request": { "name": "Desativar cedente", "description": { "content": "Desativa o cedente da conta, impedindo a emissão de novos boletos. Boletos já emitidos permanecem válidos.\n\n**Regras:**\n• Somente cedentes com status ACTIVE podem ser desativados\n• A desativação é irreversível — para reativar, entre em contato com o suporte\n• Requer papel de MASTER na conta", "type": "text/plain" }, "url": { "path": [ "accounts", "bank-slips", "issuers", "current", "deactivate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "28c7faa4-b44f-45ea-bf84-2d91d9880d08", "name": "Cedente desativado com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current", "deactivate" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"01JZWY347BXD9X4F294HTPX1VE\",\n \"status\": \"INACTIVE\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b6ec4210-5d12-4ffe-9fb9-67e1f90e7189", "name": "Cedente não está ativo para desativação", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current", "deactivate" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"ISSUER_NOT_ACTIVE\",\n \"message\": \"Cedente não está ativo para desativação\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 6847.466873154877\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "535431a3-301b-41c7-a5b0-2cc689c2dc6b", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current", "deactivate" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6534d368-0298-43cc-8f4c-f6335535f358", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current", "deactivate" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b5026c21-9347-4956-916d-df8f059d376e", "name": "Conta não possui cedente cadastrado", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current", "deactivate" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 404,\n \"code\": \"ISSUER_NOT_FOUND\",\n \"message\": \"Conta não possui cedente cadastrado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 2989,\n \"key_1\": 4172.696148583239,\n \"key_2\": \"string\",\n \"key_3\": 9518.274140774618,\n \"key_4\": 8086\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f26c77fb-916e-4698-90a4-5e5858354499", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current", "deactivate" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6136de0f-99b0-4f60-8007-2f5c936cbab3", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current", "deactivate" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "7d783627-6c4e-47e1-885c-0414c3fee025", "name": "Vincular carteira ao cedente", "request": { "name": "Vincular carteira ao cedente", "description": { "content": "Vincula uma nova carteira de cobrança ao cedente da conta. A carteira define as regras padrão para emissão de boletos (juros, multa, desconto, espécie, etc.).\n\n**Configurações da carteira:**\n• Tipo da carteira (simples, vinculada, caucionada, descontada, vendor)\n• Espécie do documento (duplicata mercantil, duplicata de serviço, etc.)\n• Regras de juros, multa e desconto\n• Dias limite para pagamento após vencimento\n• Cobrança híbrida (boleto + Pix)\n• CNAB para remessa/retorno\n\n**Pré-requisito:** Cedente deve estar com status ACTIVE.\n\n**Permissão:** Requer papel de MASTER na conta.", "type": "text/plain" }, "url": { "path": [ "accounts", "bank-slips", "issuers", "current", "portfolios" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "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 \"portfolio_type\": \"SIMPLE\",\n \"document_species\": 2,\n \"payment_type\": \"DUE_DATE\",\n \"our_number_origin\": \"PROVIDER\",\n \"interest_code\": \"FIXED_PER_DAY\",\n \"interest_value\": 100,\n \"fine_code\": \"PERCENTAGE\",\n \"fine_value\": 200,\n \"discount_code\": \"EXEMPT\",\n \"payment_limit_days\": 30,\n \"cnab_enabled\": false,\n \"hybrid\": true\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "7e331b69-3131-43fc-8c25-4caa5ed07cfe", "name": "Carteira vinculada com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current", "portfolios" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"portfolio_type\": \"SIMPLE\",\n \"document_species\": 2,\n \"payment_type\": \"DUE_DATE\",\n \"our_number_origin\": \"PROVIDER\",\n \"interest_code\": \"FIXED_PER_DAY\",\n \"interest_value\": 100,\n \"fine_code\": \"PERCENTAGE\",\n \"fine_value\": 200,\n \"discount_code\": \"EXEMPT\",\n \"payment_limit_days\": 30,\n \"cnab_enabled\": false,\n \"hybrid\": true\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"01JZWY347BXD9X4F294HTPX1VE\",\n \"portfolio_number\": 17,\n \"portfolio_type\": \"SIMPLE\",\n \"cnab_company_code\": \"00012345\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e07ef23a-404d-4267-9b44-18029d100578", "name": "Cedente não está ativo para vincular carteira", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current", "portfolios" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"portfolio_type\": \"SIMPLE\",\n \"document_species\": 2,\n \"payment_type\": \"DUE_DATE\",\n \"our_number_origin\": \"PROVIDER\",\n \"interest_code\": \"FIXED_PER_DAY\",\n \"interest_value\": 100,\n \"fine_code\": \"PERCENTAGE\",\n \"fine_value\": 200,\n \"discount_code\": \"EXEMPT\",\n \"payment_limit_days\": 30,\n \"cnab_enabled\": false,\n \"hybrid\": true\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"ISSUER_NOT_ACTIVE\",\n \"message\": \"Cedente não está ativo para vincular carteira\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 8134,\n \"key_1\": 4548\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7f2f22cc-e9c5-435a-a739-d349a3960b60", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current", "portfolios" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"portfolio_type\": \"SIMPLE\",\n \"document_species\": 2,\n \"payment_type\": \"DUE_DATE\",\n \"our_number_origin\": \"PROVIDER\",\n \"interest_code\": \"FIXED_PER_DAY\",\n \"interest_value\": 100,\n \"fine_code\": \"PERCENTAGE\",\n \"fine_value\": 200,\n \"discount_code\": \"EXEMPT\",\n \"payment_limit_days\": 30,\n \"cnab_enabled\": false,\n \"hybrid\": true\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "841603aa-0047-4470-89e7-d51cc8f0b2e6", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current", "portfolios" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"portfolio_type\": \"SIMPLE\",\n \"document_species\": 2,\n \"payment_type\": \"DUE_DATE\",\n \"our_number_origin\": \"PROVIDER\",\n \"interest_code\": \"FIXED_PER_DAY\",\n \"interest_value\": 100,\n \"fine_code\": \"PERCENTAGE\",\n \"fine_value\": 200,\n \"discount_code\": \"EXEMPT\",\n \"payment_limit_days\": 30,\n \"cnab_enabled\": false,\n \"hybrid\": true\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3332fea4-3a86-446f-8700-17497c88d77c", "name": "Conta não possui cedente cadastrado", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current", "portfolios" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"portfolio_type\": \"SIMPLE\",\n \"document_species\": 2,\n \"payment_type\": \"DUE_DATE\",\n \"our_number_origin\": \"PROVIDER\",\n \"interest_code\": \"FIXED_PER_DAY\",\n \"interest_value\": 100,\n \"fine_code\": \"PERCENTAGE\",\n \"fine_value\": 200,\n \"discount_code\": \"EXEMPT\",\n \"payment_limit_days\": 30,\n \"cnab_enabled\": false,\n \"hybrid\": true\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 404,\n \"code\": \"ISSUER_NOT_FOUND\",\n \"message\": \"Conta não possui cedente cadastrado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 2989,\n \"key_1\": 4172.696148583239,\n \"key_2\": \"string\",\n \"key_3\": 9518.274140774618,\n \"key_4\": 8086\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f3c0fbed-77dd-4072-ad2b-d05c2bd0ed27", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current", "portfolios" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"portfolio_type\": \"SIMPLE\",\n \"document_species\": 2,\n \"payment_type\": \"DUE_DATE\",\n \"our_number_origin\": \"PROVIDER\",\n \"interest_code\": \"FIXED_PER_DAY\",\n \"interest_value\": 100,\n \"fine_code\": \"PERCENTAGE\",\n \"fine_value\": 200,\n \"discount_code\": \"EXEMPT\",\n \"payment_limit_days\": 30,\n \"cnab_enabled\": false,\n \"hybrid\": true\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1b4c49ed-74e2-48ce-80ea-a4ea2891ad24", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current", "portfolios" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"portfolio_type\": \"SIMPLE\",\n \"document_species\": 2,\n \"payment_type\": \"DUE_DATE\",\n \"our_number_origin\": \"PROVIDER\",\n \"interest_code\": \"FIXED_PER_DAY\",\n \"interest_value\": 100,\n \"fine_code\": \"PERCENTAGE\",\n \"fine_value\": 200,\n \"discount_code\": \"EXEMPT\",\n \"payment_limit_days\": 30,\n \"cnab_enabled\": false,\n \"hybrid\": true\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "6c379c77-9821-4109-9875-fef6dda4afb9", "name": "Aprovações", "description": { "content": "Aprovação, rejeição e listagem de transações pendentes", "type": "text/plain" }, "item": [ { "id": "08f42684-14ef-47c5-bacf-22a03757216a", "name": "Listar transações pendentes de aprovação", "request": { "name": "Listar transações pendentes de aprovação", "description": { "content": "Retorna transações com status AWAITING_APPROVAL da conta. Paginação por cursor, ordenado por data de criação (mais antigas primeiro — transações próximas da expiração aparecem no topo). Filtro opcional por tipo de transação.", "type": "text/plain" }, "url": { "path": [ "accounts", "approvals", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "limit", "value": "20", "description": "Quantidade de itens por página (paginação por cursor). 1–100, default 10." }, { "disabled": false, "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=", "description": "Cursor da próxima página. Use exatamente o valor retornado em `page_info.next_cursor` da resposta anterior — é um token **opaco** (não construa nem interprete). Omita na primeira página." }, { "disabled": false, "key": "type", "value": "PIX", "description": "Filtrar por tipo" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "e256eee6-65f1-457f-80be-435ed7032282", "name": "Lista de transações pendentes com paginação", "originalRequest": { "url": { "path": [ "accounts", "approvals", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "20" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "type", "value": "PIX" } ], "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\": \"01JZWY347BXD9X4F294HTPX1VE\",\n \"type\": \"PIX\",\n \"direction\": \"DEBIT\",\n \"amount\": 50000,\n \"fee_amount\": 100,\n \"status\": \"AWAITING_APPROVAL\",\n \"created_at\": \"2026-05-21T14:00:00-03:00\",\n \"expires_at\": \"2026-05-22T14:00:00-03:00\",\n \"expires_in_seconds\": 82800,\n \"requested_by\": \"string\",\n \"requested_by_name\": \"João Pereira\",\n \"counterparty_name\": \"string\",\n \"counterparty_document\": \"string\",\n \"counterparty_unresolved\": false,\n \"initiation_type\": \"QR_STATIC\",\n \"operation_description\": \"string\",\n \"description\": \"string\",\n \"reference_id\": \"string\"\n },\n {\n \"id\": \"01JZWY347BXD9X4F294HTPX1VE\",\n \"type\": \"PIX\",\n \"direction\": \"DEBIT\",\n \"amount\": 50000,\n \"fee_amount\": 100,\n \"status\": \"AWAITING_APPROVAL\",\n \"created_at\": \"2026-05-21T14:00:00-03:00\",\n \"expires_at\": \"2026-05-22T14:00:00-03:00\",\n \"expires_in_seconds\": 82800,\n \"requested_by\": \"string\",\n \"requested_by_name\": \"João Pereira\",\n \"counterparty_name\": \"string\",\n \"counterparty_document\": \"string\",\n \"counterparty_unresolved\": false,\n \"initiation_type\": \"QR_STATIC\",\n \"operation_description\": \"string\",\n \"description\": \"string\",\n \"reference_id\": \"string\"\n }\n ],\n \"page_info\": {\n \"next_cursor\": {},\n \"has_next_page\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6fb0a350-2e29-4da8-9037-226f34b061aa", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "approvals", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "20" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "type", "value": "PIX" } ], "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 \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "04af4619-1de4-405b-9111-9d17ca09de98", "name": "Token inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "approvals", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "20" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "type", "value": "PIX" } ], "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 \"status_code\": 401,\n \"code\": \"INVALID_CREDENTIALS\",\n \"message\": \"Token inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 1532,\n \"key_1\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "76a25a93-154f-4597-9d3d-8b26004cb1c1", "name": "Acesso negado - permissões insuficientes para este recurso", "originalRequest": { "url": { "path": [ "accounts", "approvals", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "20" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "type", "value": "PIX" } ], "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 \"status_code\": 403,\n \"code\": \"ACCESS_DENIED\",\n \"message\": \"Acesso negado - permissões insuficientes para este recurso\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 8207.703686566874\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "356f24f3-3114-4cbf-bf49-069e9864450d", "name": "Entidade não pode ser processada - verifique os dados", "originalRequest": { "url": { "path": [ "accounts", "approvals", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "20" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "type", "value": "PIX" } ], "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 \"status_code\": 422,\n \"code\": \"UNPROCESSABLE_ENTITY\",\n \"message\": \"Entidade não pode ser processada - verifique os dados\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true,\n \"key_2\": \"string\",\n \"key_3\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3b22328c-8afa-43be-b89c-050fb3fb1d37", "name": "Limite de requisições excedido - tente novamente em alguns minutos", "originalRequest": { "url": { "path": [ "accounts", "approvals", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "20" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "type", "value": "PIX" } ], "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Limite de requisições excedido - tente novamente em alguns minutos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 6390.802837204974\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9cd00073-2f66-4c0a-81e6-fb91aed4bf81", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "approvals", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "20" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "type", "value": "PIX" } ], "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a1040c34-a96a-4bd3-9b15-f7b76cceb905", "name": "Aprovar ou rejeitar transações em lote", "request": { "name": "Aprovar ou rejeitar transações em lote", "description": { "content": "Processa até 50 transações em uma única chamada. Um único step-up valida todo o lote. Sucesso parcial: cada transação é processada independentemente. O response indica o resultado individual e totais de sucesso/falha.\n\nUm item pode voltar com status `PENDING` em vez de `PROCESSING`: significa que a aprovação daquela transação foi registrada mas o envio ao provider ficou sem desfecho conhecido — a operação pode ter sido executada e é liquidada pela reconciliação em minutos. **Não conte como falha e não reenvie**; acompanhe pelo detalhe da transação.", "type": "text/plain" }, "url": { "path": [ "accounts", "approvals", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "disabled": false, "description": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "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 \"action\": \"APPROVE\",\n \"transaction_ids\": [\n \"01JZWY347BXD9X4F294HTPX1VE\",\n \"01JZWY3A2BXD9X4F294HTPX2AB\"\n ],\n \"reason\": \"Valores incorretos\",\n \"step_up\": {\n \"totp\": \"331809\",\n \"pin\": \"1234\",\n \"assertion\": \"string\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "6ba8d4f2-4ddf-4a3a-b2a0-db9c0096e5b1", "originalRequest": { "url": { "path": [ "accounts", "approvals", "transactions" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "disabled": false, "description": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"action\": \"APPROVE\",\n \"transaction_ids\": [\n \"01JZWY347BXD9X4F294HTPX1VE\",\n \"01JZWY3A2BXD9X4F294HTPX2AB\"\n ],\n \"reason\": \"Valores incorretos\",\n \"step_up\": {\n \"totp\": \"331809\",\n \"pin\": \"1234\",\n \"assertion\": \"string\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"results\": [\n {\n \"id\": \"string\",\n \"status\": \"PROCESSING\",\n \"approved_at\": \"string\",\n \"rejected_at\": \"string\",\n \"error\": \"string\"\n },\n {\n \"id\": \"string\",\n \"status\": \"PROCESSING\",\n \"approved_at\": \"string\",\n \"rejected_at\": \"string\",\n \"error\": \"string\"\n }\n ],\n \"succeeded\": 3,\n \"failed\": 0\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a6f3a569-a188-4c41-b5d5-7b0ea5461d07", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "approvals", "transactions" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "disabled": false, "description": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"action\": \"APPROVE\",\n \"transaction_ids\": [\n \"01JZWY347BXD9X4F294HTPX1VE\",\n \"01JZWY3A2BXD9X4F294HTPX2AB\"\n ],\n \"reason\": \"Valores incorretos\",\n \"step_up\": {\n \"totp\": \"331809\",\n \"pin\": \"1234\",\n \"assertion\": \"string\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b1e42f47-88e7-4462-b070-1738aaf8c155", "name": "Token inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "approvals", "transactions" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "disabled": false, "description": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"action\": \"APPROVE\",\n \"transaction_ids\": [\n \"01JZWY347BXD9X4F294HTPX1VE\",\n \"01JZWY3A2BXD9X4F294HTPX2AB\"\n ],\n \"reason\": \"Valores incorretos\",\n \"step_up\": {\n \"totp\": \"331809\",\n \"pin\": \"1234\",\n \"assertion\": \"string\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 401,\n \"code\": \"INVALID_CREDENTIALS\",\n \"message\": \"Token inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 1532,\n \"key_1\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "422e8bfe-3df6-49e2-90cc-16a0328e9aee", "name": "Acesso negado - permissões insuficientes para este recurso", "originalRequest": { "url": { "path": [ "accounts", "approvals", "transactions" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "disabled": false, "description": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"action\": \"APPROVE\",\n \"transaction_ids\": [\n \"01JZWY347BXD9X4F294HTPX1VE\",\n \"01JZWY3A2BXD9X4F294HTPX2AB\"\n ],\n \"reason\": \"Valores incorretos\",\n \"step_up\": {\n \"totp\": \"331809\",\n \"pin\": \"1234\",\n \"assertion\": \"string\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"ACCESS_DENIED\",\n \"message\": \"Acesso negado - permissões insuficientes para este recurso\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 8207.703686566874\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "af18bc1b-c6fa-4f92-a2fd-86de9cc0eefb", "name": "Já existe uma transação com o mesmo reference_id para esta conta, ou a chave de idempotência já foi utilizada", "originalRequest": { "url": { "path": [ "accounts", "approvals", "transactions" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "disabled": false, "description": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"action\": \"APPROVE\",\n \"transaction_ids\": [\n \"01JZWY347BXD9X4F294HTPX1VE\",\n \"01JZWY3A2BXD9X4F294HTPX2AB\"\n ],\n \"reason\": \"Valores incorretos\",\n \"step_up\": {\n \"totp\": \"331809\",\n \"pin\": \"1234\",\n \"assertion\": \"string\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 409,\n \"code\": \"RESOURCE_CONFLICT\",\n \"message\": \"Já existe uma transação com o mesmo reference_id para esta conta, ou a chave de idempotência já foi utilizada\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 2211.3957762870464\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d682d540-f0d2-4ee0-a5c2-bb16c88ed114", "name": "Entidade não pode ser processada - verifique os dados", "originalRequest": { "url": { "path": [ "accounts", "approvals", "transactions" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "disabled": false, "description": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"action\": \"APPROVE\",\n \"transaction_ids\": [\n \"01JZWY347BXD9X4F294HTPX1VE\",\n \"01JZWY3A2BXD9X4F294HTPX2AB\"\n ],\n \"reason\": \"Valores incorretos\",\n \"step_up\": {\n \"totp\": \"331809\",\n \"pin\": \"1234\",\n \"assertion\": \"string\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 422,\n \"code\": \"UNPROCESSABLE_ENTITY\",\n \"message\": \"Entidade não pode ser processada - verifique os dados\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true,\n \"key_2\": \"string\",\n \"key_3\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "342e0fcb-b4fb-48f9-92ef-c1c241b37cd9", "name": "Limite de requisições excedido - tente novamente em alguns minutos", "originalRequest": { "url": { "path": [ "accounts", "approvals", "transactions" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "disabled": false, "description": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"action\": \"APPROVE\",\n \"transaction_ids\": [\n \"01JZWY347BXD9X4F294HTPX1VE\",\n \"01JZWY3A2BXD9X4F294HTPX2AB\"\n ],\n \"reason\": \"Valores incorretos\",\n \"step_up\": {\n \"totp\": \"331809\",\n \"pin\": \"1234\",\n \"assertion\": \"string\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Limite de requisições excedido - tente novamente em alguns minutos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 6390.802837204974\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d3723d79-7f52-4c73-97e7-a27dc8a371e7", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "approvals", "transactions" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "disabled": false, "description": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"action\": \"APPROVE\",\n \"transaction_ids\": [\n \"01JZWY347BXD9X4F294HTPX1VE\",\n \"01JZWY3A2BXD9X4F294HTPX2AB\"\n ],\n \"reason\": \"Valores incorretos\",\n \"step_up\": {\n \"totp\": \"331809\",\n \"pin\": \"1234\",\n \"assertion\": \"string\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "fe51af2a-fc94-46b8-95ea-24ddf9de2e34", "name": "Histórico de decisões de aprovação", "request": { "name": "Histórico de decisões de aprovação", "description": { "content": "Transações que já passaram pelo fluxo de aprovação da conta — aprovadas, rejeitadas, expiradas por falta de ação e canceladas quando o sistema barrou a aprovação por mudança de valor. Traz TODAS as decisões da conta, não apenas as de quem consulta.\n\nCada item carrega dois status independentes: o **desfecho da decisão** (bloco `decision`) e o **status atual da transação** (campo `status`) — aprovar não significa que liquidou.\n\nOrdenado pela **data de criação** da transação, da mais recente para a mais antiga. Paginação por cursor, filtros opcionais por desfecho e por período.", "type": "text/plain" }, "url": { "path": [ "accounts", "approvals", "transactions", "history" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "limit", "value": "20", "description": "Quantidade de itens por página (paginação por cursor). 1–100, default 10." }, { "disabled": false, "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=", "description": "Cursor da próxima página. Use exatamente o valor retornado em `page_info.next_cursor` da resposta anterior — é um token **opaco** (não construa nem interprete). Omita na primeira página." }, { "disabled": false, "key": "outcome", "value": "EXPIRED", "description": "Filtrar por desfecho da decisão" }, { "disabled": false, "key": "start_date", "value": "2026-07-01", "description": "Início do período, pela data de criação da transação (inclusive)" }, { "disabled": false, "key": "end_date", "value": "2026-07-31", "description": "Fim do período, pela data de criação da transação (inclusive)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "9f30e10e-5bc7-4013-a3b4-c19479208943", "name": "Histórico de decisões com paginação", "originalRequest": { "url": { "path": [ "accounts", "approvals", "transactions", "history" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "20" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "outcome", "value": "EXPIRED" }, { "key": "start_date", "value": "2026-07-01" }, { "key": "end_date", "value": "2026-07-31" } ], "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\": \"01JZWY347BXD9X4F294HTPX1VE\",\n \"type\": \"PIX\",\n \"direction\": \"DEBIT\",\n \"amount\": 50000,\n \"fee_amount\": 100,\n \"status\": \"COMPLETED\",\n \"created_at\": \"2026-07-15T14:00:00-03:00\",\n \"decision\": {\n \"outcome\": \"APPROVED\",\n \"decided_at\": \"2026-07-15T14:32:10-03:00\",\n \"decided_by\": \"string\",\n \"decided_by_name\": \"Maria Souza\",\n \"reason\": \"Fornecedor não confere com o pedido de compra\"\n },\n \"counterparty_name\": \"string\",\n \"counterparty_document\": \"string\",\n \"initiation_type\": \"QR_DYNAMIC\",\n \"description\": \"string\",\n \"reference_id\": \"string\"\n },\n {\n \"id\": \"01JZWY347BXD9X4F294HTPX1VE\",\n \"type\": \"PIX\",\n \"direction\": \"DEBIT\",\n \"amount\": 50000,\n \"fee_amount\": 100,\n \"status\": \"COMPLETED\",\n \"created_at\": \"2026-07-15T14:00:00-03:00\",\n \"decision\": {\n \"outcome\": \"APPROVED\",\n \"decided_at\": \"2026-07-15T14:32:10-03:00\",\n \"decided_by\": \"string\",\n \"decided_by_name\": \"Maria Souza\",\n \"reason\": \"Fornecedor não confere com o pedido de compra\"\n },\n \"counterparty_name\": \"string\",\n \"counterparty_document\": \"string\",\n \"initiation_type\": \"QR_STATIC\",\n \"description\": \"string\",\n \"reference_id\": \"string\"\n }\n ],\n \"page_info\": {\n \"next_cursor\": {},\n \"has_next_page\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f23ce7dd-fcc6-49c3-baaf-06f199b60535", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "approvals", "transactions", "history" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "20" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "outcome", "value": "EXPIRED" }, { "key": "start_date", "value": "2026-07-01" }, { "key": "end_date", "value": "2026-07-31" } ], "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 \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "57bb86d0-604e-4f63-b6b4-10d73318c33f", "name": "Token inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "approvals", "transactions", "history" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "20" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "outcome", "value": "EXPIRED" }, { "key": "start_date", "value": "2026-07-01" }, { "key": "end_date", "value": "2026-07-31" } ], "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 \"status_code\": 401,\n \"code\": \"INVALID_CREDENTIALS\",\n \"message\": \"Token inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 1532,\n \"key_1\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9cf8c487-adf9-4e0e-b103-efed83a28bc4", "name": "Acesso negado - permissões insuficientes para este recurso", "originalRequest": { "url": { "path": [ "accounts", "approvals", "transactions", "history" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "20" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "outcome", "value": "EXPIRED" }, { "key": "start_date", "value": "2026-07-01" }, { "key": "end_date", "value": "2026-07-31" } ], "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 \"status_code\": 403,\n \"code\": \"ACCESS_DENIED\",\n \"message\": \"Acesso negado - permissões insuficientes para este recurso\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 8207.703686566874\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cac9a881-4311-4f03-b775-32fc9d075295", "name": "Entidade não pode ser processada - verifique os dados", "originalRequest": { "url": { "path": [ "accounts", "approvals", "transactions", "history" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "20" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "outcome", "value": "EXPIRED" }, { "key": "start_date", "value": "2026-07-01" }, { "key": "end_date", "value": "2026-07-31" } ], "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 \"status_code\": 422,\n \"code\": \"UNPROCESSABLE_ENTITY\",\n \"message\": \"Entidade não pode ser processada - verifique os dados\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true,\n \"key_2\": \"string\",\n \"key_3\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7252cac4-a9f3-4421-8364-109b79f8d3af", "name": "Limite de requisições excedido - tente novamente em alguns minutos", "originalRequest": { "url": { "path": [ "accounts", "approvals", "transactions", "history" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "20" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "outcome", "value": "EXPIRED" }, { "key": "start_date", "value": "2026-07-01" }, { "key": "end_date", "value": "2026-07-31" } ], "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Limite de requisições excedido - tente novamente em alguns minutos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 6390.802837204974\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f7f5941c-ebcb-4228-a5d7-ea7d603f2a35", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "approvals", "transactions", "history" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "20" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "outcome", "value": "EXPIRED" }, { "key": "start_date", "value": "2026-07-01" }, { "key": "end_date", "value": "2026-07-31" } ], "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "7c27b7f4-9582-47aa-a485-42a4436b58ac", "name": "Aprovar ou rejeitar transação", "request": { "name": "Aprovar ou rejeitar transação", "description": { "content": "Aprova ou rejeita uma transação financeira pendente (Pix, TED, TEF, pagamento de boleto). Aprovação exige step-up: APP e INTERNET_BANKING (TOTP + PIN), PARTNER (TOTP). Rejeição não exige step-up, aceita motivo opcional.\n\n**Duas respostas de sucesso.** `200` é o caminho normal: a transação foi aprovada e enviada ao provider (status `PROCESSING`). `202` significa que a aprovação foi registrada mas o envio ficou **sem desfecho conhecido** (timeout ou indisponibilidade): a operação pode ter sido executada, a transação fica em `PENDING` e é liquidada pela reconciliação em minutos. No `202` a resposta traz `dispatch_pending: true`.\n\n**Trate o `202` como “em processamento”, nunca como falha, e NÃO reenvie a aprovação** — uma segunda tentativa é recusada com `ALREADY_APPROVED`. Para acompanhar o desfecho, consulte o detalhe da transação.", "type": "text/plain" }, "url": { "path": [ "accounts", "approvals", "transactions", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01K...", "key": "id", "description": "(Required) ID da transação a aprovar ou rejeitar" } ] }, "header": [ { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "disabled": false, "description": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "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 \"action\": \"APPROVE\",\n \"reason\": \"string\",\n \"step_up\": {\n \"totp\": \"331809\",\n \"pin\": \"1234\",\n \"assertion\": \"string\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "81a8eb79-4472-4786-9b5c-3323202c46f7", "name": "Aprovada e enviada ao provider", "originalRequest": { "url": { "path": [ "accounts", "approvals", "transactions", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01K...", "key": "id", "description": "(Required) ID da transação a aprovar ou rejeitar" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "disabled": false, "description": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"action\": \"APPROVE\",\n \"reason\": \"string\",\n \"step_up\": {\n \"totp\": \"331809\",\n \"pin\": \"1234\",\n \"assertion\": \"string\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"01JY05224X1WGAH75F5404HXMF\",\n \"status\": \"PROCESSING\",\n \"approved_at\": \"2026-05-21T07:30:00-03:00\",\n \"rejected_at\": \"2026-05-21T07:30:00-03:00\",\n \"reason\": \"string\",\n \"dispatch_pending\": true\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b60f2dc7-88fd-4392-b8b7-75571674fecc", "name": "Aprovação registrada; envio ao provider sem desfecho conhecido (liquidação pendente)", "originalRequest": { "url": { "path": [ "accounts", "approvals", "transactions", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01K...", "key": "id", "description": "(Required) ID da transação a aprovar ou rejeitar" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "disabled": false, "description": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"action\": \"APPROVE\",\n \"reason\": \"string\",\n \"step_up\": {\n \"totp\": \"331809\",\n \"pin\": \"1234\",\n \"assertion\": \"string\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Accepted", "code": 202, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"01JY05224X1WGAH75F5404HXMF\",\n \"status\": \"PROCESSING\",\n \"approved_at\": \"2026-05-21T07:30:00-03:00\",\n \"rejected_at\": \"2026-05-21T07:30:00-03:00\",\n \"reason\": \"string\",\n \"dispatch_pending\": true\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4c175eb1-a70d-4032-a40d-d6509302eac3", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "approvals", "transactions", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01K...", "key": "id", "description": "(Required) ID da transação a aprovar ou rejeitar" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "disabled": false, "description": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"action\": \"APPROVE\",\n \"reason\": \"string\",\n \"step_up\": {\n \"totp\": \"331809\",\n \"pin\": \"1234\",\n \"assertion\": \"string\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8c7436ec-b877-4b0e-a966-9e6a5016e960", "name": "Token inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "approvals", "transactions", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01K...", "key": "id", "description": "(Required) ID da transação a aprovar ou rejeitar" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "disabled": false, "description": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"action\": \"APPROVE\",\n \"reason\": \"string\",\n \"step_up\": {\n \"totp\": \"331809\",\n \"pin\": \"1234\",\n \"assertion\": \"string\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 401,\n \"code\": \"INVALID_CREDENTIALS\",\n \"message\": \"Token inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 1532,\n \"key_1\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4a6bff3c-5141-4662-bb22-8f0482140c5b", "name": "Acesso negado - permissões insuficientes para este recurso", "originalRequest": { "url": { "path": [ "accounts", "approvals", "transactions", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01K...", "key": "id", "description": "(Required) ID da transação a aprovar ou rejeitar" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "disabled": false, "description": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"action\": \"APPROVE\",\n \"reason\": \"string\",\n \"step_up\": {\n \"totp\": \"331809\",\n \"pin\": \"1234\",\n \"assertion\": \"string\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"ACCESS_DENIED\",\n \"message\": \"Acesso negado - permissões insuficientes para este recurso\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 8207.703686566874\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "022e277c-14da-46c6-b5aa-ec0689727ba3", "name": "Já existe uma transação com o mesmo reference_id para esta conta, ou a chave de idempotência já foi utilizada", "originalRequest": { "url": { "path": [ "accounts", "approvals", "transactions", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01K...", "key": "id", "description": "(Required) ID da transação a aprovar ou rejeitar" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "disabled": false, "description": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"action\": \"APPROVE\",\n \"reason\": \"string\",\n \"step_up\": {\n \"totp\": \"331809\",\n \"pin\": \"1234\",\n \"assertion\": \"string\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 409,\n \"code\": \"RESOURCE_CONFLICT\",\n \"message\": \"Já existe uma transação com o mesmo reference_id para esta conta, ou a chave de idempotência já foi utilizada\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 2211.3957762870464\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e9ad0cf4-c0dd-4efa-afd5-ad76af0e1b33", "name": "Entidade não pode ser processada - verifique os dados", "originalRequest": { "url": { "path": [ "accounts", "approvals", "transactions", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01K...", "key": "id", "description": "(Required) ID da transação a aprovar ou rejeitar" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "disabled": false, "description": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"action\": \"APPROVE\",\n \"reason\": \"string\",\n \"step_up\": {\n \"totp\": \"331809\",\n \"pin\": \"1234\",\n \"assertion\": \"string\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 422,\n \"code\": \"UNPROCESSABLE_ENTITY\",\n \"message\": \"Entidade não pode ser processada - verifique os dados\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true,\n \"key_2\": \"string\",\n \"key_3\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e64c67c4-0941-46fb-95e1-66e827825dc4", "name": "Limite de requisições excedido - tente novamente em alguns minutos", "originalRequest": { "url": { "path": [ "accounts", "approvals", "transactions", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01K...", "key": "id", "description": "(Required) ID da transação a aprovar ou rejeitar" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "disabled": false, "description": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"action\": \"APPROVE\",\n \"reason\": \"string\",\n \"step_up\": {\n \"totp\": \"331809\",\n \"pin\": \"1234\",\n \"assertion\": \"string\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Limite de requisições excedido - tente novamente em alguns minutos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 6390.802837204974\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fc8ea270-8174-40e2-abee-5a5b327a4efe", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "approvals", "transactions", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01K...", "key": "id", "description": "(Required) ID da transação a aprovar ou rejeitar" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "disabled": false, "description": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"action\": \"APPROVE\",\n \"reason\": \"string\",\n \"step_up\": {\n \"totp\": \"331809\",\n \"pin\": \"1234\",\n \"assertion\": \"string\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "cee15cf1-cdbc-46e3-ad5b-f134ace83182", "name": "Favorecidos", "description": { "content": "Cadastro e gestão de favorecidos para reutilização em Pix e TED", "type": "text/plain" }, "item": [ { "id": "c13c36da-07ea-47c8-97e4-8546d387de0d", "name": "Cadastrar favorecido", "request": { "name": "Cadastrar favorecido", "description": { "content": "Cadastra um favorecido (contraparte) para reutilização em transferências Pix e TED. Cadastro síncrono no banco emissor: ao retornar o identificador, o favorecido é gravado como ACTIVE. Exige step-up.", "type": "text/plain" }, "url": { "path": [ "accounts", "payees" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "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 \"person_type\": \"INDIVIDUAL\",\n \"name\": \"Maria Oliveira\",\n \"document_number\": \"12345678901\",\n \"nickname\": \"João - aluguel\",\n \"pix_key\": \"maria@email.com\",\n \"pix_key_type\": \"CNPJ\",\n \"bank_ispb\": \"60701190\",\n \"bank_code\": \"341\",\n \"branch_code\": \"0001\",\n \"branch_digit\": \"8\",\n \"account_number\": \"567890\",\n \"account_digit\": \"1\",\n \"account_type\": \"SAVINGS\",\n \"step_up\": {\n \"totp\": \"331809\",\n \"pin\": \"1234\",\n \"assertion\": \"string\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "cb8b3816-b2e4-489f-bddf-71e2c9bc44ab", "name": "Favorecido cadastrado", "originalRequest": { "url": { "path": [ "accounts", "payees" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"person_type\": \"INDIVIDUAL\",\n \"name\": \"Maria Oliveira\",\n \"document_number\": \"12345678901\",\n \"nickname\": \"João - aluguel\",\n \"pix_key\": \"maria@email.com\",\n \"pix_key_type\": \"CNPJ\",\n \"bank_ispb\": \"60701190\",\n \"bank_code\": \"341\",\n \"branch_code\": \"0001\",\n \"branch_digit\": \"8\",\n \"account_number\": \"567890\",\n \"account_digit\": \"1\",\n \"account_type\": \"SAVINGS\",\n \"step_up\": {\n \"totp\": \"331809\",\n \"pin\": \"1234\",\n \"assertion\": \"string\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"01KRHTDKWHPSEWVD5MXYV5DMV4\",\n \"status\": \"ACTIVE\",\n \"provider_payee_id\": \"3c90c3cc-0d44-...\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "daa2b947-5d64-40c1-9a4b-e7a3720bfd2f", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "payees" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"person_type\": \"INDIVIDUAL\",\n \"name\": \"Maria Oliveira\",\n \"document_number\": \"12345678901\",\n \"nickname\": \"João - aluguel\",\n \"pix_key\": \"maria@email.com\",\n \"pix_key_type\": \"CNPJ\",\n \"bank_ispb\": \"60701190\",\n \"bank_code\": \"341\",\n \"branch_code\": \"0001\",\n \"branch_digit\": \"8\",\n \"account_number\": \"567890\",\n \"account_digit\": \"1\",\n \"account_type\": \"SAVINGS\",\n \"step_up\": {\n \"totp\": \"331809\",\n \"pin\": \"1234\",\n \"assertion\": \"string\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3b96a097-97bb-4ae7-a925-26d756bcd607", "name": "Token inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "payees" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"person_type\": \"INDIVIDUAL\",\n \"name\": \"Maria Oliveira\",\n \"document_number\": \"12345678901\",\n \"nickname\": \"João - aluguel\",\n \"pix_key\": \"maria@email.com\",\n \"pix_key_type\": \"CNPJ\",\n \"bank_ispb\": \"60701190\",\n \"bank_code\": \"341\",\n \"branch_code\": \"0001\",\n \"branch_digit\": \"8\",\n \"account_number\": \"567890\",\n \"account_digit\": \"1\",\n \"account_type\": \"SAVINGS\",\n \"step_up\": {\n \"totp\": \"331809\",\n \"pin\": \"1234\",\n \"assertion\": \"string\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 401,\n \"code\": \"INVALID_CREDENTIALS\",\n \"message\": \"Token inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 1532,\n \"key_1\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8542edeb-9b78-4cf2-8e84-2c355e3791d8", "name": "Acesso negado - permissões insuficientes para este recurso", "originalRequest": { "url": { "path": [ "accounts", "payees" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"person_type\": \"INDIVIDUAL\",\n \"name\": \"Maria Oliveira\",\n \"document_number\": \"12345678901\",\n \"nickname\": \"João - aluguel\",\n \"pix_key\": \"maria@email.com\",\n \"pix_key_type\": \"CNPJ\",\n \"bank_ispb\": \"60701190\",\n \"bank_code\": \"341\",\n \"branch_code\": \"0001\",\n \"branch_digit\": \"8\",\n \"account_number\": \"567890\",\n \"account_digit\": \"1\",\n \"account_type\": \"SAVINGS\",\n \"step_up\": {\n \"totp\": \"331809\",\n \"pin\": \"1234\",\n \"assertion\": \"string\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"ACCESS_DENIED\",\n \"message\": \"Acesso negado - permissões insuficientes para este recurso\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 8207.703686566874\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ced92277-989f-4ac7-a4a6-2783fde89385", "name": "Entidade não pode ser processada - verifique os dados", "originalRequest": { "url": { "path": [ "accounts", "payees" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"person_type\": \"INDIVIDUAL\",\n \"name\": \"Maria Oliveira\",\n \"document_number\": \"12345678901\",\n \"nickname\": \"João - aluguel\",\n \"pix_key\": \"maria@email.com\",\n \"pix_key_type\": \"CNPJ\",\n \"bank_ispb\": \"60701190\",\n \"bank_code\": \"341\",\n \"branch_code\": \"0001\",\n \"branch_digit\": \"8\",\n \"account_number\": \"567890\",\n \"account_digit\": \"1\",\n \"account_type\": \"SAVINGS\",\n \"step_up\": {\n \"totp\": \"331809\",\n \"pin\": \"1234\",\n \"assertion\": \"string\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 422,\n \"code\": \"UNPROCESSABLE_ENTITY\",\n \"message\": \"Entidade não pode ser processada - verifique os dados\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true,\n \"key_2\": \"string\",\n \"key_3\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "56cf88b3-4731-4868-ad7c-b594cd8ad534", "name": "Limite de requisições excedido - tente novamente em alguns minutos", "originalRequest": { "url": { "path": [ "accounts", "payees" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"person_type\": \"INDIVIDUAL\",\n \"name\": \"Maria Oliveira\",\n \"document_number\": \"12345678901\",\n \"nickname\": \"João - aluguel\",\n \"pix_key\": \"maria@email.com\",\n \"pix_key_type\": \"CNPJ\",\n \"bank_ispb\": \"60701190\",\n \"bank_code\": \"341\",\n \"branch_code\": \"0001\",\n \"branch_digit\": \"8\",\n \"account_number\": \"567890\",\n \"account_digit\": \"1\",\n \"account_type\": \"SAVINGS\",\n \"step_up\": {\n \"totp\": \"331809\",\n \"pin\": \"1234\",\n \"assertion\": \"string\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Limite de requisições excedido - tente novamente em alguns minutos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 6390.802837204974\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a65f2cd2-a7de-4147-b1f3-c107a6e990cb", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "payees" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"person_type\": \"INDIVIDUAL\",\n \"name\": \"Maria Oliveira\",\n \"document_number\": \"12345678901\",\n \"nickname\": \"João - aluguel\",\n \"pix_key\": \"maria@email.com\",\n \"pix_key_type\": \"CNPJ\",\n \"bank_ispb\": \"60701190\",\n \"bank_code\": \"341\",\n \"branch_code\": \"0001\",\n \"branch_digit\": \"8\",\n \"account_number\": \"567890\",\n \"account_digit\": \"1\",\n \"account_type\": \"SAVINGS\",\n \"step_up\": {\n \"totp\": \"331809\",\n \"pin\": \"1234\",\n \"assertion\": \"string\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "0161a716-a65c-4950-a9d2-bb730784ecc4", "name": "Listar favorecidos", "request": { "name": "Listar favorecidos", "description": { "content": "Lista os favorecidos da conta com paginação por cursor. Por padrão exclui os removidos.", "type": "text/plain" }, "url": { "path": [ "accounts", "payees" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "limit", "value": "20", "description": "Quantidade de itens por página (paginação por cursor). 1–100, default 10." }, { "disabled": false, "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=", "description": "Cursor da próxima página. Use exatamente o valor retornado em `page_info.next_cursor` da resposta anterior — é um token **opaco** (não construa nem interprete). Omita na primeira página." }, { "disabled": false, "key": "status", "value": "ACTIVE", "description": "Filtrar por status" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "dc2c4bd7-0e73-4cac-9f24-b82c895bfe7f", "name": "Favorecidos da conta", "originalRequest": { "url": { "path": [ "accounts", "payees" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "20" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "status", "value": "ACTIVE" } ], "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\": \"01KRHTDKWHPSEWVD5MXYV5DMV4\",\n \"person_type\": \"INDIVIDUAL\",\n \"name\": \"Maria Oliveira\",\n \"document_number\": \"12345678901\",\n \"status\": \"ACTIVE\",\n \"created_at\": \"2026-05-31T10:00:00-03:00\",\n \"nickname\": \"João - aluguel\",\n \"pix_key\": \"maria@email.com\",\n \"pix_key_type\": \"EMAIL\",\n \"bank_ispb\": \"60701190\",\n \"bank_code\": \"341\",\n \"branch_code\": \"0001\",\n \"branch_digit\": \"8\",\n \"account_number\": \"567890\",\n \"account_digit\": \"1\",\n \"account_type\": \"CHECKING\"\n },\n {\n \"id\": \"01KRHTDKWHPSEWVD5MXYV5DMV4\",\n \"person_type\": \"INDIVIDUAL\",\n \"name\": \"Maria Oliveira\",\n \"document_number\": \"12345678901\",\n \"status\": \"ACTIVE\",\n \"created_at\": \"2026-05-31T10:00:00-03:00\",\n \"nickname\": \"João - aluguel\",\n \"pix_key\": \"maria@email.com\",\n \"pix_key_type\": \"EMAIL\",\n \"bank_ispb\": \"60701190\",\n \"bank_code\": \"341\",\n \"branch_code\": \"0001\",\n \"branch_digit\": \"8\",\n \"account_number\": \"567890\",\n \"account_digit\": \"1\",\n \"account_type\": \"CHECKING\"\n }\n ],\n \"page_info\": {\n \"next_cursor\": {},\n \"has_next_page\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "15c4a543-d16e-4dd0-9c52-e0f414f2f3cb", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "payees" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "20" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "status", "value": "ACTIVE" } ], "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 \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3e8dbee4-391f-463a-822c-532707f347df", "name": "Token inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "payees" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "20" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "status", "value": "ACTIVE" } ], "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 \"status_code\": 401,\n \"code\": \"INVALID_CREDENTIALS\",\n \"message\": \"Token inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 1532,\n \"key_1\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9a69ece9-4f69-4b93-930b-3b2c83458577", "name": "Acesso negado - permissões insuficientes para este recurso", "originalRequest": { "url": { "path": [ "accounts", "payees" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "20" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "status", "value": "ACTIVE" } ], "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 \"status_code\": 403,\n \"code\": \"ACCESS_DENIED\",\n \"message\": \"Acesso negado - permissões insuficientes para este recurso\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 8207.703686566874\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aa5bf82c-e5fb-49cf-b88d-051705433931", "name": "Entidade não pode ser processada - verifique os dados", "originalRequest": { "url": { "path": [ "accounts", "payees" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "20" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "status", "value": "ACTIVE" } ], "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 \"status_code\": 422,\n \"code\": \"UNPROCESSABLE_ENTITY\",\n \"message\": \"Entidade não pode ser processada - verifique os dados\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true,\n \"key_2\": \"string\",\n \"key_3\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3f6c7bca-2caf-4739-ba75-e5f5b4116a1b", "name": "Limite de requisições excedido - tente novamente em alguns minutos", "originalRequest": { "url": { "path": [ "accounts", "payees" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "20" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "status", "value": "ACTIVE" } ], "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Limite de requisições excedido - tente novamente em alguns minutos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 6390.802837204974\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "455cfc0e-854d-4b7e-b31f-420ad258a205", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "payees" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "20" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "status", "value": "ACTIVE" } ], "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "d2f22dfd-5ed8-4ad9-ae3b-f4305bf4cd42", "name": "Consultar favorecido", "request": { "name": "Consultar favorecido", "description": {}, "url": { "path": [ "accounts", "payees", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "id", "description": "(Required) ID do favorecido" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "2fd59e68-a80f-4350-9555-65875e417e86", "name": "Favorecido", "originalRequest": { "url": { "path": [ "accounts", "payees", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "id", "description": "(Required) ID do favorecido" } ] }, "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\": \"01KRHTDKWHPSEWVD5MXYV5DMV4\",\n \"person_type\": \"INDIVIDUAL\",\n \"name\": \"Maria Oliveira\",\n \"document_number\": \"12345678901\",\n \"status\": \"ACTIVE\",\n \"created_at\": \"2026-05-31T10:00:00-03:00\",\n \"nickname\": \"João - aluguel\",\n \"pix_key\": \"maria@email.com\",\n \"pix_key_type\": \"EMAIL\",\n \"bank_ispb\": \"60701190\",\n \"bank_code\": \"341\",\n \"branch_code\": \"0001\",\n \"branch_digit\": \"8\",\n \"account_number\": \"567890\",\n \"account_digit\": \"1\",\n \"account_type\": \"CHECKING\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6185233d-b70e-4699-bcbf-1abb71a33820", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "payees", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "id", "description": "(Required) ID do favorecido" } ] }, "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 \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "634ab8c4-f164-4bcf-9d19-ac898e3385db", "name": "Token inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "payees", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "id", "description": "(Required) ID do favorecido" } ] }, "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 \"status_code\": 401,\n \"code\": \"INVALID_CREDENTIALS\",\n \"message\": \"Token inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 1532,\n \"key_1\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a72a2e8f-3055-4ed5-b9fd-253d2308bee5", "name": "Acesso negado - permissões insuficientes para este recurso", "originalRequest": { "url": { "path": [ "accounts", "payees", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "id", "description": "(Required) ID do favorecido" } ] }, "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 \"status_code\": 403,\n \"code\": \"ACCESS_DENIED\",\n \"message\": \"Acesso negado - permissões insuficientes para este recurso\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 8207.703686566874\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "20dd4bc9-a705-40ec-a4dd-6c18a4ca7e26", "name": "Entidade não pode ser processada - verifique os dados", "originalRequest": { "url": { "path": [ "accounts", "payees", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "id", "description": "(Required) ID do favorecido" } ] }, "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 \"status_code\": 422,\n \"code\": \"UNPROCESSABLE_ENTITY\",\n \"message\": \"Entidade não pode ser processada - verifique os dados\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true,\n \"key_2\": \"string\",\n \"key_3\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "340d28ef-eacb-4aa6-9fee-4a61be423fee", "name": "Limite de requisições excedido - tente novamente em alguns minutos", "originalRequest": { "url": { "path": [ "accounts", "payees", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "id", "description": "(Required) ID do favorecido" } ] }, "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Limite de requisições excedido - tente novamente em alguns minutos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 6390.802837204974\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6dcbeb16-3550-48ab-b49a-75bd671f1472", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "payees", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "id", "description": "(Required) ID do favorecido" } ] }, "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1353fabe-a6bc-4e92-8d61-3b135e6f8b60", "name": "Remover favorecido", "request": { "name": "Remover favorecido", "description": { "content": "Inativa o favorecido (soft delete).", "type": "text/plain" }, "url": { "path": [ "accounts", "payees", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "id", "description": "(Required) ID do favorecido" } ] }, "header": [ { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "d5a2dfb7-73b3-4e70-a812-dd195b770b1e", "name": "Favorecido removido", "originalRequest": { "url": { "path": [ "accounts", "payees", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "id", "description": "(Required) ID do favorecido" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "48270dd6-7cf2-4962-aebd-1b650ac66649", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "payees", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "id", "description": "(Required) ID do favorecido" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cf21bbaa-9646-4086-8059-288fb9d08eb3", "name": "Token inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "payees", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "id", "description": "(Required) ID do favorecido" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 401,\n \"code\": \"INVALID_CREDENTIALS\",\n \"message\": \"Token inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 1532,\n \"key_1\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "77e74919-2661-4090-b969-9b6725079c08", "name": "Acesso negado - permissões insuficientes para este recurso", "originalRequest": { "url": { "path": [ "accounts", "payees", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "id", "description": "(Required) ID do favorecido" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"ACCESS_DENIED\",\n \"message\": \"Acesso negado - permissões insuficientes para este recurso\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 8207.703686566874\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "05e1da97-0183-4260-acde-78c7daaa1234", "name": "Entidade não pode ser processada - verifique os dados", "originalRequest": { "url": { "path": [ "accounts", "payees", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "id", "description": "(Required) ID do favorecido" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "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 \"status_code\": 422,\n \"code\": \"UNPROCESSABLE_ENTITY\",\n \"message\": \"Entidade não pode ser processada - verifique os dados\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true,\n \"key_2\": \"string\",\n \"key_3\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "838b031c-891a-41fb-8f6d-deb281240697", "name": "Limite de requisições excedido - tente novamente em alguns minutos", "originalRequest": { "url": { "path": [ "accounts", "payees", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "id", "description": "(Required) ID do favorecido" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Limite de requisições excedido - tente novamente em alguns minutos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 6390.802837204974\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9261bfe9-bd5b-478e-8bc4-0b4517846d19", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "payees", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "id", "description": "(Required) ID do favorecido" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "c162af6b-ca7b-4bd1-bde4-bbc26728befe", "name": "Conciliação", "description": { "content": "Conciliação de transações para ERP (PARTNER e ACCOUNT_API) — JSON, CSV e OFX", "type": "text/plain" }, "item": [ { "id": "70858eeb-6d32-4104-827f-e13c7e748f41", "name": "Listar transações para conciliação", "request": { "name": "Listar transações para conciliação", "description": { "content": "Lista os movimentos da conta para conciliação no ERP do cliente (PARTNER e ACCOUNT_API). Inclui as chaves de match (reference_id, end_to_end_id, txid, nosso número, NSU), datas de liquidação e o saldo após cada movimento.\n\n## Dois modos\n\n- **Range** (default): informe `start_date` + `end_date`. O `date_field` escolhe a data filtrada (`SETTLEMENT` = liquidação, default; `CREATED` = criação).\n- **Delta**: informe `updated_since` (ISO-8601 BRT) para receber apenas o que mudou de estado desde o último sync. Ordena por `updated_at` crescente; pagine via `cursor` até esvaziar.\n\nTarifa: o ledger trata tarifa como transação `FEE` separada — concilie por `amount` + `running_balance`. O campo `fee` é informativo.\n\nCadência recomendada, modo delta e limites de uso: veja **Polling e conciliação** na visão geral da API.", "type": "text/plain" }, "url": { "path": [ "accounts", "reconciliation", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "start_date", "value": "2026-05-01", "description": "Data inicial do período (yyyy-MM-dd, BRT). Obrigatório no modo range." }, { "disabled": false, "key": "end_date", "value": "2026-05-31", "description": "Data final do período (yyyy-MM-dd, BRT). Obrigatório no modo range." }, { "disabled": false, "key": "date_field", "value": "SETTLEMENT", "description": "Qual data o intervalo filtra (default: SETTLEMENT = liquidação)" }, { "disabled": false, "key": "updated_since", "value": "2026-05-31T10:00:00", "description": "Sincronização incremental: retorna movimentos com updated_at >= valor (ISO-8601 BRT)" }, { "disabled": false, "key": "statuses", "value": "COMPLETED", "description": "Filtrar por status (default: todos)" }, { "disabled": false, "key": "statuses", "value": "COMPLETED", "description": "Filtrar por status (default: todos)" }, { "disabled": false, "key": "types", "value": "TED", "description": "Filtrar por tipo" }, { "disabled": false, "key": "types", "value": "REVERSAL", "description": "Filtrar por tipo" }, { "disabled": false, "key": "directions", "value": "DEBIT", "description": "Filtrar por direção" }, { "disabled": false, "key": "directions", "value": "CREDIT", "description": "Filtrar por direção" }, { "disabled": false, "key": "reference_id", "value": "PEDIDO-1234", "description": "Match exato pela referência de conciliação do cliente" }, { "disabled": false, "key": "min_amount", "value": "10000", "description": "Valor mínimo em centavos" }, { "disabled": false, "key": "max_amount", "value": "500000", "description": "Valor máximo em centavos" }, { "disabled": false, "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=", "description": "Cursor da próxima página. Use exatamente o valor retornado em `page_info.next_cursor` da resposta anterior — é um token **opaco** (não construa nem interprete). Omita na primeira página." }, { "disabled": false, "key": "limit", "value": "100", "description": "Quantidade por página (default 100, max 500)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "3e46ff48-3ddc-498b-bee2-609469b9c401", "name": "Registros de conciliação retornados com sucesso", "originalRequest": { "url": { "path": [ "accounts", "reconciliation", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-31" }, { "key": "date_field", "value": "SETTLEMENT" }, { "key": "updated_since", "value": "2026-05-31T10:00:00" }, { "key": "statuses", "value": "CANCELLED" }, { "key": "statuses", "value": "REVERSED" }, { "key": "types", "value": "SPLIT" }, { "key": "types", "value": "SPLIT" }, { "key": "directions", "value": "DEBIT" }, { "key": "directions", "value": "CREDIT" }, { "key": "reference_id", "value": "PEDIDO-1234" }, { "key": "min_amount", "value": "10000" }, { "key": "max_amount", "value": "500000" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "limit", "value": "100" } ], "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 \"account_id\": \"01JY05224X1WGAH75F5404HXMF\",\n \"generated_at\": \"2026-05-31T17:00:00-03:00\",\n \"records\": [\n {\n \"id\": \"01KRHTDKWHPSEWVD5MXYV5DMV4\",\n \"idempotency_key\": \"a07e5e70-076c-461e-8abb-02521a582904\",\n \"type\": \"PIX\",\n \"direction\": \"CREDIT\",\n \"status\": \"PENDING\",\n \"amount\": 100000,\n \"fee\": 100,\n \"currency\": \"BRL\",\n \"created_at\": \"2026-05-31T10:00:00-03:00\",\n \"updated_at\": \"2026-05-31T10:00:03-03:00\",\n \"reference_id\": \"PEDIDO-1234\",\n \"description\": \"Pagamento fornecedor X\",\n \"operation_description\": \"PAGAMENTO BOLETO\",\n \"provider_transaction_id\": \"string\",\n \"provider_movement_id\": \"string\",\n \"reversal_of_id\": \"string\",\n \"end_to_end_id\": \"string\",\n \"txid\": \"string\",\n \"our_number\": \"string\",\n \"auth_code\": \"string\",\n \"nsu\": \"string\",\n \"running_balance\": 250000,\n \"settled_at\": \"2026-05-31T10:00:03-03:00\",\n \"scheduled_at\": \"string\",\n \"reversed_at\": \"string\",\n \"counterparty_name\": \"string\",\n \"counterparty_document\": \"string\",\n \"counterparty_bank_code\": \"string\",\n \"counterparty_branch_code\": \"string\",\n \"counterparty_account_number\": \"string\"\n },\n {\n \"id\": \"01KRHTDKWHPSEWVD5MXYV5DMV4\",\n \"idempotency_key\": \"a07e5e70-076c-461e-8abb-02521a582904\",\n \"type\": \"REVERSAL\",\n \"direction\": \"DEBIT\",\n \"status\": \"SCHEDULED\",\n \"amount\": 100000,\n \"fee\": 100,\n \"currency\": \"BRL\",\n \"created_at\": \"2026-05-31T10:00:00-03:00\",\n \"updated_at\": \"2026-05-31T10:00:03-03:00\",\n \"reference_id\": \"PEDIDO-1234\",\n \"description\": \"Pagamento fornecedor X\",\n \"operation_description\": \"PAGAMENTO BOLETO\",\n \"provider_transaction_id\": \"string\",\n \"provider_movement_id\": \"string\",\n \"reversal_of_id\": \"string\",\n \"end_to_end_id\": \"string\",\n \"txid\": \"string\",\n \"our_number\": \"string\",\n \"auth_code\": \"string\",\n \"nsu\": \"string\",\n \"running_balance\": 250000,\n \"settled_at\": \"2026-05-31T10:00:03-03:00\",\n \"scheduled_at\": \"string\",\n \"reversed_at\": \"string\",\n \"counterparty_name\": \"string\",\n \"counterparty_document\": \"string\",\n \"counterparty_bank_code\": \"string\",\n \"counterparty_branch_code\": \"string\",\n \"counterparty_account_number\": \"string\"\n }\n ],\n \"page_info\": {\n \"next_cursor\": {},\n \"has_next_page\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aa961ed7-be13-499d-9abc-54cbf575426c", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "reconciliation", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-31" }, { "key": "date_field", "value": "SETTLEMENT" }, { "key": "updated_since", "value": "2026-05-31T10:00:00" }, { "key": "statuses", "value": "CANCELLED" }, { "key": "statuses", "value": "REVERSED" }, { "key": "types", "value": "SPLIT" }, { "key": "types", "value": "SPLIT" }, { "key": "directions", "value": "DEBIT" }, { "key": "directions", "value": "CREDIT" }, { "key": "reference_id", "value": "PEDIDO-1234" }, { "key": "min_amount", "value": "10000" }, { "key": "max_amount", "value": "500000" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "limit", "value": "100" } ], "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 \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "233fd56f-ab98-4df6-885b-5c241da09377", "name": "Token inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "reconciliation", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-31" }, { "key": "date_field", "value": "SETTLEMENT" }, { "key": "updated_since", "value": "2026-05-31T10:00:00" }, { "key": "statuses", "value": "CANCELLED" }, { "key": "statuses", "value": "REVERSED" }, { "key": "types", "value": "SPLIT" }, { "key": "types", "value": "SPLIT" }, { "key": "directions", "value": "DEBIT" }, { "key": "directions", "value": "CREDIT" }, { "key": "reference_id", "value": "PEDIDO-1234" }, { "key": "min_amount", "value": "10000" }, { "key": "max_amount", "value": "500000" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "limit", "value": "100" } ], "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 \"status_code\": 401,\n \"code\": \"INVALID_CREDENTIALS\",\n \"message\": \"Token inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 1532,\n \"key_1\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "deff28e5-a744-4afd-8e20-322e694a6e7a", "name": "Acesso negado - permissões insuficientes para este recurso", "originalRequest": { "url": { "path": [ "accounts", "reconciliation", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-31" }, { "key": "date_field", "value": "SETTLEMENT" }, { "key": "updated_since", "value": "2026-05-31T10:00:00" }, { "key": "statuses", "value": "CANCELLED" }, { "key": "statuses", "value": "REVERSED" }, { "key": "types", "value": "SPLIT" }, { "key": "types", "value": "SPLIT" }, { "key": "directions", "value": "DEBIT" }, { "key": "directions", "value": "CREDIT" }, { "key": "reference_id", "value": "PEDIDO-1234" }, { "key": "min_amount", "value": "10000" }, { "key": "max_amount", "value": "500000" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "limit", "value": "100" } ], "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 \"status_code\": 403,\n \"code\": \"ACCESS_DENIED\",\n \"message\": \"Acesso negado - permissões insuficientes para este recurso\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 8207.703686566874\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f87aa111-2541-4e8a-8401-1da85ba03ed5", "name": "Entidade não pode ser processada - verifique os dados", "originalRequest": { "url": { "path": [ "accounts", "reconciliation", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-31" }, { "key": "date_field", "value": "SETTLEMENT" }, { "key": "updated_since", "value": "2026-05-31T10:00:00" }, { "key": "statuses", "value": "CANCELLED" }, { "key": "statuses", "value": "REVERSED" }, { "key": "types", "value": "SPLIT" }, { "key": "types", "value": "SPLIT" }, { "key": "directions", "value": "DEBIT" }, { "key": "directions", "value": "CREDIT" }, { "key": "reference_id", "value": "PEDIDO-1234" }, { "key": "min_amount", "value": "10000" }, { "key": "max_amount", "value": "500000" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "limit", "value": "100" } ], "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 \"status_code\": 422,\n \"code\": \"UNPROCESSABLE_ENTITY\",\n \"message\": \"Entidade não pode ser processada - verifique os dados\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true,\n \"key_2\": \"string\",\n \"key_3\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "26cb3d97-ffcc-41f4-a31d-159f9c38b81e", "name": "Limite de requisições excedido - tente novamente em alguns minutos", "originalRequest": { "url": { "path": [ "accounts", "reconciliation", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-31" }, { "key": "date_field", "value": "SETTLEMENT" }, { "key": "updated_since", "value": "2026-05-31T10:00:00" }, { "key": "statuses", "value": "CANCELLED" }, { "key": "statuses", "value": "REVERSED" }, { "key": "types", "value": "SPLIT" }, { "key": "types", "value": "SPLIT" }, { "key": "directions", "value": "DEBIT" }, { "key": "directions", "value": "CREDIT" }, { "key": "reference_id", "value": "PEDIDO-1234" }, { "key": "min_amount", "value": "10000" }, { "key": "max_amount", "value": "500000" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "limit", "value": "100" } ], "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Limite de requisições excedido - tente novamente em alguns minutos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 6390.802837204974\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "01aedb6d-f7f6-441d-ba3d-db19dc36dc67", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "reconciliation", "transactions" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-31" }, { "key": "date_field", "value": "SETTLEMENT" }, { "key": "updated_since", "value": "2026-05-31T10:00:00" }, { "key": "statuses", "value": "CANCELLED" }, { "key": "statuses", "value": "REVERSED" }, { "key": "types", "value": "SPLIT" }, { "key": "types", "value": "SPLIT" }, { "key": "directions", "value": "DEBIT" }, { "key": "directions", "value": "CREDIT" }, { "key": "reference_id", "value": "PEDIDO-1234" }, { "key": "min_amount", "value": "10000" }, { "key": "max_amount", "value": "500000" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "limit", "value": "100" } ], "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4f8f8758-8230-4c05-9eb1-86237a042bf5", "name": "Exportar conciliação (CSV, OFX)", "request": { "name": "Exportar conciliação (CSV, OFX)", "description": { "content": "Gera o arquivo de conciliação do período para download. Formatos: `CSV`, `OFX`. CSV traz as colunas ricas de conciliação; OFX usa FITID = id Meioo e REFNUM = referência do cliente. Período máximo de 90 dias por exportação.\n\nOperação pesada — prefira janelas maiores e baixa frequência (ex.: fechamento diário). Veja **Polling e conciliação** na visão geral da API.", "type": "text/plain" }, "url": { "path": [ "accounts", "reconciliation", "transactions", "export" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "format", "value": "CSV", "description": "(Required) Formato do arquivo" }, { "disabled": false, "key": "start_date", "value": "2026-05-01", "description": "(Required) Data inicial do período (yyyy-MM-dd, BRT)" }, { "disabled": false, "key": "end_date", "value": "2026-05-31", "description": "(Required) Data final do período (yyyy-MM-dd, BRT)" }, { "disabled": false, "key": "date_field", "value": "SETTLEMENT", "description": "Qual data o intervalo filtra (default: SETTLEMENT)" }, { "disabled": false, "key": "statuses", "value": "COMPLETED", "description": "Filtrar por status (default: todos)" }, { "disabled": false, "key": "statuses", "value": "COMPLETED", "description": "Filtrar por status (default: todos)" }, { "disabled": false, "key": "types", "value": "TED", "description": "Filtrar por tipo" }, { "disabled": false, "key": "types", "value": "REVERSAL", "description": "Filtrar por tipo" }, { "disabled": false, "key": "directions", "value": "DEBIT", "description": "Filtrar por direção" }, { "disabled": false, "key": "directions", "value": "CREDIT", "description": "Filtrar por direção" }, { "disabled": false, "key": "reference_id", "value": "string", "description": "Match exato pela referência de conciliação do cliente" }, { "disabled": false, "key": "min_amount", "value": "8888", "description": "Valor mínimo em centavos" }, { "disabled": false, "key": "max_amount", "value": "8888", "description": "Valor máximo em centavos" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "3b566897-0f35-4f69-82b8-71e72ec93cc4", "name": "Arquivo de conciliação gerado com sucesso", "originalRequest": { "url": { "path": [ "accounts", "reconciliation", "transactions", "export" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "format", "value": "CSV" }, { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-31" }, { "key": "date_field", "value": "SETTLEMENT" }, { "key": "statuses", "value": "CANCELLED" }, { "key": "statuses", "value": "REVERSED" }, { "key": "types", "value": "SPLIT" }, { "key": "types", "value": "SPLIT" }, { "key": "directions", "value": "DEBIT" }, { "key": "directions", "value": "CREDIT" }, { "key": "reference_id", "value": "string" }, { "key": "min_amount", "value": "8888" }, { "key": "max_amount", "value": "8888" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "8e44cb35-886a-47cd-810d-48fdc4567470", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "reconciliation", "transactions", "export" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "format", "value": "CSV" }, { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-31" }, { "key": "date_field", "value": "SETTLEMENT" }, { "key": "statuses", "value": "CANCELLED" }, { "key": "statuses", "value": "REVERSED" }, { "key": "types", "value": "SPLIT" }, { "key": "types", "value": "SPLIT" }, { "key": "directions", "value": "DEBIT" }, { "key": "directions", "value": "CREDIT" }, { "key": "reference_id", "value": "string" }, { "key": "min_amount", "value": "8888" }, { "key": "max_amount", "value": "8888" } ], "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 \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c704d32f-be26-4c6c-8587-33378530719a", "name": "Token inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "reconciliation", "transactions", "export" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "format", "value": "CSV" }, { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-31" }, { "key": "date_field", "value": "SETTLEMENT" }, { "key": "statuses", "value": "CANCELLED" }, { "key": "statuses", "value": "REVERSED" }, { "key": "types", "value": "SPLIT" }, { "key": "types", "value": "SPLIT" }, { "key": "directions", "value": "DEBIT" }, { "key": "directions", "value": "CREDIT" }, { "key": "reference_id", "value": "string" }, { "key": "min_amount", "value": "8888" }, { "key": "max_amount", "value": "8888" } ], "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 \"status_code\": 401,\n \"code\": \"INVALID_CREDENTIALS\",\n \"message\": \"Token inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 1532,\n \"key_1\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "03dc457b-336b-4876-9209-c2998e495296", "name": "Acesso negado - permissões insuficientes para este recurso", "originalRequest": { "url": { "path": [ "accounts", "reconciliation", "transactions", "export" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "format", "value": "CSV" }, { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-31" }, { "key": "date_field", "value": "SETTLEMENT" }, { "key": "statuses", "value": "CANCELLED" }, { "key": "statuses", "value": "REVERSED" }, { "key": "types", "value": "SPLIT" }, { "key": "types", "value": "SPLIT" }, { "key": "directions", "value": "DEBIT" }, { "key": "directions", "value": "CREDIT" }, { "key": "reference_id", "value": "string" }, { "key": "min_amount", "value": "8888" }, { "key": "max_amount", "value": "8888" } ], "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 \"status_code\": 403,\n \"code\": \"ACCESS_DENIED\",\n \"message\": \"Acesso negado - permissões insuficientes para este recurso\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 8207.703686566874\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "82840fc2-4721-4613-8f24-7c9718d4a20a", "name": "Entidade não pode ser processada - verifique os dados", "originalRequest": { "url": { "path": [ "accounts", "reconciliation", "transactions", "export" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "format", "value": "CSV" }, { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-31" }, { "key": "date_field", "value": "SETTLEMENT" }, { "key": "statuses", "value": "CANCELLED" }, { "key": "statuses", "value": "REVERSED" }, { "key": "types", "value": "SPLIT" }, { "key": "types", "value": "SPLIT" }, { "key": "directions", "value": "DEBIT" }, { "key": "directions", "value": "CREDIT" }, { "key": "reference_id", "value": "string" }, { "key": "min_amount", "value": "8888" }, { "key": "max_amount", "value": "8888" } ], "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 \"status_code\": 422,\n \"code\": \"UNPROCESSABLE_ENTITY\",\n \"message\": \"Entidade não pode ser processada - verifique os dados\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true,\n \"key_2\": \"string\",\n \"key_3\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "03784375-09bf-46e8-8ce3-35fa68106ed9", "name": "Limite de requisições excedido - tente novamente em alguns minutos", "originalRequest": { "url": { "path": [ "accounts", "reconciliation", "transactions", "export" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "format", "value": "CSV" }, { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-31" }, { "key": "date_field", "value": "SETTLEMENT" }, { "key": "statuses", "value": "CANCELLED" }, { "key": "statuses", "value": "REVERSED" }, { "key": "types", "value": "SPLIT" }, { "key": "types", "value": "SPLIT" }, { "key": "directions", "value": "DEBIT" }, { "key": "directions", "value": "CREDIT" }, { "key": "reference_id", "value": "string" }, { "key": "min_amount", "value": "8888" }, { "key": "max_amount", "value": "8888" } ], "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Limite de requisições excedido - tente novamente em alguns minutos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 6390.802837204974\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "421c96e3-7970-4901-a536-348d6a46d3aa", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "reconciliation", "transactions", "export" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "format", "value": "CSV" }, { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-31" }, { "key": "date_field", "value": "SETTLEMENT" }, { "key": "statuses", "value": "CANCELLED" }, { "key": "statuses", "value": "REVERSED" }, { "key": "types", "value": "SPLIT" }, { "key": "types", "value": "SPLIT" }, { "key": "directions", "value": "DEBIT" }, { "key": "directions", "value": "CREDIT" }, { "key": "reference_id", "value": "string" }, { "key": "min_amount", "value": "8888" }, { "key": "max_amount", "value": "8888" } ], "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "df150fab-de93-413a-8612-6ccc2e004681", "name": "Gerenciamento completo de autenticação e autorização na plataforma Meioo. Inclui login mobile, autenticação por API Key e fluxos OAuth2 para integração de terceiros.", "description": { "content": "", "type": "text/plain" }, "item": [ { "id": "3f8c4b1b-5a2c-4c20-b826-a0e600a8a40b", "name": "Autenticar API Key", "request": { "name": "Autenticar API Key", "description": { "content": "Endpoint principal para autenticação de parceiros e integradores via API Key. Destinado exclusivamente para acesso programático (server-to-server).\n\n**Formato da API Key:**\n`sk_{ambiente}.{identificador}.{secret}`\n\n**Ambientes disponíveis:**\n\n**`sk_test.*`**\nAmbiente de desenvolvimento/testes para integração e homologação.\n\n**`sk_live.*`**\nAmbiente de produção para operações reais.\n\n**Token retornado:**\nJWT de acesso com validade de 10 minutos, vinculado às permissões da API Key. Use este token no header Authorization para demais chamadas à API.", "type": "text/plain" }, "url": { "path": [ "auth", "api-key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "2155cb5b-93b7-4392-97f9-dc9ae6f68c2b", "name": "Autenticação bem-sucedida. Token JWT de acesso gerado com validade de 10 minutos.", "originalRequest": { "url": { "path": [ "auth", "api-key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "disabled": false, "description": "(Required) Chave de API do client, no formato `Bearer `.", "key": "authorization", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"access_token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiYWRtaW4iOnRydWUsImlhdCI6MTUxNjIzOTAyMn0.KMUFsIDTnFmyG3nMiGM6H9FNFUROf3wh7SmqJp-QV30\",\n \"token_type\": \"Bearer\",\n \"expires_in\": 3600\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "565a0ccf-c41a-41e3-8a21-665f94de712d", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "auth", "api-key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "disabled": false, "description": "(Required) Chave de API do client, no formato `Bearer `.", "key": "authorization", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6355be6a-2948-4753-a00d-7742da984f5e", "name": "API Key inválida, expirada ou revogada", "originalRequest": { "url": { "path": [ "auth", "api-key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "disabled": false, "description": "(Required) Chave de API do client, no formato `Bearer `.", "key": "authorization", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 401,\n \"code\": \"INVALID_API_KEY\",\n \"message\": \"API Key inválida, expirada ou revogada\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fe4363f7-dc5c-4584-9647-f2c6c71d61d7", "name": "API Key válida, mas sem permissões para este recurso", "originalRequest": { "url": { "path": [ "auth", "api-key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "disabled": false, "description": "(Required) Chave de API do client, no formato `Bearer `.", "key": "authorization", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"INSUFFICIENT_PERMISSIONS\",\n \"message\": \"API Key válida, mas sem permissões para este recurso\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "11ef4f2b-cb97-4773-a9be-b4f4cafae30e", "name": "Entidade não pode ser processada - verifique os dados", "originalRequest": { "url": { "path": [ "auth", "api-key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "disabled": false, "description": "(Required) Chave de API do client, no formato `Bearer `.", "key": "authorization", "value": "string" }, { "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 \"status_code\": 422,\n \"code\": \"UNPROCESSABLE_ENTITY\",\n \"message\": \"Entidade não pode ser processada - verifique os dados\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true,\n \"key_2\": \"string\",\n \"key_3\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ea68f4df-4514-4858-a6a9-d3ed319a0f10", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "auth", "api-key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "disabled": false, "description": "(Required) Chave de API do client, no formato `Bearer `.", "key": "authorization", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "acc2d6f3-565b-43cb-89bf-bfb316d63a39", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "auth", "api-key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "disabled": false, "description": "(Required) Chave de API do client, no formato `Bearer `.", "key": "authorization", "value": "string" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a0490aac-8bf9-48bf-bac4-c82f60cef87b", "name": "OAuth2 - Troca de Tokens", "request": { "name": "OAuth2 - Troca de Tokens", "description": { "content": "Segunda etapa do fluxo OAuth2. Converte códigos de autorização em tokens de acesso ou renova tokens expirados. Implementa grant types conforme RFC 6749.\n\n**Grant Types suportados:**\n\n**`authorization_code`**\nTroca código de autorização por tokens iniciais. Use após receber o código do endpoint `/oauth/authorize`.\n\n**`refresh_token`**\nRenova access token expirado usando refresh token válido. Implementa rotação de refresh tokens.\n\n**Validade dos tokens:**\n• **Access Token**: 10 minutos\n• **Refresh Token**: 30 dias (renovado a cada uso)", "type": "text/plain" }, "url": { "path": [ "oauth", "token" ], "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": "Authorization" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] }, "body": { "mode": "raw", "raw": "{\n \"grant_type\": \"urn:meioo:params:oauth:grant-type:delegation\",\n \"client_id\": \"meioo-partner-app\",\n \"client_assertion_type\": \"urn:ietf:params:oauth:client-assertion-type:jwt-bearer\",\n \"client_assertion\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\n \"code\": \"SplxlOBeZQQYbYS6WxSbIA\",\n \"redirect_uri\": \"https://client.example.com/cb\",\n \"code_verifier\": \"dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk\",\n \"delegation_id\": \"1234567890\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "ba15b779-d809-4430-9bf2-40477db2346e", "name": "Tokens gerados com sucesso. Novos access_token (1h) e refresh_token (30d) fornecidos.", "originalRequest": { "url": { "path": [ "oauth", "token" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"grant_type\": \"urn:meioo:params:oauth:grant-type:delegation\",\n \"client_id\": \"meioo-partner-app\",\n \"client_assertion_type\": \"urn:ietf:params:oauth:client-assertion-type:jwt-bearer\",\n \"client_assertion\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\n \"code\": \"SplxlOBeZQQYbYS6WxSbIA\",\n \"redirect_uri\": \"https://client.example.com/cb\",\n \"code_verifier\": \"dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk\",\n \"delegation_id\": \"1234567890\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"access_token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiYWRtaW4iOnRydWUsImlhdCI6MTUxNjIzOTAyMn0.KMUFsIDTnFmyG3nMiGM6H9FNFUROf3wh7SmqJp-QV30\",\n \"token_type\": \"Bearer\",\n \"expires_in\": 3600,\n \"refresh_token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiYWRtaW4iOnRydWUsImlhdCI6MTUxNjIzOTAyMn0.KMUFsIDTnFmyG3nMiGM6H9FNFUROf3wh7SmqJp-QV30\",\n \"scopes\": [\n \"account:read\",\n \"bank-slips:read\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9a962aaf-3fb5-4692-9d97-9e64afca67e2", "name": "Grant type não suportado. Use 'authorization_code' ou 'refresh_token'", "originalRequest": { "url": { "path": [ "oauth", "token" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"grant_type\": \"urn:meioo:params:oauth:grant-type:delegation\",\n \"client_id\": \"meioo-partner-app\",\n \"client_assertion_type\": \"urn:ietf:params:oauth:client-assertion-type:jwt-bearer\",\n \"client_assertion\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\n \"code\": \"SplxlOBeZQQYbYS6WxSbIA\",\n \"redirect_uri\": \"https://client.example.com/cb\",\n \"code_verifier\": \"dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk\",\n \"delegation_id\": \"1234567890\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"UNSUPPORTED_GRANT_TYPE\",\n \"message\": \"Grant type não suportado. Use 'authorization_code' ou 'refresh_token'\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\",\n \"key_2\": 4048.895636357435\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a73f7285-56a2-4148-94f1-9a174f1e4ca9", "name": "Código de autorização ou refresh token inválido/expirado", "originalRequest": { "url": { "path": [ "oauth", "token" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"grant_type\": \"urn:meioo:params:oauth:grant-type:delegation\",\n \"client_id\": \"meioo-partner-app\",\n \"client_assertion_type\": \"urn:ietf:params:oauth:client-assertion-type:jwt-bearer\",\n \"client_assertion\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\n \"code\": \"SplxlOBeZQQYbYS6WxSbIA\",\n \"redirect_uri\": \"https://client.example.com/cb\",\n \"code_verifier\": \"dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk\",\n \"delegation_id\": \"1234567890\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 401,\n \"code\": \"INVALID_TOKEN_OR_CODE\",\n \"message\": \"Código de autorização ou refresh token inválido/expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 1039.3515002167208\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "34fcf058-deb0-4fd0-aae7-019e5a03c6ed", "name": "client_id/client_secret inválidos ou aplicação não autorizada", "originalRequest": { "url": { "path": [ "oauth", "token" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"grant_type\": \"urn:meioo:params:oauth:grant-type:delegation\",\n \"client_id\": \"meioo-partner-app\",\n \"client_assertion_type\": \"urn:ietf:params:oauth:client-assertion-type:jwt-bearer\",\n \"client_assertion\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\n \"code\": \"SplxlOBeZQQYbYS6WxSbIA\",\n \"redirect_uri\": \"https://client.example.com/cb\",\n \"code_verifier\": \"dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk\",\n \"delegation_id\": \"1234567890\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"CLIENT_AUTHENTICATION_FAILED\",\n \"message\": \"client_id/client_secret inválidos ou aplicação não autorizada\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 2161\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "88aaf3f5-710b-4daa-b699-654af156aad7", "name": "Código de autorização já foi utilizado ou expirou", "originalRequest": { "url": { "path": [ "oauth", "token" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"grant_type\": \"urn:meioo:params:oauth:grant-type:delegation\",\n \"client_id\": \"meioo-partner-app\",\n \"client_assertion_type\": \"urn:ietf:params:oauth:client-assertion-type:jwt-bearer\",\n \"client_assertion\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\n \"code\": \"SplxlOBeZQQYbYS6WxSbIA\",\n \"redirect_uri\": \"https://client.example.com/cb\",\n \"code_verifier\": \"dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk\",\n \"delegation_id\": \"1234567890\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 422,\n \"code\": \"INVALID_AUTHORIZATION_CODE\",\n \"message\": \"Código de autorização já foi utilizado ou expirou\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 7263,\n \"key_1\": 8722,\n \"key_2\": \"string\",\n \"key_3\": 2643.1635439399347\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e1fd9cc6-d82b-4339-8fab-7c1bb3ee6360", "name": "Limite de requisições excedido - tente novamente em alguns minutos", "originalRequest": { "url": { "path": [ "oauth", "token" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"grant_type\": \"urn:meioo:params:oauth:grant-type:delegation\",\n \"client_id\": \"meioo-partner-app\",\n \"client_assertion_type\": \"urn:ietf:params:oauth:client-assertion-type:jwt-bearer\",\n \"client_assertion\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\n \"code\": \"SplxlOBeZQQYbYS6WxSbIA\",\n \"redirect_uri\": \"https://client.example.com/cb\",\n \"code_verifier\": \"dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk\",\n \"delegation_id\": \"1234567890\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Limite de requisições excedido - tente novamente em alguns minutos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 6390.802837204974\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "94ebded7-8fcc-436a-a3e1-fc9d01c67eb4", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "oauth", "token" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"grant_type\": \"urn:meioo:params:oauth:grant-type:delegation\",\n \"client_id\": \"meioo-partner-app\",\n \"client_assertion_type\": \"urn:ietf:params:oauth:client-assertion-type:jwt-bearer\",\n \"client_assertion\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\n \"code\": \"SplxlOBeZQQYbYS6WxSbIA\",\n \"redirect_uri\": \"https://client.example.com/cb\",\n \"code_verifier\": \"dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk\",\n \"delegation_id\": \"1234567890\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "f5fe9acf-84fa-4335-9b19-70536bef8185", "name": "Gestão completa de contas digitais na plataforma Meioo. Inclui consulta de dados, saldo, extrato, transações e gerenciamento de credenciais de API para integração programática.", "description": { "content": "", "type": "text/plain" }, "item": [ { "id": "ae0e12ba-4e6d-4de3-8f6c-c8dd8ab63ee3", "name": "Consultar saldo da conta", "request": { "name": "Consultar saldo da conta", "description": { "content": "Retorna o saldo atual da conta digital em tempo real, incluindo detalhamento de valores disponíveis e bloqueados.\n\n**Informações de saldo:**\n\n**Saldo Disponível**\nValor imediatamente disponível para transações.\n\n**Saldo Bloqueado**\nValores temporariamente indisponíveis (reservas, pre-autorizações).\n\n**Limites**\nInformações sobre limites diários, mensais e de transação configurados.\n\n**Atualização:** Os valores são consultados em tempo real no sistema bancário.", "type": "text/plain" }, "url": { "path": [ "accounts", "balance" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "ae16e81e-606b-4db1-8233-e76f979f8e96", "name": "Saldo consultado com sucesso", "originalRequest": { "url": { "path": [ "accounts", "balance" ], "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 \"current_balance\": 1000000,\n \"available_balance\": 950000,\n \"blocked_balance\": 50000,\n \"scheduled_balance\": 15000,\n \"last_update\": \"2025-01-15T14:30:00-03:00\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "30247426-26e8-4659-be11-82b62bce00e4", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "balance" ], "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": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "30248852-2656-4d22-b0d6-f5c9971ce995", "name": "Token inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "balance" ], "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 \"status_code\": 401,\n \"code\": \"INVALID_CREDENTIALS\",\n \"message\": \"Token inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 1532,\n \"key_1\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "af0710c2-75eb-4a29-8828-2aa5f57133ac", "name": "Acesso negado - permissões insuficientes para este recurso", "originalRequest": { "url": { "path": [ "accounts", "balance" ], "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 \"status_code\": 403,\n \"code\": \"ACCESS_DENIED\",\n \"message\": \"Acesso negado - permissões insuficientes para este recurso\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 8207.703686566874\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "296cb919-2b46-41e5-86e6-0b67372ec6c8", "name": "Conta não encontrada ou sem saldo disponível", "originalRequest": { "url": { "path": [ "accounts", "balance" ], "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 \"status_code\": 404,\n \"code\": \"ACCOUNT_NOT_FOUND\",\n \"message\": \"Conta não encontrada ou sem saldo disponível\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": 6677.623934265984,\n \"key_2\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "01b41456-f234-4e8c-8cf9-eca4254582af", "name": "Entidade não pode ser processada - verifique os dados", "originalRequest": { "url": { "path": [ "accounts", "balance" ], "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 \"status_code\": 422,\n \"code\": \"UNPROCESSABLE_ENTITY\",\n \"message\": \"Entidade não pode ser processada - verifique os dados\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true,\n \"key_2\": \"string\",\n \"key_3\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e9375521-0f87-4de6-a51f-060bd1255ab3", "name": "Limite de requisições excedido - tente novamente em alguns minutos", "originalRequest": { "url": { "path": [ "accounts", "balance" ], "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Limite de requisições excedido - tente novamente em alguns minutos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 6390.802837204974\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e0dad21a-cbb9-425c-9454-6a310a0aa4a1", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "balance" ], "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "82e7c3a5-18f6-4f57-a773-b6e5a10a8d7d", "name": "Consultar tarifas da conta", "request": { "name": "Consultar tarifas da conta", "description": { "content": "Retorna as tarifas aplicáveis à conta do correntista autenticado, resolvidas pela hierarquia de planos (Conta → Grupo → Parceiro → Global PF/PJ).\n\n**Informações retornadas:**\n\n**Nome do plano de tarifas**\nPlano efetivo atribuído à conta.\n\n**Regras de tarifação**\nValor fixo (FLAT) ou percentual (PERCENTAGE) por tipo de serviço.\n\n**Response 204:** Nenhum plano de tarifas atribuído à conta.", "type": "text/plain" }, "url": { "path": [ "accounts", "fees" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "06c3cf94-f2e9-4712-a05b-8f6fa52ac677", "name": "Tarifas consultadas com sucesso", "originalRequest": { "url": { "path": [ "accounts", "fees" ], "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 \"plan_name\": \"Plano Padrao PF\",\n \"rules\": [\n {\n \"service\": \"PIX_SENT\",\n \"service_label\": \"Pix enviado\",\n \"calculation_type\": \"FLAT\",\n \"amount\": 100,\n \"percentage_rate\": 100,\n \"minimum_amount\": 500,\n \"maximum_amount\": 5000\n },\n {\n \"service\": \"PIX_SENT\",\n \"service_label\": \"Pix enviado\",\n \"calculation_type\": \"FLAT\",\n \"amount\": 100,\n \"percentage_rate\": 100,\n \"minimum_amount\": 500,\n \"maximum_amount\": 5000\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b139b731-da3a-4589-924a-e101241765bf", "name": "Nenhum plano de tarifas atribuído à conta", "originalRequest": { "url": { "path": [ "accounts", "fees" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "No Content", "code": 204, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "10e8b8f2-6e15-4786-99d3-a667bacaa8e1", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "fees" ], "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": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7706e940-85bf-4d4f-9ee5-267d6faebb9f", "name": "Token inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "fees" ], "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 \"status_code\": 401,\n \"code\": \"INVALID_CREDENTIALS\",\n \"message\": \"Token inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 1532,\n \"key_1\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "eb40be3b-1db7-4d2b-97bd-d46e54f467f4", "name": "Acesso negado - permissões insuficientes para este recurso", "originalRequest": { "url": { "path": [ "accounts", "fees" ], "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 \"status_code\": 403,\n \"code\": \"ACCESS_DENIED\",\n \"message\": \"Acesso negado - permissões insuficientes para este recurso\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 8207.703686566874\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6cbb1370-2135-4494-83e5-01bfcfd6b2d8", "name": "Entidade não pode ser processada - verifique os dados", "originalRequest": { "url": { "path": [ "accounts", "fees" ], "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 \"status_code\": 422,\n \"code\": \"UNPROCESSABLE_ENTITY\",\n \"message\": \"Entidade não pode ser processada - verifique os dados\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true,\n \"key_2\": \"string\",\n \"key_3\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "97517453-bf69-4703-b559-2762987a31d4", "name": "Limite de requisições excedido - tente novamente em alguns minutos", "originalRequest": { "url": { "path": [ "accounts", "fees" ], "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Limite de requisições excedido - tente novamente em alguns minutos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 6390.802837204974\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9137b942-c3bc-41cc-a7c8-d1a397c83a28", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "fees" ], "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "cae8021c-b804-4089-b401-b79441052bf1", "name": "Consultar limites da conta", "request": { "name": "Consultar limites da conta", "description": { "content": "Retorna os limites transacionais aplicáveis à conta do correntista autenticado, incluindo consumo diário em tempo real.\n\n**Informações retornadas:**\n\n**Nome do perfil de limites**\nPerfil efetivo atribuído à conta.\n\n**Período noturno**\nHorários de início e fim do período com restrição noturna.\n\n**Regras de limite**\nMáximo por transação, diário e noturno por tipo de serviço, com consumo e disponível hoje.\n\n**Response 204:** Nenhum perfil de limites atribuído à conta.", "type": "text/plain" }, "url": { "path": [ "accounts", "limits" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "6cbfa50b-9d1a-4949-9eeb-ea38bbf5b83a", "name": "Limites consultados com sucesso", "originalRequest": { "url": { "path": [ "accounts", "limits" ], "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 \"profile_name\": \"Limites Padrão PF\",\n \"night_period\": {\n \"start\": \"20:00\",\n \"end\": \"06:00\"\n },\n \"rules\": [\n {\n \"service\": \"PIX_SENT\",\n \"service_label\": \"Pix enviado\",\n \"max_per_transaction\": 500000,\n \"max_daily\": 1000000,\n \"daily_consumed\": 350000,\n \"daily_available\": 650000,\n \"max_nightly\": 100000\n },\n {\n \"service\": \"PIX_SENT\",\n \"service_label\": \"Pix enviado\",\n \"max_per_transaction\": 500000,\n \"max_daily\": 1000000,\n \"daily_consumed\": 350000,\n \"daily_available\": 650000,\n \"max_nightly\": 100000\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "972321a0-2946-4c29-a321-97ff32b8ad32", "name": "Nenhum perfil de limites atribuído à conta", "originalRequest": { "url": { "path": [ "accounts", "limits" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "No Content", "code": 204, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "8d1c30d1-1f40-47f2-a468-a0816948236c", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "limits" ], "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": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "17edeb94-fbc4-4ca9-adad-7566f0018cb2", "name": "Token inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "limits" ], "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 \"status_code\": 401,\n \"code\": \"INVALID_CREDENTIALS\",\n \"message\": \"Token inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 1532,\n \"key_1\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cf58ef1e-bc50-4e99-8fca-9140f4c604c3", "name": "Acesso negado - permissões insuficientes para este recurso", "originalRequest": { "url": { "path": [ "accounts", "limits" ], "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 \"status_code\": 403,\n \"code\": \"ACCESS_DENIED\",\n \"message\": \"Acesso negado - permissões insuficientes para este recurso\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 8207.703686566874\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f62caba5-0a34-414e-84be-45f8d7d172d7", "name": "Entidade não pode ser processada - verifique os dados", "originalRequest": { "url": { "path": [ "accounts", "limits" ], "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 \"status_code\": 422,\n \"code\": \"UNPROCESSABLE_ENTITY\",\n \"message\": \"Entidade não pode ser processada - verifique os dados\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true,\n \"key_2\": \"string\",\n \"key_3\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "02c9dcde-b255-4afd-b2e7-1fe5dc7402a8", "name": "Limite de requisições excedido - tente novamente em alguns minutos", "originalRequest": { "url": { "path": [ "accounts", "limits" ], "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Limite de requisições excedido - tente novamente em alguns minutos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 6390.802837204974\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "52da3264-5187-4d04-82b0-30f2b2b88457", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "limits" ], "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6427bfe7-57cd-4955-9698-a0cb845cbcae", "name": "Consultar extrato da conta", "request": { "name": "Consultar extrato da conta", "description": { "content": "Retorna o histórico detalhado de transações concluídas da conta. Ideal para conciliação e relatórios financeiros.\n\n**O período é opcional.** Sem `start_date`/`end_date`, a resposta traz as **últimas `limit` transações**, independente de quando ocorreram — é o que evita a tela vazia numa conta parada há meses. A rolagem para o passado continua pelo `cursor`, igual.\n\n## Parâmetros\n\n| Parâmetro | Obrigatório | Descrição | Exemplo |\n|---|---|---|---|\n| `start_date` | Não* | Data inicial do período (BRT, `yyyy-MM-dd`) | `2026-05-01` |\n| `end_date` | Não* | Data final do período (BRT, `yyyy-MM-dd`) | `2026-05-24` |\n| `types` | Não | Filtrar por tipo de transação: `PIX`, `BANK_SLIP`, `TED`, `TEF`, `FEE`, `REVERSAL`, `SPLIT`, `CARD_PURCHASE` | `?types=PIX&types=TED` |\n| `directions` | Não | Filtrar por direção: `CREDIT`, `DEBIT` | `?directions=CREDIT` |\n| `limit` | Não | Quantidade por página (padrão: 100, máximo: 500) | `?limit=50` |\n| `cursor` | Não | Token **opaco** da próxima página — reenvie o valor de `page_info.next_cursor` (não construa) | `?cursor=eyJjcmVhdGVkQXQiOi...` |\n\n\\* **É ambos ou nenhum:** enviar só uma das duas datas responde `400`.\n\nNa resposta, `start_date` e `end_date` **ecoam o período pedido** quando ele é informado; sem período, são derivados da página (a data da transação mais antiga e da mais recente devolvidas) e vêm **nulos** quando a página sai vazia.\n\nA resposta inclui `page_info { next_cursor, has_next_page }`. Veja o guia de **Paginação** na introdução da API.", "type": "text/plain" }, "url": { "path": [ "accounts", "statement" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "start_date", "value": "2026-05-01", "description": "Data inicial do período, pela **data econômica** da transação (liquidação/`processed_at`, não a data de criação). Formato: yyyy-MM-dd, interpretada como BRT. O extrato lista apenas transações concluídas, ordenadas pela data econômica (saldo que fecha linha a linha).\n\n**Opcional, mas é AMBOS ou NENHUM** — enviar só uma das duas datas responde 400. Sem período, o extrato traz as últimas `limit` transações concluídas, independente de quando ocorreram; a rolagem para o passado continua pelo `cursor`, igual." }, { "disabled": false, "key": "end_date", "value": "2026-05-23", "description": "Data final do período, pela **data econômica** da transação (liquidação/`processed_at`). Formato: yyyy-MM-dd, interpretada como BRT. Opcional — ver `start_date`." }, { "disabled": false, "key": "types", "value": "PIX", "description": "Filtrar por tipo de transação" }, { "disabled": false, "key": "types", "value": "TED", "description": "Filtrar por tipo de transação" }, { "disabled": false, "key": "directions", "value": "CREDIT", "description": "Filtrar por direção" }, { "disabled": false, "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=", "description": "Cursor da próxima página. Use exatamente o valor retornado em `page_info.next_cursor` da resposta anterior — é um token **opaco** (não construa nem interprete). Omita na primeira página." }, { "disabled": false, "key": "limit", "value": "100", "description": "Quantidade por página (default 100, max 500)" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "5c4710bc-2c7a-41c9-8f74-ebe783a1e9db", "name": "Extrato consultado com sucesso", "originalRequest": { "url": { "path": [ "accounts", "statement" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-23" }, { "key": "types", "value": "PIX" }, { "key": "types", "value": "TED" }, { "key": "directions", "value": "CREDIT" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "limit", "value": "100" } ], "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 \"statement_date\": \"2026-05-24T14:30:00-03:00\",\n \"start_date\": \"2026-05-01T00:00:00-03:00\",\n \"end_date\": \"2026-05-24T00:00:00-03:00\",\n \"start_date_balance\": 15000.5,\n \"end_date_balance\": 18750.25,\n \"blocked_balance\": 500,\n \"current_balance\": 18250.25,\n \"transactions\": [\n {\n \"id\": \"c4aa46cc-e3fc-...\",\n \"type\": \"BANK_SLIP\",\n \"direction\": \"CREDIT\",\n \"status\": \"COMPLETED\",\n \"occurred_at\": \"2026-04-24T08:14:09-03:00\",\n \"amount\": 15000,\n \"operation_description\": \"PAGAMENTO BOLETO\",\n \"end_of_day_balance\": 133072,\n \"requested_channel\": \"API\",\n \"approved_channel\": \"MOBILE\",\n \"provider_transaction_id\": \"23903e9a-0a35-...\",\n \"provider_movement_id\": \"bfe899aa-75e6-...\",\n \"fee_amount\": 50,\n \"description\": \"Nosso Número: 371\",\n \"reference_id\": \"OP_001234\",\n \"counterparty_name\": \"João Silva\",\n \"counterparty_document\": \"85831877540\",\n \"counterparty_bank_code\": \"274\",\n \"counterparty_branch_code\": \"0001\",\n \"counterparty_account_number\": \"02381705\",\n \"pix_key\": \"joao@email.com\",\n \"barcode\": \"23793381286...\",\n \"end_to_end_id\": \"E90400888...\",\n \"nsu\": \"123456\",\n \"is_pix_qr_code\": false,\n \"control_number\": \"00000000001\"\n },\n {\n \"id\": \"c4aa46cc-e3fc-...\",\n \"type\": \"BANK_SLIP\",\n \"direction\": \"CREDIT\",\n \"status\": \"COMPLETED\",\n \"occurred_at\": \"2026-04-24T08:14:09-03:00\",\n \"amount\": 15000,\n \"operation_description\": \"PAGAMENTO BOLETO\",\n \"end_of_day_balance\": 133072,\n \"requested_channel\": \"WEB\",\n \"approved_channel\": \"WEB\",\n \"provider_transaction_id\": \"23903e9a-0a35-...\",\n \"provider_movement_id\": \"bfe899aa-75e6-...\",\n \"fee_amount\": 50,\n \"description\": \"Nosso Número: 371\",\n \"reference_id\": \"OP_001234\",\n \"counterparty_name\": \"João Silva\",\n \"counterparty_document\": \"85831877540\",\n \"counterparty_bank_code\": \"274\",\n \"counterparty_branch_code\": \"0001\",\n \"counterparty_account_number\": \"02381705\",\n \"pix_key\": \"joao@email.com\",\n \"barcode\": \"23793381286...\",\n \"end_to_end_id\": \"E90400888...\",\n \"nsu\": \"123456\",\n \"is_pix_qr_code\": false,\n \"control_number\": \"00000000001\"\n }\n ],\n \"page_info\": {\n \"next_cursor\": {},\n \"has_next_page\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b1c40cb3-aee7-45e8-8ac3-1fe6f78b8710", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "statement" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-23" }, { "key": "types", "value": "PIX" }, { "key": "types", "value": "TED" }, { "key": "directions", "value": "CREDIT" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "limit", "value": "100" } ], "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 \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c667f53a-91de-4849-baa9-8c3c2a074d65", "name": "Token inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "statement" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-23" }, { "key": "types", "value": "PIX" }, { "key": "types", "value": "TED" }, { "key": "directions", "value": "CREDIT" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "limit", "value": "100" } ], "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 \"status_code\": 401,\n \"code\": \"INVALID_CREDENTIALS\",\n \"message\": \"Token inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 1532,\n \"key_1\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fa59820c-6525-4657-839c-e0af420f63fa", "name": "Acesso negado - permissões insuficientes para este recurso", "originalRequest": { "url": { "path": [ "accounts", "statement" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-23" }, { "key": "types", "value": "PIX" }, { "key": "types", "value": "TED" }, { "key": "directions", "value": "CREDIT" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "limit", "value": "100" } ], "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 \"status_code\": 403,\n \"code\": \"ACCESS_DENIED\",\n \"message\": \"Acesso negado - permissões insuficientes para este recurso\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 8207.703686566874\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c01cd703-37a0-48d2-aae5-095a7383d6ef", "name": "Entidade não pode ser processada - verifique os dados", "originalRequest": { "url": { "path": [ "accounts", "statement" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-23" }, { "key": "types", "value": "PIX" }, { "key": "types", "value": "TED" }, { "key": "directions", "value": "CREDIT" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "limit", "value": "100" } ], "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 \"status_code\": 422,\n \"code\": \"UNPROCESSABLE_ENTITY\",\n \"message\": \"Entidade não pode ser processada - verifique os dados\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true,\n \"key_2\": \"string\",\n \"key_3\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0ebfe75f-e537-4c0c-976f-74110ff2b515", "name": "Limite de requisições excedido - tente novamente em alguns minutos", "originalRequest": { "url": { "path": [ "accounts", "statement" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-23" }, { "key": "types", "value": "PIX" }, { "key": "types", "value": "TED" }, { "key": "directions", "value": "CREDIT" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "limit", "value": "100" } ], "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Limite de requisições excedido - tente novamente em alguns minutos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 6390.802837204974\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fb15dbcd-3539-4b43-a192-aaa1124cb907", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "statement" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-23" }, { "key": "types", "value": "PIX" }, { "key": "types", "value": "TED" }, { "key": "directions", "value": "CREDIT" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "limit", "value": "100" } ], "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "491a6212-df8c-4872-b1a8-b49035b3acbb", "name": "Exportar extrato da conta", "request": { "name": "Exportar extrato da conta", "description": { "content": "Gera e retorna o extrato da conta em formato de arquivo para download. Suporta PDF (visualizacao), CSV (processamento) e OFX (importacao em softwares contabeis).\n\n## Formatos disponíveis\n\n| Formato | Content-Type | Uso |\n|---|---|---|\n| PDF | application/pdf | Visualizacao e compartilhamento |\n| CSV | text/csv | Processamento em planilhas |\n| OFX | application/x-ofx | Importacao em softwares contabeis |\n\n## Parametros\n\n| Parametro | Obrigatorio | Descricao | Exemplo |\n|---|---|---|---|\n| `format` | Sim | Formato do arquivo: `PDF`, `CSV`, `OFX` | `?format=PDF` |\n| `start_date` | Sim | Data inicial do período (BRT, formato ISO 8601) | `2026-05-01` |\n| `end_date` | Sim | Data final do período (BRT, formato ISO 8601) | `2026-05-25` |\n| `types` | Não | Filtrar por tipo de transação: `PIX`, `BANK_SLIP`, `TED`, `TEF`, `FEE`, `REVERSAL`, `SPLIT`, `CARD_PURCHASE` | `?types=PIX&types=TED` |\n| `directions` | Não | Filtrar por direcao: `CREDIT`, `DEBIT` | `?directions=CREDIT` |\n\n**Período máximo:** 90 dias por exportação.", "type": "text/plain" }, "url": { "path": [ "accounts", "statement", "export" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "format", "value": "PDF", "description": "(Required) Formato do arquivo de exportação" }, { "disabled": false, "key": "start_date", "value": "2026-05-01", "description": "(Required) Data inicial do período (formato: yyyy-MM-dd, interpretada como BRT)" }, { "disabled": false, "key": "end_date", "value": "2026-05-25", "description": "(Required) Data final do período (formato: yyyy-MM-dd, interpretada como BRT)" }, { "disabled": false, "key": "types", "value": "PIX", "description": "Filtrar por tipo de transação" }, { "disabled": false, "key": "types", "value": "TED", "description": "Filtrar por tipo de transação" }, { "disabled": false, "key": "directions", "value": "CREDIT", "description": "Filtrar por direção" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "7533e121-a500-4a83-9ad5-8bc6253443dd", "name": "Arquivo gerado com sucesso. Content-Type varia conforme formato solicitado: application/pdf (PDF), text/csv (CSV), application/x-ofx (OFX).", "originalRequest": { "url": { "path": [ "accounts", "statement", "export" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "format", "value": "PDF" }, { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-25" }, { "key": "types", "value": "PIX" }, { "key": "types", "value": "TED" }, { "key": "directions", "value": "CREDIT" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "45b932fd-4171-421c-8d67-33355020a74f", "name": "Periodo superior a 90 dias", "originalRequest": { "url": { "path": [ "accounts", "statement", "export" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "format", "value": "PDF" }, { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-25" }, { "key": "types", "value": "PIX" }, { "key": "types", "value": "TED" }, { "key": "directions", "value": "CREDIT" } ], "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 \"status_code\": 400,\n \"code\": \"INVALID_DATE_RANGE\",\n \"message\": \"Periodo superior a 90 dias\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 3462.6351711747593,\n \"key_1\": 5134\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "965d381f-e0f7-42ea-9718-b537c0cd63af", "name": "Token inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "statement", "export" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "format", "value": "PDF" }, { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-25" }, { "key": "types", "value": "PIX" }, { "key": "types", "value": "TED" }, { "key": "directions", "value": "CREDIT" } ], "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 \"status_code\": 401,\n \"code\": \"INVALID_CREDENTIALS\",\n \"message\": \"Token inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 1532,\n \"key_1\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b7e90f09-f833-42ce-b678-e322a3c16bf1", "name": "Acesso negado - permissões insuficientes para este recurso", "originalRequest": { "url": { "path": [ "accounts", "statement", "export" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "format", "value": "PDF" }, { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-25" }, { "key": "types", "value": "PIX" }, { "key": "types", "value": "TED" }, { "key": "directions", "value": "CREDIT" } ], "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 \"status_code\": 403,\n \"code\": \"ACCESS_DENIED\",\n \"message\": \"Acesso negado - permissões insuficientes para este recurso\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 8207.703686566874\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2e619a4a-abd5-4c3b-883a-7cef58ec1414", "name": "Conta nao encontrada", "originalRequest": { "url": { "path": [ "accounts", "statement", "export" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "format", "value": "PDF" }, { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-25" }, { "key": "types", "value": "PIX" }, { "key": "types", "value": "TED" }, { "key": "directions", "value": "CREDIT" } ], "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 \"status_code\": 404,\n \"code\": \"ACCOUNT_NOT_FOUND\",\n \"message\": \"Conta nao encontrada\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": 6372,\n \"key_2\": \"string\",\n \"key_3\": 911\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8077a76d-1973-4c6e-be65-2626d3f4c8c1", "name": "Entidade não pode ser processada - verifique os dados", "originalRequest": { "url": { "path": [ "accounts", "statement", "export" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "format", "value": "PDF" }, { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-25" }, { "key": "types", "value": "PIX" }, { "key": "types", "value": "TED" }, { "key": "directions", "value": "CREDIT" } ], "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 \"status_code\": 422,\n \"code\": \"UNPROCESSABLE_ENTITY\",\n \"message\": \"Entidade não pode ser processada - verifique os dados\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true,\n \"key_2\": \"string\",\n \"key_3\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d1bb8999-c607-429f-9d6f-0e41c77437f5", "name": "Limite de requisições excedido - tente novamente em alguns minutos", "originalRequest": { "url": { "path": [ "accounts", "statement", "export" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "format", "value": "PDF" }, { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-25" }, { "key": "types", "value": "PIX" }, { "key": "types", "value": "TED" }, { "key": "directions", "value": "CREDIT" } ], "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Limite de requisições excedido - tente novamente em alguns minutos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 6390.802837204974\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d0755e85-7819-4443-84c7-49ca210e877c", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "statement", "export" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "format", "value": "PDF" }, { "key": "start_date", "value": "2026-05-01" }, { "key": "end_date", "value": "2026-05-25" }, { "key": "types", "value": "PIX" }, { "key": "types", "value": "TED" }, { "key": "directions", "value": "CREDIT" } ], "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b98c0a3d-c955-4113-ab7e-dd240f789c38", "name": "Consultar recibo de transação", "request": { "name": "Consultar recibo de transação", "description": { "content": "Gera e retorna o recibo oficial de uma transação específica. Útil para comprovação e auditoria de operações financeiras.\n\n**Recibo inclui:**\n\n**Dados completos da transação**\nValor, origem, destino, método de pagamento e status.\n\n**Informações de autenticação**\nDados do usuário, dispositivo e método de autorização.\n\n**Timestamps e identificadores únicos**\nDatas de criação, processamento e IDs de rastreamento.\n\n**Hash de verificação de integridade**\nAssinatura digital para validação da autenticidade.\n\n**Formatos disponíveis:**\n\n**JSON estruturado**\nFormato ideal para integração e processamento automatizado.\n\n**PDF para impressão**\nFormato visual para comprovação física (quando solicitado).\n\n**Validade:** Recibos são válidos indefinidamente para fins de auditoria.", "type": "text/plain" }, "url": { "path": [ "accounts", "transactions", ":transaction_id", "receipt" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "transaction_id", "description": "(Required) ID da transação a ser consultada" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "6bd655b3-1d83-4472-a721-8f5f3d07b962", "name": "Recibo consultado com sucesso", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "receipt" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "transaction_id", "description": "(Required) ID da transação a ser consultada" } ] }, "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\": \"c4aa46cc-e3fc-...\",\n \"type\": \"PIX\",\n \"direction\": \"DEBIT\",\n \"status\": \"COMPLETED\",\n \"amount\": 15000,\n \"occurred_at\": \"2025-01-15T11:30:00-03:00\",\n \"provider_transaction_id\": \"23903e9a-0a35-...\",\n \"provider_movement_id\": \"c4aa46cc-e3fc-...\",\n \"fee_amount\": 50,\n \"auth_code\": \"e36c4123-b4a7-...\",\n \"nsu\": \"000123456789\",\n \"end_to_end_id\": \"E12345678202501151430000000001\",\n \"txid\": \"REC1234567890\",\n \"pix_key\": \"maria@email.com\",\n \"pix_key_type\": \"EMAIL\",\n \"refund_reason\": \"Solicitação do pagador\",\n \"barcode\": \"23793381286...\",\n \"digitable_line\": \"23793.38128 60080...\",\n \"operation_description\": \"Pix enviado\",\n \"description\": \"Pagamento aluguel\",\n \"reference_id\": \"ORDER-2025-0042\",\n \"amount_due\": 15000,\n \"interest_amount\": 250,\n \"fine_amount\": 500,\n \"discount_amount\": 1000,\n \"rebate_amount\": 300,\n \"due_date\": \"2025-08-30\",\n \"beneficiary_name\": \"Empresa Exemplo LTDA\",\n \"beneficiary_document\": \"12345678000190\",\n \"issuer_name\": \"Empresa Exemplo LTDA\",\n \"issuer_document\": \"12345678000190\",\n \"issuer_bank_code\": \"001\",\n \"our_number\": \"00000001234\",\n \"document_number\": \"000001\",\n \"purpose_code\": 10,\n \"purpose_description\": \"Pagamento de salários\",\n \"initiation_type\": \"DICT\",\n \"additional_info\": \"Pagamento referente ao pedido 123\",\n \"return_detail\": \"Conta encerrada\",\n \"reversal_of_id\": \"01JZWY347BXD9X4F294HTPX1VE\",\n \"balance_after\": 250000,\n \"from\": {\n \"holder_name\": \"João Silva Santos\",\n \"holder_document\": \"12345678900\",\n \"bank_code\": \"274\",\n \"bank_ispb\": \"11581339\",\n \"bank_name\": \"Banco Exemplo S.A.\",\n \"branch_code\": \"0001\",\n \"branch_digit\": \"8\",\n \"account_number\": \"238170\",\n \"account_digit\": \"5\",\n \"account_type\": \"PAYMENT\"\n },\n \"to\": {\n \"holder_name\": \"João Silva Santos\",\n \"holder_document\": \"12345678900\",\n \"bank_code\": \"274\",\n \"bank_ispb\": \"11581339\",\n \"bank_name\": \"Banco Exemplo S.A.\",\n \"branch_code\": \"0001\",\n \"branch_digit\": \"8\",\n \"account_number\": \"238170\",\n \"account_digit\": \"5\",\n \"account_type\": \"PAYMENT\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b07c1f98-1c81-470e-a32d-15189766d8a8", "name": "Dados inválidos ou não informados", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "receipt" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "transaction_id", "description": "(Required) ID da transação a ser consultada" } ] }, "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 \"status_code\": 400,\n \"code\": \"INVALID_INPUT\",\n \"message\": \"Dados inválidos ou não informados\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 3405,\n \"key_1\": 1312.7345250032497,\n \"key_2\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "80dd01ad-dc83-4ea5-b5b0-7c9ae072ad9c", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "receipt" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "transaction_id", "description": "(Required) ID da transação a ser consultada" } ] }, "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 \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "45608eb3-03d5-4647-b27f-51b7333bbf37", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "receipt" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "transaction_id", "description": "(Required) ID da transação a ser consultada" } ] }, "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 \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "60092f37-f3d9-4687-a719-23bc8cefe4ad", "name": "Transação não encontrada", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "receipt" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "transaction_id", "description": "(Required) ID da transação a ser consultada" } ] }, "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 \"status_code\": 404,\n \"code\": \"TRANSACTION_NOT_FOUND\",\n \"message\": \"Transação não encontrada\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 6851,\n \"key_1\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f2d370f4-c7db-468e-ba7b-bc1282fcfcae", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "receipt" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "transaction_id", "description": "(Required) ID da transação a ser consultada" } ] }, "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "519a4ac3-aa4a-45d7-a44f-824067004e03", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "receipt" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "transaction_id", "description": "(Required) ID da transação a ser consultada" } ] }, "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "44912b2c-579b-4b1a-8b3b-a69f943fed4a", "name": "Gerar PDF do recibo de transação", "request": { "name": "Gerar PDF do recibo de transação", "description": { "content": "Gera e retorna o recibo de transação em formato PDF, pronto para impressão ou envio.\n\n**Inclui:** valor, data/hora, dados do remetente e destinatário, código de autenticação, NSU e campos específicos do tipo de operação (end_to_end_id para Pix, linha digitável para boleto, etc.).\n\n**Disponível apenas para transações com status COMPLETED.**\n\n**Content-Type da resposta:** `application/pdf`", "type": "text/plain" }, "url": { "path": [ "accounts", "transactions", ":transaction_id", "receipt", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "transaction_id", "description": "(Required) ID da transação" } ] }, "header": [ { "key": "Accept", "value": "application/pdf" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "3263a4f9-1750-4f5b-a592-8a34086cac2a", "name": "PDF do comprovante gerado com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "receipt", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "transaction_id", "description": "(Required) ID da transação" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/pdf" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/pdf" } ], "body": "string", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "e99820f1-32ae-4b24-b830-20920678ac6c", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "receipt", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "transaction_id", "description": "(Required) ID da transação" } ] }, "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 \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7f9e9c52-6cbb-44a0-92e5-5abdf9589408", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "receipt", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "transaction_id", "description": "(Required) ID da transação" } ] }, "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 \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "099361df-959e-40b9-bd52-3947c3c60634", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "receipt", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "transaction_id", "description": "(Required) ID da transação" } ] }, "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 \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9ac49025-e9f9-4a03-8e34-a0005f2890ec", "name": "Transação não encontrada", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "receipt", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "transaction_id", "description": "(Required) ID da transação" } ] }, "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 \"status_code\": 404,\n \"code\": \"TRANSACTION_NOT_FOUND\",\n \"message\": \"Transação não encontrada\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 6851,\n \"key_1\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4550f1b4-561c-47ed-a6fc-b6ef0432ac28", "name": "Comprovante disponível apenas para transações concluídas", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "receipt", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "transaction_id", "description": "(Required) ID da transação" } ] }, "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 \"status_code\": 422,\n \"code\": \"INVALID_INPUT\",\n \"message\": \"Comprovante disponível apenas para transações concluídas\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 9157.58584384357\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3de26085-2985-45dc-ac6f-2f5df4f93386", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "receipt", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "transaction_id", "description": "(Required) ID da transação" } ] }, "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "78921cdb-2ac3-42c5-a448-1c01516fb9e9", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "receipt", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "transaction_id", "description": "(Required) ID da transação" } ] }, "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "29afe5d0-bee8-43b0-abbc-2385c6f2fa26", "name": "Consultar detalhes de transação", "request": { "name": "Consultar detalhes de transação", "description": { "content": "Retorna informações detalhadas e técnicas de uma transação específica. Fornece dados completos para análise e troubleshooting.\n\n**Informações detalhadas:**\n\n**Dados da transação**\nValores, moeda, método de pagamento, status atual.\n\n**Dados técnicos**\nIDs de sistema, códigos de resposta, tempos de processamento.\n\n**Histórico de status**\nCronologia completa desde iniciação até finalização.\n\n**Dados de segurança**\nIPs, dispositivos, tokens de autenticação utilizados.", "type": "text/plain" }, "url": { "path": [ "accounts", "transactions", ":transaction_id", "details" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "transaction_id", "description": "(Required) ID da transação a ser consultada" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "06d1f474-44c5-4b2d-b143-a93f5086b41c", "name": "Detalhes da transação consultados com sucesso", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "details" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "transaction_id", "description": "(Required) ID da transação a ser consultada" } ] }, "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\": \"01KRHX6B1RA7VXF25HS3S7NVY4\",\n \"type\": \"PIX\",\n \"direction\": \"DEBIT\",\n \"status\": \"COMPLETED\",\n \"amount\": 10000,\n \"occurred_at\": \"2026-05-14T10:06:16-03:00\",\n \"created_at\": \"2026-05-30T11:00:00-03:00\",\n \"updated_at\": \"2026-05-30T11:30:00-03:00\",\n \"requested_channel\": \"INTERNAL\",\n \"approved_channel\": \"MOBILE\",\n \"fee_amount\": 100,\n \"auth_code\": \"1095448f-b2df-4c65-8f86-37173def9f43\",\n \"nsu\": \"6578270\",\n \"operation_description\": \"TEF enviada\",\n \"description\": \"Pagamento de teste\",\n \"reference_id\": \"TRANSACAO_1515\",\n \"counterparty_name\": \"JULIANA MARINA REBECA DA SILVA\",\n \"counterparty_document\": \"33259371796\",\n \"provider_transaction_id\": \"823bb42d-775c-44fe-80ba-36daf1cf8d50\",\n \"provider_movement_id\": \"0ec5bab1-8ca2-4b10-9ca1-fdf7b5e7dab1\",\n \"end_to_end_id\": \"E12345678202605141430000000001\",\n \"pix_key\": \"joao@email.com\",\n \"pix_key_type\": \"EMAIL\",\n \"operation_number\": \"E90400888202605140001\",\n \"txid\": \"abc123def456\",\n \"barcode\": \"23793381286...\",\n \"digitable_line\": \"23793.38128 60080...\",\n \"due_date\": \"2026-08-30\",\n \"beneficiary_name\": \"Empresa XYZ Ltda\",\n \"beneficiary_document\": \"12345678000195\",\n \"purpose_code\": 10,\n \"counterparty_bank_code\": \"274\",\n \"counterparty_bank_ispb\": \"11581339\",\n \"counterparty_bank_name\": \"Banco Exemplo S.A.\",\n \"counterparty_branch\": \"0001\",\n \"counterparty_branch_digit\": \"8\",\n \"counterparty_account_number\": \"02381705\",\n \"counterparty_account_digit\": \"5\",\n \"counterparty_account_type\": \"PAYMENT\",\n \"balance_after\": 150000,\n \"amount_due\": 15000,\n \"interest_amount\": 250,\n \"fine_amount\": 500,\n \"discount_amount\": 1000,\n \"rebate_amount\": 300,\n \"issuer_name\": \"Empresa Exemplo LTDA\",\n \"issuer_document\": \"12345678000190\",\n \"issuer_bank_code\": \"001\",\n \"our_number\": \"00000001234\",\n \"document_number\": \"000001\",\n \"wallet_number\": 109,\n \"paid_at\": \"2026-05-30T11:30:00-03:00\",\n \"payment_limit_date\": \"2026-09-30\",\n \"is_hybrid\": false,\n \"initiation_type\": \"DICT\",\n \"refund_reason\": \"Solicitação do pagador\",\n \"rejection_reason\": \"AB03\",\n \"rejection_description\": \"Saldo insuficiente na conta do recebedor\",\n \"additional_info\": \"Pagamento referente ao pedido 123\",\n \"purpose_description\": \"Pagamento de salários\",\n \"return_detail\": \"Conta encerrada\",\n \"reversal_of_id\": \"01JZWY347BXD9X4F294HTPX1VE\",\n \"processed_at\": \"2026-05-30T11:30:00-03:00\",\n \"scheduled_at\": \"2026-06-01T08:00:00-03:00\",\n \"failed_at\": \"2026-05-30T11:31:00-03:00\",\n \"reversed_at\": \"2026-05-31T09:00:00-03:00\",\n \"requested_by\": \"01JZWY347BXD9X4F294HTPX1VE\",\n \"approved_at\": \"2026-05-30T11:15:00-03:00\",\n \"approved_by\": \"01JZWY347BXD9X4F294HTPX1VE\",\n \"rejected_at\": \"2026-05-30T11:15:00-03:00\",\n \"rejected_by\": \"01JZWY347BXD9X4F294HTPX1VE\",\n \"expires_at\": \"2026-05-22T14:00:00-03:00\",\n \"expires_in_seconds\": 82800\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9ad3872d-8fe1-46e0-bab9-31e94ceb8eb8", "name": "Dados inválidos ou não informados", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "details" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "transaction_id", "description": "(Required) ID da transação a ser consultada" } ] }, "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 \"status_code\": 400,\n \"code\": \"INVALID_INPUT\",\n \"message\": \"Dados inválidos ou não informados\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 3405,\n \"key_1\": 1312.7345250032497,\n \"key_2\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9bb4adb2-79af-4a09-a5bf-4257f2ddc55b", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "details" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "transaction_id", "description": "(Required) ID da transação a ser consultada" } ] }, "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 \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "16e32b67-c4f6-4ff9-b792-ddf0ce60e819", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "details" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "transaction_id", "description": "(Required) ID da transação a ser consultada" } ] }, "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 \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0eec7ae3-7d1c-44dd-ac48-52163248452c", "name": "Transação não encontrada", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "details" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "transaction_id", "description": "(Required) ID da transação a ser consultada" } ] }, "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 \"status_code\": 404,\n \"code\": \"TRANSACTION_NOT_FOUND\",\n \"message\": \"Transação não encontrada\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 6851,\n \"key_1\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "00a1d1ce-a173-4780-a205-39e337c87a36", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "details" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "transaction_id", "description": "(Required) ID da transação a ser consultada" } ] }, "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0397d9c6-2003-491e-8912-a474abf919a0", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "transactions", ":transaction_id", "details" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "transaction_id", "description": "(Required) ID da transação a ser consultada" } ] }, "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "a7ef716f-0691-4529-a364-5625c0838348", "name": "Operações completas do ecossistema Pix na plataforma Meioo. Inclui gerenciamento de chaves, geração de QR Codes, transferências instantâneas e devoluções.", "description": { "content": "", "type": "text/plain" }, "item": [ { "id": "c685338f-4fc5-44ff-a623-de5a0122714f", "name": "Consultar chave Pix", "request": { "name": "Consultar chave Pix", "description": { "content": "Consulta uma chave Pix diretamente no DICT (Diretório de Identificadores de Contas Transacionais) do Banco Central. Útil para validar o destinatário antes de realizar uma transferência.\n\n**Tipos de chave suportados:**\n\n**CPF / CNPJ**\nDocumento do titular da conta (somente dígitos).\n\n**E-mail**\nEndereço de e-mail cadastrado como chave.\n\n**Telefone**\nNúmero no formato E.164: `+5511999990000`.\n\n**Chave aleatória (EVP)**\nUUID gerado pela plataforma, sem vínculo com dados pessoais.\n\n**Resposta:** Retorna os dados da conta associada à chave (titular, instituição, agência, conta). Chaves inativas ou não registradas no DICT retornam 404.", "type": "text/plain" }, "url": { "path": [ "accounts", "pix", "keys", "dict", ":key" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "pix_key", "value": "nome@email.com", "description": "(Required) Chave Pix a ser consultada no DICT" } ], "variable": [ { "disabled": false, "type": "any", "value": "usuario@meioo.com.br", "key": "key", "description": "(Required) Chave Pix a consultar no DICT (CPF/CNPJ, e-mail, telefone ou chave aleatória)" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "8a261410-c96e-4bb5-963c-e1e009811bc2", "name": "Chave ativa encontrada no DICT.", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", "dict", ":key" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "pix_key", "value": "nome@email.com" } ], "variable": [ { "disabled": false, "type": "any", "value": "usuario@meioo.com.br", "key": "key", "description": "(Required) Chave Pix a consultar no DICT (CPF/CNPJ, e-mail, telefone ou chave aleatória)" } ] }, "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 \"pix_key\": \"0fc8781d-3c1e-4b9b-bdb1-8fa34455799c\",\n \"pix_key_type\": \"CPF\",\n \"holder_name\": \"João da Silva\",\n \"ticket\": \"1b2eb2d5-d1ee-442c-a11c-d779e21321c9\",\n \"holder_document\": \"***456789**\",\n \"person_type\": \"INDIVIDUAL\",\n \"trade_name\": \"Meioo Pagamentos\",\n \"account\": {\n \"branch_code\": \"0001\",\n \"account_number\": \"1234567\",\n \"account_type\": \"CACC\"\n },\n \"bank\": {\n \"bank_name\": \"Banco Exemplo S.A.\",\n \"bank_code\": \"274\",\n \"bank_ispb\": \"11581339\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e7c98768-1ef1-4fef-b0f4-c639ee9abd4f", "name": "Formato de chave Pix inválido", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", "dict", ":key" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "pix_key", "value": "nome@email.com" } ], "variable": [ { "disabled": false, "type": "any", "value": "usuario@meioo.com.br", "key": "key", "description": "(Required) Chave Pix a consultar no DICT (CPF/CNPJ, e-mail, telefone ou chave aleatória)" } ] }, "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 \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Formato de chave Pix inválido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "35c6a783-8060-4eae-a218-3feb10bb83a9", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", "dict", ":key" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "pix_key", "value": "nome@email.com" } ], "variable": [ { "disabled": false, "type": "any", "value": "usuario@meioo.com.br", "key": "key", "description": "(Required) Chave Pix a consultar no DICT (CPF/CNPJ, e-mail, telefone ou chave aleatória)" } ] }, "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 \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d957b1f6-f12a-4263-8362-6868321ca48d", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", "dict", ":key" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "pix_key", "value": "nome@email.com" } ], "variable": [ { "disabled": false, "type": "any", "value": "usuario@meioo.com.br", "key": "key", "description": "(Required) Chave Pix a consultar no DICT (CPF/CNPJ, e-mail, telefone ou chave aleatória)" } ] }, "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 \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "816c7646-c6e4-47c9-96f9-bfdf5657badc", "name": "Chave Pix não encontrada no DICT ou inativa", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", "dict", ":key" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "pix_key", "value": "nome@email.com" } ], "variable": [ { "disabled": false, "type": "any", "value": "usuario@meioo.com.br", "key": "key", "description": "(Required) Chave Pix a consultar no DICT (CPF/CNPJ, e-mail, telefone ou chave aleatória)" } ] }, "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 \"status_code\": 404,\n \"code\": \"PIX_KEY_NOT_FOUND\",\n \"message\": \"Chave Pix não encontrada no DICT ou inativa\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": false,\n \"key_2\": 7812\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8281b584-f37d-433e-ae5f-93763d36f288", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", "dict", ":key" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "pix_key", "value": "nome@email.com" } ], "variable": [ { "disabled": false, "type": "any", "value": "usuario@meioo.com.br", "key": "key", "description": "(Required) Chave Pix a consultar no DICT (CPF/CNPJ, e-mail, telefone ou chave aleatória)" } ] }, "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "da5be988-988b-47f1-a16d-177ec446034a", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", "dict", ":key" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "pix_key", "value": "nome@email.com" } ], "variable": [ { "disabled": false, "type": "any", "value": "usuario@meioo.com.br", "key": "key", "description": "(Required) Chave Pix a consultar no DICT (CPF/CNPJ, e-mail, telefone ou chave aleatória)" } ] }, "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5b6aa50f-3fba-43f4-8581-0400b1071098", "name": "Cadastrar chave Pix", "request": { "name": "Cadastrar chave Pix", "description": { "content": "Registra uma nova chave Pix para a conta autenticada no DICT do Banco Central. A chave fica disponível para recebimento de transferências Pix após o registro.\n\n**Tipos de chave disponíveis:**\n\n**CPF / CNPJ**\nVincula o documento do titular à conta. Cada CPF/CNPJ pode ter uma única chave por tipo de conta.\n\n**E-mail**\nDeve ser confirmado via código de verificação.\n\n**Telefone**\nNúmero no formato E.164 (`+5511999990000`). Deve ser confirmado via SMS.\n\n**Chave aleatória (EVP)**\nGerada automaticamente pela plataforma. Não requer confirmação.\n\n**Fluxo com MFA:** Para tipos que exigem confirmação, solicite o código via `POST /accounts/pix/mfa` antes de registrar a chave.", "type": "text/plain" }, "url": { "path": [ "accounts", "pix", "keys" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "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 \"pix_key_type\": \"CPF\",\n \"pix_key\": \"+5511999998888\",\n \"auth_code\": \"123456\",\n \"mfa_code\": \"123456\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "96a5cbef-9139-4bf0-9c16-5ccf0f22c33d", "name": "Chave Pix registrada com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"pix_key_type\": \"CPF\",\n \"pix_key\": \"+5511999998888\",\n \"auth_code\": \"123456\",\n \"mfa_code\": \"123456\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "39b2b67e-48df-45a9-a31f-f396a3b79983", "name": "Formato de chave inválido ou dados incompletos", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"pix_key_type\": \"CPF\",\n \"pix_key\": \"+5511999998888\",\n \"auth_code\": \"123456\",\n \"mfa_code\": \"123456\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Formato de chave inválido ou dados incompletos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e1a2d031-c12e-4827-9b44-028748c152b6", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"pix_key_type\": \"CPF\",\n \"pix_key\": \"+5511999998888\",\n \"auth_code\": \"123456\",\n \"mfa_code\": \"123456\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2a69d125-df1c-4e32-852e-bf7c5c1c67c2", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"pix_key_type\": \"CPF\",\n \"pix_key\": \"+5511999998888\",\n \"auth_code\": \"123456\",\n \"mfa_code\": \"123456\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "23c419e0-78eb-4ae9-9377-f01eb42d306b", "name": "Chave Pix já cadastrada nesta ou em outra conta", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"pix_key_type\": \"CPF\",\n \"pix_key\": \"+5511999998888\",\n \"auth_code\": \"123456\",\n \"mfa_code\": \"123456\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 409,\n \"code\": \"PIX_KEY_ALREADY_EXISTS\",\n \"message\": \"Chave Pix já cadastrada nesta ou em outra conta\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5659,\n \"key_1\": 868.2550899398777\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b8225d42-83d3-410a-90f3-6bbec12f2e6a", "name": "Limite máximo de chaves Pix para esta conta atingido", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"pix_key_type\": \"CPF\",\n \"pix_key\": \"+5511999998888\",\n \"auth_code\": \"123456\",\n \"mfa_code\": \"123456\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 422,\n \"code\": \"PIX_KEY_LIMIT_REACHED\",\n \"message\": \"Limite máximo de chaves Pix para esta conta atingido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5955.029482472767\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1b1281af-5d71-4284-8f44-047d22d687ab", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"pix_key_type\": \"CPF\",\n \"pix_key\": \"+5511999998888\",\n \"auth_code\": \"123456\",\n \"mfa_code\": \"123456\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c37c40fe-b2ef-4f91-87e7-3012b350b857", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"pix_key_type\": \"CPF\",\n \"pix_key\": \"+5511999998888\",\n \"auth_code\": \"123456\",\n \"mfa_code\": \"123456\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4cc5172b-d25d-4c8b-a6fc-a527249b9ad8", "name": "Listar chaves Pix", "request": { "name": "Listar chaves Pix", "description": { "content": "Retorna todas as chaves Pix cadastradas para a conta autenticada. A conta é identificada pelo token Bearer — nenhum parâmetro adicional é necessário.\n\n**Informações retornadas por chave:**\n• Tipo e valor da chave\n• Status (ativa, pendente de confirmação, removida)\n• Data de cadastro", "type": "text/plain" }, "url": { "path": [ "accounts", "pix", "keys" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "d4c03188-c56f-4f3e-9cde-73e8d06a89a5", "name": "Lista de chaves Pix retornada com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys" ], "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 {\n \"pix_key\": \"0fc8781d-3c1e-4b9b-bdb1-8fa34455799c\",\n \"pix_key_type\": \"EVP\",\n \"holder_name\": \"João da Silva\",\n \"holder_document\": \"858.***.***-40\",\n \"person_type\": \"INDIVIDUAL\",\n \"pix_emv\": \"00020126580014BR.GOV.BCB.PIX...\",\n \"pix_qr_code\": \"data:image/png;base64,iVBORw0KGgo...\"\n },\n {\n \"pix_key\": \"0fc8781d-3c1e-4b9b-bdb1-8fa34455799c\",\n \"pix_key_type\": \"EVP\",\n \"holder_name\": \"João da Silva\",\n \"holder_document\": \"858.***.***-40\",\n \"person_type\": \"INDIVIDUAL\",\n \"pix_emv\": \"00020126580014BR.GOV.BCB.PIX...\",\n \"pix_qr_code\": \"data:image/png;base64,iVBORw0KGgo...\"\n }\n]", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "78f521ec-f2c4-4c24-933d-4242ee771ab7", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys" ], "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": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "827af598-6899-49e5-ab50-bf15fe06f309", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys" ], "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 \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7460ebaf-43d8-40b1-b19f-ff967e7012e1", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys" ], "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 \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "23d6757e-61ab-48b6-9891-4dd524cf7441", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys" ], "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "54e872ad-98ac-440e-9598-297616aa09f8", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys" ], "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f1217e1c-dae7-4d76-969e-2d8d720820b7", "name": "Excluir chave Pix", "request": { "name": "Excluir chave Pix", "description": { "content": "Remove uma chave Pix da conta, excluindo seu registro do DICT do Banco Central. Após a remoção, transferências enviadas para esta chave serão recusadas pelo DICT.\n\n**Importante:**\n• A remoção é imediata e irreversível\n• QR Codes estáticos vinculados à chave removida deixam de funcionar\n• A chave poderá ser recadastrada posteriormente, se necessário", "type": "text/plain" }, "url": { "path": [ "accounts", "pix", "keys", ":pix_key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "nome@email.com", "key": "pix_key", "description": "(Required) Chave Pix a ser removida (valor da chave, não o ID)" } ] }, "header": [ { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "29ab374a-db84-40e5-ae89-dd5c26159393", "name": "Chave Pix removida com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", ":pix_key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "nome@email.com", "key": "pix_key", "description": "(Required) Chave Pix a ser removida (valor da chave, não o ID)" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "c4e5ff03-063f-4f56-bde3-fcf32edb03ee", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", ":pix_key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "nome@email.com", "key": "pix_key", "description": "(Required) Chave Pix a ser removida (valor da chave, não o ID)" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1ce19b82-40f7-4aa5-b433-bf2ee14fdd03", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", ":pix_key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "nome@email.com", "key": "pix_key", "description": "(Required) Chave Pix a ser removida (valor da chave, não o ID)" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d6ba7b13-78a2-4438-861f-12929a0ce21f", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", ":pix_key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "nome@email.com", "key": "pix_key", "description": "(Required) Chave Pix a ser removida (valor da chave, não o ID)" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "245fa04c-62c2-411f-94f9-eb542f880915", "name": "Chave Pix não encontrada ou não pertence à conta", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", ":pix_key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "nome@email.com", "key": "pix_key", "description": "(Required) Chave Pix a ser removida (valor da chave, não o ID)" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 404,\n \"code\": \"PIX_KEY_NOT_FOUND\",\n \"message\": \"Chave Pix não encontrada ou não pertence à conta\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 2130.65503007414,\n \"key_2\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "31c9b0ba-085a-4a54-a2c0-7319253a4729", "name": "Chave não pode ser removida no estado atual", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", ":pix_key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "nome@email.com", "key": "pix_key", "description": "(Required) Chave Pix a ser removida (valor da chave, não o ID)" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "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 \"status_code\": 422,\n \"code\": \"PIX_KEY_REMOVAL_NOT_ALLOWED\",\n \"message\": \"Chave não pode ser removida no estado atual\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dfc3fb37-0f34-400a-a12e-8982c2ac0227", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", ":pix_key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "nome@email.com", "key": "pix_key", "description": "(Required) Chave Pix a ser removida (valor da chave, não o ID)" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "85b2f99c-b5ea-40a1-b50f-f6af63ceb964", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", ":pix_key" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "nome@email.com", "key": "pix_key", "description": "(Required) Chave Pix a ser removida (valor da chave, não o ID)" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "d084ef1d-adc2-4429-80b7-b87e0c96f959", "name": "Gerar QR Code de chave Pix", "request": { "name": "Gerar QR Code de chave Pix", "description": { "content": "Gera ou regenera o QR Code estático associado a uma chave Pix existente da conta. Útil para chaves que foram criadas sem QR Code ou para atualizar o QR Code após alterações.\n\n**Comportamento:**\n• Se a chave já possui QR Code, ele é regenerado e atualizado\n• Se a chave não possui QR Code, um novo é gerado e associado\n• A chave deve pertencer à conta autenticada\n\n**Retorno:** Dados da chave com `pix_emv` (payload copia e cola) e `pix_qr_code` (imagem em base64 PNG).", "type": "text/plain" }, "url": { "path": [ "accounts", "pix", "keys", ":pix_key", "qrcode" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "0fc8781d-3c1e-4b9b-bdb1-8fa34455799c", "key": "pix_key", "description": "(Required) Valor da chave Pix (CPF, CNPJ, e-mail, telefone ou UUID)" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "e423e258-2a59-40f2-a0a4-b4aab9aac607", "name": "QR Code gerado com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", ":pix_key", "qrcode" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "0fc8781d-3c1e-4b9b-bdb1-8fa34455799c", "key": "pix_key", "description": "(Required) Valor da chave Pix (CPF, CNPJ, e-mail, telefone ou UUID)" } ] }, "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 \"pix_key\": \"0fc8781d-3c1e-4b9b-bdb1-8fa34455799c\",\n \"pix_key_type\": \"EVP\",\n \"pix_emv\": \"00020126580014BR.GOV.BCB.PIX...\",\n \"pix_qr_code\": \"data:image/png;base64,iVBORw0KGgo...\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "954fb096-763b-4e7a-9d78-c23dbaa02af3", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", ":pix_key", "qrcode" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "0fc8781d-3c1e-4b9b-bdb1-8fa34455799c", "key": "pix_key", "description": "(Required) Valor da chave Pix (CPF, CNPJ, e-mail, telefone ou UUID)" } ] }, "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 Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "18c6ccc3-30c1-46dc-afe1-9578aa044815", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", ":pix_key", "qrcode" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "0fc8781d-3c1e-4b9b-bdb1-8fa34455799c", "key": "pix_key", "description": "(Required) Valor da chave Pix (CPF, CNPJ, e-mail, telefone ou UUID)" } ] }, "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 \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7153025e-a924-4c7a-8130-0e04e27d7736", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", ":pix_key", "qrcode" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "0fc8781d-3c1e-4b9b-bdb1-8fa34455799c", "key": "pix_key", "description": "(Required) Valor da chave Pix (CPF, CNPJ, e-mail, telefone ou UUID)" } ] }, "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 \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b79ce640-0af9-4f91-9675-167113d2f3b6", "name": "Chave Pix não encontrada para esta conta", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", ":pix_key", "qrcode" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "0fc8781d-3c1e-4b9b-bdb1-8fa34455799c", "key": "pix_key", "description": "(Required) Valor da chave Pix (CPF, CNPJ, e-mail, telefone ou UUID)" } ] }, "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 \"status_code\": 404,\n \"code\": \"PIX_KEY_NOT_FOUND\",\n \"message\": \"Chave Pix não encontrada para esta conta\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "44559c96-da46-4900-9a1e-3e007dde065d", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", ":pix_key", "qrcode" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "0fc8781d-3c1e-4b9b-bdb1-8fa34455799c", "key": "pix_key", "description": "(Required) Valor da chave Pix (CPF, CNPJ, e-mail, telefone ou UUID)" } ] }, "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": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "19bb9b8e-8605-4d72-ac99-aa3fa1cb1667", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "pix", "keys", ":pix_key", "qrcode" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "0fc8781d-3c1e-4b9b-bdb1-8fa34455799c", "key": "pix_key", "description": "(Required) Valor da chave Pix (CPF, CNPJ, e-mail, telefone ou UUID)" } ] }, "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8fa8ba8c-9e3b-435e-9327-5cb18c03002c", "name": "Solicitar MFA para chave Pix", "request": { "name": "Solicitar MFA para chave Pix", "description": { "content": "Solicita o envio de um código de verificação (MFA) necessário para registrar chaves Pix que exigem confirmação, como e-mail e telefone.\n\n**Quando usar:**\n• Antes de registrar uma chave Pix do tipo e-mail ou telefone\n• O código recebido deve ser incluído no payload de `POST /accounts/pix/keys`\n\n**Canais de envio:**\n• E-mail: código enviado para o endereço informado\n• Telefone: código enviado via SMS para o número informado", "type": "text/plain" }, "url": { "path": [ "accounts", "pix", "mfa" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "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 \"type\": \"EMAIL\",\n \"send_to\": \"nome@email.com.br\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "d31b349b-aeea-4d6d-b8f4-e123e9dc95ca", "name": "Código de verificação enviado com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "pix", "mfa" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"EMAIL\",\n \"send_to\": \"nome@email.com.br\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"auth_code\": \"123456\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1aff7dd4-07cb-4713-8b4e-d4ef66e072ab", "name": "Tipo de chave inválido ou dados incorretos", "originalRequest": { "url": { "path": [ "accounts", "pix", "mfa" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"EMAIL\",\n \"send_to\": \"nome@email.com.br\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Tipo de chave inválido ou dados incorretos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 4893\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "92b7fff1-fd3f-481b-9197-ecf59fd695b6", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "pix", "mfa" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"EMAIL\",\n \"send_to\": \"nome@email.com.br\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a842d8fd-2396-4f40-87da-ac6a94c72181", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "pix", "mfa" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"EMAIL\",\n \"send_to\": \"nome@email.com.br\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3ef76262-005b-4787-8cc1-6c4db6115f4c", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "pix", "mfa" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"EMAIL\",\n \"send_to\": \"nome@email.com.br\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "23b175a3-ac97-4a48-9de3-425cb24c7103", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "pix", "mfa" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"EMAIL\",\n \"send_to\": \"nome@email.com.br\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "57259442-9f53-40e8-bfab-27688ea0c235", "name": "Criar QR-Code estático", "request": { "name": "Criar QR-Code estático", "description": { "content": "Gera um QR Code Pix estático, ideal para cobranças com valor fixo e recorrentes. O mesmo QR Code pode ser utilizado múltiplas vezes.\n\n**Características:**\n• Valor fixo definido na criação (ou sem valor, para o pagador preencher)\n• Reutilizável — pode ser pago quantas vezes for necessário\n• Sem data de vencimento\n• Ideal para: mensalidades, doações, cobranças recorrentes com valor fixo\n\n**Retorno:** Payload EMV do QR Code e imagem em base64 para exibição.", "type": "text/plain" }, "url": { "path": [ "accounts", "pix", "qrcodes", "static" ], "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 \"pix_key\": \"nome@email.com.br\",\n \"pix_key_type\": \"EMAIL\",\n \"amount\": 5000,\n \"txid\": \"9876543210123456744\",\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code estático\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "3cd0d400-89c7-4597-8d40-880670e60c16", "name": "QR Code estático gerado com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "static" ], "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 \"pix_key\": \"nome@email.com.br\",\n \"pix_key_type\": \"EMAIL\",\n \"amount\": 5000,\n \"txid\": \"9876543210123456744\",\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code estático\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"pix_emv\": \"00020126580014BR.GOV.BCB.PIX...\",\n \"pix_qr_code\": \"data:image/png;base64,iVBORw0KGgo...\",\n \"id\": \"01JY05224X1WGAH75F5404HXMF\",\n \"txid\": \"pixcobrança2026051401\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "68abb9f5-07ff-4b16-843d-6189f1b36944", "name": "Dados do QR Code inválidos", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "static" ], "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 \"pix_key\": \"nome@email.com.br\",\n \"pix_key_type\": \"EMAIL\",\n \"amount\": 5000,\n \"txid\": \"9876543210123456744\",\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code estático\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados do QR Code inválidos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 3300.351220205424,\n \"key_1\": 9695.756482887486\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "214e8a24-3a67-4c5c-bb50-caa521619a98", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "static" ], "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 \"pix_key\": \"nome@email.com.br\",\n \"pix_key_type\": \"EMAIL\",\n \"amount\": 5000,\n \"txid\": \"9876543210123456744\",\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code estático\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e13ff271-50e0-4e4b-8fad-77c7d7f73312", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "static" ], "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 \"pix_key\": \"nome@email.com.br\",\n \"pix_key_type\": \"EMAIL\",\n \"amount\": 5000,\n \"txid\": \"9876543210123456744\",\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code estático\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bbb2660a-15e1-48fc-91cc-629caba724a5", "name": "Nenhuma chave Pix ativa cadastrada para a conta", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "static" ], "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 \"pix_key\": \"nome@email.com.br\",\n \"pix_key_type\": \"EMAIL\",\n \"amount\": 5000,\n \"txid\": \"9876543210123456744\",\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code estático\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 422,\n \"code\": \"NO_PIX_KEY_REGISTERED\",\n \"message\": \"Nenhuma chave Pix ativa cadastrada para a conta\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5016.335262068578\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1c37e2e9-e2d9-43f9-9787-8d68c639fe24", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "static" ], "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 \"pix_key\": \"nome@email.com.br\",\n \"pix_key_type\": \"EMAIL\",\n \"amount\": 5000,\n \"txid\": \"9876543210123456744\",\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code estático\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6fb7ea32-7fa8-400d-9b6e-329c5949f8db", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "static" ], "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 \"pix_key\": \"nome@email.com.br\",\n \"pix_key_type\": \"EMAIL\",\n \"amount\": 5000,\n \"txid\": \"9876543210123456744\",\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code estático\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "609d7eee-9fe3-4219-899e-6bbe5b39e62a", "name": "Criar QR-Code dinâmico", "request": { "name": "Criar QR-Code dinâmico", "description": { "content": "Gera um QR Code Pix dinâmico para uma cobrança específica de uso único. Recomendado para transações individuais que exigem rastreabilidade.\n\n**Características:**\n• Uso único — expira após o primeiro pagamento ou na data definida\n• Permite identificar o pagador via campo de informação adicional\n• Rastreável por `txid` para conciliação automatizada\n• Suporta data e hora de expiração\n\n**Ideal para:** cobranças pontuais, e-commerce, checkouts.", "type": "text/plain" }, "url": { "path": [ "accounts", "pix", "qrcodes", "dynamic" ], "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 \"pix_key\": \"12345678900\",\n \"pix_key_type\": \"CPF\",\n \"txid\": \"01KH3JQFGK0HV3GMMAGX8V7XQE\",\n \"amount\": 5000,\n \"rebate_amount\": 5000,\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code dinâmico\",\n \"payer_name\": \"Fulano da Silva\",\n \"payer_document\": \"12345678900\",\n \"payer_type\": \"INDIVIDUAL\",\n \"expires_at\": \"2026-05-08T23:59:00-03:00\",\n \"expires_in\": 1800\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "a311a97a-672a-46d0-b70f-b929ec94f07d", "name": "QR Code dinâmico gerado com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "dynamic" ], "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 \"pix_key\": \"12345678900\",\n \"pix_key_type\": \"CPF\",\n \"txid\": \"01KH3JQFGK0HV3GMMAGX8V7XQE\",\n \"amount\": 5000,\n \"rebate_amount\": 5000,\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code dinâmico\",\n \"payer_name\": \"Fulano da Silva\",\n \"payer_document\": \"12345678900\",\n \"payer_type\": \"INDIVIDUAL\",\n \"expires_at\": \"2026-05-08T23:59:00-03:00\",\n \"expires_in\": 1800\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"pix_emv\": \"00020126580014BR.GOV.BCB.PIX...\",\n \"pix_qr_code\": \"data:image/png;base64,iVBORw0KGgo...\",\n \"id\": \"01JY05224X1WGAH75F5404HXMF\",\n \"txid\": \"pixcobrança2026051401\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "acffeae6-8216-4f65-aa65-57ca31d5e272", "name": "Dados do QR Code inválidos", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "dynamic" ], "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 \"pix_key\": \"12345678900\",\n \"pix_key_type\": \"CPF\",\n \"txid\": \"01KH3JQFGK0HV3GMMAGX8V7XQE\",\n \"amount\": 5000,\n \"rebate_amount\": 5000,\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code dinâmico\",\n \"payer_name\": \"Fulano da Silva\",\n \"payer_document\": \"12345678900\",\n \"payer_type\": \"INDIVIDUAL\",\n \"expires_at\": \"2026-05-08T23:59:00-03:00\",\n \"expires_in\": 1800\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados do QR Code inválidos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 3300.351220205424,\n \"key_1\": 9695.756482887486\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6646efea-60af-44f1-bba8-02101c44e754", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "dynamic" ], "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 \"pix_key\": \"12345678900\",\n \"pix_key_type\": \"CPF\",\n \"txid\": \"01KH3JQFGK0HV3GMMAGX8V7XQE\",\n \"amount\": 5000,\n \"rebate_amount\": 5000,\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code dinâmico\",\n \"payer_name\": \"Fulano da Silva\",\n \"payer_document\": \"12345678900\",\n \"payer_type\": \"INDIVIDUAL\",\n \"expires_at\": \"2026-05-08T23:59:00-03:00\",\n \"expires_in\": 1800\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "48293bb1-319f-406f-88e3-123a2558c821", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "dynamic" ], "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 \"pix_key\": \"12345678900\",\n \"pix_key_type\": \"CPF\",\n \"txid\": \"01KH3JQFGK0HV3GMMAGX8V7XQE\",\n \"amount\": 5000,\n \"rebate_amount\": 5000,\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code dinâmico\",\n \"payer_name\": \"Fulano da Silva\",\n \"payer_document\": \"12345678900\",\n \"payer_type\": \"INDIVIDUAL\",\n \"expires_at\": \"2026-05-08T23:59:00-03:00\",\n \"expires_in\": 1800\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ac1356c8-fad2-4d18-afab-20a0a60450be", "name": "Nenhuma chave Pix ativa cadastrada para a conta", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "dynamic" ], "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 \"pix_key\": \"12345678900\",\n \"pix_key_type\": \"CPF\",\n \"txid\": \"01KH3JQFGK0HV3GMMAGX8V7XQE\",\n \"amount\": 5000,\n \"rebate_amount\": 5000,\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code dinâmico\",\n \"payer_name\": \"Fulano da Silva\",\n \"payer_document\": \"12345678900\",\n \"payer_type\": \"INDIVIDUAL\",\n \"expires_at\": \"2026-05-08T23:59:00-03:00\",\n \"expires_in\": 1800\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 422,\n \"code\": \"NO_PIX_KEY_REGISTERED\",\n \"message\": \"Nenhuma chave Pix ativa cadastrada para a conta\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5016.335262068578\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8b0f99ed-c2f9-45ae-85a4-a0520d0dc759", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "dynamic" ], "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 \"pix_key\": \"12345678900\",\n \"pix_key_type\": \"CPF\",\n \"txid\": \"01KH3JQFGK0HV3GMMAGX8V7XQE\",\n \"amount\": 5000,\n \"rebate_amount\": 5000,\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code dinâmico\",\n \"payer_name\": \"Fulano da Silva\",\n \"payer_document\": \"12345678900\",\n \"payer_type\": \"INDIVIDUAL\",\n \"expires_at\": \"2026-05-08T23:59:00-03:00\",\n \"expires_in\": 1800\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "72a64ac4-ce69-45cd-b4ef-7a73ce78c8b0", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "dynamic" ], "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 \"pix_key\": \"12345678900\",\n \"pix_key_type\": \"CPF\",\n \"txid\": \"01KH3JQFGK0HV3GMMAGX8V7XQE\",\n \"amount\": 5000,\n \"rebate_amount\": 5000,\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code dinâmico\",\n \"payer_name\": \"Fulano da Silva\",\n \"payer_document\": \"12345678900\",\n \"payer_type\": \"INDIVIDUAL\",\n \"expires_at\": \"2026-05-08T23:59:00-03:00\",\n \"expires_in\": 1800\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b98f6f85-b069-4d0d-823a-14295d4b78c1", "name": "Criar QR-Code de cobrança", "request": { "name": "Criar QR-Code de cobrança", "description": { "content": "Gera um QR Code Pix de cobrança com suporte a regras financeiras avançadas: desconto por antecipação, multa e juros por atraso.\n\n**Recursos disponíveis:**\n\n**Desconto**\nRedução percentual ou valor fixo para pagamentos antecipados.\n\n**Multa por atraso**\nPercentual aplicado sobre o valor principal após o vencimento.\n\n**Juros**\nTaxa diária ou mensal aplicada após o vencimento.\n\n**Ideal para:** faturas, mensalidades com políticas de desconto e multa.", "type": "text/plain" }, "url": { "path": [ "accounts", "pix", "qrcodes", "billing" ], "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 \"pix_key\": \"12345678900\",\n \"pix_key_type\": \"CPF\",\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code estático\",\n \"amount\": 5000,\n \"rebate_amount\": 5000,\n \"payer_name\": \"Fulano da Silva\",\n \"payer_document\": \"12345678900\",\n \"payer_type\": \"INDIVIDUAL\",\n \"due_date\": \"2026-05-14\",\n \"discount\": {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"interest\": {\n \"code\": \"PERCENTAGE_PER_MONTH\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"fine\": {\n \"code\": \"PERCENTAGE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"txid\": \"pixcobrança20260514abcdefgh\",\n \"expires_at\": \"2026-05-08T23:59:00-03:00\",\n \"expires_in\": 86400\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "ace10e50-569d-4332-b79e-64cf134117ee", "name": "QR Code de cobrança gerado com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "billing" ], "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 \"pix_key\": \"12345678900\",\n \"pix_key_type\": \"CPF\",\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code estático\",\n \"amount\": 5000,\n \"rebate_amount\": 5000,\n \"payer_name\": \"Fulano da Silva\",\n \"payer_document\": \"12345678900\",\n \"payer_type\": \"INDIVIDUAL\",\n \"due_date\": \"2026-05-14\",\n \"discount\": {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"interest\": {\n \"code\": \"PERCENTAGE_PER_MONTH\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"fine\": {\n \"code\": \"PERCENTAGE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"txid\": \"pixcobrança20260514abcdefgh\",\n \"expires_at\": \"2026-05-08T23:59:00-03:00\",\n \"expires_in\": 86400\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"pix_emv\": \"00020126580014BR.GOV.BCB.PIX...\",\n \"pix_qr_code\": \"data:image/png;base64,iVBORw0KGgo...\",\n \"id\": \"01JY05224X1WGAH75F5404HXMF\",\n \"txid\": \"pixcobrança2026051401\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e115aff7-1b1d-4915-ba6b-c4670c4af38c", "name": "Dados da cobrança inválidos", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "billing" ], "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 \"pix_key\": \"12345678900\",\n \"pix_key_type\": \"CPF\",\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code estático\",\n \"amount\": 5000,\n \"rebate_amount\": 5000,\n \"payer_name\": \"Fulano da Silva\",\n \"payer_document\": \"12345678900\",\n \"payer_type\": \"INDIVIDUAL\",\n \"due_date\": \"2026-05-14\",\n \"discount\": {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"interest\": {\n \"code\": \"PERCENTAGE_PER_MONTH\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"fine\": {\n \"code\": \"PERCENTAGE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"txid\": \"pixcobrança20260514abcdefgh\",\n \"expires_at\": \"2026-05-08T23:59:00-03:00\",\n \"expires_in\": 86400\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados da cobrança inválidos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1816.214715365594,\n \"key_2\": 388.0545606436758\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c943c594-8f06-4bbd-bbf1-73c935469eec", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "billing" ], "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 \"pix_key\": \"12345678900\",\n \"pix_key_type\": \"CPF\",\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code estático\",\n \"amount\": 5000,\n \"rebate_amount\": 5000,\n \"payer_name\": \"Fulano da Silva\",\n \"payer_document\": \"12345678900\",\n \"payer_type\": \"INDIVIDUAL\",\n \"due_date\": \"2026-05-14\",\n \"discount\": {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"interest\": {\n \"code\": \"PERCENTAGE_PER_MONTH\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"fine\": {\n \"code\": \"PERCENTAGE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"txid\": \"pixcobrança20260514abcdefgh\",\n \"expires_at\": \"2026-05-08T23:59:00-03:00\",\n \"expires_in\": 86400\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "539470db-c29d-473a-b571-bc9ceea83ff5", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "billing" ], "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 \"pix_key\": \"12345678900\",\n \"pix_key_type\": \"CPF\",\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code estático\",\n \"amount\": 5000,\n \"rebate_amount\": 5000,\n \"payer_name\": \"Fulano da Silva\",\n \"payer_document\": \"12345678900\",\n \"payer_type\": \"INDIVIDUAL\",\n \"due_date\": \"2026-05-14\",\n \"discount\": {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"interest\": {\n \"code\": \"PERCENTAGE_PER_MONTH\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"fine\": {\n \"code\": \"PERCENTAGE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"txid\": \"pixcobrança20260514abcdefgh\",\n \"expires_at\": \"2026-05-08T23:59:00-03:00\",\n \"expires_in\": 86400\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e3712980-3dfb-4b4b-aa99-dd6a6ddcccaf", "name": "Nenhuma chave Pix ativa cadastrada para a conta", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "billing" ], "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 \"pix_key\": \"12345678900\",\n \"pix_key_type\": \"CPF\",\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code estático\",\n \"amount\": 5000,\n \"rebate_amount\": 5000,\n \"payer_name\": \"Fulano da Silva\",\n \"payer_document\": \"12345678900\",\n \"payer_type\": \"INDIVIDUAL\",\n \"due_date\": \"2026-05-14\",\n \"discount\": {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"interest\": {\n \"code\": \"PERCENTAGE_PER_MONTH\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"fine\": {\n \"code\": \"PERCENTAGE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"txid\": \"pixcobrança20260514abcdefgh\",\n \"expires_at\": \"2026-05-08T23:59:00-03:00\",\n \"expires_in\": 86400\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 422,\n \"code\": \"NO_PIX_KEY_REGISTERED\",\n \"message\": \"Nenhuma chave Pix ativa cadastrada para a conta\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5016.335262068578\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5fdd5644-5a20-4eb5-b9b9-fe14ebcec8c0", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "billing" ], "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 \"pix_key\": \"12345678900\",\n \"pix_key_type\": \"CPF\",\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code estático\",\n \"amount\": 5000,\n \"rebate_amount\": 5000,\n \"payer_name\": \"Fulano da Silva\",\n \"payer_document\": \"12345678900\",\n \"payer_type\": \"INDIVIDUAL\",\n \"due_date\": \"2026-05-14\",\n \"discount\": {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"interest\": {\n \"code\": \"PERCENTAGE_PER_MONTH\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"fine\": {\n \"code\": \"PERCENTAGE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"txid\": \"pixcobrança20260514abcdefgh\",\n \"expires_at\": \"2026-05-08T23:59:00-03:00\",\n \"expires_in\": 86400\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fbf6058f-5715-47dc-8b1e-a8cb3d5b88a2", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", "billing" ], "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 \"pix_key\": \"12345678900\",\n \"pix_key_type\": \"CPF\",\n \"reference_id\": \"26f35e64-1832-42ca-913f-9338b25a7118\",\n \"additional_info\": \"Pagamento via Qr-Code estático\",\n \"amount\": 5000,\n \"rebate_amount\": 5000,\n \"payer_name\": \"Fulano da Silva\",\n \"payer_document\": \"12345678900\",\n \"payer_type\": \"INDIVIDUAL\",\n \"due_date\": \"2026-05-14\",\n \"discount\": {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"interest\": {\n \"code\": \"PERCENTAGE_PER_MONTH\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"fine\": {\n \"code\": \"PERCENTAGE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"txid\": \"pixcobrança20260514abcdefgh\",\n \"expires_at\": \"2026-05-08T23:59:00-03:00\",\n \"expires_in\": 86400\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f5511278-d477-408e-9bdf-7e18c1dbb733", "name": "Ler QR-Code", "request": { "name": "Ler QR-Code", "description": { "content": "Decodifica o payload EMV de um QR Code Pix e retorna as informações da cobrança associada. Utilize antes de confirmar um pagamento para exibir os dados ao usuário.\n\n**Informações retornadas:**\n• Dados do recebedor (nome, CPF/CNPJ, instituição)\n• Valor e tipo (estático, dinâmico ou cobrança)\n• Data de vencimento, quando aplicável\n• `txid` para rastreamento da transação\n\n**Parâmetro `emv`:** String completa do payload EMV do QR Code lido pelo dispositivo.", "type": "text/plain" }, "url": { "path": [ "accounts", "pix", "qrcodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "emv", "value": "00020126580014br.gov.bcb.pix0136123e4567-e12b-12d1-a456-426655440000...", "description": "(Required) Payload EMV completo do QR Code Pix" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "6499f51e-10a7-4b76-aa30-5cb0b17621c2", "name": "QR Code decodificado com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "emv", "value": "00020126580014br.gov.bcb.pix0136123e4567-e12b-12d1-a456-426655440000..." } ], "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 \"read_id\": \"01JY05224X1WGAH75F5404HXMF\",\n \"qrcode_type\": \"DYNAMIC\",\n \"pix_key\": \"joao.silva@exemplo.com\",\n \"reusable\": false,\n \"amount\": 15000,\n \"txid\": \"pixcobrança2026051401\",\n \"holder_document\": \"12345678900\",\n \"additional_info\": \"Pagamento ref #12345\",\n \"merchant_name\": \"Meioo Pagamentos\",\n \"merchant_city\": \"Sao Paulo\",\n \"url\": \"https://qr.cornerpix.com.br/...\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b19fbb94-2489-4f7a-9f31-c7a5f0aa9c11", "name": "Payload EMV inválido ou mal formatado", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "emv", "value": "00020126580014br.gov.bcb.pix0136123e4567-e12b-12d1-a456-426655440000..." } ], "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 \"status_code\": 400,\n \"code\": \"INVALID_QR_CODE\",\n \"message\": \"Payload EMV inválido ou mal formatado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5780,\n \"key_1\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4493e399-a5fe-4b2a-9633-4076ac632403", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "emv", "value": "00020126580014br.gov.bcb.pix0136123e4567-e12b-12d1-a456-426655440000..." } ], "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 \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "561fff79-806d-466a-9c3c-213567ae1c5e", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "emv", "value": "00020126580014br.gov.bcb.pix0136123e4567-e12b-12d1-a456-426655440000..." } ], "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 \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "55b8476d-bbc2-43e2-8f44-75e7e2ded738", "name": "QR Code expirado ou já utilizado", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "emv", "value": "00020126580014br.gov.bcb.pix0136123e4567-e12b-12d1-a456-426655440000..." } ], "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 \"status_code\": 422,\n \"code\": \"QR_CODE_EXPIRED\",\n \"message\": \"QR Code expirado ou já utilizado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true,\n \"key_2\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6a9f227e-e07b-4a34-96a5-7c2bf4be61f6", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "emv", "value": "00020126580014br.gov.bcb.pix0136123e4567-e12b-12d1-a456-426655440000..." } ], "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "593d1801-ce5e-4674-99b5-13a7395529df", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "emv", "value": "00020126580014br.gov.bcb.pix0136123e4567-e12b-12d1-a456-426655440000..." } ], "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2f6d9dd3-29f1-4113-9dd1-f53a2a54b5f3", "name": "Consultar situação de QR-Code", "request": { "name": "Consultar situação de QR-Code", "description": { "content": "Consulta o status atual de um QR Code gerado pela plataforma Meioo a partir do seu ID interno. Permite verificar se o QR Code foi pago, está pendente ou expirou.\n\n**Status possíveis:**\n\n**ACTIVE**\nAguardando pagamento.\n\n**PAID**\nPagamento confirmado. Inclui dados da transação liquidada.\n\n**EXPIRED**\nPrazo de validade encerrado sem pagamento.\n\n**O `id`** é retornado no campo `id` da resposta dos endpoints de criação de QR Code.", "type": "text/plain" }, "url": { "path": [ "accounts", "pix", "qrcodes", ":id", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID interno do QR Code (retornado na criação)" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "75d701ce-8a95-42b0-8f74-3636370f5ac6", "name": "Status do QR Code retornado com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", ":id", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID interno do QR Code (retornado na criação)" } ] }, "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\": \"01JY05224X1WGAH75F5404HXMF\",\n \"qrcode_type\": \"DYNAMIC\",\n \"txid\": \"pixcobrança2026051401\",\n \"status\": \"ACTIVE\",\n \"amount\": 15000,\n \"pix_key\": \"joao.silva@exemplo.com\",\n \"additional_info\": \"Pagamento ref #12345\",\n \"reference_id\": \"REF-20260514-001\",\n \"payer_name\": \"Ana Carolina Lima\",\n \"payer_document\": \"00011122233\",\n \"paid_amount\": 15000,\n \"paid_at\": \"2026-05-14T14:30:00-03:00\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "08f9b8d0-1331-410c-9bd2-0102fd1f6d75", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", ":id", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID interno do QR Code (retornado na criação)" } ] }, "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 \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "971ebd96-c1a0-4411-8960-2d6a56b88d96", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", ":id", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID interno do QR Code (retornado na criação)" } ] }, "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 \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c77847c8-7f2b-4adf-9f64-2b2779e94f8b", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", ":id", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID interno do QR Code (retornado na criação)" } ] }, "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 \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2680bfcb-8da7-4a63-a555-f230d9ef56b8", "name": "QR Code não encontrado ou não pertence à conta", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", ":id", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID interno do QR Code (retornado na criação)" } ] }, "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 \"status_code\": 404,\n \"code\": \"QR_CODE_NOT_FOUND\",\n \"message\": \"QR Code não encontrado ou não pertence à conta\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4968.003835962322,\n \"key_1\": 8355.238763800755\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8fb1207f-2fce-43da-8ee9-10e42d7856a2", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", ":id", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID interno do QR Code (retornado na criação)" } ] }, "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3e8ae3e5-0c74-4dfc-b43e-9b9759d780b3", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "pix", "qrcodes", ":id", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID interno do QR Code (retornado na criação)" } ] }, "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "11b3b8a7-cc94-4a40-995c-2f83efa8b410", "name": "Transferir via Pix", "request": { "name": "Transferir via Pix", "description": { "content": "Realiza uma transferência instantânea via Pix. A liquidação ocorre em tempo real, 24 horas por dia, 7 dias por semana.\n\n**Formas de endereçamento:**\n\n**Por chave Pix**\nCPF, CNPJ, e-mail, telefone ou chave aleatória do destinatário.\n\n**Por QR Code**\nPayload EMV lido e validado via `GET /accounts/pix/qrcodes`.\n\n**Dados bancários**\nAgência, conta, tipo de conta e ISPB da instituição destinatária.\n\n**SLA de liquidação:** Máximo de 10 segundos conforme regulação BACEN.\n\n**Fluxo de aprovação:**\nA transação é criada com status `AWAITING_APPROVAL`. A aprovação deve ser feita via `PATCH /accounts/approvals/transactions/{id}` com autenticação step-up.", "type": "text/plain" }, "url": { "path": [ "accounts", "pix", "transfers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "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 \"pix_transfer_type\": \"KEY\",\n \"pix_key\": \"000.000.000-00\",\n \"pix_qrcode_emv\": \"00020126850014BR.GOV.BCB.PIX2563qr.cornerpix.com.br/new/11581339/v2/cobv/d8z7CCHxatKYreSvrw3UpE5204000053039865802BR5914BMP Money Plus6009SAO PAULO62070503***63046FE1\",\n \"pix_account\": {\n \"holder_name\": \"Fulano da Silva\",\n \"holder_document\": \"12345678900\",\n \"branch_code\": \"0001\",\n \"account_number\": \"02381705\",\n \"ispb\": \"11581339\",\n \"account_type\": \"PAYMENT\",\n \"branch_digit\": \"8\",\n \"account_digit\": \"5\",\n \"account_model\": \"MOVEMENT\"\n },\n \"amount\": 5313.71765446526,\n \"reference_id\": \"21a888e9-e36b-47ef-b365-5268314a04d0\",\n \"description\": \"Pagamento de contas\",\n \"additional_info\": \"Transferência Pix\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "1180509d-b2b6-4a31-a0c1-8858bf7babc2", "name": "Transferência Pix realizada com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "pix", "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"pix_transfer_type\": \"KEY\",\n \"pix_key\": \"000.000.000-00\",\n \"pix_qrcode_emv\": \"00020126850014BR.GOV.BCB.PIX2563qr.cornerpix.com.br/new/11581339/v2/cobv/d8z7CCHxatKYreSvrw3UpE5204000053039865802BR5914BMP Money Plus6009SAO PAULO62070503***63046FE1\",\n \"pix_account\": {\n \"holder_name\": \"Fulano da Silva\",\n \"holder_document\": \"12345678900\",\n \"branch_code\": \"0001\",\n \"account_number\": \"02381705\",\n \"ispb\": \"11581339\",\n \"account_type\": \"PAYMENT\",\n \"branch_digit\": \"8\",\n \"account_digit\": \"5\",\n \"account_model\": \"MOVEMENT\"\n },\n \"amount\": 5313.71765446526,\n \"reference_id\": \"21a888e9-e36b-47ef-b365-5268314a04d0\",\n \"description\": \"Pagamento de contas\",\n \"additional_info\": \"Transferência Pix\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"01JXYZ...\",\n \"type\": \"PIX\",\n \"status\": \"PENDING\",\n \"amount\": 10000,\n \"occurred_at\": \"2026-05-14T14:00:00-03:00\",\n \"fee_amount\": 50\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1eedcc0d-830c-474c-9179-517f47d8dadd", "name": "Dados da transferência inválidos ou incompletos", "originalRequest": { "url": { "path": [ "accounts", "pix", "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"pix_transfer_type\": \"KEY\",\n \"pix_key\": \"000.000.000-00\",\n \"pix_qrcode_emv\": \"00020126850014BR.GOV.BCB.PIX2563qr.cornerpix.com.br/new/11581339/v2/cobv/d8z7CCHxatKYreSvrw3UpE5204000053039865802BR5914BMP Money Plus6009SAO PAULO62070503***63046FE1\",\n \"pix_account\": {\n \"holder_name\": \"Fulano da Silva\",\n \"holder_document\": \"12345678900\",\n \"branch_code\": \"0001\",\n \"account_number\": \"02381705\",\n \"ispb\": \"11581339\",\n \"account_type\": \"PAYMENT\",\n \"branch_digit\": \"8\",\n \"account_digit\": \"5\",\n \"account_model\": \"MOVEMENT\"\n },\n \"amount\": 5313.71765446526,\n \"reference_id\": \"21a888e9-e36b-47ef-b365-5268314a04d0\",\n \"description\": \"Pagamento de contas\",\n \"additional_info\": \"Transferência Pix\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados da transferência inválidos ou incompletos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 2915.2737104598937,\n \"key_1\": 6322.163170310378,\n \"key_2\": 5153.476386524771\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5a53f384-1892-457f-a556-9e11ee7e5a8e", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "pix", "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"pix_transfer_type\": \"KEY\",\n \"pix_key\": \"000.000.000-00\",\n \"pix_qrcode_emv\": \"00020126850014BR.GOV.BCB.PIX2563qr.cornerpix.com.br/new/11581339/v2/cobv/d8z7CCHxatKYreSvrw3UpE5204000053039865802BR5914BMP Money Plus6009SAO PAULO62070503***63046FE1\",\n \"pix_account\": {\n \"holder_name\": \"Fulano da Silva\",\n \"holder_document\": \"12345678900\",\n \"branch_code\": \"0001\",\n \"account_number\": \"02381705\",\n \"ispb\": \"11581339\",\n \"account_type\": \"PAYMENT\",\n \"branch_digit\": \"8\",\n \"account_digit\": \"5\",\n \"account_model\": \"MOVEMENT\"\n },\n \"amount\": 5313.71765446526,\n \"reference_id\": \"21a888e9-e36b-47ef-b365-5268314a04d0\",\n \"description\": \"Pagamento de contas\",\n \"additional_info\": \"Transferência Pix\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5bbbe972-24b7-44dd-8584-c969e61bd57b", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "pix", "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"pix_transfer_type\": \"KEY\",\n \"pix_key\": \"000.000.000-00\",\n \"pix_qrcode_emv\": \"00020126850014BR.GOV.BCB.PIX2563qr.cornerpix.com.br/new/11581339/v2/cobv/d8z7CCHxatKYreSvrw3UpE5204000053039865802BR5914BMP Money Plus6009SAO PAULO62070503***63046FE1\",\n \"pix_account\": {\n \"holder_name\": \"Fulano da Silva\",\n \"holder_document\": \"12345678900\",\n \"branch_code\": \"0001\",\n \"account_number\": \"02381705\",\n \"ispb\": \"11581339\",\n \"account_type\": \"PAYMENT\",\n \"branch_digit\": \"8\",\n \"account_digit\": \"5\",\n \"account_model\": \"MOVEMENT\"\n },\n \"amount\": 5313.71765446526,\n \"reference_id\": \"21a888e9-e36b-47ef-b365-5268314a04d0\",\n \"description\": \"Pagamento de contas\",\n \"additional_info\": \"Transferência Pix\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3ce1b829-dce6-434b-a2de-37e8296ce315", "name": "Chave Pix do destinatário não encontrada no DICT", "originalRequest": { "url": { "path": [ "accounts", "pix", "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"pix_transfer_type\": \"KEY\",\n \"pix_key\": \"000.000.000-00\",\n \"pix_qrcode_emv\": \"00020126850014BR.GOV.BCB.PIX2563qr.cornerpix.com.br/new/11581339/v2/cobv/d8z7CCHxatKYreSvrw3UpE5204000053039865802BR5914BMP Money Plus6009SAO PAULO62070503***63046FE1\",\n \"pix_account\": {\n \"holder_name\": \"Fulano da Silva\",\n \"holder_document\": \"12345678900\",\n \"branch_code\": \"0001\",\n \"account_number\": \"02381705\",\n \"ispb\": \"11581339\",\n \"account_type\": \"PAYMENT\",\n \"branch_digit\": \"8\",\n \"account_digit\": \"5\",\n \"account_model\": \"MOVEMENT\"\n },\n \"amount\": 5313.71765446526,\n \"reference_id\": \"21a888e9-e36b-47ef-b365-5268314a04d0\",\n \"description\": \"Pagamento de contas\",\n \"additional_info\": \"Transferência Pix\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 404,\n \"code\": \"PIX_KEY_NOT_FOUND\",\n \"message\": \"Chave Pix do destinatário não encontrada no DICT\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 2866,\n \"key_2\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2dabb7bf-7dcd-42d0-adc1-cb1d8a2a1224", "name": "Já existe uma transação com o mesmo reference_id para esta conta, ou a chave de idempotência já foi utilizada", "originalRequest": { "url": { "path": [ "accounts", "pix", "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"pix_transfer_type\": \"KEY\",\n \"pix_key\": \"000.000.000-00\",\n \"pix_qrcode_emv\": \"00020126850014BR.GOV.BCB.PIX2563qr.cornerpix.com.br/new/11581339/v2/cobv/d8z7CCHxatKYreSvrw3UpE5204000053039865802BR5914BMP Money Plus6009SAO PAULO62070503***63046FE1\",\n \"pix_account\": {\n \"holder_name\": \"Fulano da Silva\",\n \"holder_document\": \"12345678900\",\n \"branch_code\": \"0001\",\n \"account_number\": \"02381705\",\n \"ispb\": \"11581339\",\n \"account_type\": \"PAYMENT\",\n \"branch_digit\": \"8\",\n \"account_digit\": \"5\",\n \"account_model\": \"MOVEMENT\"\n },\n \"amount\": 5313.71765446526,\n \"reference_id\": \"21a888e9-e36b-47ef-b365-5268314a04d0\",\n \"description\": \"Pagamento de contas\",\n \"additional_info\": \"Transferência Pix\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 409,\n \"code\": \"RESOURCE_CONFLICT\",\n \"message\": \"Já existe uma transação com o mesmo reference_id para esta conta, ou a chave de idempotência já foi utilizada\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 2211.3957762870464\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "49de130f-5356-41c2-9360-0b56069c9025", "name": "Limite diário de transferências Pix atingido", "originalRequest": { "url": { "path": [ "accounts", "pix", "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"pix_transfer_type\": \"KEY\",\n \"pix_key\": \"000.000.000-00\",\n \"pix_qrcode_emv\": \"00020126850014BR.GOV.BCB.PIX2563qr.cornerpix.com.br/new/11581339/v2/cobv/d8z7CCHxatKYreSvrw3UpE5204000053039865802BR5914BMP Money Plus6009SAO PAULO62070503***63046FE1\",\n \"pix_account\": {\n \"holder_name\": \"Fulano da Silva\",\n \"holder_document\": \"12345678900\",\n \"branch_code\": \"0001\",\n \"account_number\": \"02381705\",\n \"ispb\": \"11581339\",\n \"account_type\": \"PAYMENT\",\n \"branch_digit\": \"8\",\n \"account_digit\": \"5\",\n \"account_model\": \"MOVEMENT\"\n },\n \"amount\": 5313.71765446526,\n \"reference_id\": \"21a888e9-e36b-47ef-b365-5268314a04d0\",\n \"description\": \"Pagamento de contas\",\n \"additional_info\": \"Transferência Pix\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 422,\n \"code\": \"DAILY_LIMIT_EXCEEDED\",\n \"message\": \"Limite diário de transferências Pix atingido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 8041.990995341935,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ed050ffe-d78d-4826-84c3-ac6cc65d8c4e", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "pix", "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"pix_transfer_type\": \"KEY\",\n \"pix_key\": \"000.000.000-00\",\n \"pix_qrcode_emv\": \"00020126850014BR.GOV.BCB.PIX2563qr.cornerpix.com.br/new/11581339/v2/cobv/d8z7CCHxatKYreSvrw3UpE5204000053039865802BR5914BMP Money Plus6009SAO PAULO62070503***63046FE1\",\n \"pix_account\": {\n \"holder_name\": \"Fulano da Silva\",\n \"holder_document\": \"12345678900\",\n \"branch_code\": \"0001\",\n \"account_number\": \"02381705\",\n \"ispb\": \"11581339\",\n \"account_type\": \"PAYMENT\",\n \"branch_digit\": \"8\",\n \"account_digit\": \"5\",\n \"account_model\": \"MOVEMENT\"\n },\n \"amount\": 5313.71765446526,\n \"reference_id\": \"21a888e9-e36b-47ef-b365-5268314a04d0\",\n \"description\": \"Pagamento de contas\",\n \"additional_info\": \"Transferência Pix\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6a5e3b5a-e026-4421-8e7a-0ce7fd4c70f4", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "pix", "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"pix_transfer_type\": \"KEY\",\n \"pix_key\": \"000.000.000-00\",\n \"pix_qrcode_emv\": \"00020126850014BR.GOV.BCB.PIX2563qr.cornerpix.com.br/new/11581339/v2/cobv/d8z7CCHxatKYreSvrw3UpE5204000053039865802BR5914BMP Money Plus6009SAO PAULO62070503***63046FE1\",\n \"pix_account\": {\n \"holder_name\": \"Fulano da Silva\",\n \"holder_document\": \"12345678900\",\n \"branch_code\": \"0001\",\n \"account_number\": \"02381705\",\n \"ispb\": \"11581339\",\n \"account_type\": \"PAYMENT\",\n \"branch_digit\": \"8\",\n \"account_digit\": \"5\",\n \"account_model\": \"MOVEMENT\"\n },\n \"amount\": 5313.71765446526,\n \"reference_id\": \"21a888e9-e36b-47ef-b365-5268314a04d0\",\n \"description\": \"Pagamento de contas\",\n \"additional_info\": \"Transferência Pix\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "db5a4891-3414-4932-b100-df2cc6676769", "name": "Sistema Pix (SPI) temporariamente indisponível", "originalRequest": { "url": { "path": [ "accounts", "pix", "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"pix_transfer_type\": \"KEY\",\n \"pix_key\": \"000.000.000-00\",\n \"pix_qrcode_emv\": \"00020126850014BR.GOV.BCB.PIX2563qr.cornerpix.com.br/new/11581339/v2/cobv/d8z7CCHxatKYreSvrw3UpE5204000053039865802BR5914BMP Money Plus6009SAO PAULO62070503***63046FE1\",\n \"pix_account\": {\n \"holder_name\": \"Fulano da Silva\",\n \"holder_document\": \"12345678900\",\n \"branch_code\": \"0001\",\n \"account_number\": \"02381705\",\n \"ispb\": \"11581339\",\n \"account_type\": \"PAYMENT\",\n \"branch_digit\": \"8\",\n \"account_digit\": \"5\",\n \"account_model\": \"MOVEMENT\"\n },\n \"amount\": 5313.71765446526,\n \"reference_id\": \"21a888e9-e36b-47ef-b365-5268314a04d0\",\n \"description\": \"Pagamento de contas\",\n \"additional_info\": \"Transferência Pix\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 503,\n \"code\": \"PIX_SERVICE_UNAVAILABLE\",\n \"message\": \"Sistema Pix (SPI) temporariamente indisponível\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": 7686,\n \"key_2\": 6015,\n \"key_3\": 4414\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2497a125-0271-4221-9e64-690c1335fc8f", "name": "Devolver Pix recebido", "request": { "name": "Devolver Pix recebido", "description": { "content": "Realiza a devolução total ou parcial de uma transferência Pix recebida. O valor é devolvido ao remetente original de forma instantânea.\n\n**Regras:**\n• Devoluções devem ser solicitadas em até 90 dias após o recebimento\n• Devolução parcial: o valor devolvido não pode ser superior ao valor recebido\n• Múltiplas devoluções parciais são permitidas até o limite do valor original\n\n**Rastreamento:** O `id` retornado no response identifica a devolução. A confirmação da liquidação é assíncrona e pode ser acompanhada via webhook.\n\n**Fluxo de aprovação:**\nA transação é criada com status `AWAITING_APPROVAL`. A aprovação deve ser feita via `PATCH /accounts/approvals/transactions/{id}` com autenticação step-up.", "type": "text/plain" }, "url": { "path": [ "accounts", "pix", "refunds" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "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 \"transaction_id\": \"01KRE4P8B10YB2DY9SPGZCZK23\",\n \"amount\": 500,\n \"additional_info\": \"Pagamento ref #12345\",\n \"description\": \"Estorno solicitado pelo cliente\",\n \"reference_id\": \"DEV-2026-000123\",\n \"refund_reason\": \"PAYER_REQUEST\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "aaa14f45-f2e2-438f-894b-600c302cdf72", "name": "Devolução Pix iniciada com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "pix", "refunds" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"transaction_id\": \"01KRE4P8B10YB2DY9SPGZCZK23\",\n \"amount\": 500,\n \"additional_info\": \"Pagamento ref #12345\",\n \"description\": \"Estorno solicitado pelo cliente\",\n \"reference_id\": \"DEV-2026-000123\",\n \"refund_reason\": \"PAYER_REQUEST\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"01JY05224X1WGAH75F5404HXMF\",\n \"type\": \"PIX_REFUND\",\n \"status\": \"COMPLETED\",\n \"amount\": 15000,\n \"occurred_at\": \"2026-05-14T14:00:00-03:00\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5e9550a9-5788-4c87-a573-f1366e7a22a6", "name": "Dados da devolução inválidos", "originalRequest": { "url": { "path": [ "accounts", "pix", "refunds" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"transaction_id\": \"01KRE4P8B10YB2DY9SPGZCZK23\",\n \"amount\": 500,\n \"additional_info\": \"Pagamento ref #12345\",\n \"description\": \"Estorno solicitado pelo cliente\",\n \"reference_id\": \"DEV-2026-000123\",\n \"refund_reason\": \"PAYER_REQUEST\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados da devolução inválidos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 9168.325055195892,\n \"key_1\": 2062\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "15317703-308b-4270-ad7d-64f51efadb8e", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "pix", "refunds" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"transaction_id\": \"01KRE4P8B10YB2DY9SPGZCZK23\",\n \"amount\": 500,\n \"additional_info\": \"Pagamento ref #12345\",\n \"description\": \"Estorno solicitado pelo cliente\",\n \"reference_id\": \"DEV-2026-000123\",\n \"refund_reason\": \"PAYER_REQUEST\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a294dace-e4f3-4f05-a520-6177de8bfed0", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "pix", "refunds" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"transaction_id\": \"01KRE4P8B10YB2DY9SPGZCZK23\",\n \"amount\": 500,\n \"additional_info\": \"Pagamento ref #12345\",\n \"description\": \"Estorno solicitado pelo cliente\",\n \"reference_id\": \"DEV-2026-000123\",\n \"refund_reason\": \"PAYER_REQUEST\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5afa83f2-0ee6-4961-ac22-267ff61e165a", "name": "Transação Pix original não encontrada", "originalRequest": { "url": { "path": [ "accounts", "pix", "refunds" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"transaction_id\": \"01KRE4P8B10YB2DY9SPGZCZK23\",\n \"amount\": 500,\n \"additional_info\": \"Pagamento ref #12345\",\n \"description\": \"Estorno solicitado pelo cliente\",\n \"reference_id\": \"DEV-2026-000123\",\n \"refund_reason\": \"PAYER_REQUEST\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 404,\n \"code\": \"TRANSACTION_NOT_FOUND\",\n \"message\": \"Transação Pix original não encontrada\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0ba9b740-bf50-42d9-92db-63db56d546ce", "name": "Já existe uma transação com o mesmo reference_id para esta conta, ou a chave de idempotência já foi utilizada", "originalRequest": { "url": { "path": [ "accounts", "pix", "refunds" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"transaction_id\": \"01KRE4P8B10YB2DY9SPGZCZK23\",\n \"amount\": 500,\n \"additional_info\": \"Pagamento ref #12345\",\n \"description\": \"Estorno solicitado pelo cliente\",\n \"reference_id\": \"DEV-2026-000123\",\n \"refund_reason\": \"PAYER_REQUEST\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 409,\n \"code\": \"RESOURCE_CONFLICT\",\n \"message\": \"Já existe uma transação com o mesmo reference_id para esta conta, ou a chave de idempotência já foi utilizada\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 2211.3957762870464\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1ff055dd-3c3c-4a6e-b1f8-f153f09820da", "name": "Prazo de 90 dias para devolução expirado", "originalRequest": { "url": { "path": [ "accounts", "pix", "refunds" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"transaction_id\": \"01KRE4P8B10YB2DY9SPGZCZK23\",\n \"amount\": 500,\n \"additional_info\": \"Pagamento ref #12345\",\n \"description\": \"Estorno solicitado pelo cliente\",\n \"reference_id\": \"DEV-2026-000123\",\n \"refund_reason\": \"PAYER_REQUEST\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 422,\n \"code\": \"REFUND_DEADLINE_EXCEEDED\",\n \"message\": \"Prazo de 90 dias para devolução expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b4165c0c-c87a-4c1e-abc4-e3bdbbd34db3", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "pix", "refunds" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"transaction_id\": \"01KRE4P8B10YB2DY9SPGZCZK23\",\n \"amount\": 500,\n \"additional_info\": \"Pagamento ref #12345\",\n \"description\": \"Estorno solicitado pelo cliente\",\n \"reference_id\": \"DEV-2026-000123\",\n \"refund_reason\": \"PAYER_REQUEST\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d98e1422-f749-48e4-97da-3df163ea9c8e", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "pix", "refunds" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"transaction_id\": \"01KRE4P8B10YB2DY9SPGZCZK23\",\n \"amount\": 500,\n \"additional_info\": \"Pagamento ref #12345\",\n \"description\": \"Estorno solicitado pelo cliente\",\n \"reference_id\": \"DEV-2026-000123\",\n \"refund_reason\": \"PAYER_REQUEST\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "d1eec1df-e616-4db2-98d7-1ed70eb347a9", "name": "Transferências bancárias convencionais entre contas. Suporta TEF (entre contas Meioo) e TED (para contas em outras instituições).", "description": { "content": "", "type": "text/plain" }, "item": [ { "id": "e97b8dcd-3d55-4d02-a279-f366a70e9b34", "name": "Transferir para conta Meioo (TEF)", "request": { "name": "Transferir para conta Meioo (TEF)", "description": { "content": "Realiza uma transferência entre contas dentro da plataforma Meioo (Transferência Eletrônica de Fundos). A liquidação é imediata, independente do horário.\n\n**Características:**\n• Liquidação instantânea, 24/7\n• Disponível para contas PF e PJ na plataforma\n• Sem janela operacional restritiva\n\n**Fluxo de aprovação:** A transação é criada com status `AWAITING_APPROVAL`. A aprovação deve ser feita via `PATCH /accounts/approvals/transactions/{id}` com autenticação step-up.", "type": "text/plain" }, "url": { "path": [ "accounts", "transfers", "tef" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "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 \"account_number\": \"08690148\",\n \"amount\": 10000,\n \"purpose\": \"ACCOUNT_CREDIT\",\n \"reference_id\": \"TRANSACAO_123\",\n \"description\": \"Pagamento de contas\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "255c8fb6-421c-4239-9e6d-3664f65abed4", "name": "Transferência TEF criada com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "transfers", "tef" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"account_number\": \"08690148\",\n \"amount\": 10000,\n \"purpose\": \"ACCOUNT_CREDIT\",\n \"reference_id\": \"TRANSACAO_123\",\n \"description\": \"Pagamento de contas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"01K8RPN86DS9D1KZ5ZBGJKF53M\",\n \"status\": \"PROCESSING\",\n \"amount\": 10000,\n \"destination_account\": {\n \"account_number\": \"08690148\",\n \"branch_code\": \"0001\"\n },\n \"fee_amount\": 100\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0b417cbb-1be1-4765-b909-28e3571da48c", "name": "Dados da transferência inválidos ou incompletos", "originalRequest": { "url": { "path": [ "accounts", "transfers", "tef" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"account_number\": \"08690148\",\n \"amount\": 10000,\n \"purpose\": \"ACCOUNT_CREDIT\",\n \"reference_id\": \"TRANSACAO_123\",\n \"description\": \"Pagamento de contas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados da transferência inválidos ou incompletos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 2915.2737104598937,\n \"key_1\": 6322.163170310378,\n \"key_2\": 5153.476386524771\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2804dd3b-46cc-43bc-9745-6c2d9fa3990b", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "transfers", "tef" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"account_number\": \"08690148\",\n \"amount\": 10000,\n \"purpose\": \"ACCOUNT_CREDIT\",\n \"reference_id\": \"TRANSACAO_123\",\n \"description\": \"Pagamento de contas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "622801d4-0d06-4e19-8ef6-b2c9a8097675", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "transfers", "tef" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"account_number\": \"08690148\",\n \"amount\": 10000,\n \"purpose\": \"ACCOUNT_CREDIT\",\n \"reference_id\": \"TRANSACAO_123\",\n \"description\": \"Pagamento de contas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "95de8f4f-ddee-4a46-8344-799b2be41e77", "name": "Conta de destino não encontrada na plataforma Meioo", "originalRequest": { "url": { "path": [ "accounts", "transfers", "tef" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"account_number\": \"08690148\",\n \"amount\": 10000,\n \"purpose\": \"ACCOUNT_CREDIT\",\n \"reference_id\": \"TRANSACAO_123\",\n \"description\": \"Pagamento de contas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 404,\n \"code\": \"DESTINATION_ACCOUNT_NOT_FOUND\",\n \"message\": \"Conta de destino não encontrada na plataforma Meioo\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 3282.08080616186\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1d226303-c4ec-4284-9c9b-c3a3321d4b95", "name": "Já existe uma transação com o mesmo reference_id para esta conta, ou a chave de idempotência já foi utilizada", "originalRequest": { "url": { "path": [ "accounts", "transfers", "tef" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"account_number\": \"08690148\",\n \"amount\": 10000,\n \"purpose\": \"ACCOUNT_CREDIT\",\n \"reference_id\": \"TRANSACAO_123\",\n \"description\": \"Pagamento de contas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 409,\n \"code\": \"RESOURCE_CONFLICT\",\n \"message\": \"Já existe uma transação com o mesmo reference_id para esta conta, ou a chave de idempotência já foi utilizada\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 2211.3957762870464\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "20e9399b-1d78-4f42-8139-dfd5eb89c9f4", "name": "Transferência para a própria conta não é permitida", "originalRequest": { "url": { "path": [ "accounts", "transfers", "tef" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"account_number\": \"08690148\",\n \"amount\": 10000,\n \"purpose\": \"ACCOUNT_CREDIT\",\n \"reference_id\": \"TRANSACAO_123\",\n \"description\": \"Pagamento de contas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 422,\n \"code\": \"SAME_ACCOUNT_TRANSFER\",\n \"message\": \"Transferência para a própria conta não é permitida\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 3315.9576229663658,\n \"key_1\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4753debd-57f9-4bda-b222-c2570a32894c", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "transfers", "tef" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"account_number\": \"08690148\",\n \"amount\": 10000,\n \"purpose\": \"ACCOUNT_CREDIT\",\n \"reference_id\": \"TRANSACAO_123\",\n \"description\": \"Pagamento de contas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7d24f359-e060-4950-bb8e-8cedf09235df", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "transfers", "tef" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"account_number\": \"08690148\",\n \"amount\": 10000,\n \"purpose\": \"ACCOUNT_CREDIT\",\n \"reference_id\": \"TRANSACAO_123\",\n \"description\": \"Pagamento de contas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3b19dcf1-c071-4145-bfd2-14f7288a31fb", "name": "Transferir para outras instituições (TED)", "request": { "name": "Transferir para outras instituições (TED)", "description": { "content": "Realiza uma transferência bancária para contas em outras instituições financeiras via TED.\n\n**Janela operacional:**\nTEDs processadas fora do horário bancário são agendadas para o próximo dia útil.\n\n**Fluxo de aprovação:** A transação é criada com status `AWAITING_APPROVAL`. A aprovação deve ser feita via `PATCH /accounts/approvals/transactions/{id}` com autenticação step-up.", "type": "text/plain" }, "url": { "path": [ "accounts", "transfers", "ted" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "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 \"beneficiary\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"12345678900\",\n \"bank_code\": \"274\",\n \"branch_code\": \"0001\",\n \"branch_digit\": \"1\",\n \"account_number\": \"02381705\",\n \"account_type\": \"PAYMENT\",\n \"account_digit\": \"5\"\n },\n \"amount\": 10000,\n \"purpose\": \"ACCOUNT_CREDIT\",\n \"reference_id\": \"TRANSACAO_123\",\n \"description\": \"Pagamento de contas\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "d316b225-93af-4ee8-9d52-23ce1144cb46", "name": "Transferência TED criada com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "transfers", "ted" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"beneficiary\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"12345678900\",\n \"bank_code\": \"274\",\n \"branch_code\": \"0001\",\n \"branch_digit\": \"1\",\n \"account_number\": \"02381705\",\n \"account_type\": \"PAYMENT\",\n \"account_digit\": \"5\"\n },\n \"amount\": 10000,\n \"purpose\": \"ACCOUNT_CREDIT\",\n \"reference_id\": \"TRANSACAO_123\",\n \"description\": \"Pagamento de contas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"01K8RPN86DS9D1KZ5ZBGJKF53M\",\n \"status\": \"PROCESSING\",\n \"amount\": 10000,\n \"beneficiary\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"12345678900\",\n \"bank_code\": \"274\",\n \"branch_code\": \"0001\",\n \"account_number\": \"02381705\",\n \"branch_digit\": \"8\",\n \"account_digit\": \"5\"\n },\n \"fee_amount\": 100\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "71266407-b024-4f7f-a084-5bb43d151f67", "name": "Dados bancários inválidos ou incompletos", "originalRequest": { "url": { "path": [ "accounts", "transfers", "ted" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"beneficiary\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"12345678900\",\n \"bank_code\": \"274\",\n \"branch_code\": \"0001\",\n \"branch_digit\": \"1\",\n \"account_number\": \"02381705\",\n \"account_type\": \"PAYMENT\",\n \"account_digit\": \"5\"\n },\n \"amount\": 10000,\n \"purpose\": \"ACCOUNT_CREDIT\",\n \"reference_id\": \"TRANSACAO_123\",\n \"description\": \"Pagamento de contas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados bancários inválidos ou incompletos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 9023.932277241729\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "395d425c-de9b-472b-a81d-0d4f7157dce5", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "transfers", "ted" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"beneficiary\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"12345678900\",\n \"bank_code\": \"274\",\n \"branch_code\": \"0001\",\n \"branch_digit\": \"1\",\n \"account_number\": \"02381705\",\n \"account_type\": \"PAYMENT\",\n \"account_digit\": \"5\"\n },\n \"amount\": 10000,\n \"purpose\": \"ACCOUNT_CREDIT\",\n \"reference_id\": \"TRANSACAO_123\",\n \"description\": \"Pagamento de contas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4fc431b6-9fb4-4c37-b17b-29acdcb54a20", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "transfers", "ted" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"beneficiary\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"12345678900\",\n \"bank_code\": \"274\",\n \"branch_code\": \"0001\",\n \"branch_digit\": \"1\",\n \"account_number\": \"02381705\",\n \"account_type\": \"PAYMENT\",\n \"account_digit\": \"5\"\n },\n \"amount\": 10000,\n \"purpose\": \"ACCOUNT_CREDIT\",\n \"reference_id\": \"TRANSACAO_123\",\n \"description\": \"Pagamento de contas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bf8f7e6c-271e-4da5-b735-1209f074c2d3", "name": "Já existe uma transação com o mesmo reference_id para esta conta, ou a chave de idempotência já foi utilizada", "originalRequest": { "url": { "path": [ "accounts", "transfers", "ted" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"beneficiary\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"12345678900\",\n \"bank_code\": \"274\",\n \"branch_code\": \"0001\",\n \"branch_digit\": \"1\",\n \"account_number\": \"02381705\",\n \"account_type\": \"PAYMENT\",\n \"account_digit\": \"5\"\n },\n \"amount\": 10000,\n \"purpose\": \"ACCOUNT_CREDIT\",\n \"reference_id\": \"TRANSACAO_123\",\n \"description\": \"Pagamento de contas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 409,\n \"code\": \"RESOURCE_CONFLICT\",\n \"message\": \"Já existe uma transação com o mesmo reference_id para esta conta, ou a chave de idempotência já foi utilizada\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 2211.3957762870464\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "baabb7ea-1ce2-42f6-bc76-eff29b30ab9f", "name": "Dados bancários do destinatário inválidos", "originalRequest": { "url": { "path": [ "accounts", "transfers", "ted" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"beneficiary\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"12345678900\",\n \"bank_code\": \"274\",\n \"branch_code\": \"0001\",\n \"branch_digit\": \"1\",\n \"account_number\": \"02381705\",\n \"account_type\": \"PAYMENT\",\n \"account_digit\": \"5\"\n },\n \"amount\": 10000,\n \"purpose\": \"ACCOUNT_CREDIT\",\n \"reference_id\": \"TRANSACAO_123\",\n \"description\": \"Pagamento de contas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 422,\n \"code\": \"INVALID_BANK_ACCOUNT\",\n \"message\": \"Dados bancários do destinatário inválidos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 7622\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "81acde78-63b5-447a-afb4-92b39384de11", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "transfers", "ted" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"beneficiary\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"12345678900\",\n \"bank_code\": \"274\",\n \"branch_code\": \"0001\",\n \"branch_digit\": \"1\",\n \"account_number\": \"02381705\",\n \"account_type\": \"PAYMENT\",\n \"account_digit\": \"5\"\n },\n \"amount\": 10000,\n \"purpose\": \"ACCOUNT_CREDIT\",\n \"reference_id\": \"TRANSACAO_123\",\n \"description\": \"Pagamento de contas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e5cd9c4f-f6dc-4304-9649-b9dd25be04ed", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "transfers", "ted" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"beneficiary\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"12345678900\",\n \"bank_code\": \"274\",\n \"branch_code\": \"0001\",\n \"branch_digit\": \"1\",\n \"account_number\": \"02381705\",\n \"account_type\": \"PAYMENT\",\n \"account_digit\": \"5\"\n },\n \"amount\": 10000,\n \"purpose\": \"ACCOUNT_CREDIT\",\n \"reference_id\": \"TRANSACAO_123\",\n \"description\": \"Pagamento de contas\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "d72cc8a6-eb9c-490b-80e4-64c5fe21b3f7", "name": "Emissão, consulta, pagamento e cancelamento de boletos bancários. Suporta boletos próprios (registrados pela conta) e boletos de terceiros (pagamento de qualquer boleto). Inclui gestão de cedentes e carteiras para emissão de boletos.", "description": { "content": "", "type": "text/plain" }, "item": [ { "id": "ec1ea85f-8096-4848-aa6d-cfbf3ac3b0d8", "name": "Consultar boleto para pagamento", "request": { "name": "Consultar boleto para pagamento", "description": { "content": "Consulta os dados de qualquer boleto a partir do seu código de barras ou linha digitável, independente da instituição emissora. Útil para validar os dados antes de efetuar o pagamento.\n\n**Parâmetros (ao menos um é obrigatório):**\n\n**barcode**\nCódigo de barras numérico do boleto (44 dígitos).\n\n**digitable_line**\nLinha digitável do boleto (47 ou 48 dígitos, formatada ou sem formatação).\n\n**Informações retornadas:** valor, vencimento, cedente, sacado e status de pagabilidade.", "type": "text/plain" }, "url": { "path": [ "accounts", "bank-slips", "consult" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "digitable_line", "value": "27490001011000000000969023817005311480000100000", "description": "Linha digitável do boleto. Informe pelo menos um: digitable_line ou barcode." }, { "disabled": false, "key": "barcode", "value": "27495114800000100000001010000000003202381700", "description": "Código de barras do boleto. Informe pelo menos um: digitable_line ou barcode." } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "c1c3f2a5-2e0e-48dd-b8a8-d372515a98d5", "name": "Dados do boleto consultados com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "consult" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "digitable_line", "value": "27490001011000000000969023817005311480000100000" }, { "key": "barcode", "value": "27495114800000100000001010000000003202381700" } ], "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 \"barcode\": \"27495114800001000000001010000000007102381700\",\n \"digitable_line\": \"27490001011000000000971023817001511480000100000\",\n \"amount\": 10000,\n \"due_date\": \"2025-11-30\",\n \"issuer\": {\n \"person_type\": \"INDIVIDUAL\",\n \"document_number\": \"12345678901\",\n \"name\": \"João da Silva\",\n \"trade_name\": \"Empresa Exemplo LTDA\",\n \"bank_code\": \"001\",\n \"ispb\": \"123456789\"\n },\n \"payer\": {\n \"person_type\": \"INDIVIDUAL\",\n \"document_number\": \"12345678901\",\n \"name\": \"Maria da Silva\"\n },\n \"rebate_amount\": 0,\n \"amount_due\": 10500,\n \"issue_date\": \"2025-10-31\",\n \"payment_limit_date\": \"2025-12-31\",\n \"dda_control_number\": \"0000012345678\",\n \"status\": \"OPEN\",\n \"guarantor\": {\n \"type\": \"CPF\",\n \"document\": \"78823832012\",\n \"name\": \"João da Silva\"\n },\n \"interest\": {\n \"value\": 1000,\n \"code\": \"1\",\n \"date\": \"2025-01-01\",\n \"percentage\": 2.5\n },\n \"fine\": {\n \"value\": 1000,\n \"code\": \"1\",\n \"date\": \"2025-01-01\",\n \"percentage\": 2.5\n },\n \"discounts\": [\n {\n \"value\": 1000,\n \"code\": \"1\",\n \"date\": \"2025-01-01\",\n \"percentage\": 2.5\n },\n {\n \"value\": 1000,\n \"code\": \"1\",\n \"date\": \"2025-01-01\",\n \"percentage\": 2.5\n }\n ],\n \"validations\": [\n {\n \"message\": \"Boleto já baixado\"\n },\n {\n \"message\": \"Boleto já baixado\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "881d0304-a1d5-4726-8ad0-dd19ae999731", "name": "Nenhum código informado ou formato inválido", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "consult" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "digitable_line", "value": "27490001011000000000969023817005311480000100000" }, { "key": "barcode", "value": "27495114800000100000001010000000003202381700" } ], "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 \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Nenhum código informado ou formato inválido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 6171\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "63184552-3395-4dff-bb2e-3fefe5bfa1d7", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "consult" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "digitable_line", "value": "27490001011000000000969023817005311480000100000" }, { "key": "barcode", "value": "27495114800000100000001010000000003202381700" } ], "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 \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9f33bcdf-c09c-4caa-afd6-b7b7bce37b8f", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "consult" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "digitable_line", "value": "27490001011000000000969023817005311480000100000" }, { "key": "barcode", "value": "27495114800000100000001010000000003202381700" } ], "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 \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c821ca83-cc85-4313-83ab-672d3dc3f468", "name": "Boleto não encontrado ou não reconhecido", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "consult" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "digitable_line", "value": "27490001011000000000969023817005311480000100000" }, { "key": "barcode", "value": "27495114800000100000001010000000003202381700" } ], "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 \"status_code\": 404,\n \"code\": \"BANK_SLIP_NOT_FOUND\",\n \"message\": \"Boleto não encontrado ou não reconhecido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "40024d1a-90ec-4180-abf0-0fd68e692c9b", "name": "Boleto vencido, já pago ou cancelado", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "consult" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "digitable_line", "value": "27490001011000000000969023817005311480000100000" }, { "key": "barcode", "value": "27495114800000100000001010000000003202381700" } ], "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 \"status_code\": 422,\n \"code\": \"BANK_SLIP_NOT_PAYABLE\",\n \"message\": \"Boleto vencido, já pago ou cancelado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "44827b6f-6db2-4c97-a42f-dd9e2c690528", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "consult" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "digitable_line", "value": "27490001011000000000969023817005311480000100000" }, { "key": "barcode", "value": "27495114800000100000001010000000003202381700" } ], "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e2b21d21-b3df-4df7-9175-c7e53f3bf585", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "consult" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "digitable_line", "value": "27490001011000000000969023817005311480000100000" }, { "key": "barcode", "value": "27495114800000100000001010000000003202381700" } ], "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "12d4e96b-1399-42b7-b57a-101f14677ea6", "name": "Pagar boleto", "request": { "name": "Pagar boleto", "description": { "content": "Realiza o pagamento de um boleto bancário de qualquer instituição a partir dos dados fornecidos.\n\n**Janela operacional:**\nPagamentos processados dentro do horário bancário são liquidados no mesmo dia. Pagamentos fora do horário são agendados para o próximo dia útil.\n\n**Boletos com vencimento:**\n• Boletos vencidos há até 60 dias podem ser pagos com multa e juros calculados automaticamente\n• Verifique o valor atualizado via `GET /accounts/bank-slips/consult` antes de confirmar o pagamento\n\n**Fluxo de aprovação:** A transação é criada com status `AWAITING_APPROVAL`. A aprovação deve ser feita via `PATCH /accounts/approvals/transactions/{id}` com autenticação step-up.", "type": "text/plain" }, "url": { "path": [ "accounts", "bank-slips", "payments" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "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 \"due_date\": \"2023-12-31\",\n \"amount\": 10000,\n \"payment_amount\": 9500,\n \"digitable_line\": \"27490001011000000000971023817001511480000100000\",\n \"barcode\": \"27495114800001000000001010000000007102381700\",\n \"reference_id\": \"1234567890\",\n \"description\": \"Pagamento do boleto 1234567890\",\n \"payment_limit_date\": \"2026-01-10\",\n \"rebate_amount\": 0,\n \"dda_control_number\": \"0000012345678\",\n \"issuer\": {\n \"name\": \"Empresa Exemplo LTDA\",\n \"document_number\": \"12345678000190\",\n \"bank_code\": \"274\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "a57826bd-2ce5-47ef-ac0d-e2b7871cfbfd", "name": "Pagamento do boleto realizado com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "payments" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"due_date\": \"2023-12-31\",\n \"amount\": 10000,\n \"payment_amount\": 9500,\n \"digitable_line\": \"27490001011000000000971023817001511480000100000\",\n \"barcode\": \"27495114800001000000001010000000007102381700\",\n \"reference_id\": \"1234567890\",\n \"description\": \"Pagamento do boleto 1234567890\",\n \"payment_limit_date\": \"2026-01-10\",\n \"rebate_amount\": 0,\n \"dda_control_number\": \"0000012345678\",\n \"issuer\": {\n \"name\": \"Empresa Exemplo LTDA\",\n \"document_number\": \"12345678000190\",\n \"bank_code\": \"274\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"01HK6XQVZ8R9YJ7N2P5KMQB1XZ\",\n \"status\": \"PROCESSING\",\n \"amount\": 10000,\n \"digitable_line\": \"27490001011000000000971023817001511480000100000\",\n \"barcode\": \"27495114800001000000001010000000007102381700\",\n \"fee_amount\": 200\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "51a097ac-7533-401d-84dc-ee7fe8002b74", "name": "Dados do boleto inválidos ou incompletos", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "payments" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"due_date\": \"2023-12-31\",\n \"amount\": 10000,\n \"payment_amount\": 9500,\n \"digitable_line\": \"27490001011000000000971023817001511480000100000\",\n \"barcode\": \"27495114800001000000001010000000007102381700\",\n \"reference_id\": \"1234567890\",\n \"description\": \"Pagamento do boleto 1234567890\",\n \"payment_limit_date\": \"2026-01-10\",\n \"rebate_amount\": 0,\n \"dda_control_number\": \"0000012345678\",\n \"issuer\": {\n \"name\": \"Empresa Exemplo LTDA\",\n \"document_number\": \"12345678000190\",\n \"bank_code\": \"274\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados do boleto inválidos ou incompletos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 1693\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b4f77780-cf58-4738-84bb-35b0399f6a41", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "payments" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"due_date\": \"2023-12-31\",\n \"amount\": 10000,\n \"payment_amount\": 9500,\n \"digitable_line\": \"27490001011000000000971023817001511480000100000\",\n \"barcode\": \"27495114800001000000001010000000007102381700\",\n \"reference_id\": \"1234567890\",\n \"description\": \"Pagamento do boleto 1234567890\",\n \"payment_limit_date\": \"2026-01-10\",\n \"rebate_amount\": 0,\n \"dda_control_number\": \"0000012345678\",\n \"issuer\": {\n \"name\": \"Empresa Exemplo LTDA\",\n \"document_number\": \"12345678000190\",\n \"bank_code\": \"274\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "003b68fc-e61c-4a80-801b-f11f3dc1fed8", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "payments" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"due_date\": \"2023-12-31\",\n \"amount\": 10000,\n \"payment_amount\": 9500,\n \"digitable_line\": \"27490001011000000000971023817001511480000100000\",\n \"barcode\": \"27495114800001000000001010000000007102381700\",\n \"reference_id\": \"1234567890\",\n \"description\": \"Pagamento do boleto 1234567890\",\n \"payment_limit_date\": \"2026-01-10\",\n \"rebate_amount\": 0,\n \"dda_control_number\": \"0000012345678\",\n \"issuer\": {\n \"name\": \"Empresa Exemplo LTDA\",\n \"document_number\": \"12345678000190\",\n \"bank_code\": \"274\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1a54e2a4-1558-41b7-98ed-a49ac0a2d590", "name": "Já existe uma transação com o mesmo reference_id para esta conta, ou a chave de idempotência já foi utilizada", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "payments" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"due_date\": \"2023-12-31\",\n \"amount\": 10000,\n \"payment_amount\": 9500,\n \"digitable_line\": \"27490001011000000000971023817001511480000100000\",\n \"barcode\": \"27495114800001000000001010000000007102381700\",\n \"reference_id\": \"1234567890\",\n \"description\": \"Pagamento do boleto 1234567890\",\n \"payment_limit_date\": \"2026-01-10\",\n \"rebate_amount\": 0,\n \"dda_control_number\": \"0000012345678\",\n \"issuer\": {\n \"name\": \"Empresa Exemplo LTDA\",\n \"document_number\": \"12345678000190\",\n \"bank_code\": \"274\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 409,\n \"code\": \"RESOURCE_CONFLICT\",\n \"message\": \"Já existe uma transação com o mesmo reference_id para esta conta, ou a chave de idempotência já foi utilizada\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 2211.3957762870464\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "da430991-eb06-4945-8c29-2a7dee60e85a", "name": "Limite diário de pagamentos atingido", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "payments" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"due_date\": \"2023-12-31\",\n \"amount\": 10000,\n \"payment_amount\": 9500,\n \"digitable_line\": \"27490001011000000000971023817001511480000100000\",\n \"barcode\": \"27495114800001000000001010000000007102381700\",\n \"reference_id\": \"1234567890\",\n \"description\": \"Pagamento do boleto 1234567890\",\n \"payment_limit_date\": \"2026-01-10\",\n \"rebate_amount\": 0,\n \"dda_control_number\": \"0000012345678\",\n \"issuer\": {\n \"name\": \"Empresa Exemplo LTDA\",\n \"document_number\": \"12345678000190\",\n \"bank_code\": \"274\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 422,\n \"code\": \"DAILY_LIMIT_EXCEEDED\",\n \"message\": \"Limite diário de pagamentos atingido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 8102\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bf87fa85-3323-43fa-8c4c-fbfee9decb02", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "payments" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"due_date\": \"2023-12-31\",\n \"amount\": 10000,\n \"payment_amount\": 9500,\n \"digitable_line\": \"27490001011000000000971023817001511480000100000\",\n \"barcode\": \"27495114800001000000001010000000007102381700\",\n \"reference_id\": \"1234567890\",\n \"description\": \"Pagamento do boleto 1234567890\",\n \"payment_limit_date\": \"2026-01-10\",\n \"rebate_amount\": 0,\n \"dda_control_number\": \"0000012345678\",\n \"issuer\": {\n \"name\": \"Empresa Exemplo LTDA\",\n \"document_number\": \"12345678000190\",\n \"bank_code\": \"274\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "34af5aa6-3ed0-42f3-aaaf-d4ab009d7c93", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "payments" ], "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": "Chave de idempotência (UUID). Evita duplicação em retentativas. Recomendado para todas as integrações programáticas (PARTNER, ACCOUNT_API).", "key": "x-idempotency-key", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"due_date\": \"2023-12-31\",\n \"amount\": 10000,\n \"payment_amount\": 9500,\n \"digitable_line\": \"27490001011000000000971023817001511480000100000\",\n \"barcode\": \"27495114800001000000001010000000007102381700\",\n \"reference_id\": \"1234567890\",\n \"description\": \"Pagamento do boleto 1234567890\",\n \"payment_limit_date\": \"2026-01-10\",\n \"rebate_amount\": 0,\n \"dda_control_number\": \"0000012345678\",\n \"issuer\": {\n \"name\": \"Empresa Exemplo LTDA\",\n \"document_number\": \"12345678000190\",\n \"bank_code\": \"274\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "341494bb-9c3c-4f4e-956e-9b85e3ce8096", "name": "Registrar boleto", "request": { "name": "Registrar boleto", "description": { "content": "Emite um novo boleto bancário e o registra automaticamente na CIP (Câmara Interbancária de Pagamentos). Boletos registrados são aceitos em qualquer banco.\n\n**Campos configuráveis:**\n\n**Vencimento**\nData de vencimento do boleto.\n\n**Desconto**\nPercentual ou valor fixo de desconto para pagamento antecipado.\n\n**Multa e Juros**\nPercentuais de multa e juros aplicados após o vencimento.\n\n**Instruções**\nTexto livre exibido no boleto para orientação ao pagador.\n\n**Retorno:** Dados completos do boleto registrado, incluindo linha digitável, código de barras e PDF disponível via `GET /accounts/bank-slips/{id}/pdf`.", "type": "text/plain" }, "url": { "path": [ "accounts", "bank-slips" ], "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 \"issue_date\": \"2025-10-31\",\n \"due_date\": \"2025-11-30\",\n \"payment_limit_date\": \"2025-12-31\",\n \"amount\": 10000,\n \"rebate_amount\": 100,\n \"document_number\": \"123456\",\n \"our_number\": \"123456\",\n \"payer\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"78823832012\",\n \"person_type\": \"INDIVIDUAL\",\n \"trade_name\": \"Padaria do João\",\n \"email\": \"joao@email.com\",\n \"phone_number\": \"31999999999\",\n \"address\": {\n \"street\": \"Rua da Bahia\",\n \"number\": \"500\",\n \"complement\": \"Apto 101\",\n \"neighborhood\": \"Centro\",\n \"city\": \"Belo Horizonte\",\n \"state\": \"MG\",\n \"zip_code\": \"30111300\"\n }\n },\n \"guarantor\": {\n \"type\": \"CNPJ\",\n \"document\": \"12345678000199\",\n \"name\": \"Empresa Garantidora SA\"\n },\n \"interest\": {\n \"code\": \"PERCENTAGE_PER_MONTH\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"fine\": {\n \"code\": \"PERCENTAGE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"instructions\": [\n \"Não receber após o vencimento\"\n ],\n \"reference_id\": \"REF-2026-001\",\n \"portfolio_number\": 1,\n \"description\": \"Mensalidade junho/2026\",\n \"discounts\": [\n {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n }\n ],\n \"recurrence\": {\n \"model\": \"DUPLICATE\",\n \"type\": \"MONTHLY\",\n \"quantity\": 12,\n \"fixed_day\": 15\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "544de8fd-1846-4871-aca4-2598065115de", "name": "Boleto emitido e registrado com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "bank-slips" ], "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 \"issue_date\": \"2025-10-31\",\n \"due_date\": \"2025-11-30\",\n \"payment_limit_date\": \"2025-12-31\",\n \"amount\": 10000,\n \"rebate_amount\": 100,\n \"document_number\": \"123456\",\n \"our_number\": \"123456\",\n \"payer\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"78823832012\",\n \"person_type\": \"INDIVIDUAL\",\n \"trade_name\": \"Padaria do João\",\n \"email\": \"joao@email.com\",\n \"phone_number\": \"31999999999\",\n \"address\": {\n \"street\": \"Rua da Bahia\",\n \"number\": \"500\",\n \"complement\": \"Apto 101\",\n \"neighborhood\": \"Centro\",\n \"city\": \"Belo Horizonte\",\n \"state\": \"MG\",\n \"zip_code\": \"30111300\"\n }\n },\n \"guarantor\": {\n \"type\": \"CNPJ\",\n \"document\": \"12345678000199\",\n \"name\": \"Empresa Garantidora SA\"\n },\n \"interest\": {\n \"code\": \"PERCENTAGE_PER_MONTH\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"fine\": {\n \"code\": \"PERCENTAGE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"instructions\": [\n \"Não receber após o vencimento\"\n ],\n \"reference_id\": \"REF-2026-001\",\n \"portfolio_number\": 1,\n \"description\": \"Mensalidade junho/2026\",\n \"discounts\": [\n {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n }\n ],\n \"recurrence\": {\n \"model\": \"DUPLICATE\",\n \"type\": \"MONTHLY\",\n \"quantity\": 12,\n \"fixed_day\": 15\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"01JZ8B37N8NPBSSD59JBCNFX6J\",\n \"registration_code\": \"REG123456\",\n \"issuer_number\": \"123456789\",\n \"issue_date\": \"2025-07-31\",\n \"due_date\": \"2025-08-10\",\n \"our_number\": \"123456\",\n \"document_number\": \"DOC123456789\",\n \"identification_code\": \"ID123\",\n \"barcode\": \"27492114800000010000001010000000002002381700\",\n \"digitable_line\": \"27490001011000000000920023817008211480000001000\",\n \"amount\": 100,\n \"payment_limit_date\": \"2025-08-10\",\n \"rebate_amount\": 100,\n \"status\": \"REGISTERED\",\n \"portfolio_number\": \"109\",\n \"payer\": {\n \"person_type\": \"INDIVIDUAL\",\n \"document_number\": \"12345678901\",\n \"name\": \"João Silva\",\n \"phone_number\": \"+5511999999999\",\n \"email\": \"joao@example.com\",\n \"address\": {\n \"street\": \"Rua das Flores\",\n \"number\": \"123\",\n \"neighborhood\": \"Centro\",\n \"city\": \"São Paulo\",\n \"state\": \"SP\",\n \"zip_code\": \"01000-000\",\n \"complement\": \"Apto 101\"\n },\n \"trade_name\": \"João's Store\"\n },\n \"pdf_url\": \"https://api.meioo.com.br/accounts/bank-slips/01KSG8PEVHX28ZXMQE4QZKVG8Q/pdf\",\n \"payment_date\": \"2025-08-11\",\n \"payment_amount\": 100,\n \"credit_date\": \"2025-08-12\",\n \"credit_amount\": 100,\n \"guarantor\": {\n \"type\": \"CNPJ\",\n \"document\": \"12345678000199\",\n \"name\": \"Empresa Garantidora SA\"\n },\n \"interest\": {\n \"date\": \"2025-08-01\",\n \"code\": \"01\",\n \"value\": 100\n },\n \"fine\": {\n \"date\": \"2025-08-01\",\n \"code\": \"01\",\n \"value\": 100\n },\n \"discounts\": [\n {\n \"date\": \"2025-08-01\",\n \"code\": \"02\",\n \"value\": 100\n },\n {\n \"date\": \"2025-08-01\",\n \"code\": \"02\",\n \"value\": 100\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "04aa8d73-bb12-4cb2-88b7-e70aa17b9607", "name": "Dados do boleto inválidos ou incompletos", "originalRequest": { "url": { "path": [ "accounts", "bank-slips" ], "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 \"issue_date\": \"2025-10-31\",\n \"due_date\": \"2025-11-30\",\n \"payment_limit_date\": \"2025-12-31\",\n \"amount\": 10000,\n \"rebate_amount\": 100,\n \"document_number\": \"123456\",\n \"our_number\": \"123456\",\n \"payer\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"78823832012\",\n \"person_type\": \"INDIVIDUAL\",\n \"trade_name\": \"Padaria do João\",\n \"email\": \"joao@email.com\",\n \"phone_number\": \"31999999999\",\n \"address\": {\n \"street\": \"Rua da Bahia\",\n \"number\": \"500\",\n \"complement\": \"Apto 101\",\n \"neighborhood\": \"Centro\",\n \"city\": \"Belo Horizonte\",\n \"state\": \"MG\",\n \"zip_code\": \"30111300\"\n }\n },\n \"guarantor\": {\n \"type\": \"CNPJ\",\n \"document\": \"12345678000199\",\n \"name\": \"Empresa Garantidora SA\"\n },\n \"interest\": {\n \"code\": \"PERCENTAGE_PER_MONTH\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"fine\": {\n \"code\": \"PERCENTAGE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"instructions\": [\n \"Não receber após o vencimento\"\n ],\n \"reference_id\": \"REF-2026-001\",\n \"portfolio_number\": 1,\n \"description\": \"Mensalidade junho/2026\",\n \"discounts\": [\n {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n }\n ],\n \"recurrence\": {\n \"model\": \"DUPLICATE\",\n \"type\": \"MONTHLY\",\n \"quantity\": 12,\n \"fixed_day\": 15\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados do boleto inválidos ou incompletos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 1693\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8591e69f-68c8-44ec-ac50-b2ae67e79427", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "bank-slips" ], "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 \"issue_date\": \"2025-10-31\",\n \"due_date\": \"2025-11-30\",\n \"payment_limit_date\": \"2025-12-31\",\n \"amount\": 10000,\n \"rebate_amount\": 100,\n \"document_number\": \"123456\",\n \"our_number\": \"123456\",\n \"payer\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"78823832012\",\n \"person_type\": \"INDIVIDUAL\",\n \"trade_name\": \"Padaria do João\",\n \"email\": \"joao@email.com\",\n \"phone_number\": \"31999999999\",\n \"address\": {\n \"street\": \"Rua da Bahia\",\n \"number\": \"500\",\n \"complement\": \"Apto 101\",\n \"neighborhood\": \"Centro\",\n \"city\": \"Belo Horizonte\",\n \"state\": \"MG\",\n \"zip_code\": \"30111300\"\n }\n },\n \"guarantor\": {\n \"type\": \"CNPJ\",\n \"document\": \"12345678000199\",\n \"name\": \"Empresa Garantidora SA\"\n },\n \"interest\": {\n \"code\": \"PERCENTAGE_PER_MONTH\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"fine\": {\n \"code\": \"PERCENTAGE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"instructions\": [\n \"Não receber após o vencimento\"\n ],\n \"reference_id\": \"REF-2026-001\",\n \"portfolio_number\": 1,\n \"description\": \"Mensalidade junho/2026\",\n \"discounts\": [\n {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n }\n ],\n \"recurrence\": {\n \"model\": \"DUPLICATE\",\n \"type\": \"MONTHLY\",\n \"quantity\": 12,\n \"fixed_day\": 15\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cd03078f-940c-4111-8421-f3cba4097989", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "bank-slips" ], "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 \"issue_date\": \"2025-10-31\",\n \"due_date\": \"2025-11-30\",\n \"payment_limit_date\": \"2025-12-31\",\n \"amount\": 10000,\n \"rebate_amount\": 100,\n \"document_number\": \"123456\",\n \"our_number\": \"123456\",\n \"payer\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"78823832012\",\n \"person_type\": \"INDIVIDUAL\",\n \"trade_name\": \"Padaria do João\",\n \"email\": \"joao@email.com\",\n \"phone_number\": \"31999999999\",\n \"address\": {\n \"street\": \"Rua da Bahia\",\n \"number\": \"500\",\n \"complement\": \"Apto 101\",\n \"neighborhood\": \"Centro\",\n \"city\": \"Belo Horizonte\",\n \"state\": \"MG\",\n \"zip_code\": \"30111300\"\n }\n },\n \"guarantor\": {\n \"type\": \"CNPJ\",\n \"document\": \"12345678000199\",\n \"name\": \"Empresa Garantidora SA\"\n },\n \"interest\": {\n \"code\": \"PERCENTAGE_PER_MONTH\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"fine\": {\n \"code\": \"PERCENTAGE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"instructions\": [\n \"Não receber após o vencimento\"\n ],\n \"reference_id\": \"REF-2026-001\",\n \"portfolio_number\": 1,\n \"description\": \"Mensalidade junho/2026\",\n \"discounts\": [\n {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n }\n ],\n \"recurrence\": {\n \"model\": \"DUPLICATE\",\n \"type\": \"MONTHLY\",\n \"quantity\": 12,\n \"fixed_day\": 15\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6b46e35f-c103-4215-a7fd-4a49df900c04", "name": "Falha no registro do boleto na CIP", "originalRequest": { "url": { "path": [ "accounts", "bank-slips" ], "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 \"issue_date\": \"2025-10-31\",\n \"due_date\": \"2025-11-30\",\n \"payment_limit_date\": \"2025-12-31\",\n \"amount\": 10000,\n \"rebate_amount\": 100,\n \"document_number\": \"123456\",\n \"our_number\": \"123456\",\n \"payer\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"78823832012\",\n \"person_type\": \"INDIVIDUAL\",\n \"trade_name\": \"Padaria do João\",\n \"email\": \"joao@email.com\",\n \"phone_number\": \"31999999999\",\n \"address\": {\n \"street\": \"Rua da Bahia\",\n \"number\": \"500\",\n \"complement\": \"Apto 101\",\n \"neighborhood\": \"Centro\",\n \"city\": \"Belo Horizonte\",\n \"state\": \"MG\",\n \"zip_code\": \"30111300\"\n }\n },\n \"guarantor\": {\n \"type\": \"CNPJ\",\n \"document\": \"12345678000199\",\n \"name\": \"Empresa Garantidora SA\"\n },\n \"interest\": {\n \"code\": \"PERCENTAGE_PER_MONTH\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"fine\": {\n \"code\": \"PERCENTAGE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"instructions\": [\n \"Não receber após o vencimento\"\n ],\n \"reference_id\": \"REF-2026-001\",\n \"portfolio_number\": 1,\n \"description\": \"Mensalidade junho/2026\",\n \"discounts\": [\n {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n }\n ],\n \"recurrence\": {\n \"model\": \"DUPLICATE\",\n \"type\": \"MONTHLY\",\n \"quantity\": 12,\n \"fixed_day\": 15\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 422,\n \"code\": \"BANK_SLIP_REGISTRATION_FAILED\",\n \"message\": \"Falha no registro do boleto na CIP\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 829\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "57605623-c0ae-4416-baaf-0d86e8f620d3", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "bank-slips" ], "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 \"issue_date\": \"2025-10-31\",\n \"due_date\": \"2025-11-30\",\n \"payment_limit_date\": \"2025-12-31\",\n \"amount\": 10000,\n \"rebate_amount\": 100,\n \"document_number\": \"123456\",\n \"our_number\": \"123456\",\n \"payer\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"78823832012\",\n \"person_type\": \"INDIVIDUAL\",\n \"trade_name\": \"Padaria do João\",\n \"email\": \"joao@email.com\",\n \"phone_number\": \"31999999999\",\n \"address\": {\n \"street\": \"Rua da Bahia\",\n \"number\": \"500\",\n \"complement\": \"Apto 101\",\n \"neighborhood\": \"Centro\",\n \"city\": \"Belo Horizonte\",\n \"state\": \"MG\",\n \"zip_code\": \"30111300\"\n }\n },\n \"guarantor\": {\n \"type\": \"CNPJ\",\n \"document\": \"12345678000199\",\n \"name\": \"Empresa Garantidora SA\"\n },\n \"interest\": {\n \"code\": \"PERCENTAGE_PER_MONTH\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"fine\": {\n \"code\": \"PERCENTAGE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"instructions\": [\n \"Não receber após o vencimento\"\n ],\n \"reference_id\": \"REF-2026-001\",\n \"portfolio_number\": 1,\n \"description\": \"Mensalidade junho/2026\",\n \"discounts\": [\n {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n }\n ],\n \"recurrence\": {\n \"model\": \"DUPLICATE\",\n \"type\": \"MONTHLY\",\n \"quantity\": 12,\n \"fixed_day\": 15\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e22d4c08-6287-494a-9877-9d9c373e9f89", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "bank-slips" ], "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 \"issue_date\": \"2025-10-31\",\n \"due_date\": \"2025-11-30\",\n \"payment_limit_date\": \"2025-12-31\",\n \"amount\": 10000,\n \"rebate_amount\": 100,\n \"document_number\": \"123456\",\n \"our_number\": \"123456\",\n \"payer\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"78823832012\",\n \"person_type\": \"INDIVIDUAL\",\n \"trade_name\": \"Padaria do João\",\n \"email\": \"joao@email.com\",\n \"phone_number\": \"31999999999\",\n \"address\": {\n \"street\": \"Rua da Bahia\",\n \"number\": \"500\",\n \"complement\": \"Apto 101\",\n \"neighborhood\": \"Centro\",\n \"city\": \"Belo Horizonte\",\n \"state\": \"MG\",\n \"zip_code\": \"30111300\"\n }\n },\n \"guarantor\": {\n \"type\": \"CNPJ\",\n \"document\": \"12345678000199\",\n \"name\": \"Empresa Garantidora SA\"\n },\n \"interest\": {\n \"code\": \"PERCENTAGE_PER_MONTH\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"fine\": {\n \"code\": \"PERCENTAGE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"instructions\": [\n \"Não receber após o vencimento\"\n ],\n \"reference_id\": \"REF-2026-001\",\n \"portfolio_number\": 1,\n \"description\": \"Mensalidade junho/2026\",\n \"discounts\": [\n {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n {\n \"code\": \"FIXED_UNTIL_DATE\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n }\n ],\n \"recurrence\": {\n \"model\": \"DUPLICATE\",\n \"type\": \"MONTHLY\",\n \"quantity\": 12,\n \"fixed_day\": 15\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "459f3c42-d9cc-4e3d-8410-6a524d003027", "name": "Consultar boletos", "request": { "name": "Consultar boletos", "description": { "content": "Retorna a lista de boletos registrados pela conta, ordenada do mais recente para o mais antigo. Todos os filtros são opcionais e combináveis.\n\n**Filtros disponíveis:**\n- `status`: situação do boleto (REGISTERED, PAID, CANCELLED, ...).\n- `portfolio`: número da carteira do cedente.\n- `from_date` / `to_date`: período de **registro** no sistema (`created_at`).\n- `from_issue_date` / `to_issue_date`: período de **emissão** declarado no boleto (`issue_date`).\n- `from_due_date` / `to_due_date`: período de **vencimento** (`due_date`).\n\nDatas no formato `yyyy-MM-dd`.\n\n**Paginação por cursor:** informe `limit` (tamanho da página) e, para avançar, o `cursor` retornado em `page_info.next_cursor` da resposta anterior. Enquanto houver mais páginas, `page_info.has_next_page` é `true`.", "type": "text/plain" }, "url": { "path": [ "accounts", "bank-slips" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "limit", "value": "20", "description": "Quantidade de itens por página (paginação por cursor). 1–100, default 10." }, { "disabled": false, "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=", "description": "Cursor da próxima página. Use exatamente o valor retornado em `page_info.next_cursor` da resposta anterior — é um token **opaco** (não construa nem interprete). Omita na primeira página." }, { "disabled": false, "key": "status", "value": "REGISTERED", "description": "Situação do boleto registrado" }, { "disabled": false, "key": "portfolio", "value": "9", "description": "Número da carteira. 1: Simples, 9: CNAB" }, { "disabled": false, "key": "from_date", "value": "2023-01-01", "description": "Data de registro inicial (quando o boleto foi registrado no sistema)" }, { "disabled": false, "key": "to_date", "value": "2023-01-31", "description": "Data de registro final (quando o boleto foi registrado no sistema)" }, { "disabled": false, "key": "from_issue_date", "value": "2023-01-01", "description": "Data de emissão inicial (issue_date declarada no boleto)" }, { "disabled": false, "key": "to_issue_date", "value": "2023-01-31", "description": "Data de emissão final (issue_date declarada no boleto)" }, { "disabled": false, "key": "from_due_date", "value": "2023-01-01", "description": "Data de vencimento inicial" }, { "disabled": false, "key": "to_due_date", "value": "2023-01-31", "description": "Data de vencimento final" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "e0fb8fe7-4645-4dd4-8245-8a156ea1da22", "name": "Lista de boletos retornada com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "bank-slips" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "20" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "status", "value": "REGISTERED" }, { "key": "portfolio", "value": "9" }, { "key": "from_date", "value": "2023-01-01" }, { "key": "to_date", "value": "2023-01-31" }, { "key": "from_issue_date", "value": "2023-01-01" }, { "key": "to_issue_date", "value": "2023-01-31" }, { "key": "from_due_date", "value": "2023-01-01" }, { "key": "to_due_date", "value": "2023-01-31" } ], "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 \"payer\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"78823832012\",\n \"person_type\": \"INDIVIDUAL\",\n \"trade_name\": \"Padaria do João\",\n \"email\": \"joao@email.com\",\n \"phone_number\": \"31999999999\",\n \"address\": {\n \"street\": \"Rua da Bahia\",\n \"number\": \"500\",\n \"complement\": \"Apto 101\",\n \"neighborhood\": \"Centro\",\n \"city\": \"Belo Horizonte\",\n \"state\": \"MG\",\n \"zip_code\": \"30111300\"\n }\n },\n \"id\": \"1234567890\",\n \"pdf_url\": \"https://api.meioo.com.br/accounts/bank-slips/01KSK.../pdf\",\n \"registration_code\": {},\n \"issuer_number\": {},\n \"issuer_code\": {},\n \"issue_date\": {},\n \"due_date\": {},\n \"payment_limit_date\": {},\n \"our_number\": {},\n \"document_number\": {},\n \"barcode\": {},\n \"digitable_line\": {},\n \"amount\": {},\n \"rebate_amount\": {},\n \"status\": \"REGISTERED\",\n \"portfolio_number\": {},\n \"payment_date\": {},\n \"payment_amount\": {},\n \"credit_date\": {},\n \"credit_amount\": {},\n \"interest\": {\n \"code\": \"123\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"fine\": {\n \"code\": \"123\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"discounts\": [\n {\n \"code\": \"123\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n {\n \"code\": \"123\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n }\n ],\n \"instructions\": [\n \"Após o vencimento cobrar multa de 2%.\",\n \"Pagar preferencialmente na Meioo.\"\n ],\n \"guarantor\": {\n \"type\": \"CPF\",\n \"document\": \"78823832012\",\n \"name\": \"João da Silva\"\n },\n \"registration_date\": {},\n \"title_species\": {},\n \"payment_blocked\": {},\n \"is_hybrid\": {},\n \"pix_emv\": {},\n \"pix_qr_code\": {}\n },\n {\n \"payer\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"78823832012\",\n \"person_type\": \"INDIVIDUAL\",\n \"trade_name\": \"Padaria do João\",\n \"email\": \"joao@email.com\",\n \"phone_number\": \"31999999999\",\n \"address\": {\n \"street\": \"Rua da Bahia\",\n \"number\": \"500\",\n \"complement\": \"Apto 101\",\n \"neighborhood\": \"Centro\",\n \"city\": \"Belo Horizonte\",\n \"state\": \"MG\",\n \"zip_code\": \"30111300\"\n }\n },\n \"id\": \"1234567890\",\n \"pdf_url\": \"https://api.meioo.com.br/accounts/bank-slips/01KSK.../pdf\",\n \"registration_code\": {},\n \"issuer_number\": {},\n \"issuer_code\": {},\n \"issue_date\": {},\n \"due_date\": {},\n \"payment_limit_date\": {},\n \"our_number\": {},\n \"document_number\": {},\n \"barcode\": {},\n \"digitable_line\": {},\n \"amount\": {},\n \"rebate_amount\": {},\n \"status\": \"REGISTERED\",\n \"portfolio_number\": {},\n \"payment_date\": {},\n \"payment_amount\": {},\n \"credit_date\": {},\n \"credit_amount\": {},\n \"interest\": {\n \"code\": \"123\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"fine\": {\n \"code\": \"123\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"discounts\": [\n {\n \"code\": \"123\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n {\n \"code\": \"123\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n }\n ],\n \"instructions\": [\n \"Após o vencimento cobrar multa de 2%.\",\n \"Pagar preferencialmente na Meioo.\"\n ],\n \"guarantor\": {\n \"type\": \"CPF\",\n \"document\": \"78823832012\",\n \"name\": \"João da Silva\"\n },\n \"registration_date\": {},\n \"title_species\": {},\n \"payment_blocked\": {},\n \"is_hybrid\": {},\n \"pix_emv\": {},\n \"pix_qr_code\": {}\n }\n ],\n \"page_info\": {\n \"next_cursor\": {},\n \"has_next_page\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a9ddeea9-b047-433c-9d02-fd9a444a150f", "name": "Parâmetros de filtro ausentes ou inválidos", "originalRequest": { "url": { "path": [ "accounts", "bank-slips" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "20" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "status", "value": "REGISTERED" }, { "key": "portfolio", "value": "9" }, { "key": "from_date", "value": "2023-01-01" }, { "key": "to_date", "value": "2023-01-31" }, { "key": "from_issue_date", "value": "2023-01-01" }, { "key": "to_issue_date", "value": "2023-01-31" }, { "key": "from_due_date", "value": "2023-01-01" }, { "key": "to_due_date", "value": "2023-01-31" } ], "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 \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Parâmetros de filtro ausentes ou inválidos\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "90b6ff55-4b64-4e1d-94b6-d08cf855f442", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "bank-slips" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "20" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "status", "value": "REGISTERED" }, { "key": "portfolio", "value": "9" }, { "key": "from_date", "value": "2023-01-01" }, { "key": "to_date", "value": "2023-01-31" }, { "key": "from_issue_date", "value": "2023-01-01" }, { "key": "to_issue_date", "value": "2023-01-31" }, { "key": "from_due_date", "value": "2023-01-01" }, { "key": "to_due_date", "value": "2023-01-31" } ], "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 \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "af140997-671d-48f2-a9fa-44c56397f12f", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "bank-slips" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "20" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "status", "value": "REGISTERED" }, { "key": "portfolio", "value": "9" }, { "key": "from_date", "value": "2023-01-01" }, { "key": "to_date", "value": "2023-01-31" }, { "key": "from_issue_date", "value": "2023-01-01" }, { "key": "to_issue_date", "value": "2023-01-31" }, { "key": "from_due_date", "value": "2023-01-01" }, { "key": "to_due_date", "value": "2023-01-31" } ], "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 \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "468c3169-888f-4d72-80a6-8a0e4045a031", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "bank-slips" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "20" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "status", "value": "REGISTERED" }, { "key": "portfolio", "value": "9" }, { "key": "from_date", "value": "2023-01-01" }, { "key": "to_date", "value": "2023-01-31" }, { "key": "from_issue_date", "value": "2023-01-01" }, { "key": "to_issue_date", "value": "2023-01-31" }, { "key": "from_due_date", "value": "2023-01-01" }, { "key": "to_due_date", "value": "2023-01-31" } ], "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9bf7d757-7747-4199-ba71-d1f1184c2cd1", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "bank-slips" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "20" }, { "key": "cursor", "value": "eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=" }, { "key": "status", "value": "REGISTERED" }, { "key": "portfolio", "value": "9" }, { "key": "from_date", "value": "2023-01-01" }, { "key": "to_date", "value": "2023-01-31" }, { "key": "from_issue_date", "value": "2023-01-01" }, { "key": "to_issue_date", "value": "2023-01-31" }, { "key": "from_due_date", "value": "2023-01-01" }, { "key": "to_due_date", "value": "2023-01-31" } ], "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c21d5818-1972-449e-b4bc-71ef3edcd322", "name": "Consultar boleto por ID", "request": { "name": "Consultar boleto por ID", "description": { "content": "Retorna os dados completos de um boleto registrado a partir do seu ID interno. Inclui status atual, dados de pagamento (quando aplicável) e informações do sacado.", "type": "text/plain" }, "url": { "path": [ "accounts", "bank-slips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "165181d4-97c8-4eef-8ece-86adc5764d7c", "name": "Dados do boleto retornados com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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 \"payer\": {\n \"name\": \"João da Silva\",\n \"document_number\": \"78823832012\",\n \"person_type\": \"INDIVIDUAL\",\n \"trade_name\": \"Padaria do João\",\n \"email\": \"joao@email.com\",\n \"phone_number\": \"31999999999\",\n \"address\": {\n \"street\": \"Rua da Bahia\",\n \"number\": \"500\",\n \"complement\": \"Apto 101\",\n \"neighborhood\": \"Centro\",\n \"city\": \"Belo Horizonte\",\n \"state\": \"MG\",\n \"zip_code\": \"30111300\"\n }\n },\n \"id\": \"1234567890\",\n \"pdf_url\": \"https://api.meioo.com.br/accounts/bank-slips/01KSK.../pdf\",\n \"registration_code\": {},\n \"issuer_number\": {},\n \"issuer_code\": {},\n \"issue_date\": {},\n \"due_date\": {},\n \"payment_limit_date\": {},\n \"our_number\": {},\n \"document_number\": {},\n \"barcode\": {},\n \"digitable_line\": {},\n \"amount\": {},\n \"rebate_amount\": {},\n \"status\": \"REGISTERED\",\n \"portfolio_number\": {},\n \"payment_date\": {},\n \"payment_amount\": {},\n \"credit_date\": {},\n \"credit_amount\": {},\n \"interest\": {\n \"code\": \"123\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"fine\": {\n \"code\": \"123\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n \"discounts\": [\n {\n \"code\": \"123\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n },\n {\n \"code\": \"123\",\n \"date\": \"2025-11-01\",\n \"value\": 1000\n }\n ],\n \"instructions\": [\n \"Após o vencimento cobrar multa de 2%.\",\n \"Pagar preferencialmente na Meioo.\"\n ],\n \"guarantor\": {\n \"type\": \"CPF\",\n \"document\": \"78823832012\",\n \"name\": \"João da Silva\"\n },\n \"registration_date\": {},\n \"title_species\": {},\n \"payment_blocked\": {},\n \"is_hybrid\": {},\n \"pix_emv\": {},\n \"pix_qr_code\": {}\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "63fa8af1-b30a-4010-b97d-9f090302d8ea", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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 \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "692a7399-e78d-4a13-9228-1a3ab3d63af9", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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 \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "996ef2c8-59e5-41c3-b69a-1f08d49f9ff2", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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 \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1e363d83-53b3-4ea6-b177-1fba50bd9dc6", "name": "Boleto não encontrado ou não pertence à conta", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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 \"status_code\": 404,\n \"code\": \"BANK_SLIP_NOT_FOUND\",\n \"message\": \"Boleto não encontrado ou não pertence à conta\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 7793,\n \"key_1\": 1239\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f199b2fb-ab6c-4cf7-ad8f-62b40e7bfe7a", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5385b9dc-6fd6-427c-815d-89599c631554", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b31cc2de-21fd-4779-b9ba-074223fe7e97", "name": "Cancelar boleto registrado", "request": { "name": "Cancelar boleto registrado", "description": { "content": "Cancela um boleto registrado, tornando-o inválido para pagamento. O cancelamento é propagado para a CIP.\n\n**Regras:**\n• Somente boletos com status `REGISTERED` ou `PENDING` podem ser cancelados\n• Boletos já pagos não podem ser cancelados — utilize o reembolso\n• O cancelamento é irreversível", "type": "text/plain" }, "url": { "path": [ "accounts", "bank-slips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto a ser cancelado" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "2ca5bfec-a9c7-4ae9-b6eb-fedb7aefea31", "name": "Boleto cancelado com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto a ser cancelado" } ] }, "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": "f20449fe-207f-4577-b6f2-249540c0ea2f", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto a ser cancelado" } ] }, "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": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8a7e0175-bc8d-46e1-95e1-7c8619280038", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto a ser cancelado" } ] }, "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 \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0d1c52de-73ea-47df-a283-200421bef631", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto a ser cancelado" } ] }, "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": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c778fe9a-dd83-4ed7-b621-17b97f5ac28c", "name": "Boleto não encontrado ou não pertence à conta", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto a ser cancelado" } ] }, "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 \"status_code\": 404,\n \"code\": \"BANK_SLIP_NOT_FOUND\",\n \"message\": \"Boleto não encontrado ou não pertence à conta\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 7793,\n \"key_1\": 1239\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1019b9c6-d9f6-4832-874c-72e86a889ea4", "name": "Boleto no estado atual não permite cancelamento", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto a ser cancelado" } ] }, "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": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 422,\n \"code\": \"BANK_SLIP_CANCELLATION_NOT_ALLOWED\",\n \"message\": \"Boleto no estado atual não permite cancelamento\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "62cb3658-069c-46b4-a195-6614330feff7", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto a ser cancelado" } ] }, "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "478a7074-0f31-41a1-950b-ac6eb02173e8", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto a ser cancelado" } ] }, "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "7b8ab3dc-ab3b-4222-8d0b-8795fca64a38", "name": "Gerar PDF de boleto", "request": { "name": "Gerar PDF de boleto", "description": { "content": "Gera e retorna o PDF do boleto registrado, pronto para impressão ou envio ao pagador. O arquivo segue o layout padrão FEBRABAN.\n\n**Content-Type da resposta:** `application/pdf`\n\n**Disponibilidade:** O PDF fica disponível após o registro bem-sucedido do boleto.", "type": "text/plain" }, "url": { "path": [ "accounts", "bank-slips", ":id", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "header": [ { "key": "Accept", "value": "application/pdf" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "3ab98ae1-f649-4e3f-840d-b91b76b0615d", "name": "PDF do boleto gerado com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/pdf" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/pdf" } ], "body": "string", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "538fe1d7-ad8c-48b5-a735-7ee4bbde26da", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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 \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fd59453b-f96c-4c6e-a485-48dcda335a06", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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 \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "258e7e7b-d334-4f06-814d-79a6763286eb", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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 \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2b50e120-2389-4b91-b206-c681c10a2314", "name": "Boleto não encontrado ou não pertence à conta", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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 \"status_code\": 404,\n \"code\": \"BANK_SLIP_NOT_FOUND\",\n \"message\": \"Boleto não encontrado ou não pertence à conta\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 7793,\n \"key_1\": 1239\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "385d55bf-6287-48e8-829d-b677a5ef9336", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d6d98bf2-49d4-4736-b760-2dd4cadd1c6d", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id", "pdf" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b2c87da3-1f0b-439c-9a27-f2816e733216", "name": "Gerar link público para PDF do boleto", "request": { "name": "Gerar link público para PDF do boleto", "description": { "content": "Gera uma URL pública e temporária para acesso ao PDF do boleto sem autenticação. Ideal para enviar ao pagador por e-mail, SMS ou WhatsApp.\n\n**Segurança:**\n• O link é um token opaco (UUID) sem informações sensíveis\n• Expira automaticamente\n• Boletos cancelados retornam 404 mesmo com link válido\n\n**Múltiplos links:** Cada chamada gera um novo link independente. Links anteriores permanecem válidos até expirar.", "type": "text/plain" }, "url": { "path": [ "accounts", "bank-slips", ":id", "pdf", "link" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "32b8221e-7cb0-481b-b7f3-67a7d5f5d2a0", "name": "Link público gerado com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id", "pdf", "link" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"url\": \"https://api.meioo.com.br/public/bank-slips/pdf/b44617f4-cf27-470e-8555-bcb68bbe9fd1\",\n \"expires_at\": \"2026-06-03T15:30:00-03:00\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "031bd175-ecf8-4876-ba79-355c719ace15", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id", "pdf", "link" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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 Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "988d2d47-634f-4c64-a7bb-e7ec490b2b39", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id", "pdf", "link" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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 \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9740ffd1-3f6e-4ab3-a8ef-52299ce84e0d", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id", "pdf", "link" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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 \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a1bdcdf1-7f89-4af4-8f4b-547bdf7d9569", "name": "Boleto não encontrado ou não pertence à conta", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id", "pdf", "link" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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 \"status_code\": 404,\n \"code\": \"BANK_SLIP_NOT_FOUND\",\n \"message\": \"Boleto não encontrado ou não pertence à conta\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 7793,\n \"key_1\": 1239\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c53a9dca-770f-4c49-8054-1fd014c05755", "name": "Boleto cancelado, link não pode ser gerado", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id", "pdf", "link" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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 \"status_code\": 409,\n \"code\": \"BANK_SLIP_CANCELLED\",\n \"message\": \"Boleto cancelado, link não pode ser gerado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "71ad3785-2817-4c3f-b61c-a25bb8113376", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id", "pdf", "link" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f9c41db2-3cda-4693-b20a-d0fad4e745f0", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", ":id", "pdf", "link" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "01JZWY347BXD9X4F294HTPX1VE", "key": "id", "description": "(Required) ID do boleto registrado" } ] }, "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5fce190d-1861-432f-9d79-fa7f77a36c31", "name": "Cadastrar cedente", "request": { "name": "Cadastrar cedente", "description": { "content": "Cadastra a conta como cedente de boletos bancários junto ao provider. O cadastro é pré-requisito para emissão de boletos próprios.\n\n**Regras:**\n• Cada conta pode ter apenas um cedente\n• O cedente é ativado automaticamente após confirmação do provider\n• Requer papel de MASTER na conta", "type": "text/plain" }, "url": { "path": [ "accounts", "bank-slips", "issuers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "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 \"portfolio_type\": \"SIMPLE\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "6dfd2edd-3095-4518-9964-dc0d56c000dc", "name": "Cedente cadastrado e ativado com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"portfolio_type\": \"SIMPLE\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"01JZWY347BXD9X4F294HTPX1VE\",\n \"issuer_number\": \"123456789\",\n \"status\": \"ACTIVE\",\n \"activated_at\": \"2026-05-26T14:30:00-03:00\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0bf2886e-6ad0-49de-bc2b-ba4839ff8d27", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"portfolio_type\": \"SIMPLE\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9f7ea0e5-82a6-4c94-a149-8fc8fe5bcee2", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"portfolio_type\": \"SIMPLE\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4f7fb4f1-ebca-428f-8190-47a8ddb1117b", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"portfolio_type\": \"SIMPLE\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4351d07a-9dac-4ca8-aeb0-6bd24b7c7ddf", "name": "Conta já possui cedente cadastrado", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"portfolio_type\": \"SIMPLE\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 409,\n \"code\": \"ISSUER_ALREADY_EXISTS\",\n \"message\": \"Conta já possui cedente cadastrado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c4705891-2267-4e03-bc24-2663f4a01ae3", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"portfolio_type\": \"SIMPLE\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "55e2e5f8-ad42-47c4-a8f3-48fbfa122c30", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"portfolio_type\": \"SIMPLE\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f25a5e1a-28fa-4533-8aac-fe0c4d4db483", "name": "Consultar cedente", "request": { "name": "Consultar cedente", "description": { "content": "Retorna os dados do cedente da conta, incluindo número do cedente e status.", "type": "text/plain" }, "url": { "path": [ "accounts", "bank-slips", "issuers", "current" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "dfae82af-c9eb-4707-8bca-731dd43a49d5", "name": "Dados do cedente retornados com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current" ], "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 \"id\": \"01JZWY347BXD9X4F294HTPX1VE\",\n \"issuer_number\": \"123456789\",\n \"status\": \"ACTIVE\",\n \"created_at\": \"2026-05-26T14:00:00-03:00\",\n \"portfolios\": [\n {\n \"id\": \"01JZWY347BXD9X4F294HTPX1VE\",\n \"portfolio_number\": 17,\n \"portfolio_type\": \"SIMPLE\",\n \"status\": \"ACTIVE\",\n \"title_species\": 99,\n \"interest_code\": \"FIXED_PER_DAY\",\n \"interest_value\": 100,\n \"fine_code\": \"PERCENTAGE\",\n \"fine_value\": 200,\n \"discount_code\": \"EXEMPT\",\n \"payment_type\": \"DUE_DATE\",\n \"our_number_origin\": \"PROVIDER\",\n \"payment_limit_days\": 30,\n \"is_hybrid\": true,\n \"cnab_enabled\": false,\n \"cnab_company_code\": \"00012345\"\n },\n {\n \"id\": \"01JZWY347BXD9X4F294HTPX1VE\",\n \"portfolio_number\": 17,\n \"portfolio_type\": \"SIMPLE\",\n \"status\": \"ACTIVE\",\n \"title_species\": 99,\n \"interest_code\": \"FIXED_PER_DAY\",\n \"interest_value\": 100,\n \"fine_code\": \"PERCENTAGE\",\n \"fine_value\": 200,\n \"discount_code\": \"EXEMPT\",\n \"payment_type\": \"DUE_DATE\",\n \"our_number_origin\": \"PROVIDER\",\n \"payment_limit_days\": 30,\n \"is_hybrid\": true,\n \"cnab_enabled\": false,\n \"cnab_company_code\": \"00012345\"\n }\n ],\n \"activated_at\": \"2026-05-26T14:30:00-03:00\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bd6186c5-1dc1-458b-9892-851c57f4cdee", "name": "Dados inválidos na requisição", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current" ], "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": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Dados inválidos na requisição\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 4108.629989496835,\n \"key_1\": 9902\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1be6b72f-e0ef-4e4f-9430-a518559466fe", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current" ], "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 \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9100c575-462f-485e-8887-f5903d1034a1", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current" ], "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 \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6c0496b5-ef74-4a0e-bcf9-03f6c6b14fee", "name": "Conta não possui cedente cadastrado", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current" ], "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 \"status_code\": 404,\n \"code\": \"ISSUER_NOT_FOUND\",\n \"message\": \"Conta não possui cedente cadastrado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 2989,\n \"key_1\": 4172.696148583239,\n \"key_2\": \"string\",\n \"key_3\": 9518.274140774618,\n \"key_4\": 8086\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6773b5a1-9e77-4d48-ae53-1628e7327f1f", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current" ], "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": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4e3cdf91-da6a-4cc8-b546-7cd25e300f21", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current" ], "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": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1192e277-cb28-4238-9edf-feec42a0c463", "name": "Desativar cedente", "request": { "name": "Desativar cedente", "description": { "content": "Desativa o cedente da conta, impedindo a emissão de novos boletos. Boletos já emitidos permanecem válidos.\n\n**Regras:**\n• Somente cedentes com status ACTIVE podem ser desativados\n• A desativação é irreversível — para reativar, entre em contato com o suporte\n• Requer papel de MASTER na conta", "type": "text/plain" }, "url": { "path": [ "accounts", "bank-slips", "issuers", "current", "deactivate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "36488c89-ee71-4d85-a6d0-912705bab80c", "name": "Cedente desativado com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current", "deactivate" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"01JZWY347BXD9X4F294HTPX1VE\",\n \"status\": \"INACTIVE\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9fb5bbc5-3f13-48e2-a07c-8cdb8b317cee", "name": "Cedente não está ativo para desativação", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current", "deactivate" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"ISSUER_NOT_ACTIVE\",\n \"message\": \"Cedente não está ativo para desativação\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 6847.466873154877\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2586dd49-3530-4eec-a324-c69863b365ec", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current", "deactivate" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "593134ec-d11a-4cb8-81be-aa7486add871", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current", "deactivate" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8cbce3e3-bd99-4d5c-946d-164deb265268", "name": "Conta não possui cedente cadastrado", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current", "deactivate" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 404,\n \"code\": \"ISSUER_NOT_FOUND\",\n \"message\": \"Conta não possui cedente cadastrado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 2989,\n \"key_1\": 4172.696148583239,\n \"key_2\": \"string\",\n \"key_3\": 9518.274140774618,\n \"key_4\": 8086\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1a093abb-102b-4625-9706-57128e2106e9", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current", "deactivate" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2fbc46c1-522b-4549-b771-d6ded18eb467", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current", "deactivate" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "30cdcbc5-c77f-4e72-a436-b8cbb38625f8", "name": "Vincular carteira ao cedente", "request": { "name": "Vincular carteira ao cedente", "description": { "content": "Vincula uma nova carteira de cobrança ao cedente da conta. A carteira define as regras padrão para emissão de boletos (juros, multa, desconto, espécie, etc.).\n\n**Configurações da carteira:**\n• Tipo da carteira (simples, vinculada, caucionada, descontada, vendor)\n• Espécie do documento (duplicata mercantil, duplicata de serviço, etc.)\n• Regras de juros, multa e desconto\n• Dias limite para pagamento após vencimento\n• Cobrança híbrida (boleto + Pix)\n• CNAB para remessa/retorno\n\n**Pré-requisito:** Cedente deve estar com status ACTIVE.\n\n**Permissão:** Requer papel de MASTER na conta.", "type": "text/plain" }, "url": { "path": [ "accounts", "bank-slips", "issuers", "current", "portfolios" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "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 \"portfolio_type\": \"SIMPLE\",\n \"document_species\": 2,\n \"payment_type\": \"DUE_DATE\",\n \"our_number_origin\": \"PROVIDER\",\n \"interest_code\": \"FIXED_PER_DAY\",\n \"interest_value\": 100,\n \"fine_code\": \"PERCENTAGE\",\n \"fine_value\": 200,\n \"discount_code\": \"EXEMPT\",\n \"payment_limit_days\": 30,\n \"cnab_enabled\": false,\n \"hybrid\": true\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "a6b8ed71-be94-44d5-b6fd-2c28ac6e4543", "name": "Carteira vinculada com sucesso.", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current", "portfolios" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"portfolio_type\": \"SIMPLE\",\n \"document_species\": 2,\n \"payment_type\": \"DUE_DATE\",\n \"our_number_origin\": \"PROVIDER\",\n \"interest_code\": \"FIXED_PER_DAY\",\n \"interest_value\": 100,\n \"fine_code\": \"PERCENTAGE\",\n \"fine_value\": 200,\n \"discount_code\": \"EXEMPT\",\n \"payment_limit_days\": 30,\n \"cnab_enabled\": false,\n \"hybrid\": true\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"01JZWY347BXD9X4F294HTPX1VE\",\n \"portfolio_number\": 17,\n \"portfolio_type\": \"SIMPLE\",\n \"cnab_company_code\": \"00012345\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1bf0ae38-a2ff-46f4-b614-d0782a94356d", "name": "Cedente não está ativo para vincular carteira", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current", "portfolios" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"portfolio_type\": \"SIMPLE\",\n \"document_species\": 2,\n \"payment_type\": \"DUE_DATE\",\n \"our_number_origin\": \"PROVIDER\",\n \"interest_code\": \"FIXED_PER_DAY\",\n \"interest_value\": 100,\n \"fine_code\": \"PERCENTAGE\",\n \"fine_value\": 200,\n \"discount_code\": \"EXEMPT\",\n \"payment_limit_days\": 30,\n \"cnab_enabled\": false,\n \"hybrid\": true\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 400,\n \"code\": \"ISSUER_NOT_ACTIVE\",\n \"message\": \"Cedente não está ativo para vincular carteira\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 8134,\n \"key_1\": 4548\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6f36ddd1-a666-413b-aa72-9c1e838aca95", "name": "Token de autenticação inválido ou expirado", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current", "portfolios" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"portfolio_type\": \"SIMPLE\",\n \"document_species\": 2,\n \"payment_type\": \"DUE_DATE\",\n \"our_number_origin\": \"PROVIDER\",\n \"interest_code\": \"FIXED_PER_DAY\",\n \"interest_value\": 100,\n \"fine_code\": \"PERCENTAGE\",\n \"fine_value\": 200,\n \"discount_code\": \"EXEMPT\",\n \"payment_limit_days\": 30,\n \"cnab_enabled\": false,\n \"hybrid\": true\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 401,\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token de autenticação inválido ou expirado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 5287.768278177425,\n \"key_1\": false,\n \"key_2\": false,\n \"key_3\": 2588.442296657172\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f03be626-38e8-4ce4-ab90-80498e320898", "name": "Acesso negado - permissões insuficientes", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current", "portfolios" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"portfolio_type\": \"SIMPLE\",\n \"document_species\": 2,\n \"payment_type\": \"DUE_DATE\",\n \"our_number_origin\": \"PROVIDER\",\n \"interest_code\": \"FIXED_PER_DAY\",\n \"interest_value\": 100,\n \"fine_code\": \"PERCENTAGE\",\n \"fine_value\": 200,\n \"discount_code\": \"EXEMPT\",\n \"payment_limit_days\": 30,\n \"cnab_enabled\": false,\n \"hybrid\": true\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 403,\n \"code\": \"FORBIDDEN\",\n \"message\": \"Acesso negado - permissões insuficientes\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": \"string\",\n \"key_1\": 1244,\n \"key_2\": \"string\",\n \"key_3\": 5503,\n \"key_4\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d55b8ea0-5cb8-4776-b4dc-4a61fa492a13", "name": "Conta não possui cedente cadastrado", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current", "portfolios" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"portfolio_type\": \"SIMPLE\",\n \"document_species\": 2,\n \"payment_type\": \"DUE_DATE\",\n \"our_number_origin\": \"PROVIDER\",\n \"interest_code\": \"FIXED_PER_DAY\",\n \"interest_value\": 100,\n \"fine_code\": \"PERCENTAGE\",\n \"fine_value\": 200,\n \"discount_code\": \"EXEMPT\",\n \"payment_limit_days\": 30,\n \"cnab_enabled\": false,\n \"hybrid\": true\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 404,\n \"code\": \"ISSUER_NOT_FOUND\",\n \"message\": \"Conta não possui cedente cadastrado\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": 2989,\n \"key_1\": 4172.696148583239,\n \"key_2\": \"string\",\n \"key_3\": 9518.274140774618,\n \"key_4\": 8086\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c41c624b-3fa9-4562-adac-2150d58480a2", "name": "Muitas requisições - limite excedido", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current", "portfolios" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"portfolio_type\": \"SIMPLE\",\n \"document_species\": 2,\n \"payment_type\": \"DUE_DATE\",\n \"our_number_origin\": \"PROVIDER\",\n \"interest_code\": \"FIXED_PER_DAY\",\n \"interest_value\": 100,\n \"fine_code\": \"PERCENTAGE\",\n \"fine_value\": 200,\n \"discount_code\": \"EXEMPT\",\n \"payment_limit_days\": 30,\n \"cnab_enabled\": false,\n \"hybrid\": true\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 429,\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Muitas requisições - limite excedido\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": false,\n \"key_1\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1efc7f20-ef17-4f23-8693-674101f17053", "name": "Erro interno do servidor", "originalRequest": { "url": { "path": [ "accounts", "bank-slips", "issuers", "current", "portfolios" ], "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": "Assinatura HMAC-SHA256 do payload. Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-signature", "value": "string" }, { "disabled": false, "description": "Timestamp Unix em segundos (validade de 60 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-timestamp", "value": "string" }, { "disabled": false, "description": "UUID único para proteção contra replay (validade de 300 segundos). Obrigatório para PARTNER. Não se aplica a APP e INTERNET_BANKING.", "key": "x-nonce", "value": "38ad5276-a3a1-fdc9-818d-4aa36695c6d7" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"portfolio_type\": \"SIMPLE\",\n \"document_species\": 2,\n \"payment_type\": \"DUE_DATE\",\n \"our_number_origin\": \"PROVIDER\",\n \"interest_code\": \"FIXED_PER_DAY\",\n \"interest_value\": 100,\n \"fine_code\": \"PERCENTAGE\",\n \"fine_value\": 200,\n \"discount_code\": \"EXEMPT\",\n \"payment_limit_days\": 30,\n \"cnab_enabled\": false,\n \"hybrid\": true\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 500,\n \"code\": \"INTERNAL_SERVER_ERROR\",\n \"message\": \"Erro interno do servidor\",\n \"timestamp\": \"2026-03-12T09:32:51.228Z\",\n \"path\": \"/api/endpoint\",\n \"details\": {\n \"key_0\": true,\n \"key_1\": 3937.6276574756575\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] } ], "event": [], "variable": [ { "type": "string", "value": "https://api.meioo.com.br", "key": "baseUrl" } ], "info": { "_postman_id": "956aa7fd-f64d-4c04-9b64-38845e9cd434", "name": "Meioo Core Banking — Documentação", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "description": { "content": "## Tipos de integração\n\nVocê verá na documentação dos endpoints os termos `PARTNER` e `ACCOUNT_API`, que representam respectivamente **Parceria Meioo** e **Integração Direta**. Ou seja, os modelos de integração com a Meioo. Esses _labels_ identificam qual, ou quais, tipos de integração pode consumir aquele determinado endpoint.\n\n## Convenções da API\n\n### Valores monetários\n\nTodos os valores monetários são representados em **centavos** (número inteiro). Não são aceitos valores decimais.\n\n| Valor real | Representação na API |\n| ----------- | -------------------- |\n| R$ 10,00 | `1000` |\n| R$ 150,50 | `15050` |\n| R$ 1.000,00 | `100000` |\n\nCampos afetados: `amount`, `fee_amount`, `current_balance`, `available_balance`, `blocked_balance`, `paid_amount`, `interest_amount`, `fine_amount`, `rebate_amount`, entre outros.\n\n### Data e hora\n\nDatas e horas são retornadas no fuso horário de **São Paulo (BRT, UTC-3)**, no formato ISO 8601 com offset:\n\n```http\n2026-05-14T14:00:00-03:00\n```\n\nEnvie datas no mesmo formato nos requests. Campos de data sem horário (ex: `due_date`) aceitam o formato `YYYY-MM-DD`.\n\n### Identificadores\n\nOs IDs gerados pela plataforma utilizam o formato **ULID** (26 caracteres, ordenáveis por tempo):\n\n```http\n01JZWY347BXD9X4F294HTPX1VE\n```\n\nIDs de referência do parceiro (`reference_id`) podem ser strings livres de até 36 caracteres.\n\n### Nomenclatura de campos\n\nTodos os campos nos payloads de request e response utilizam **snake_case**:\n\n\n```json\n{\n \"current_balance\": 125000,\n \"available_balance\": 120000,\n \"provider_transaction_id\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\",\n \"end_to_end_id\": \"E11581339202605141400A1B2C3D4E5F\"\n}\n```\n\n### Campos opcionais\n\nCampos opcionais são **omitidos** da resposta quando não possuem valor. Não são enviados como `null` — simplesmente não aparecem no JSON. Trate a ausência do campo da mesma forma que trataria um valor nulo.\n\n### Rastreamento de requisições\n\nTodas as requisições recebem um identificador único no header `x-correlation-id`. Se não informado, a plataforma gera automaticamente. O mesmo ID é propagado entre os serviços internos e pode ser utilizado pelo suporte para rastrear o fluxo completo de uma operação.\n\n```http\nGET /accounts/balance\nx-correlation-id: 550e8400-e29b-41d4-a716-446655440000\n```\n\nO header é retornado na resposta. Recomendamos armazená-lo para facilitar a investigação de incidentes.\n\n## Ambientes\n\n| Ambiente | URL Base |\n| ------------------- | -------------------------- |\n| Produção | `https://api.meioo.com.br` |\n| Teste / Homologação | `https://api.meioo.dev.br` |\n\nTodas as requisições devem utilizar HTTPS. Chamadas via HTTP são rejeitadas.\n\n## Autenticação\n\nA API oferece dois mecanismos de autenticação, cada um destinado a um perfil de integração com escopo e requisitos de segurança diferentes.\n\n### Tipos de integração\n\n| Aspecto | Integração Direta (API Key) | Parceria Meioo (OAuth2) |\n| ------------------------- | ---------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |\n| **Destinado a** | Empresa que integra a própria conta (cobranças, consultas, QR Codes) | Plataformas/parceiros que operam contas dos seus clientes |\n| **Escopo** | Consultas + geração e administração de cobranças (boletos, QR Codes, charges) | Tudo que a Integração Direta pode + operações financeiras e gestão de chaves Pix |\n| **Autenticação** | API Key → JWT (troca direta, sem consentimento do correntista) | OAuth2 Authorization Code + PKCE (com consentimento do correntista) |\n| **Operações financeiras** | Não disponível (transferências Pix, TED, TEF e pagamento de boleto são exclusivos do parceiro) | Pode executar de ponta a ponta (solicitar e aprovar) |\n| **Segurança adicional** | Não exige assinatura HMAC nem step-up (escopo restrito) | Exige assinatura HMAC (`x-signature`, `x-timestamp`, `x-nonce`) em operações sensíveis |\n| **Step-up (TOTP)** | Não se aplica | Exigido em operações críticas (transferências, devoluções) |\n\n### Integração Direta — Acesso por conta (API Key)\n\nIndicado para empresas que integram a **própria conta**: consultas de conta (saldo, extrato, comprovantes) e geração/administração de cobranças (registro e cancelamento de boletos, criação de QR Codes Pix, criação e gestão de cobranças). A API Key é vinculada a uma conta e concede acesso direto, sem necessidade de consentimento do correntista.\n\nOperações financeiras como transferências (Pix, TED, TEF) e pagamento de boleto **não estão disponíveis** neste formato — são exclusivas da **Parceria Meioo**.\n\n**Formato da API Key:**\n\n```http\nsk_{ambiente}.{identificador}.{secret}\n```\n\n| Prefixo | Ambiente |\n| ----------- | ------------------- |\n| `sk_test.*` | Teste / Homologação |\n| `sk_live.*` | Produção |\n\n**Fluxo de autenticação:**\n\n```http\nPOST /auth/api-key\nAuthorization: sk_live.meioo_partner.a1b2c3d4e5f6...\n```\n\nA resposta contém um `access_token` JWT com validade de **10 minutos**. Utilize este token no header `Authorization` para todas as chamadas subsequentes:\n\n```http\nAuthorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\n```\n\nImplemente rotação proativa de tokens: renove o token antes do vencimento para evitar interrupções.\n\n**Endpoints disponíveis (principais):** consulta de conta, saldo, extrato, comprovantes, registro e cancelamento de boletos, consulta de boletos, criação e consulta de QR Codes Pix, criação e gestão de cobranças. Veja a etiqueta **Integração Direta** em cada endpoint para a lista completa.\n\n### Parceria Meioo — Acesso delegado (OAuth2)\n\nIndicado para plataformas e parceiros que precisam operar contas dos seus clientes com acesso amplo à API. O fluxo OAuth2 garante que o correntista autorize explicitamente o acesso, e o parceiro recebe credenciais com escopos definidos.\n\nAlém do acesso a tudo que a Integração Direta oferece, a Parceria Meioo pode **aprovar operações financeiras** (transferências, devoluções, pagamentos de boleto), **gerenciar chaves Pix** (criar, excluir, MFA) e realizar **reembolsos de cobranças**. Em contrapartida, operações sensíveis exigem:\n\n- **Assinatura HMAC** (`x-signature`, `x-timestamp`, `x-nonce`) para garantir integridade e autenticidade\n- **Step-up TOTP** (código de 6 dígitos do autenticador) para autorizar operações críticas\n\n**Fluxo de autenticação (Authorization Code + PKCE):**\n\n1. `POST /oauth/authorize` com `client_id`, `redirect_uri`, `scope` e `code_challenge` (PKCE)\n2. Correntista autoriza o acesso\n3. Aplicação recebe `authorization_code` (válido por 10 minutos)\n4. `POST /oauth/token` com `grant_type=authorization_code` e `code_verifier`\n5. Resposta contém `access_token` (15 min) e `refresh_token` (30 dias)\n\nPara renovar o token sem nova autorização do correntista:\n\n```http\nPOST /oauth/token\nContent-Type: application/json\n\n{ \"grant_type\": \"refresh_token\", \"refresh_token\": \"...\" }\n```\n\n**Endpoints exclusivos da Parceria Meioo (exemplos):** aprovação de transferências (Pix, TED, TEF), aprovação de pagamento de boleto, criação e exclusão de chaves Pix, reembolso de cobranças. Veja a etiqueta **Parceria Meioo** em cada endpoint para a lista completa.\n\n## Segurança em operações sensíveis\n\nOperações financeiras (transferências, pagamentos, devoluções) exigem validações adicionais para proteger a conta contra uso não autorizado.\n\n### Idempotência\n\nEnvie o header `x-idempotency-key` com um UUID único em operações financeiras para garantir que retentativas não gerem duplicação. Se a mesma chave for enviada novamente, a plataforma retorna a resposta original sem executar a operação novamente.\n\n```http\nPOST /accounts/pix/transfers\nx-idempotency-key: 550e8400-e29b-41d4-a716-446655440000\n```\n\nSe o header não for informado, a plataforma gera uma chave automaticamente — mas nesse caso, retentativas podem resultar em operações duplicadas.\n\nO campo `reference_id` no body é uma referência de rastreamento livre do parceiro. Ele é **único por conta**: se já existir uma transação com o mesmo `reference_id` para a mesma conta, a requisição retorna HTTP 409 (Conflict).\n\n### Assinatura HMAC (parceiros)\n\nOperações de risco alto e crítico exigem assinatura HMAC-SHA256 nos headers na **Parceria Meioo**. Três headers são obrigatórios:\n\n| Header | Formato | Descrição |\n| ------------- | -------------- | ------------------------------------------------------------------ |\n| `x-signature` | Hex string | HMAC-SHA256 da string canônica (abaixo) com o secret compartilhado |\n| `x-timestamp` | Unix timestamp | Momento da requisição (validade: 60 segundos) |\n| `x-nonce` | UUID | Identificador único da requisição (validade: 300 segundos) |\n\n```http\nPOST /accounts/pix/transfers\nAuthorization: Bearer eyJhbG...\nx-signature: a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2\nx-timestamp: 1715692800\nx-nonce: 660e8400-e29b-41d4-a716-446655440001\nx-idempotency-key: 550e8400-e29b-41d4-a716-446655440000\n```\n\nA assinatura (`x-signature`) é o HMAC-SHA256, em hex, de uma **string canônica** montada a partir da própria requisição, usando o secret fornecido no onboarding do parceiro:\n\n```\ntimestamp:nonce:metodo:path:body\n```\n\n- `timestamp` / `nonce` — os mesmos valores enviados nos headers `x-timestamp` / `x-nonce`.\n- `metodo` — o método HTTP em **minúsculas** (ex.: `post`).\n- `path` — o caminho da requisição em **minúsculas**, **sem** query string (ex.: `/accounts/pix/transfers`).\n- `body` — o corpo JSON serializado (`{}` quando não há corpo).\n\nOs campos são unidos por `:`. O timestamp e o nonce evitam ataques de replay; o método e o path ligam a assinatura ao endpoint exato. Exemplo do texto assinado:\n\n```\n1715692800:660e8400-e29b-41d4-a716-446655440001:post:/accounts/pix/transfers:{\"amount\":10000,\"pix_key\":\"...\"}\n```\n\n### Autenticação step-up (TOTP)\n\nO step-up vai no campo `step_up` do body — **do endpoint de aprovação, não do de criação**. Toda operação financeira nasce em `AWAITING_APPROVAL` e só é executada quando aprovada; é a aprovação que exige a prova (TOTP de 6 dígitos do autenticador e, para APP e Internet Banking, também o PIN transacional).\n\n```json\nPATCH /accounts/approvals/transactions/{id}\n{\n \"action\": \"APPROVE\",\n \"step_up\": {\n \"totp\": \"331809\",\n \"pin\": \"1234\"\n }\n}\n```\n\n**Os endpoints de criação não aceitam `step_up`.** Como a API rejeita campo desconhecido no body, enviá-lo na criação devolve **400**. Rejeitar não exige step-up — use `action: \"REJECT\"` com `reason`.\n\nCada endpoint indica na documentação se exige step-up e quais métodos são aceitos.\n\n### Níveis de risco\n\nCada endpoint possui um nível de risco que determina quais validações são aplicadas:\n\n| Nível | Validações | Exemplos |\n| ------------ | ------------------------------------ | ------------------------------------------------------------------------------------------- |\n| **PUBLIC** | Nenhuma (endpoint sem autenticação) | Login, health check |\n| **LOW** | Token JWT + escopos | Consulta de saldo, extrato |\n| **MEDIUM** | Token JWT + escopos + papel mínimo | Registro de boleto, criação de QR Code, **criação** de Pix/TED/TEF e de pagamento de boleto |\n| **HIGH** | Tudo acima + assinatura HMAC + nonce | Criação de chave Pix |\n| **CRITICAL** | Tudo acima + step-up (TOTP) | **Aprovação** de transação (é ela que move o dinheiro) |\n\nO nível de risco e os requisitos de cada endpoint estão indicados na documentação individual do endpoint.\n\n## Camadas de segurança\n\n\n\nCada requisição passa por uma cadeia de validações antes de alcançar a lógica de negócio. As camadas são avaliadas na ordem abaixo — a primeira falha encerra a requisição com o erro correspondente.\n\n### Cadeia de validação\n\n| Ordem | Camada | Quando se aplica | Erro em caso de falha |\n| ----- | ------------------------------- | ------------------------------- | --------------------- |\n| 1 | Token JWT válido | Todos (exceto `PUBLIC`) | 401 Unauthorized |\n| 2 | Tipo de cliente permitido | Todos | 403 Forbidden |\n| 3 | Papel do usuário (`user_role`) | Todos | 403 Forbidden |\n| 4 | Papel na conta (`account_role`) | MEDIUM, HIGH, CRITICAL | 403 Forbidden |\n| 5 | Escopos OAuth2 | Todos | 403 Forbidden |\n| 6 | Assinatura HMAC | HIGH, CRITICAL (Parceria Meioo) | 401 Unauthorized |\n| 7 | Timestamp (60s) | HIGH, CRITICAL (Parceria Meioo) | 401 Unauthorized |\n| 8 | Nonce (replay, 300s) | HIGH, CRITICAL (Parceria Meioo) | 409 Conflict |\n| 9 | Step-up (TOTP / PIN) | CRITICAL | 403 Forbidden |\n\nAs camadas 6–8 (integridade) se aplicam apenas à **Parceria Meioo**. A **Integração Direta** não acessa endpoints de risco alto ou crítico.\n\n### Requisitos por formato de integração\n\n| Requisito | Integração Direta | Parceria Meioo |\n| ---------------- | --------------------- | ----------------------------------------------- |\n| Autenticação | API Key → JWT | OAuth2 Authorization Code + PKCE |\n| Escopo de acesso | Consultas + cobranças | Tudo acima + operações financeiras + chaves Pix |\n| Assinatura HMAC | Não se aplica | Obrigatória em HIGH e CRITICAL |\n| Step-up | Não se aplica | TOTP (6 dígitos) em operações CRITICAL |\n| Rate limiting | Sim (por endpoint) | Sim (por endpoint) |\n\n### Fluxo de aprovação de transações\n\nOperações financeiras (transferências, pagamentos, devoluções) seguem obrigatoriamente um fluxo de dois passos:\n\n1. **Solicitação** (`POST`): cria a transação com status `AWAITING_APPROVAL`. O limite diário é reservado neste momento. Nenhuma validação de step-up ou assinatura HMAC é exigida neste passo. A transação aguarda aprovação por até 24 horas — após esse prazo, é cancelada automaticamente e o limite reservado é devolvido.\n\n2. **Aprovação** (`PATCH /accounts/approvals/transactions/{id}`): um usuário com papel `ADMIN` ou `MASTER` aprova (executa) ou rejeita (cancela) a transação. A aprovação exige step-up (TOTP para parceiros, PIN + TOTP para app). Após a aprovação, a transação é enviada ao provider para liquidação.\n\nWebhooks de aprovação (`TRANSACTION_APPROVED`, `TRANSACTION_REJECTED`, `TRANSACTION_EXPIRED`) informam o resultado do fluxo. Após a aprovação, aguarde o evento de conclusão correspondente (ex: `PIX_PAYMENT_SENT`, `TEF_SENT`) para confirmar a liquidação.\n\n### Rate limiting\n\nEndpoints sensíveis possuem limites de requisição por IP e por conta para proteção contra abuso. Ao exceder o limite, a API retorna HTTP 429 (Too Many Requests) com o header `Retry-After` indicando o tempo de espera em segundos.\n\nOs limites são dimensionados para não afetar integrações legítimas. Se sua aplicação atingir o rate limit em uso normal, entre em contato com o suporte.\n\n## Polling e conciliação\n\n\n\n### Tempo real vs. conciliação\n\nEventos em tempo real — pagamentos recebidos, transações concluídas, boletos registrados — chegam pelos **Webhooks**: esse é o canal de tempo real. Os endpoints de **conciliação** (`GET /accounts/reconciliation/transactions`) são uma **rede de segurança** para o fechamento contábil no seu ERP, garantindo que nenhum movimento foi perdido caso um webhook tenha falhado. Não use a conciliação para obter eventos em tempo real — para isso, use os webhooks.\n\n### Polling eficiente\n\n- **Use o modo delta (`updated_since`):** a cada ciclo, peça apenas o que mudou desde o último sincronismo e pagine pelo `cursor` até a resposta esvaziar. Evite re-consultar a janela inteira por data a cada ciclo.\n- **Cadência recomendada:** a cada **1 hora** é suficiente para conciliação. Polling mais frequente que **1 minuto** não traz ganho (o tempo real vem dos webhooks) e tende a ser limitado.\n- **Exportação (`/export`, CSV/OFX):** operação mais pesada que a consulta paginada — prefira janelas maiores e baixa frequência (ex.: fechamento diário), não polling.\n- **Respeite `429`:** implemente backoff exponencial e honre o header `Retry-After`.\n\n### Limites de uso\n\nOs endpoints de conciliação estão sujeitos a rate limiting para proteção contra abuso (ver **Camadas de segurança › Rate limiting**), dimensionado para o polling legítimo descrito acima. Um job em loop ou com ciclo muito curto pode receber `429 Too Many Requests` com `Retry-After`. Projete sua integração para a cadência recomendada e o consumo será sempre confortável dentro dos limites.\n\n## Códigos de Status HTTP\n\n| Código | Significado | Quando ocorre |\n| ------ | --------------------- | -------------------------------------------------------------------------------- |\n| `200` | OK | Requisição processada com sucesso |\n| `201` | Created | Recurso criado com sucesso |\n| `202` | Accepted | Aceita, desfecho ainda não confirmado — **não é falha e não deve ser reenviada** |\n| `204` | No Content | Operação concluída sem retorno de dados |\n| `400` | Bad Request | Payload inválido ou parâmetros faltando |\n| `401` | Unauthorized | Token ausente, inválido ou expirado |\n| `403` | Forbidden | Token válido, mas sem permissão para o recurso |\n| `404` | Not Found | Recurso não encontrado |\n| `409` | Conflict | Operação duplicada (idempotência ou `reference_id` repetido) |\n| `422` | Unprocessable Entity | Regra de negócio violada (ex: saldo insuficiente) |\n| `429` | Too Many Requests | Rate limit excedido |\n| `500` | Internal Server Error | Erro interno — acione o suporte se persistir |\n\n## Formato das Respostas\n\n### Sucesso\n\nAs respostas de sucesso retornam diretamente o recurso ou lista solicitada, sem envelope adicional:\n\n\n```json\n{\n \"current_balance\": 125000,\n \"available_balance\": 120000,\n \"blocked_balance\": 5000,\n \"last_update\": \"2026-05-14T14:00:00-03:00\"\n}\n```\n\n### Erro\n\nTodos os erros seguem o mesmo schema:\n\n\n```json\n{\n \"status_code\": 422,\n \"code\": \"INSUFFICIENT_BALANCE\",\n \"message\": \"Saldo insuficiente para realizar a transferência\",\n \"timestamp\": \"2026-04-09T14:32:11-03:00\",\n \"path\": \"/accounts/pix/transfers\"\n}\n```\n\n| Campo | Tipo | Descrição |\n| ------------- | -------- | --------------------------------------------------------------------- |\n| `status_code` | `number` | Código HTTP do erro |\n| `code` | `string` | Código de erro legível por máquina — use para tratamento programático |\n| `message` | `string` | Descrição legível para diagnóstico |\n| `timestamp` | `string` | Data e hora do erro (ISO 8601, BRT) |\n| `path` | `string` | Endpoint que gerou o erro |\n\nTrate o campo `code` para distinguir erros recuperáveis (ex: `RATE_LIMIT_EXCEEDED`, `INSUFFICIENT_BALANCE`) de erros permanentes (ex: `INVALID_API_KEY`).\n\n## Paginação\n\nTodos os endpoints de listagem usam **paginação por cursor** — estável e eficiente para grandes volumes e sincronização incremental (ERP). Não há paginação por número de página/offset.\n\n### Parâmetros de consulta\n\n| Parâmetro | Tipo | Descrição |\n| --------- | -------- | ---------------------------------------------------------------------------------------------- |\n| `limit` | `number` | Itens por página. Opcional. O padrão e o máximo podem variar por endpoint (veja a referência). |\n| `cursor` | `string` | Token **opaco** da próxima página. Omita na primeira requisição. |\n\n### Formato da resposta\n\nA lista vem em `items` e a paginação em `page_info`:\n\n\n```json\n{\n \"items\": [\n /* ... recursos da página ... */\n ],\n \"page_info\": {\n \"next_cursor\": \"eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDAxOjI3OjQzLjc5OFoiLCJpZCI6IjAxS0dYRFM4RFA3MUMzMk1RSkVINTUwNEtRIn0=\",\n \"has_next_page\": true\n }\n}\n```\n\n| Campo | Tipo | Descrição |\n| ------------------------- | --------- | ------------------------------------------------------------ |\n| `items` | `array` | Recursos da página atual. |\n| `page_info.next_cursor` | `string` | Cursor da próxima página. **Nulo/ausente na última página.** |\n| `page_info.has_next_page` | `boolean` | `true` enquanto houver próxima página; `false` na última. |\n\n> **Respostas compostas:** o **extrato** (`GET /accounts/statement`) e a **conciliação** (`GET /accounts/reconciliation/transactions`) são documentos ricos (incluem saldos/metadados), então a lista vem na chave de domínio (`transactions` / `records`) em vez de `items` — mas o `page_info` é idêntico.\n\n### O cursor é opaco\n\nTrate `next_cursor` como uma **caixa-preta**: reenvie exatamente o valor recebido no parâmetro `cursor`, sem construir, decodificar ou supor seu conteúdo. O formato interno pode mudar sem aviso e **não** deve ser usado como identificador de recurso.\n\n### Como percorrer todas as páginas\n\n1. Faça a primeira requisição **sem** `cursor` (opcionalmente com `limit`).\n2. Processe `items`.\n3. Se `page_info.has_next_page` for `true`, repita enviando `cursor = page_info.next_cursor`.\n4. Pare quando `has_next_page` for `false` (ou `next_cursor` ausente).\n\n```text\nGET /accounts/bank-slips?limit=50\n → items[...], page_info.next_cursor = \"AAA\", has_next_page = true\nGET /accounts/bank-slips?limit=50&cursor=AAA\n → items[...], page_info.next_cursor = \"BBB\", has_next_page = true\nGET /accounts/bank-slips?limit=50&cursor=BBB\n → items[...], page_info.has_next_page = false ← fim\n```\n\nMantenha o mesmo `limit` e os mesmos filtros entre as páginas. Para **sincronização incremental**, prefira a conciliação em modo delta (`updated_since`), que pagina pela mesma mecânica de cursor.\n\n## Suporte Técnico\n\nPara dúvidas técnicas, erros de integração ou solicitação de credenciais de acesso:\n\n📧 [tecnologia@meioo.com.br](mailto:tecnologia@meioo.com.br)\n\n\nContact Support:\n Name: Equipe Meioo\n Email: tecnologia@meioo.com.br", "type": "text/plain" } }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{token}}", "type": "string" } ] } }