Consulte pagadores identificados e bancos agrupados pelos recebimentos da conta em um periodo.
A API de pagadores e bancos permite visualizar quem pagou e por qual instituicao financeira, ordenados por valor confirmado. E util para analise de comportamento e concentracao de recebimentos.
A resposta contem ate 100 pagadores identificados, ordenados por valor confirmado, e a lista de bancos agrupados pelos pagamentos recebidos no periodo.
array
required
Lista de pagadores (maximo 100).
string
required
Identificador pseudonimizado do pagador.
string
Nome do pagador, quando disponivel.
string
Nome do banco, quando disponivel.
integer
required
Quantidade de pagamentos confirmados deste pagador no periodo.
integer
required
Valor total confirmado deste pagador em centavos de BRL.
string
required
Data/hora do ultimo pagamento confirmado (ISO 8601).
array
required
Lista de bancos agrupados.
string
required
Identificador do banco.
string
required
Nome do banco.
integer
required
Quantidade de pagamentos recebidos por este banco no periodo.
integer
required
Valor total recebido por este banco em centavos de BRL.
integer
required
Total de pagadores distintos no periodo.
integer
required
Total de pagadores recorrentes (que ja haviam pagado antes) no periodo.
integer
required
Periodo consultado (7, 30 ou 90).
integer
required
Limite de itens retornados: 100.
Interpretacao dos dados
Pagadores sao pseudonimizados; o identificador nao expoe dados pessoais diretos.
A ordenacao por amountCents ajuda a identificar os maiores pagadores do periodo.
O campo returningPayers indica fidelizacao: quantos pagadores ja haviam feito pelo menos um pagamento anterior.
Bancos sao agrupados automaticamente com base nos recebimentos processados.
A consulta le o estado persistido no periodo indicado. Nao e possivel filtrar por carteira individual nesta versao.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Bunni Pay","description":"Documentação da API Bunni Pay: autenticação, pagamentos Pix, carteiras, links e relatórios.","colors":{"primary":"#FF5E8E","light":"#FF7AA2","dark":"#E0457A"},"logo":{"light":"https://mintcdn.com/bunnipaybr/OBxipp_5Heqx0S4k/logo/light.svg?fit=max\u0026auto=format\u0026n=OBxipp_5Heqx0S4k\u0026q=85\u0026s=d824344959ade8bac02a0f55341c3df2","dark":"https://mintcdn.com/bunnipaybr/OBxipp_5Heqx0S4k/logo/dark.svg?fit=max\u0026auto=format\u0026n=OBxipp_5Heqx0S4k\u0026q=85\u0026s=70ee9d3475ce2eb0dd0f8c1e18a11422","href":"/index"},"favicon":"https://mintcdn.com/bunnipaybr/OBxipp_5Heqx0S4k/images/bunni.jpg?fit=max\u0026auto=format\u0026n=OBxipp_5Heqx0S4k\u0026q=85\u0026s=ef6ffec6ebacbff04502977c2b0ef671","api":{"playground":{"display":"interactive"},"examples":{"languages":["bash","javascript","python"],"prefill":false,"autogenerate":true},"mdx":{"auth":{"method":"key","name":"X-API-Key"},"server":"https://api.bunnipay.com.br"}},"appearance":{"default":"dark","strict":false},"background":{"color":{"light":"#FFFFFF","dark":"#0A0A0B"}},"navbar":{"links":[{"href":"https://app.bunnipay.com.br","label":"Dashboard"},{"href":"/mcp-server","label":"MCP Server"},{"href":"/llms.txt","label":"llms.txt"}],"primary":{"type":"button","label":"Começar agora","href":"https://app.bunnipay.com.br/sign-up"}},"search":{"prompt":"Buscar na documentação..."},"seo":{"metatags":{"canonical":"https://docs.bunnipay.com.br","og:locale":"pt_BR","og:site_name":"Bunni Pay — Documentação","twitter:card":"summary_large_image","robots":"index, follow, max-image-preview:large"},"indexing":"navigable"},"icons":{"library":"lucide"},"styling":{"eyebrows":"section","codeblocks":{"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}},"latex":false},"contextual":{"options":["copy","view","mcp","add-mcp","cursor","vscode","claude","chatgpt"],"display":"header"},"thumbnails":{"preset":"minimal","appearance":"dark","surface":"neutral"},"interaction":{"drilldown":false},"markdown":{"schema":true,"instructions":["Consulte o contrato Bunni antes de sugerir chamadas. Valores monetários são inteiros em centavos. Não invente endpoints ou respostas de sucesso para recursos ainda indisponíveis. Nunca solicite chaves reais no chat nem exponha credenciais no cliente."]},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"bunnipaybr","hasAudioNarration":false,"actualSubdomain":"bunnipaybr","customDomains":["docs.bunnipay.com.br"],"gitSource":{"type":"artifacts","owner":"prod","repo":"6af651438e91e5115ee886d0","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"","_id":"6af652078e91e5115ee8957c"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afe0ffda594ac7d9eb59dd3","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"API Reference","count":25},{"language":"default","tag":"Guias","count":12},{"language":"default","tag":"Relatórios","count":6},{"language":"default","tag":"Introdução","count":6},{"language":"default","tag":"Conta","count":5},{"language":"default","tag":"MCP","count":4},{"language":"default","tag":"Links de pagamento","count":4},{"language":"default","tag":"PIX","count":4},{"language":"default","tag":"Saques Pix","count":4},{"language":"default","tag":"Checkout público","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":":root{--bunni-pink: #ff5e8e;--bunni-pink-soft: rgba(255, 94, 142, 0.12);--bunni-border: rgba(255, 255, 255, 0.06)}#navbar{background:rgba(10, 10, 11, 0.85)!important;backdrop-filter:blur(12px);border-bottom:1px solid var(--bunni-border)!important}#navbar a:hover{color:var(--bunni-pink)!important}.nav-tabs-item[data-active=\"true\"],.nav-tabs a[aria-current=\"page\"]{color:#fff!important;border-bottom-color:var(--bunni-pink)!important}#sidebar,#sidebar-content{background:#0a0a0b!important;border-right:1px solid var(--bunni-border)}#sidebar .sidebar-group-header,#sidebar h5{color:#8a8a93!important;font-size:0.72rem;letter-spacing:0.08em;text-transform:uppercase}#sidebar a{border-radius:10px;color:#b4b4bd;transition:background 0.15s, color 0.15s}#sidebar a:hover{background:rgba(255, 255, 255, 0.04);color:#fff}#sidebar a[aria-current=\"page\"],#sidebar li[data-active=\"true\"]>a{background:var(--bunni-pink-soft)!important;color:var(--bunni-pink)!important;font-weight:500}.method-pill-get,[data-method=\"GET\"],.bg-green-400\\/20{background:var(--bunni-pink-soft)!important;color:var(--bunni-pink)!important}#content-area a:not(.card):not([class*=\"button\"]){text-decoration-color:rgba(255, 94, 142, 0.4)}.card{border-color:var(--bunni-border)!important;background:#111114!important;border-radius:16px!important}.card:hover{border-color:rgba(255, 94, 142, 0.5)!important}pre,.code-block{background:#0f0f12!important;border:1px solid var(--bunni-border)!important;border-radius:14px!important}::selection{background:rgba(255, 94, 142, 0.35)}"}],"page":{"pagePath":"api-reference/customers","slug":"/api-reference/customers","pageMetadata":{"title":"Pagadores e bancos","description":"Consulte pagadores identificados e bancos agrupados pelos recebimentos da conta em um periodo.","icon":"users","href":"/api-reference/customers"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Consulte pagadores identificados e bancos agrupados pelos recebimentos da conta em um periodo.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,ParamField,ResponseField}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`A API de pagadores e bancos permite visualizar quem pagou e por qual instituicao financeira, ordenados por valor confirmado. E util para analise de comportamento e concentracao de recebimentos.`}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Requer escopo `,_jsx(_components.code,{children:`payments:read`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`consultar-pagadores-e-bancos`,children:`Consultar pagadores e bancos`}),`\n`,_jsxs(_components.p,{children:[`Envie `,_jsx(_components.code,{children:`GET /v1/customers`}),` com o periodo desejado.`]}),`\n`,_jsx(ParamField,{query:`days`,type:`number`,id:`param-days`,children:_jsxs(_components.p,{children:[`Periodo em dias: `,_jsx(_components.code,{children:`7`}),`, `,_jsx(_components.code,{children:`30`}),` (padrao) ou `,_jsx(_components.code,{children:`90`}),`.`]})}),`\n`,_jsx(CodeBlock,{filename:`curl`,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-dark-dimmed github-dark-dimmed`,style:{backgroundColor:`#22272e`,\"--shiki-dark-bg\":`#22272e`,color:`#adbac7`,\"--shiki-dark\":`#adbac7`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#F69D50`,\"--shiki-dark\":`#F69D50`},children:`curl`}),_jsx(_components.span,{style:{color:`#96D0FF`,\"--shiki-dark\":`#96D0FF`},children:` \"https://api.bunnipay.com.br/v1/customers?days=30\"`}),_jsx(_components.span,{style:{color:`#F47067`,\"--shiki-dark\":`#F47067`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#6CB6FF`,\"--shiki-dark\":`#6CB6FF`},children:` -H`}),_jsx(_components.span,{style:{color:`#96D0FF`,\"--shiki-dark\":`#96D0FF`},children:` \"X-API-Key: SUA_CHAVE\"`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`resposta`,children:`Resposta`}),`\n`,_jsx(_components.p,{children:`A resposta contem ate 100 pagadores identificados, ordenados por valor confirmado, e a lista de bancos agrupados pelos pagamentos recebidos no periodo.`}),`\n`,_jsx(ResponseField,{name:`data.items`,type:`array`,required:true,id:`param-data-items`,children:_jsx(_components.p,{children:`Lista de pagadores (maximo 100).`})}),`\n`,_jsx(ResponseField,{name:`data.items[].id`,type:`string`,required:true,id:`param-data-items-id`,children:_jsx(_components.p,{children:`Identificador pseudonimizado do pagador.`})}),`\n`,_jsx(ResponseField,{name:`data.items[].name`,type:`string`,id:`param-data-items-name`,children:_jsx(_components.p,{children:`Nome do pagador, quando disponivel.`})}),`\n`,_jsx(ResponseField,{name:`data.items[].bank`,type:`string`,id:`param-data-items-bank`,children:_jsx(_components.p,{children:`Nome do banco, quando disponivel.`})}),`\n`,_jsx(ResponseField,{name:`data.items[].payments`,type:`integer`,required:true,id:`param-data-items-payments`,children:_jsx(_components.p,{children:`Quantidade de pagamentos confirmados deste pagador no periodo.`})}),`\n`,_jsx(ResponseField,{name:`data.items[].amountCents`,type:`integer`,required:true,id:`param-data-items-amount-cents`,children:_jsx(_components.p,{children:`Valor total confirmado deste pagador em centavos de BRL.`})}),`\n`,_jsx(ResponseField,{name:`data.items[].lastPayment`,type:`string`,required:true,id:`param-data-items-last-payment`,children:_jsx(_components.p,{children:`Data/hora do ultimo pagamento confirmado (ISO 8601).`})}),`\n`,_jsx(ResponseField,{name:`data.banks`,type:`array`,required:true,id:`param-data-banks`,children:_jsx(_components.p,{children:`Lista de bancos agrupados.`})}),`\n`,_jsx(ResponseField,{name:`data.banks[].id`,type:`string`,required:true,id:`param-data-banks-id`,children:_jsx(_components.p,{children:`Identificador do banco.`})}),`\n`,_jsx(ResponseField,{name:`data.banks[].name`,type:`string`,required:true,id:`param-data-banks-name`,children:_jsx(_components.p,{children:`Nome do banco.`})}),`\n`,_jsx(ResponseField,{name:`data.banks[].payments`,type:`integer`,required:true,id:`param-data-banks-payments`,children:_jsx(_components.p,{children:`Quantidade de pagamentos recebidos por este banco no periodo.`})}),`\n`,_jsx(ResponseField,{name:`data.banks[].amountCents`,type:`integer`,required:true,id:`param-data-banks-amount-cents`,children:_jsx(_components.p,{children:`Valor total recebido por este banco em centavos de BRL.`})}),`\n`,_jsx(ResponseField,{name:`data.payers`,type:`integer`,required:true,id:`param-data-payers`,children:_jsx(_components.p,{children:`Total de pagadores distintos no periodo.`})}),`\n`,_jsx(ResponseField,{name:`data.returningPayers`,type:`integer`,required:true,id:`param-data-returning-payers`,children:_jsx(_components.p,{children:`Total de pagadores recorrentes (que ja haviam pagado antes) no periodo.`})}),`\n`,_jsx(ResponseField,{name:`data.days`,type:`integer`,required:true,id:`param-data-days`,children:_jsx(_components.p,{children:`Periodo consultado (7, 30 ou 90).`})}),`\n`,_jsx(ResponseField,{name:`data.limit`,type:`integer`,required:true,id:`param-data-limit`,children:_jsx(_components.p,{children:`Limite de itens retornados: 100.`})}),`\n`,_jsx(Heading,{level:`2`,id:`interpretacao-dos-dados`,children:`Interpretacao dos dados`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Pagadores sao pseudonimizados; o identificador nao expoe dados pessoais diretos.`}),`\n`,_jsxs(_components.li,{children:[`A ordenacao por `,_jsx(_components.code,{children:`amountCents`}),` ajuda a identificar os maiores pagadores do periodo.`]}),`\n`,_jsxs(_components.li,{children:[`O campo `,_jsx(_components.code,{children:`returningPayers`}),` indica fidelizacao: quantos pagadores ja haviam feito pelo menos um pagamento anterior.`]}),`\n`,_jsx(_components.li,{children:`Bancos sao agrupados automaticamente com base nos recebimentos processados.`}),`\n`]}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`A consulta le o estado persistido no periodo indicado. Nao e possivel filtrar por carteira individual nesta versao.`})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}},"config":{},"pageMetadata":{"title":"Pagadores e bancos","description":"Consulte pagadores identificados e bancos agrupados pelos recebimentos da conta em um periodo.","icon":"users","href":"/api-reference/customers"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Consultar pagadores e bancos","slug":"consultar-pagadores-e-bancos","depth":2,"children":[]},{"title":"Resposta","slug":"resposta","depth":2,"children":[]},{"title":"Interpretacao dos dados","slug":"interpretacao-dos-dados","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"bunnipaybr","siteName":"Bunni Pay","title":"Pagadores e bancos - Bunni Pay","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-18T00:35:03.323Z","originalFileLocation":"api-reference/customers.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Consulte pagadores identificados e bancos agrupados pelos recebimentos da conta em um periodo.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Bunni Pay\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow, max-image-preview:large\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/bunnipaybr/s5WbNWD_L2dwHJHE/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/bunnipaybr/s5WbNWD_L2dwHJHE/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/bunnipaybr/s5WbNWD_L2dwHJHE/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/bunnipaybr/s5WbNWD_L2dwHJHE/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/bunnipaybr/s5WbNWD_L2dwHJHE/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/bunnipaybr/s5WbNWD_L2dwHJHE/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/bunnipaybr/s5WbNWD_L2dwHJHE/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/bunnipaybr/s5WbNWD_L2dwHJHE/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/bunnipaybr/s5WbNWD_L2dwHJHE/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Pagadores e bancos - Bunni Pay\">\u003cmeta data-mint-head property=\"og:description\" content=\"Consulte pagadores identificados e bancos agrupados pelos recebimentos da conta em um periodo.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Bunni Pay — Documentação\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.bunnipay.com.br/api-reference/customers\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://bunnipaybr.mintlify.site/_mintlify/api/og/v2?division=Relat%C3%B3rios\u0026amp;title=Pagadores+e+bancos\u0026amp;description=Consulte+pagadores+identificados+e+bancos+agrupados+pelos+recebimentos+da+conta+em+um+periodo.\u0026amp;theme=26b772f5e0da02d5daa64c70\u0026amp;signature=6f4f0fe5f0136816456a502261e63155cb49e8799d21934071e5466ae113810c\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Pagadores e bancos - Bunni Pay\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Consulte pagadores identificados e bancos agrupados pelos recebimentos da conta em um periodo.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://bunnipaybr.mintlify.site/_mintlify/api/og/v2?division=Relat%C3%B3rios\u0026amp;title=Pagadores+e+bancos\u0026amp;description=Consulte+pagadores+identificados+e+bancos+agrupados+pelos+recebimentos+da+conta+em+um+periodo.\u0026amp;theme=26b772f5e0da02d5daa64c70\u0026amp;signature=6f4f0fe5f0136816456a502261e63155cb49e8799d21934071e5466ae113810c\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/bunnipaybr/s5WbNWD_L2dwHJHE/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Bunni Pay\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#FF5E8E\">\u003cmeta data-mint-head name=\"og:locale\" content=\"pt_BR\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.bunnipay.com.br/api-reference/customers\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/customers.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.bunnipay.com.br/#organization\",\"name\":\"Bunni Pay\",\"url\":\"https://docs.bunnipay.com.br\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/bunnipaybr/OBxipp_5Heqx0S4k/logo/light.svg?fit=max\u0026auto=format\u0026n=OBxipp_5Heqx0S4k\u0026q=85\u0026s=d824344959ade8bac02a0f55341c3df2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.bunnipay.com.br#website\",\"name\":\"Bunni Pay\",\"url\":\"https://docs.bunnipay.com.br\",\"publisher\":{\"@id\":\"https://docs.bunnipay.com.br/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.bunnipay.com.br/api-reference/customers#webpage\",\"url\":\"https://docs.bunnipay.com.br/api-reference/customers\",\"name\":\"Pagadores e bancos\",\"description\":\"Consulte pagadores identificados e bancos agrupados pelos recebimentos da conta em um periodo.\",\"dateModified\":\"2026-11-18T00:35:03.323Z\",\"isPartOf\":{\"@id\":\"https://docs.bunnipay.com.br#website\"},\"breadcrumb\":{\"@id\":\"https://docs.bunnipay.com.br/api-reference/customers#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.bunnipay.com.br/api-reference/customers#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Relatórios\",\"item\":\"https://docs.bunnipay.com.br/api-reference/statement\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Pagadores e bancos\",\"item\":\"https://docs.bunnipay.com.br/api-reference/customers\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.bunnipay.com.br/api-reference/customers#article\",\"headline\":\"Pagadores e bancos\",\"name\":\"Pagadores e bancos\",\"description\":\"Consulte pagadores identificados e bancos agrupados pelos recebimentos da conta em um periodo.\",\"url\":\"https://docs.bunnipay.com.br/api-reference/customers\",\"mainEntityOfPage\":{\"@id\":\"https://docs.bunnipay.com.br/api-reference/customers#webpage\"},\"dateModified\":\"2026-11-18T00:35:03.323Z\",\"publisher\":{\"@id\":\"https://docs.bunnipay.com.br/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.bunnipay.com.br#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Bunni Pay\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Bunni Pay\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/customers.md","siteName":"Bunni Pay","nav":{"global":null,"tabs":[{"tab":"Guias","icon":"book-open","groups":[{"group":"Introdução","pages":[{"title":"Autenticação","sidebarTitle":"Autenticação","icon":"key-round","href":"/authentication"},{"title":"Idempotência","sidebarTitle":"Idempotência","icon":"repeat","href":"/idempotency"},{"title":"Erros","sidebarTitle":"Erros","icon":"triangle-alert","href":"/errors"},{"title":"Limites e tarifas","sidebarTitle":"Limites e tarifas","icon":"gauge","href":"/limits-fees"}]},{"group":"Conta","pages":[{"title":"Conta","href":"/account"},{"title":"Carteiras","href":"/wallets"}]},{"group":"Pix","pages":[{"title":"Cobranças Pix","icon":"qr-code","href":"/api-reference/payments"},{"title":"Saques Pix","icon":"banknote","href":"/api-reference/payouts"}]},{"group":"Loja","pages":[{"title":"Links e checkout","icon":"link","href":"/api-reference/payment-links"}]},{"group":"Relatórios","pages":[{"title":"Extrato","icon":"receipt-text","href":"/api-reference/statement"},{"title":"Estatísticas","description":"Consulte indicadores da conta, totais de pagamentos e serie diaria liquida de recebimentos confirmados.","icon":"chart-line","href":"/api-reference/analytics"},{"title":"Pagadores e bancos","icon":"users","href":"/api-reference/customers"}]}]},{"tab":"API Reference","icon":"code","pages":[{"title":"API Reference","href":"/api-reference/routes"}]},{"tab":"MCP","icon":"bot","pages":[{"title":"MCP","href":"/mcp-server"}]}]},"basePath":"","title":"Pagadores e bancos - Bunni Pay","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":[],"chunks":[]}