Cria uma cobrança agendada — avulsa (one_time) ou recorrente (recurring) — para uma data futura. A Garu envia o e-mail ao cliente no dia do vencimento e dispara webhooks no ciclo de vida. Para recorrência debitada automaticamente, combine type: "recurring" com methods: ["pix_automatic"] (veja Pix Automático).
Cadastre o cliente primeiro via dashboard ou API — veja
Cadastro de clientes. O customerId é o ID numérico
interno do cliente (não o uuid público de /api/v1/customers) — as duas
APIs ainda não compartilham um identificador cruzado.
Valor em BRL decimal (ex: 297.50). Não use centavos. Mínimo de R$ 5,00 (5.00), o valor mínimo da plataforma por cobrança, na cobrança avulsa e na recorrente. Abaixo disso a API responde 400. Veja Erros Comuns.
Janela, em dias (inteiro de 1 a 365), para a recuperação automática de uma
cobrança que o cron diário tenha perdido — se o disparo do dueDate falhar, a
Garu segue tentando dentro dessa janela. Omitir usa o padrão do sistema (14).
Também aparece no objeto retornado.
Envie o header X-Idempotency-Key. A mesma chave devolve a série originalmente criada por 24h, em vez de agendar uma cobrança duplicada, então um retry após timeout de rede fica seguro.Derive a chave de algo estável no seu sistema, como o id da assinatura e o mês. Uma chave nova a cada tentativa não protege nada. O SDK Node só envia o header quando você passa idempotencyKey: desde a versão 5.0.0 ele não gera uma chave sozinho.
{ "statusCode": 400, "timestamp": "2026-09-30T23:00:00.000Z", "path": "/api/v1/scheduled-charges", "message": "O valor mínimo de uma cobrança é R$ 5,00."}
Solução: Envie um amount de pelo menos 5.00. A regra vale para a cobrança avulsa e para a recorrente. As cobranças agendadas criadas antes dessa regra mantêm o valor e continuam sendo cobradas normalmente.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/schema.json","name":"Garu","description":"Documentação oficial da API Garu - Gateway de pagamentos que simplifica a gestão e apoia empreendedores no seu crescimento. Integre PIX, Cartão de Crédito e Boleto em minutos.","colors":{"primary":"#257264","light":"#FAF6ED","dark":"#005243"},"logo":{"light":"https://mintcdn.com/garu/g-shOvMOEbJZqokd/logo/light.svg?fit=max\u0026auto=format\u0026n=g-shOvMOEbJZqokd\u0026q=85\u0026s=b6c0de2b9b2378205ccf76d131a91a69","dark":"https://mintcdn.com/garu/g-shOvMOEbJZqokd/logo/dark.svg?fit=max\u0026auto=format\u0026n=g-shOvMOEbJZqokd\u0026q=85\u0026s=4c31441f3c8b4cf869015f4f30d47395"},"favicon":"https://mintcdn.com/garu/g-shOvMOEbJZqokd/favicon.png?fit=max\u0026auto=format\u0026n=g-shOvMOEbJZqokd\u0026q=85\u0026s=8cac01c3f496d267e96afa23109702bf","api":{"playground":{},"mdx":{"auth":{"method":"bearer","name":"Authorization"},"server":"https://garu.com.br"}},"navbar":{"links":[{"href":"mailto:contato@garu.com.br","label":"Suporte"}],"primary":{"type":"button","label":"Dashboard","href":"https://garu.com.br/inicio"}},"footer":{"socials":{"instagram":"https://www.instagram.com/tecnosolve","linkedin":"https://www.linkedin.com/company/tecnosolve"}},"seo":{},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"metadata":{"timestamp":false},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Dashboard","icon":"gauge","href":"https://garu.com.br/inicio"},{"anchor":"OpenAPI","icon":"code","href":"https://garu.com.br/api/openapi.json"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"garu","hasAudioNarration":false,"actualSubdomain":"garu","customDomains":["docs.garu.com.br"],"gitSource":{"type":"github","owner":"garu-pagamentos","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ada8827b792eded1561428d","collectionId":"8e683863-27aa-4e08-86f8-5bc4bb583c9a","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ada8827b792eded1561428d"},"feedback":{"thumbs":true,"issues":false},"entitlements":{},"buildId":"6ada8827b792eded1561428d","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"default","tag":"Referência da API","count":74},{"language":"default","tag":"Guias","count":22},{"language":"default","tag":"Integrando Pagamentos","count":12},{"language":"default","tag":"Cobranças Agendadas","count":9},{"language":"default","tag":"Boleto Parcelado (Carnê)","count":8},{"language":"default","tag":"Webhooks e Exemplos","count":8},{"language":"default","tag":"Assinaturas","count":7},{"language":"default","tag":"Clientes","count":6},{"language":"default","tag":"Produtos","count":6},{"language":"default","tag":"Preços de Assinatura","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"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":"llms-txt-v2","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":"per-site-search-delta","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":"editor-private-page-search","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/cobrancas-agendadas/criar","slug":"/api-reference/cobrancas-agendadas/criar","pageMetadata":{"title":"Criar Cobrança Agendada","description":"Agende uma cobrança PIX ou Boleto para um cliente cadastrado","api":"POST /api/v1/scheduled-charges","href":"/api-reference/cobrancas-agendadas/criar"},"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: \"Agende uma cobrança PIX ou Boleto para um cliente cadastrado\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,CodeBlock,CodeGroup,Expandable,Heading,Note,ParamField}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`visão-geral`,children:`Visão Geral`}),`\n`,_jsxs(_components.p,{children:[`Cria uma cobrança agendada — avulsa (`,_jsx(_components.code,{children:`one_time`}),`) ou recorrente (`,_jsx(_components.code,{children:`recurring`}),`) — para uma data futura. A Garu envia o e-mail ao cliente no dia do vencimento e dispara webhooks no ciclo de vida. Para recorrência debitada automaticamente, combine `,_jsx(_components.code,{children:`type: \"recurring\"`}),` com `,_jsx(_components.code,{children:`methods: [\"pix_automatic\"]`}),` (veja `,_jsx(_components.a,{href:`/guias/pix-automatico`,children:`Pix Automático`}),`).`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Cadastre o cliente primeiro via dashboard ou API — veja\n`,_jsx(_components.a,{href:`/guias/clientes`,children:`Cadastro de clientes`}),`. O `,_jsx(_components.code,{children:`customerId`}),` é o ID numérico\ninterno do cliente (não o `,_jsx(_components.code,{children:`uuid`}),` público de `,_jsx(_components.code,{children:`/api/v1/customers`}),`) — as duas\nAPIs ainda não compartilham um identificador cruzado.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`exemplo-de-requisição`,children:`Exemplo de Requisição`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`12`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`12`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://garu.com.br/api/v1/scheduled-charges`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer sk_test_sua_chave\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-Idempotency-Key: 6c4c2a1e-4c2b-4f1c-9a8d-1b2e3f4a5b6c\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"customerId\": 42,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"amount\": 297.50,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"type\": \"one_time\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"dueDate\": \"2026-06-15\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"methods\": [\"pix\", \"boleto\"],`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"description\": \"Mensalidade Junho\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`JavaScript`,numberOfLines:`15`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`15`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`Garu`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` } `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '@garuhq/node'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` garu`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` new`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` Garu`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({ `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`apiKey:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` process`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`env`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`GARU_API_KEY`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` });`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` charge`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` garu`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`scheduledCharges`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`create`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` customerId:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 42`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` amount:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 297.5`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// em Reais; mínimo R$ 5,00`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` type:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'one_time'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` dueDate:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '2026-06-15'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` methods:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'pix'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'boleto'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` description:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Mensalidade Junho'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` idempotencyKey:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'cliente-42-mensalidade-2026-06'`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`charge`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`id`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`); `}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// sch_abc123`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`20`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`20`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` os`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`response `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests.post(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://garu.com.br/api/v1/scheduled-charges\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` headers`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`f`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Bearer `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`os.environ[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'GARU_API_KEY'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-Idempotency-Key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"cliente-42-mensalidade-2026-06\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` json`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"customerId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`42`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"amount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`297.50`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"one_time\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"dueDate\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-06-15\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"methods\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"pix\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"boleto\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"description\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Mensalidade Junho\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(response.json()[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]) `}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# sch_abc123`})]}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`3`,id:`recorrente-com-pix-automático`,children:`Recorrente com Pix Automático`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`13`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`13`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://garu.com.br/api/v1/scheduled-charges`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer sk_live_xxx\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"customerId\": 42,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"productId\": 456,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"amount\": 297.50,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"type\": \"recurring\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"dueDate\": \"2026-06-15\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"methods\": [\"pix_automatic\"],`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"recurrence\": { \"interval\": \"monthly\", \"intervalCount\": 1, \"endsAfter\": 12 },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"description\": \"Plano Premium - mensal\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`parâmetros`,children:`Parâmetros`}),`\n`,_jsx(ParamField,{body:`customerId`,type:`number`,required:true,id:`param-customer-id`,children:_jsx(_components.p,{children:`ID do cliente no Garu (já cadastrado neste seller).`})}),`\n`,_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount`,children:_jsxs(_components.p,{children:[`Valor em BRL decimal (ex: `,_jsx(_components.code,{children:`297.50`}),`). `,_jsx(_components.strong,{children:`Não use centavos.`}),` Mínimo de `,_jsx(_components.strong,{children:`R$ 5,00`}),` (`,_jsx(_components.code,{children:`5.00`}),`), o valor mínimo da plataforma por cobrança, na cobrança avulsa e na recorrente. Abaixo disso a API responde `,_jsx(_components.code,{children:`400`}),`. Veja `,_jsx(_components.a,{href:`#erros-comuns`,children:`Erros Comuns`}),`.`]})}),`\n`,_jsx(ParamField,{body:`type`,type:`string`,required:true,id:`param-type`,children:_jsxs(_components.p,{children:[`Tipo da cobrança: `,_jsx(_components.code,{children:`one_time`}),` (avulsa) ou `,_jsx(_components.code,{children:`recurring`}),` (recorrente). `,_jsx(_components.code,{children:`pix_automatic`}),` exige `,_jsx(_components.code,{children:`recurring`}),`.`]})}),`\n`,_jsx(ParamField,{body:`dueDate`,type:`string`,required:true,id:`param-due-date`,children:_jsxs(_components.p,{children:[`Data de vencimento em `,_jsx(_components.code,{children:`YYYY-MM-DD`}),`, fuso de São Paulo. Deve ser hoje ou futura.`]})}),`\n`,_jsx(ParamField,{body:`methods`,type:`array`,required:true,id:`param-methods`,children:_jsxs(_components.p,{children:[`Métodos oferecidos ao cliente. Aceita `,_jsx(_components.code,{children:`[\"pix\"]`}),`, `,_jsx(_components.code,{children:`[\"boleto\"]`}),`, `,_jsx(_components.code,{children:`[\"pix\", \"boleto\"]`}),` ou `,_jsx(_components.code,{children:`[\"pix_automatic\"]`}),`. Usar `,_jsx(_components.code,{children:`pix_automatic`}),` exige `,_jsx(_components.code,{children:`type: \"recurring\"`}),` `,_jsx(_components.strong,{children:`e`}),` um `,_jsx(_components.code,{children:`productId`}),` cujo produto tenha `,_jsx(_components.code,{children:`pixAutomatic: true`}),`.`]})}),`\n`,_jsx(ParamField,{body:`productId`,type:`number`,id:`param-product-id`,children:_jsxs(_components.p,{children:[`ID de um produto opcional. Quando informado, aparece vinculado à cobrança no dashboard. `,_jsx(_components.strong,{children:`Obrigatório`}),` quando `,_jsx(_components.code,{children:`methods`}),` inclui `,_jsx(_components.code,{children:`pix_automatic`}),`.`]})}),`\n`,_jsxs(ParamField,{body:`recurrence`,type:`object`,id:`param-recurrence`,children:[_jsxs(_components.p,{children:[`Configuração da recorrência (use com `,_jsx(_components.code,{children:`type: \"recurring\"`}),`).`]}),_jsxs(Expandable,{title:`campos de recurrence`,children:[_jsx(ParamField,{body:`interval`,type:`string`,required:true,id:`param-interval`,children:_jsxs(_components.p,{children:[`Frequência: `,_jsx(_components.code,{children:`weekly`}),`, `,_jsx(_components.code,{children:`biweekly`}),`, `,_jsx(_components.code,{children:`monthly`}),`, `,_jsx(_components.code,{children:`bimonthly`}),`, `,_jsx(_components.code,{children:`quarterly`}),`, `,_jsx(_components.code,{children:`biannual`}),` ou `,_jsx(_components.code,{children:`yearly`}),`.`]})}),_jsx(ParamField,{body:`intervalCount`,type:`number`,id:`param-interval-count`,children:_jsxs(_components.p,{children:[`Multiplicador do intervalo (ex: `,_jsx(_components.code,{children:`interval: \"monthly\"`}),` + `,_jsx(_components.code,{children:`intervalCount: 2`}),` = a cada 2 meses).`]})}),_jsx(ParamField,{body:`endsAfter`,type:`number`,id:`param-ends-after`,children:_jsx(_components.p,{children:`Encerra após este número de ciclos. Opcional.`})}),_jsx(ParamField,{body:`endsOn`,type:`string`,id:`param-ends-on`,children:_jsxs(_components.p,{children:[`Data final da recorrência em `,_jsx(_components.code,{children:`YYYY-MM-DD`}),`. Opcional.`]})})]})]}),`\n`,_jsx(ParamField,{body:`trialDays`,type:`number`,id:`param-trial-days`,children:_jsxs(_components.p,{children:[`Dias de teste gratuito antes do primeiro ciclo (`,_jsx(_components.code,{children:`1`}),`–`,_jsx(_components.code,{children:`365`}),`). Apenas para `,_jsx(_components.code,{children:`type: \"recurring\"`}),`.`]})}),`\n`,_jsx(ParamField,{body:`description`,type:`string`,id:`param-description`,children:_jsx(_components.p,{children:`Texto livre exibido no e-mail do cliente e na página de pagamento. Até 500 caracteres.`})}),`\n`,_jsx(ParamField,{body:`maxRecoveryDays`,type:`number`,default:`14`,id:`param-max-recovery-days`,children:_jsxs(_components.p,{children:[`Janela, em dias (inteiro de `,_jsx(_components.code,{children:`1`}),` a `,_jsx(_components.code,{children:`365`}),`), para a recuperação automática de uma\ncobrança que o cron diário tenha perdido — se o disparo do `,_jsx(_components.code,{children:`dueDate`}),` falhar, a\nGaru segue tentando dentro dessa janela. Omitir usa o padrão do sistema (`,_jsx(_components.code,{children:`14`}),`).\nTambém aparece no objeto retornado.`]})}),`\n`,_jsx(ParamField,{body:`externalReference`,type:`string`,id:`param-external-reference`,children:_jsx(_components.p,{children:`Identificador interno seu (até 255 caracteres). Útil para reconciliação.`})}),`\n`,_jsx(ParamField,{body:`metadata`,type:`object`,id:`param-metadata`,children:_jsx(_components.p,{children:`JSON livre. Persistido como JSONB; não interpretado pela Garu.`})}),`\n`,_jsx(Heading,{level:`2`,id:`idempotência`,children:`Idempotência`}),`\n`,_jsxs(_components.p,{children:[`Envie o header `,_jsx(_components.code,{children:`X-Idempotency-Key`}),`. A mesma chave devolve a série originalmente criada por 24h, em vez de agendar uma cobrança duplicada, então um retry após timeout de rede fica seguro.`]}),`\n`,_jsxs(_components.p,{children:[`Derive a chave de algo estável no seu sistema, como o id da assinatura e o mês. Uma chave nova a cada tentativa não protege nada. O SDK Node só envia o header quando você passa `,_jsx(_components.code,{children:`idempotencyKey`}),`: desde a versão 5.0.0 ele não gera uma chave sozinho.`]}),`\n`,_jsx(Heading,{level:`2`,id:`resposta`,children:`Resposta`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`21`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`21`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"sch_abc123\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"sellerId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`10`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"customerId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`42`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"productId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"amount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`297.5`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"description\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Mensalidade Junho\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"one_time\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"dueDate\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-06-15\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"methods\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"pix\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"boleto\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"recurrence\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"scheduled\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"subscriptionId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"trialEndsAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"cancelAtPeriodEnd\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"maxRecoveryDays\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`14`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"externalReference\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"metadata\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"createdAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-05-01T12:00:00Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"updatedAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-05-01T12:00:00Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`erros-comuns`,children:`Erros Comuns`}),`\n`,_jsx(AccordionGroup,{children:_jsxs(Accordion,{title:`400 - Valor abaixo do mínimo`,id:`400-valor-abaixo-do-minimo`,children:[_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"statusCode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`400`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"timestamp\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-09-30T23:00:00.000Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"path\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"/api/v1/scheduled-charges\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"O valor mínimo de uma cobrança é R$ 5,00.\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Solução:`}),` Envie um `,_jsx(_components.code,{children:`amount`}),` de pelo menos `,_jsx(_components.code,{children:`5.00`}),`. A regra vale para a cobrança avulsa e para a recorrente. As cobranças agendadas criadas antes dessa regra mantêm o valor e continuam sendo cobradas normalmente.`]})]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Criar Cobrança Agendada","description":"Agende uma cobrança PIX ou Boleto para um cliente cadastrado","api":"POST /api/v1/scheduled-charges","href":"/api-reference/cobrancas-agendadas/criar"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Visão Geral","slug":"visão-geral","depth":2,"children":[]},{"title":"Exemplo de Requisição","slug":"exemplo-de-requisição","depth":2,"children":[{"title":"Recorrente com Pix Automático","slug":"recorrente-com-pix-automático","depth":3,"children":[]}]},{"title":"Parâmetros","slug":"parâmetros","depth":2,"children":[]},{"title":"Idempotência","slug":"idempotência","depth":2,"children":[]},{"title":"Resposta","slug":"resposta","depth":2,"children":[]},{"title":"Erros Comuns","slug":"erros-comuns","depth":2,"children":[]}],"codeExamples":{},"endpoint":{"title":"Criar Cobrança Agendada","path":"/api/v1/scheduled-charges","method":"post","request":{"security":[],"parameters":{"query":{},"header":{},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"customerId":[{"type":"number","description":"ID do cliente no Garu (já cadastrado neste seller).","required":true}],"amount":[{"type":"number","description":"Valor em BRL decimal (ex: `297.50` ). Não use centavos. Mínimo de R$ 5,00 ( `5.00` ), o valor mínimo da plataforma por cobrança, na cobrança avulsa e na recorrente. Abaixo disso a API responde `400` . Veja Erros Comuns .","required":true}],"type":[{"type":"string","description":"Tipo da cobrança: `one_time` (avulsa) ou `recurring` (recorrente). `pix_automatic` exige `recurring` .","required":true}],"dueDate":[{"type":"string","description":"Data de vencimento em `YYYY-MM-DD` , fuso de São Paulo. Deve ser hoje ou futura.","required":true}],"methods":[{"type":"array","items":[{"type":"object","properties":{}}],"description":"Métodos oferecidos ao cliente. Aceita `[\"pix\"]` , `[\"boleto\"]` , `[\"pix\", \"boleto\"]` ou `[\"pix_automatic\"]` . Usar `pix_automatic` exige `type: \"recurring\"` e um `productId` cujo produto tenha `pixAutomatic: true` .","required":true}],"productId":[{"type":"number","description":"ID de um produto opcional. Quando informado, aparece vinculado à cobrança no dashboard. Obrigatório quando `methods` inclui `pix_automatic` ."}],"recurrence":[{"type":"object","properties":{"interval":[{"type":"string","description":"Frequência: `weekly` , `biweekly` , `monthly` , `bimonthly` , `quarterly` , `biannual` ou `yearly` .","required":true}],"intervalCount":[{"type":"number","description":"Multiplicador do intervalo (ex: `interval: \"monthly\"` + `intervalCount: 2` = a cada 2 meses)."}],"endsAfter":[{"type":"number","description":"Encerra após este número de ciclos. Opcional."}],"endsOn":[{"type":"string","description":"Data final da recorrência em `YYYY-MM-DD` . Opcional."}]},"description":"Configuração da recorrência (use com `type: \"recurring\"` )."}],"trialDays":[{"type":"number","description":"Dias de teste gratuito antes do primeiro ciclo ( `1` – `365` ). Apenas para `type: \"recurring\"` ."}],"description":[{"type":"string","description":"Texto livre exibido no e-mail do cliente e na página de pagamento. Até 500 caracteres."}],"maxRecoveryDays":[{"type":"number","description":"Janela, em dias (inteiro de `1` a `365` ), para a recuperação automática de uma cobrança que o cron diário tenha perdido — se o disparo do `dueDate` falhar, a Garu segue tentando dentro dessa janela. Omitir usa o padrão do sistema ( `14` ). Também aparece no objeto retornado."}],"externalReference":[{"type":"string","description":"Identificador interno seu (até 255 caracteres). Útil para reconciliação."}],"metadata":[{"type":"object","properties":{},"description":"JSON livre. Persistido como JSONB; não interpretado pela Garu."}]}}],"examples":{"example":{"value":{"customerId":123,"amount":123,"type":"\u003cstring>","dueDate":"\u003cstring>","methods":[{}],"productId":123,"recurrence":{"interval":"\u003cstring>","intervalCount":123,"endsAfter":123,"endsOn":"\u003cstring>"},"trialDays":123,"description":"\u003cstring>","maxRecoveryDays":123,"externalReference":"\u003cstring>","metadata":{}}}}}}},"response":{},"deprecated":false}},"jsLinks":[],"subdomain":"garu","siteName":"Garu","title":"Criar Cobrança Agendada - Garu","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-02T01:18:56.592Z","originalFileLocation":"api-reference/cobrancas-agendadas/criar.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Agende uma cobrança PIX ou Boleto para um cliente cadastrado\">\u003cmeta data-mint-head name=\"application-name\" content=\"Garu\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/garu/ITGxpj5UQhT-Vt8F/_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/garu/ITGxpj5UQhT-Vt8F/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/garu/ITGxpj5UQhT-Vt8F/_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/garu/ITGxpj5UQhT-Vt8F/_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/garu/ITGxpj5UQhT-Vt8F/_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/garu/ITGxpj5UQhT-Vt8F/_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/garu/ITGxpj5UQhT-Vt8F/_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/garu/ITGxpj5UQhT-Vt8F/_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/garu/ITGxpj5UQhT-Vt8F/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Criar Cobrança Agendada - Garu\">\u003cmeta data-mint-head property=\"og:description\" content=\"Agende uma cobrança PIX ou Boleto para um cliente cadastrado\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Garu\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.garu.com.br/api-reference/cobrancas-agendadas/criar\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://garu.mintlify.app/_mintlify/api/og/v2?division=Cobran%C3%A7as+Agendadas\u0026amp;title=Criar+Cobran%C3%A7a+Agendada\u0026amp;description=Agende+uma+cobran%C3%A7a+PIX+ou+Boleto+para+um+cliente+cadastrado\u0026amp;theme=39fe5b8799026abc572c883a\u0026amp;signature=2eccba97f782d509c35a9a24f08ecdee7b4eac080128e15efc0f79bf3a282417\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Criar Cobrança Agendada - Garu\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Agende uma cobrança PIX ou Boleto para um cliente cadastrado\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://garu.mintlify.app/_mintlify/api/og/v2?division=Cobran%C3%A7as+Agendadas\u0026amp;title=Criar+Cobran%C3%A7a+Agendada\u0026amp;description=Agende+uma+cobran%C3%A7a+PIX+ou+Boleto+para+um+cliente+cadastrado\u0026amp;theme=39fe5b8799026abc572c883a\u0026amp;signature=2eccba97f782d509c35a9a24f08ecdee7b4eac080128e15efc0f79bf3a282417\">\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/garu/ITGxpj5UQhT-Vt8F/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Garu\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#257264\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.garu.com.br/api-reference/cobrancas-agendadas/criar\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/cobrancas-agendadas/criar.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.garu.com.br/#organization\",\"name\":\"Garu\",\"url\":\"https://docs.garu.com.br\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/garu/g-shOvMOEbJZqokd/logo/light.svg?fit=max\u0026auto=format\u0026n=g-shOvMOEbJZqokd\u0026q=85\u0026s=b6c0de2b9b2378205ccf76d131a91a69\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.garu.com.br#website\",\"name\":\"Garu\",\"url\":\"https://docs.garu.com.br\",\"publisher\":{\"@id\":\"https://docs.garu.com.br/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.garu.com.br/api-reference/cobrancas-agendadas/criar#webpage\",\"url\":\"https://docs.garu.com.br/api-reference/cobrancas-agendadas/criar\",\"name\":\"Criar Cobrança Agendada\",\"description\":\"Agende uma cobrança PIX ou Boleto para um cliente cadastrado\",\"dateModified\":\"2026-10-02T01:18:56.592Z\",\"isPartOf\":{\"@id\":\"https://docs.garu.com.br#website\"},\"breadcrumb\":{\"@id\":\"https://docs.garu.com.br/api-reference/cobrancas-agendadas/criar#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.garu.com.br/api-reference/cobrancas-agendadas/criar#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Garu\",\"item\":\"https://docs.garu.com.br\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Criar Cobrança Agendada\",\"item\":\"https://docs.garu.com.br/api-reference/cobrancas-agendadas/criar\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.garu.com.br/api-reference/cobrancas-agendadas/criar#apireference\",\"headline\":\"Criar Cobrança Agendada\",\"name\":\"Criar Cobrança Agendada\",\"description\":\"Agende uma cobrança PIX ou Boleto para um cliente cadastrado\",\"url\":\"https://docs.garu.com.br/api-reference/cobrancas-agendadas/criar\",\"mainEntityOfPage\":{\"@id\":\"https://docs.garu.com.br/api-reference/cobrancas-agendadas/criar#webpage\"},\"dateModified\":\"2026-10-02T01:18:56.592Z\",\"publisher\":{\"@id\":\"https://docs.garu.com.br/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.garu.com.br#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Garu\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Garu","nav":{"global":{"anchors":[{"anchor":"Dashboard","icon":"gauge","href":"https://garu.com.br/inicio"},{"anchor":"OpenAPI","icon":"code","href":"https://garu.com.br/api/openapi.json"}]},"tabs":[{"tab":"Guias","pages":[{"title":"Guias","href":""}]},{"tab":"Referência da API","groups":[{"group":"Primeiros Passos","pages":[{"title":"Introdução","href":"/api-reference/introduction"},{"title":"Autenticação","href":"/api-reference/autenticacao"}]},{"group":"Produtos","pages":[{"title":"Criar Produto","api":"POST /api/v1/products","href":"/api-reference/produtos/criar"},{"title":"Link de Pagamento","href":"/api-reference/produtos/link-pagamento"},{"title":"Listar Produtos","api":"GET /api/v1/products","href":"/api-reference/produtos/listar"},{"title":"Atualizar Produto","api":"PATCH /api/v1/products/{uuid}","href":"/api-reference/produtos/atualizar"},{"title":"Excluir Produto","api":"DELETE /api/v1/products/{uuid}","href":"/api-reference/produtos/excluir"},{"title":"Portal customizado por produto (B2B2C)","href":"/api-reference/produtos/portal-config"}]},{"group":"Checkout Sessions","pages":[{"title":"Criar Checkout Session","api":"POST /api/checkout/sessions","href":"/api-reference/checkout/criar"},{"title":"Listar Checkout Sessions","api":"GET /api/checkout/sessions","href":"/api-reference/checkout/listar"},{"title":"Detalhes da Checkout Session","api":"GET /api/checkout/sessions/{id}","href":"/api-reference/checkout/detalhes"},{"title":"Expirar Checkout Session","api":"POST /api/checkout/sessions/{id}/expire","href":"/api-reference/checkout/expirar"}]},{"group":"Cobranças","pages":[{"title":"Criar Cobrança","api":"POST /api/v1/charges","href":"/api-reference/cobrancas/criar"},{"title":"Consultar Cobrança","api":"GET /api/v1/charges/{uuid}","href":"/api-reference/cobrancas/detalhes"},{"title":"Listar Cobranças","api":"GET /api/v1/charges","href":"/api-reference/cobrancas/listar"},{"title":"Estornar Cobrança","api":"POST /api/v1/charges/{uuid}/refund","href":"/api-reference/cobrancas/reembolsar"},{"title":"Cancelar Cobrança","api":"DELETE /api/v1/charges/{uuid}","href":"/api-reference/cobrancas/cancelar"}]},{"group":"Clientes","pages":[{"title":"Registrar Cliente","api":"POST /api/v1/customers","href":"/api-reference/clientes/criar"},{"title":"Listar Clientes","api":"GET /api/v1/customers","href":"/api-reference/clientes/listar"},{"title":"Consultar Cliente","api":"GET /api/v1/customers/{uuid}","href":"/api-reference/clientes/detalhes"},{"title":"Atualizar Cliente","api":"PATCH /api/v1/customers/{uuid}","href":"/api-reference/clientes/atualizar"},{"title":"Definir E-mail de Cobrança","api":"PATCH /api/v1/customers/{uuid}/billing-email-override","href":"/api-reference/clientes/definir-email-cobranca"},{"title":"Remover Cliente","api":"DELETE /api/v1/customers/{uuid}","href":"/api-reference/clientes/excluir"}]},{"group":"Transações","pages":[{"title":"Listar Transações","api":"GET /api/transactions","href":"/api-reference/transacoes/listar"},{"title":"Detalhes da Transação","api":"GET /api/transactions/{id}","href":"/api-reference/transacoes/detalhes"},{"title":"Consultar Status","api":"GET /api/transactions/status/{galaxPayId}","href":"/api-reference/transacoes/status"},{"title":"Reembolsar Transação","api":"POST /api/transactions/{id}/refund","href":"/api-reference/transacoes/reembolsar"},{"title":"Cancelar Transação","api":"DELETE /api/transactions/{id}","href":"/api-reference/transacoes/cancelar"}]},{"group":"Preços de Assinatura","pages":[{"title":"Criar Preço de Assinatura","api":"POST /api/subscription-prices","href":"/api-reference/assinaturas/precos/criar"},{"title":"Listar Preços de Assinatura","api":"GET /api/subscription-prices","href":"/api-reference/assinaturas/precos/listar"},{"title":"Detalhes do Preço","api":"GET /api/subscription-prices/{id}","href":"/api-reference/assinaturas/precos/detalhes"},{"title":"Atualizar Preço de Assinatura","api":"PATCH /api/subscription-prices/{id}","href":"/api-reference/assinaturas/precos/atualizar"},{"title":"Excluir Preço de Assinatura","api":"DELETE /api/subscription-prices/{id}","href":"/api-reference/assinaturas/precos/excluir"}]},{"group":"Assinaturas","pages":[{"title":"Listar Assinaturas","api":"GET /api/subscriptions","href":"/api-reference/assinaturas/listar"},{"title":"Detalhes da Assinatura","api":"GET /api/subscriptions/{id}","href":"/api-reference/assinaturas/detalhes"},{"title":"Cancelar Assinatura","api":"POST /api/subscriptions/{id}/cancel","href":"/api-reference/assinaturas/cancelar"},{"title":"Pausar Assinatura","api":"POST /api/subscriptions/{id}/pause","href":"/api-reference/assinaturas/pausar"},{"title":"Retomar Assinatura","api":"POST /api/subscriptions/{id}/resume","href":"/api-reference/assinaturas/retomar"},{"title":"Eventos da Assinatura","api":"GET /api/subscriptions/{id}/events","href":"/api-reference/assinaturas/eventos"},{"title":"Portal do Cliente","description":"Permitir que assinantes gerenciem suas assinaturas de forma autônoma","api":"POST /api/portal/sessions","href":"/api-reference/assinaturas/portal"}]},{"group":"Cobranças Agendadas","pages":[{"title":"Criar Cobrança Agendada","api":"POST /api/v1/scheduled-charges","href":"/api-reference/cobrancas-agendadas/criar"},{"title":"Listar Cobranças Agendadas","description":"Liste e filtre cobranças agendadas com paginação e busca por cliente","api":"GET /api/v1/scheduled-charges","href":"/api-reference/cobrancas-agendadas/listar"},{"title":"Detalhes da Cobrança Agendada","api":"GET /api/v1/scheduled-charges/{id}","href":"/api-reference/cobrancas-agendadas/detalhes"},{"title":"Cobrar Agora","api":"POST /api/v1/scheduled-charges/{id}/charge-now","href":"/api-reference/cobrancas-agendadas/cobrar-agora"},{"title":"Adiar Cobrança","api":"POST /api/v1/scheduled-charges/{id}/postpone","href":"/api-reference/cobrancas-agendadas/adiar"},{"title":"Pausar Cobrança","api":"POST /api/v1/scheduled-charges/{id}/pause","href":"/api-reference/cobrancas-agendadas/pausar"},{"title":"Retomar Cobrança","api":"POST /api/v1/scheduled-charges/{id}/resume","href":"/api-reference/cobrancas-agendadas/retomar"},{"title":"Marcar como Paga","api":"POST /api/v1/scheduled-charges/{id}/mark-paid","href":"/api-reference/cobrancas-agendadas/marcar-como-paga"},{"title":"Listar tentativas de cobrança","api":"GET /api/v1/scheduled-charges/{id}/attempts","href":"/api-reference/cobrancas-agendadas/tentativas"}]},{"group":"Boleto Parcelado (Carnê)","pages":[{"title":"Criar Carnê","api":"POST /api/v1/installment-plans","href":"/api-reference/carne/criar"},{"title":"Listar Carnês","api":"GET /api/v1/installment-plans","href":"/api-reference/carne/listar"},{"title":"Detalhes do Carnê","api":"GET /api/v1/installment-plans/{uuid}","href":"/api-reference/carne/detalhes"},{"title":"Segunda Via de Parcela","api":"POST /api/v1/installment-plans/{uuid}/installments/{number}/reissue","href":"/api-reference/carne/segunda-via"},{"title":"Adiar Parcela","api":"POST /api/v1/installment-plans/{uuid}/installments/{number}/postpone","href":"/api-reference/carne/adiar"},{"title":"Marcar Parcela como Paga","api":"POST /api/v1/installment-plans/{uuid}/installments/{number}/mark-paid","href":"/api-reference/carne/marcar-como-paga"},{"title":"Cancelar Carnê","api":"POST /api/v1/installment-plans/{uuid}/cancel","href":"/api-reference/carne/cancelar"},{"title":"Solicitar Estorno de Carnê","api":"POST /api/v1/installment-plans/{uuid}/refund-requests","href":"/api-reference/carne/solicitar-estorno"}]},{"group":"Pedidos de Estorno","pages":[{"title":"Listar Pedidos de Estorno","api":"GET /api/v1/refund-requests","href":"/api-reference/estornos/listar"},{"title":"Detalhes do Pedido de Estorno","api":"GET /api/v1/refund-requests/{uuid}","href":"/api-reference/estornos/detalhes"},{"title":"Confirmar Estorno","api":"POST /api/v1/refund-requests/{uuid}/confirm","href":"/api-reference/estornos/confirmar"},{"title":"Rejeitar Estorno","api":"POST /api/v1/refund-requests/{uuid}/reject","href":"/api-reference/estornos/rejeitar"}]},{"group":"Portal do Cliente","pages":[{"title":"Solicitar Link Mágico","api":"POST /api/public/minha-area/request","href":"/api-reference/portal-do-cliente/solicitar-link"},{"title":"Listar Cobranças do Cliente","api":"GET /api/public/minha-area/charges","href":"/api-reference/portal-do-cliente/listar-cobrancas"},{"title":"Atualizar E-mail de Cobrança","api":"PATCH /api/public/minha-area/profile","href":"/api-reference/portal-do-cliente/atualizar-email"}]},{"group":"Configuração da Conta","pages":[{"title":"Consultar Taxas Negociadas","api":"GET /api/seller-config/me","href":"/api-reference/seller-config/taxas"}]},{"group":"Webhooks e Exemplos","pages":[{"title":"Webhooks","href":"/api-reference/webhooks"},{"title":"Códigos de falha","href":"/api-reference/webhooks/codigos-de-falha"},{"title":"Disparar webhook manualmente","api":"POST /api/webhook-endpoints/{id}/trigger","href":"/api-reference/webhooks/disparar-manualmente"},{"title":"Listar Eventos de Webhook","api":"GET /api/v1/webhook-events","href":"/api-reference/webhooks/eventos/listar"},{"title":"Detalhes do Evento de Webhook","api":"GET /api/v1/webhook-events/{uuid}","href":"/api-reference/webhooks/eventos/detalhes"},{"title":"Reenviar (clonando) Evento de Webhook","api":"POST /api/v1/webhook-events/{uuid}/resend","href":"/api-reference/webhooks/eventos/resend"},{"title":"Reenviar Evento de Webhook","api":"POST /api/v1/webhook-events/{uuid}/retry","href":"/api-reference/webhooks/eventos/reenviar"},{"title":"Exemplos de Código","href":"/api-reference/exemplos"}]},{"group":"Suporte","pages":[{"title":"Solução de Problemas","href":"/api-reference/troubleshooting"}]}]}]},"title":"Criar Cobrança Agendada - Garu","buildId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","deploymentId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-26-lDe7V.js","utils-CWQmgYtH.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-4-Aw3rSD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C2zjXYA5.js","snippetPresets-DFmpFA7C.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-FJpQavWq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D_GvPF7k.js","shallow-Bs2ZB0NO.js","getApiPlaygroundDisplay-DCcqJJk-.js","CodeSnippet-DzDxawVe.js","CodeSnippets-aUr7fU-7.js","Page-CT9uE8Ip.js","getPastedJson-Y1fKsj_I.js","icon-DI4zTsDr.js","MethodPill-C0nDlmSQ.js","DuplicateIcon-NUXbx2nQ.js","createIcon-BdTHrPAi.js","DynamicMarkdown-CtpgKJwj.js","SectionHeading-B3x35tOt.js","axios-vUo_bRtp.js"]}