Envie um cartão de pagamento dentro do WhatsApp, com Pix copia-e-cola ou link de pagamento, dê baixa quando o cliente pagar e use em conversas, templates e automações.
O que é
Uma cobrança é um cartão de pagamento nativo do WhatsApp que chega dentro da conversa: número da cobrança, itens, total e um botão, Copiar código Pix ou Pagar, conforme o meio que você usar.
O WhatsApp não processa o pagamento, e a Arara também não. O Pix copia-e-cola ou o link vêm do seu banco ou PSP, e o dinheiro cai direto na sua conta. A Arara entrega o cartão e, quando você avisa que foi pago, põe o selo de pago nele.
Por que usar
O cliente paga sem sair da conversa. Sem “entra no site”, sem PDF de boleto, sem procurar o código no e-mail.
O cartão é nativo. Não é uma mensagem de texto com um código solto: o WhatsApp mostra itens, total e botão de copiar.
O código é conferido antes de sair. Pix cortado ou com caractere trocado é recusado na API, não no app do banco do seu cliente.
Fica registrado. Cada cobrança tem status, contato, origem e data de pagamento, e alimenta o total gasto do contato.
Como aparece no WhatsApp
À esquerda, a cobrança recém-enviada. À direita, a mesma cobrança depois que você deu baixa.O ciclo tem dois passos e os dois são seus: enviar a cobrança e dar baixa.
Como faço
1
Envie a cobrança na conversa (janela de 24h aberta)
curl -X POST https://api.ararahq.com/v1/messages \ -H "Authorization: Bearer $ARARA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "receiver": "5588999990000", "interactive": { "type": "charge", "body": "Segue a fatura de outubro. É só tocar no botão para pagar.", "charge": { "referenceId": "fatura-2026-10-9912", "items": [{ "name": "Fatura out/2026", "amountCents": 5990, "quantity": 1 }], "pix": { "code": "00020126580014br.gov.bcb.pix...6304ABCD", "key": "39580525000189", "keyType": "CNPJ", "merchantName": "Loja Exemplo" } } } }'
Valores sempre em centavos.No dashboard, o mesmo envio sai do link Cobrar na caixa de Conversas: você cola o Pix e a tela lê valor, nome de quem recebe e chave do próprio código.
Conversas: o painel Cobrar com o Pix colado, o valor lido do código e o total no botão de enviar.
2
Dê baixa quando o pagamento cair
Quando o seu banco ou PSP confirmar, avise a Arara. O cartão ganha o selo de pago.
status aceita PAID, FAILED (o pagamento não passou; a cobrança segue em aberto) e CANCELED. description é opcional, até 120 caracteres.Com a conversa fechada, a baixa sai pelo painel ou por PUT /v1/charges/{id}/status: ela é registrada de qualquer jeito, e o cartão no WhatsApp só é atualizado quando a janela de 24h deixa.No dashboard, as cobranças em aberto da conversa aparecem com Marcar como paga e Cancelar.
Conversas: as cobranças em aberto do contato, com os botões Marcar como paga e Cancelar.
3
Fora da janela, cobre por template
Para cobrar quem não falou com você nas últimas 24h, crie um template com o botão de cobrança. Ele precisa ser o único botão do template.
Template com botão de cobrança exigecharge; template sem o botão recusa charge.
O que pode dar errado
A cobrança não muda de estado sozinha
Esse é o ponto que mais gera dúvida, então sem rodeio: a Arara não sabe que o cliente pagou. O Pix cai no seu banco, não aqui. Enquanto ninguém avisar, a cobrança fica PENDING para sempre, e o cartão no WhatsApp continua “aguardando pagamento” mesmo com o dinheiro já na sua conta.Existem dois jeitos de avisar, e você precisa de um deles:
Alguém marca como paga no painel, ou o seu código manda o charge_status por POST /v1/messages.
O seu sistema posta no gancho da automação: um POST no link da automação com { "referenceId": "...", "status": "paid" }. É o caminho para automatizar, o seu backend, ao receber a confirmação do PSP, repassa para o gancho. status aceita paid, failed, canceled e expired.
A única mudança automática é o vencimento: se você mandou expiresAt e o prazo passa sem baixa, a Arara marca EXPIRED sozinha. No WhatsApp ela aparece como cancelada, porque o cartão não tem estado de vencido. Sem expiresAt, nem isso acontece.
Um meio de pagamento por cobrança
Ou pix, ou paymentLink. Mandar os dois é recusado (“por enquanto é um meio de pagamento por cobrança”), e não mandar nenhum também. Não existe cartão com as duas opções.
O Pix é conferido antes de sair
Erro de cobrança aparece no celular do seu cliente, então a API recusa cedo, com 422 e a frase do problema:
Código que não é Pix copia-e-cola, ou cortado: todo BR Code termina em 6304 + um dígito verificador (CRC16). A Arara recalcula.
Caractere trocado: o CRC não fecha e o envio é recusado com “copie de novo do banco”.
Total diferente do valor dentro do Pix: se o código fixa valor e ele não bate com o total dos itens, o envio é recusado. Sem isso, o cartão mostraria um número e o banco cobraria outro. Pix sem valor fixo (dinâmico) passa.
referenceId repetido, total zerado ou negativo, item sem nome, valor ou quantidade não positivos, vencimento a menos de 5 minutos, link sem https.
Na conversa, a cobrança só é registrada depois que o provedor aceita o envio: envio que falha não queima o referenceId. Com template é diferente: o template vai para fila, então a cobrança é registrada já no enfileiramento. Se o envio falhar depois, aquele referenceId ficou usado, reenvie com outro.
Cobrança encerrada não volta atrás
Cobrança PAID, CANCELED ou EXPIRED não aceita outro status. Reenviar o mesmo status é permitido (é o caso do cartão que precisa alcançar uma baixa que entrou pelo gancho), qualquer outro é recusado. FAILED não encerra: a cobrança segue em aberto.A baixa por mensagem (charge_status) é mensagem dentro da janela de 24h, então depende da janela de 24h. Como pagamento costuma ser confirmado em minutos, na prática ela está aberta, e quando não está, o caminho é o PUT.
Campanhas ainda não enviam cobrança por contato. Um template de cobrança escolhido numa campanha é recusado na criação. Use a API ou uma automação.
Em automações
Num passo de mensagem com template de cobrança, você diz de onde vem cada dado. Cada campo aceita texto fixo ou {{variavel}} do evento que dispara a automação:
Para link de pagamento, use "paymentLink": "{{payment_url}}" no lugar dos campos de Pix. O seu sistema gera o Pix ou o link e manda no evento (payment.failed, cart.abandoned ou webhook próprio); a automação monta e envia a cobrança. As mesmas conferências do envio pela API valem aqui.
Saber se pagou dentro da automação
O caminho recomendado é o link da automação: o seu sistema manda a cobrança pronta num POST, a automação envia e para no passo wait_payment, e um segundo POST no mesmo link avisa paid. A execução segue por paid ou unpaid, sem mapear {{variaveis}}.Os gatilhos charge.paid e charge.expired iniciam uma automação quando qualquer cobrança da organização chega nesse status.
Referência
Campos da cobrança
Campo
Regra
body
Obrigatório, até 1024 caracteres.
charge.referenceId
Seu número da cobrança. Até 60 caracteres: letras, números, ., - e _. Único por organização: é com ele que você dá baixa.
charge.items
De 1 a 10. name até 60 caracteres, amountCents e quantity positivos. id opcional (seu SKU).
charge.shippingCents, charge.discountCents
Opcionais, não negativos. O total do cartão é itens + frete − desconto.
charge.expiresAt
Opcional, epoch em segundos, pelo menos 5 minutos à frente.
charge.pix
code (copia-e-cola), key, keyType (CPF, CNPJ, EMAIL, PHONE ou EVP) e merchantName.
charge.paymentLink
url em https.
Cobrança e contato
Toda cobrança fica ligada ao contato do telefone. Quando ela é paga, o contato tem o total gasto, o número de compras e a última compra atualizados.
Consultar
Os caminhos /v1/charges/** aceitam chave de API: leitura pede a permissão READ, e a baixa direta (PUT /v1/charges/{id}/status) pede MESSAGES_SEND. Para acompanhar status no seu backend sem consultar, use os eventos charge.* do webhook.
method é PIX ou PAYMENT_LINK. contact pode vir null; automationId, automationName e runId só vêm preenchidos quando a cobrança saiu de uma automação. O código Pix e o link não são guardados pela Arara.
Endpoint
O que devolve
GET /v1/charges/{id}
Uma cobrança.
GET /v1/charges?contactId={id}
As cobranças de um contato.
PUT /v1/charges/{id}/status
Dá baixa direto: { "status": "PAID" | "CANCELED" | "FAILED" }. Funciona com a conversa fechada; cardUpdated na resposta diz se o cartão no WhatsApp foi atualizado.
Para receber cada mudança de status no seu backend, use os eventos charge.*.
Cobranças: a lista com os filtros de status e origem, mostrando cobranças em aberto, pagas e vencidas.
Próximos passos
Link da automação e pagamento
Dar baixa na cobrança pelo seu sistema.
Automações pela API
Cobrança como passo de automação.
Eventos de webhook
Eventos charge.*.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Arara — API de WhatsApp Business","colors":{"primary":"#1c99a7","light":"#5fbcc7","dark":"#205f6a"},"logo":{"light":"https://mintcdn.com/arara/ovMH8TBGwmFFaXL6/logo/arara-horizontal-light.svg?fit=max\u0026auto=format\u0026n=ovMH8TBGwmFFaXL6\u0026q=85\u0026s=8fef9120c75d5f9f411f505c5f9cd556","dark":"https://mintcdn.com/arara/ovMH8TBGwmFFaXL6/logo/arara-horizontal-dark.svg?fit=max\u0026auto=format\u0026n=ovMH8TBGwmFFaXL6\u0026q=85\u0026s=2cfd5e64a99d74b4554167bdbd1628d5"},"favicon":"https://mintcdn.com/arara/ovMH8TBGwmFFaXL6/favicon.svg?fit=max\u0026auto=format\u0026n=ovMH8TBGwmFFaXL6\u0026q=85\u0026s=a5edca9339f945c101aa8c8e7cf14d55","api":{"examples":{"defaults":"required","languages":["curl","javascript","python","php"]}},"appearance":{"default":"system","strict":false},"navbar":{"links":[{"href":"https://docs.ararahq.com/llms.txt","label":"llms.txt"},{"href":"https://github.com/ararahq","label":"Repositório"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.ararahq.com"}},"footer":{"socials":{"github":"https://github.com/ararahq","linkedin":"https://linkedin.com/company/ararahq"}},"fonts":{"family":"Geist"},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"GitHub","icon":"github","href":"https://github.com/ararahq/"},{"anchor":"Landing Page","icon":"browser","href":"https://ararahq.com"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"arara","hasAudioNarration":false,"actualSubdomain":"arara","customDomains":["docs.ararahq.com"],"gitSource":{"type":"github","owner":"ararahq","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6affbfa6f7863031296acab1","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API","count":107},{"language":"default","tag":"Guias","count":30},{"language":"default","tag":"Automações","count":17},{"language":"default","tag":"Templates","count":11},{"language":"default","tag":"Campanhas","count":10},{"language":"default","tag":"SDKs e Ferramentas","count":10},{"language":"default","tag":"Comece aqui","count":10},{"language":"default","tag":"Contatos","count":9},{"language":"default","tag":"Mensagens","count":9},{"language":"default","tag":"Formulários","count":9}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"custom.css","content":":root{--arara-brand-500: #1c99a7;--arara-brand-600: #1c7682;--arara-brand-300-dark: #5fbcc7}nav img[alt*=\"logo\"i],header img[alt*=\"logo\"i],a[href=\"/\"] img,[class*=\"logo\"] img,[class*=\"Logo\"] img{height:2.25rem;max-height:2.25rem;width:auto;object-fit:contain}"}]}
{"page":{"pagePath":"cobrancas","slug":"/cobrancas","pageMetadata":{"title":"Cobranças (Pix e link de pagamento)","description":"Envie um cartão de pagamento dentro do WhatsApp, com Pix copia-e-cola ou link de pagamento, dê baixa quando o cliente pagar e use em conversas, templates e automações.","keywords":["pix","cobrança","pagamento","order_details","link de pagamento","copia e cola","baixa"],"href":"/cobrancas"},"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: \"Envie um cartão de pagamento dentro do WhatsApp, com Pix copia-e-cola ou link de pagamento, dê baixa quando o cliente pagar e use em conversas, templates e automações.\"\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`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Card,CardGroup,CodeBlock,Frame,Heading,Note,OptimizedImage,Step,Steps,Table,Warning}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`o-que-é`,children:`O que é`}),`\n`,_jsxs(_components.p,{children:[`Uma cobrança é um `,_jsx(_components.strong,{children:`cartão de pagamento nativo do WhatsApp`}),` que chega dentro da conversa: número da cobrança, itens, total e um botão, `,_jsx(_components.strong,{children:`Copiar código Pix`}),` ou `,_jsx(_components.strong,{children:`Pagar`}),`, conforme o meio que você usar.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`O WhatsApp não processa o pagamento, e a Arara também não.`}),` O Pix copia-e-cola ou o link vêm do seu banco ou PSP, e o dinheiro cai direto na sua conta. A Arara entrega o cartão e, quando você avisa que foi pago, põe o selo de pago nele.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`por-que-usar`,children:`Por que usar`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`O cliente paga sem sair da conversa.`}),` Sem “entra no site”, sem PDF de boleto, sem procurar o código no e-mail.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`O cartão é nativo.`}),` Não é uma mensagem de texto com um código solto: o WhatsApp mostra itens, total e botão de copiar.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`O código é conferido antes de sair.`}),` Pix cortado ou com caractere trocado é recusado na API, não no app do banco do seu cliente.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Fica registrado.`}),` Cada cobrança tem status, contato, origem e data de pagamento, e alimenta o total gasto do contato.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`como-aparece-no-whatsapp`,children:`Como aparece no WhatsApp`}),`\n`,_jsxs(_components.p,{children:[`À esquerda, a cobrança recém-enviada. À direita, a mesma cobrança depois que `,_jsx(_components.strong,{children:`você`}),` deu baixa.`]}),`\n`,_jsx(OptimizedImage,{className:`mint-block dark:mint-hidden`,src:`https://mintcdn.com/arara/1O3fcKz8iJHdQsj0/images/cobrancas-cartao-light.svg?fit=max\u0026auto=format\u0026n=1O3fcKz8iJHdQsj0\u0026q=85\u0026s=467453fe0b9b955a91d9d592c5fa62e0`,alt:`Cartão de cobrança com botão Copiar código Pix e, ao lado, o mesmo cartão com o selo de pago`,\"data-og-width\":`640`,width:`640`,\"data-og-height\":`360`,height:`360`,\"data-path\":`images/cobrancas-cartao-light.svg`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/arara/1O3fcKz8iJHdQsj0/images/cobrancas-cartao-light.svg?w=280\u0026fit=max\u0026auto=format\u0026n=1O3fcKz8iJHdQsj0\u0026q=85\u0026s=940d1fce1a5dc37772daaab69305bae7 280w, https://mintcdn.com/arara/1O3fcKz8iJHdQsj0/images/cobrancas-cartao-light.svg?w=560\u0026fit=max\u0026auto=format\u0026n=1O3fcKz8iJHdQsj0\u0026q=85\u0026s=eb3948c29326a1bc4af51c2aa3a3a7d6 560w, https://mintcdn.com/arara/1O3fcKz8iJHdQsj0/images/cobrancas-cartao-light.svg?w=840\u0026fit=max\u0026auto=format\u0026n=1O3fcKz8iJHdQsj0\u0026q=85\u0026s=f0c844932502c62e2882b19c7d9047e3 840w, https://mintcdn.com/arara/1O3fcKz8iJHdQsj0/images/cobrancas-cartao-light.svg?w=1100\u0026fit=max\u0026auto=format\u0026n=1O3fcKz8iJHdQsj0\u0026q=85\u0026s=658968dce5b044a14bcf7fbc5fd49c81 1100w, https://mintcdn.com/arara/1O3fcKz8iJHdQsj0/images/cobrancas-cartao-light.svg?w=1650\u0026fit=max\u0026auto=format\u0026n=1O3fcKz8iJHdQsj0\u0026q=85\u0026s=f105d235f8d7a602a5812bd571d8af20 1650w, https://mintcdn.com/arara/1O3fcKz8iJHdQsj0/images/cobrancas-cartao-light.svg?w=2500\u0026fit=max\u0026auto=format\u0026n=1O3fcKz8iJHdQsj0\u0026q=85\u0026s=3b0c2d69ebf957f3812e4af1f699c774 2500w`}),`\n`,_jsx(OptimizedImage,{className:`mint-hidden dark:mint-block`,src:`https://mintcdn.com/arara/1O3fcKz8iJHdQsj0/images/cobrancas-cartao-dark.svg?fit=max\u0026auto=format\u0026n=1O3fcKz8iJHdQsj0\u0026q=85\u0026s=bb600ef6b1f33da7993540a53040c121`,alt:`Cartão de cobrança com botão Copiar código Pix e, ao lado, o mesmo cartão com o selo de pago`,\"data-og-width\":`640`,width:`640`,\"data-og-height\":`360`,height:`360`,\"data-path\":`images/cobrancas-cartao-dark.svg`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/arara/1O3fcKz8iJHdQsj0/images/cobrancas-cartao-dark.svg?w=280\u0026fit=max\u0026auto=format\u0026n=1O3fcKz8iJHdQsj0\u0026q=85\u0026s=f7ad8c935902131d0b99861bf14b945c 280w, https://mintcdn.com/arara/1O3fcKz8iJHdQsj0/images/cobrancas-cartao-dark.svg?w=560\u0026fit=max\u0026auto=format\u0026n=1O3fcKz8iJHdQsj0\u0026q=85\u0026s=4d7a49bd756e8032ce0218fa12ffa235 560w, https://mintcdn.com/arara/1O3fcKz8iJHdQsj0/images/cobrancas-cartao-dark.svg?w=840\u0026fit=max\u0026auto=format\u0026n=1O3fcKz8iJHdQsj0\u0026q=85\u0026s=60a39e5d35435d800d5862a51b799f6d 840w, https://mintcdn.com/arara/1O3fcKz8iJHdQsj0/images/cobrancas-cartao-dark.svg?w=1100\u0026fit=max\u0026auto=format\u0026n=1O3fcKz8iJHdQsj0\u0026q=85\u0026s=9f605150c514dce26d735684b2084e77 1100w, https://mintcdn.com/arara/1O3fcKz8iJHdQsj0/images/cobrancas-cartao-dark.svg?w=1650\u0026fit=max\u0026auto=format\u0026n=1O3fcKz8iJHdQsj0\u0026q=85\u0026s=aa48a1af95cc3900694245a8df4ff12e 1650w, https://mintcdn.com/arara/1O3fcKz8iJHdQsj0/images/cobrancas-cartao-dark.svg?w=2500\u0026fit=max\u0026auto=format\u0026n=1O3fcKz8iJHdQsj0\u0026q=85\u0026s=e7d275718a7a509bd1ea30fda3b9b0db 2500w`}),`\n`,_jsxs(_components.p,{children:[`O ciclo tem dois passos e os dois são seus: `,_jsx(_components.strong,{children:`enviar a cobrança`}),` e `,_jsx(_components.strong,{children:`dar baixa`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`como-faço`,children:`Como faço`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Envie a cobrança na conversa (janela de 24h aberta)`,children:[_jsx(CodeBlock,{filename:``,numberOfLines:`20`,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:`20`,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://api.ararahq.com/v1/messages`}),_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 `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$ARARA_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_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:` \"receiver\": \"5588999990000\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"interactive\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"type\": \"charge\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"body\": \"Segue a fatura de outubro. É só tocar no botão para pagar.\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"charge\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"referenceId\": \"fatura-2026-10-9912\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"items\": [{ \"name\": \"Fatura out/2026\", \"amountCents\": 5990, \"quantity\": 1 }],`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"pix\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"code\": \"00020126580014br.gov.bcb.pix...6304ABCD\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"key\": \"39580525000189\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"keyType\": \"CNPJ\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"merchantName\": \"Loja Exemplo\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_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:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_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:` }'`})}),`\n`]})})}),_jsxs(_components.p,{children:[`Com link de pagamento, troque o bloco `,_jsx(_components.code,{children:`pix`}),` por:`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`1`,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:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"paymentLink\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://pay.seupsp.com/c/abc123\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`]})})}),_jsxs(_components.p,{children:[`Valores sempre `,_jsx(_components.strong,{children:`em centavos`}),`.`]}),_jsxs(_components.p,{children:[`No dashboard, o mesmo envio sai do link `,_jsx(_components.strong,{children:`Cobrar`}),` na caixa de Conversas: você cola o Pix e a tela lê valor, nome de quem recebe e chave do próprio código.`]}),_jsx(Frame,{caption:`Conversas: o painel Cobrar com o Pix colado, o valor lido do código e o total no botão de enviar.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/arara/581xFdBhHj9cwuGo/images/cobrancas-conversa-cobrar.png?fit=max\u0026auto=format\u0026n=581xFdBhHj9cwuGo\u0026q=85\u0026s=2cfe5e2291d98ef1ecffe7434ff1bb48`,alt:`Painel de nova cobrança na caixa de Conversas do dashboard da Arara`,\"data-og-width\":`354`,width:`354`,\"data-og-height\":`600`,height:`600`,\"data-path\":`images/cobrancas-conversa-cobrar.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/arara/581xFdBhHj9cwuGo/images/cobrancas-conversa-cobrar.png?w=280\u0026fit=max\u0026auto=format\u0026n=581xFdBhHj9cwuGo\u0026q=85\u0026s=f0b187ebee6287a147da076d3df23ec6 280w, https://mintcdn.com/arara/581xFdBhHj9cwuGo/images/cobrancas-conversa-cobrar.png?w=560\u0026fit=max\u0026auto=format\u0026n=581xFdBhHj9cwuGo\u0026q=85\u0026s=8eb504e1ba5c6d49efa479754c34288f 560w, https://mintcdn.com/arara/581xFdBhHj9cwuGo/images/cobrancas-conversa-cobrar.png?w=840\u0026fit=max\u0026auto=format\u0026n=581xFdBhHj9cwuGo\u0026q=85\u0026s=53e510af9ec98e398ccad06e5aa81394 840w, https://mintcdn.com/arara/581xFdBhHj9cwuGo/images/cobrancas-conversa-cobrar.png?w=1100\u0026fit=max\u0026auto=format\u0026n=581xFdBhHj9cwuGo\u0026q=85\u0026s=8663574bf9807f7797f4cc309ca01792 1100w, https://mintcdn.com/arara/581xFdBhHj9cwuGo/images/cobrancas-conversa-cobrar.png?w=1650\u0026fit=max\u0026auto=format\u0026n=581xFdBhHj9cwuGo\u0026q=85\u0026s=b0c826d939201a598bb00451c5e1723b 1650w, https://mintcdn.com/arara/581xFdBhHj9cwuGo/images/cobrancas-conversa-cobrar.png?w=2500\u0026fit=max\u0026auto=format\u0026n=581xFdBhHj9cwuGo\u0026q=85\u0026s=341e215eb8b13ffe2c9ab79e244f13bb 2500w`})})]}),_jsxs(Step,{title:`Dê baixa quando o pagamento cair`,children:[_jsx(_components.p,{children:`Quando o seu banco ou PSP confirmar, avise a Arara. O cartão ganha o selo de pago.`}),_jsx(CodeBlock,{filename:``,numberOfLines:`11`,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:`11`,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://api.ararahq.com/v1/messages`}),_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 `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$ARARA_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_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:` \"receiver\": \"5588999990000\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"interactive\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"type\": \"charge_status\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"body\": \"Recebemos o pagamento. Obrigado!\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"chargeStatus\": { \"referenceId\": \"fatura-2026-10-9912\", \"status\": \"PAID\" }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_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:` }'`})}),`\n`]})})}),_jsxs(_components.p,{children:[_jsx(_components.code,{children:`status`}),` aceita `,_jsx(_components.code,{children:`PAID`}),`, `,_jsx(_components.code,{children:`FAILED`}),` (o pagamento não passou; a cobrança segue em aberto) e `,_jsx(_components.code,{children:`CANCELED`}),`. `,_jsx(_components.code,{children:`description`}),` é opcional, até 120 caracteres.`]}),_jsxs(_components.p,{children:[`Com a conversa fechada, a baixa sai pelo painel ou por `,_jsx(_components.code,{children:`PUT /v1/charges/{id}/status`}),`: ela é registrada de qualquer jeito, e o cartão no WhatsApp só é atualizado quando a janela de 24h deixa.`]}),_jsxs(_components.p,{children:[`No dashboard, as cobranças em aberto da conversa aparecem com `,_jsx(_components.strong,{children:`Marcar como paga`}),` e `,_jsx(_components.strong,{children:`Cancelar`}),`.`]}),_jsx(Frame,{caption:`Conversas: as cobranças em aberto do contato, com os botões Marcar como paga e Cancelar.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/arara/581xFdBhHj9cwuGo/images/cobrancas-marcar-como-paga.png?fit=max\u0026auto=format\u0026n=581xFdBhHj9cwuGo\u0026q=85\u0026s=77fd5bcb3a3a97ecb3a4e2bbbd67296e`,alt:`Lista de cobranças em aberto de um contato, com ações de baixa`,\"data-og-width\":`352`,width:`352`,\"data-og-height\":`288`,height:`288`,\"data-path\":`images/cobrancas-marcar-como-paga.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/arara/581xFdBhHj9cwuGo/images/cobrancas-marcar-como-paga.png?w=280\u0026fit=max\u0026auto=format\u0026n=581xFdBhHj9cwuGo\u0026q=85\u0026s=04d88c6f0d36b088751cafe50db84615 280w, https://mintcdn.com/arara/581xFdBhHj9cwuGo/images/cobrancas-marcar-como-paga.png?w=560\u0026fit=max\u0026auto=format\u0026n=581xFdBhHj9cwuGo\u0026q=85\u0026s=1d46fbe914961a99331926540d625990 560w, https://mintcdn.com/arara/581xFdBhHj9cwuGo/images/cobrancas-marcar-como-paga.png?w=840\u0026fit=max\u0026auto=format\u0026n=581xFdBhHj9cwuGo\u0026q=85\u0026s=dcd1285b69a176a8d22fb4e97738fdfc 840w, https://mintcdn.com/arara/581xFdBhHj9cwuGo/images/cobrancas-marcar-como-paga.png?w=1100\u0026fit=max\u0026auto=format\u0026n=581xFdBhHj9cwuGo\u0026q=85\u0026s=62de3c1d8c88e5f8744630dc4706f8d1 1100w, https://mintcdn.com/arara/581xFdBhHj9cwuGo/images/cobrancas-marcar-como-paga.png?w=1650\u0026fit=max\u0026auto=format\u0026n=581xFdBhHj9cwuGo\u0026q=85\u0026s=97b0a3336c0b518668fde0be78e2d0ee 1650w, https://mintcdn.com/arara/581xFdBhHj9cwuGo/images/cobrancas-marcar-como-paga.png?w=2500\u0026fit=max\u0026auto=format\u0026n=581xFdBhHj9cwuGo\u0026q=85\u0026s=d01fa2c985948d53e6303634bc4fcd29 2500w`})})]}),_jsxs(Step,{title:`Fora da janela, cobre por template`,children:[_jsxs(_components.p,{children:[`Para cobrar quem não falou com você nas últimas 24h, crie um template com o botão de cobrança. Ele precisa ser o `,_jsx(_components.strong,{children:`único`}),` botão do template.`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`11`,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:`11`,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://api.ararahq.com/v1/templates`}),_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 `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$ARARA_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_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:` \"name\": \"fatura_pix\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"category\": \"UTILITY\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"language\": \"pt_BR\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"body\": \"Oi {{nome}}, sua fatura de {{mes}} chegou.\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"samples\": { \"nome\": \"João\", \"mes\": \"outubro\" },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"buttons\": [{ \"type\": \"CHARGE\", \"text\": \"Pagar com Pix\" }]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsxs(_components.p,{children:[`Depois de aprovado, envie o template com o mesmo objeto `,_jsx(_components.code,{children:`charge`}),` do envio na conversa:`]}),_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://api.ararahq.com/v1/messages`}),_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 `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$ARARA_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_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:` \"receiver\": \"5588999990000\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"templateName\": \"fatura_pix\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"templateVariables\": [\"Maria\", \"outubro\"],`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"charge\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"referenceId\": \"fatura-2026-10-9912\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"items\": [{ \"name\": \"Fatura out/2026\", \"amountCents\": 5990 }],`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"pix\": { \"code\": \"000201...\", \"key\": \"39580525000189\", \"keyType\": \"CNPJ\", \"merchantName\": \"Loja Exemplo\" }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_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:` }'`})}),`\n`]})})}),_jsxs(_components.p,{children:[`Template com botão de cobrança `,_jsx(_components.strong,{children:`exige`}),` `,_jsx(_components.code,{children:`charge`}),`; template sem o botão recusa `,_jsx(_components.code,{children:`charge`}),`.`]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`o-que-pode-dar-errado`,children:`O que pode dar errado`}),`\n`,_jsx(Heading,{level:`3`,id:`a-cobrança-não-muda-de-estado-sozinha`,children:`A cobrança não muda de estado sozinha`}),`\n`,_jsxs(_components.p,{children:[`Esse é o ponto que mais gera dúvida, então sem rodeio: `,_jsx(_components.strong,{children:`a Arara não sabe que o cliente pagou.`}),` O Pix cai no seu banco, não aqui. Enquanto ninguém avisar, a cobrança fica `,_jsx(_components.code,{children:`PENDING`}),` para sempre, e o cartão no WhatsApp continua “aguardando pagamento” mesmo com o dinheiro já na sua conta.`]}),`\n`,_jsx(_components.p,{children:`Existem dois jeitos de avisar, e você precisa de um deles:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Alguém marca como paga no painel`}),`, ou o seu código manda o `,_jsx(_components.code,{children:`charge_status`}),` por `,_jsx(_components.code,{children:`POST /v1/messages`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`O seu sistema posta no gancho da automação`}),`: um `,_jsx(_components.code,{children:`POST`}),` no link da automação com `,_jsx(_components.code,{children:`{ \"referenceId\": \"...\", \"status\": \"paid\" }`}),`. É o caminho para automatizar, o seu backend, ao receber a confirmação do PSP, repassa para o gancho. `,_jsx(_components.code,{children:`status`}),` aceita `,_jsx(_components.code,{children:`paid`}),`, `,_jsx(_components.code,{children:`failed`}),`, `,_jsx(_components.code,{children:`canceled`}),` e `,_jsx(_components.code,{children:`expired`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`A única mudança automática é o vencimento: se você mandou `,_jsx(_components.code,{children:`expiresAt`}),` e o prazo passa sem baixa, a Arara marca `,_jsx(_components.code,{children:`EXPIRED`}),` sozinha. No WhatsApp ela aparece como cancelada, porque o cartão não tem estado de vencido. Sem `,_jsx(_components.code,{children:`expiresAt`}),`, nem isso acontece.`]}),`\n`,_jsx(Heading,{level:`3`,id:`um-meio-de-pagamento-por-cobrança`,children:`Um meio de pagamento por cobrança`}),`\n`,_jsxs(_components.p,{children:[`Ou `,_jsx(_components.code,{children:`pix`}),`, ou `,_jsx(_components.code,{children:`paymentLink`}),`. Mandar os dois é recusado (“por enquanto é um meio de pagamento por cobrança”), e não mandar nenhum também. Não existe cartão com as duas opções.`]}),`\n`,_jsx(Heading,{level:`3`,id:`o-pix-é-conferido-antes-de-sair`,children:`O Pix é conferido antes de sair`}),`\n`,_jsxs(_components.p,{children:[`Erro de cobrança aparece no celular do seu cliente, então a API recusa cedo, com `,_jsx(_components.code,{children:`422`}),` e a frase do problema:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Código que não é Pix copia-e-cola`}),`, ou `,_jsx(_components.strong,{children:`cortado`}),`: todo BR Code termina em `,_jsx(_components.code,{children:`6304`}),` + um dígito verificador (CRC16). A Arara recalcula.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Caractere trocado`}),`: o CRC não fecha e o envio é recusado com “copie de novo do banco”.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Total diferente do valor dentro do Pix`}),`: se o código fixa valor e ele não bate com o total dos itens, o envio é recusado. Sem isso, o cartão mostraria um número e o banco cobraria outro. Pix sem valor fixo (dinâmico) passa.`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`referenceId`}),` repetido`]}),`, total zerado ou negativo, item sem nome, valor ou quantidade não positivos, vencimento a menos de 5 minutos, link sem `,_jsx(_components.code,{children:`https`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Na conversa, a cobrança só é registrada depois que o provedor aceita o envio: envio que falha não queima o `,_jsx(_components.code,{children:`referenceId`}),`. `,_jsx(_components.strong,{children:`Com template é diferente`}),`: o template vai para fila, então a cobrança é registrada já no enfileiramento. Se o envio falhar depois, aquele `,_jsx(_components.code,{children:`referenceId`}),` ficou usado, reenvie com outro.`]}),`\n`,_jsx(Heading,{level:`3`,id:`cobrança-encerrada-não-volta-atrás`,children:`Cobrança encerrada não volta atrás`}),`\n`,_jsxs(_components.p,{children:[`Cobrança `,_jsx(_components.code,{children:`PAID`}),`, `,_jsx(_components.code,{children:`CANCELED`}),` ou `,_jsx(_components.code,{children:`EXPIRED`}),` não aceita outro status. Reenviar o mesmo status é permitido (é o caso do cartão que precisa alcançar uma baixa que entrou pelo gancho), qualquer outro é recusado. `,_jsx(_components.code,{children:`FAILED`}),` não encerra: a cobrança segue em aberto.`]}),`\n`,_jsxs(_components.p,{children:[`A baixa por mensagem (`,_jsx(_components.code,{children:`charge_status`}),`) é mensagem dentro da janela de 24h, então depende da janela de 24h. Como pagamento costuma ser confirmado em minutos, na prática ela está aberta, e quando não está, o caminho é o `,_jsx(_components.code,{children:`PUT`}),`.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Campanhas ainda não enviam cobrança por contato. Um template de cobrança escolhido numa campanha é recusado na criação. Use a API ou uma automação.`})}),`\n`,_jsx(Heading,{level:`2`,id:`em-automações`,children:`Em automações`}),`\n`,_jsxs(_components.p,{children:[`Num passo de mensagem com template de cobrança, você diz de onde vem cada dado. Cada campo aceita texto fixo ou `,_jsx(_components.code,{children:`{{variavel}}`}),` do evento que dispara a automação:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`13`,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:`13`,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:` \"templateId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},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:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"variables\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"nome\"`}),_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:` \"charge\"`}),_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:` \"referenceId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"pedido-{{order_id}}\"`}),_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:`\"{{product}}\"`}),_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:` \"amountCents\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"{{amount_cents}}\"`}),_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:` \"pixCode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"{{pix_code}}\"`}),_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:` \"pixKey\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"39580525000189\"`}),_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:` \"pixKeyType\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"CNPJ\"`}),_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:` \"merchantName\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Loja Exemplo\"`})]}),`\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`]})})}),`\n`,_jsxs(_components.p,{children:[`Para link de pagamento, use `,_jsx(_components.code,{children:`\"paymentLink\": \"{{payment_url}}\"`}),` no lugar dos campos de Pix. O seu sistema gera o Pix ou o link e manda no evento (`,_jsx(_components.code,{children:`payment.failed`}),`, `,_jsx(_components.code,{children:`cart.abandoned`}),` ou webhook próprio); a automação monta e envia a cobrança. As mesmas conferências do envio pela API valem aqui.`]}),`\n`,_jsx(Heading,{level:`3`,id:`saber-se-pagou-dentro-da-automação`,children:`Saber se pagou dentro da automação`}),`\n`,_jsxs(_components.p,{children:[`O caminho recomendado é o `,_jsx(_components.a,{href:`/automacoes-webhook`,children:`link da automação`}),`: o seu sistema manda a cobrança pronta num `,_jsx(_components.code,{children:`POST`}),`, a automação envia e para no passo `,_jsx(_components.code,{children:`wait_payment`}),`, e um segundo `,_jsx(_components.code,{children:`POST`}),` no mesmo link avisa `,_jsx(_components.code,{children:`paid`}),`. A execução segue por `,_jsx(_components.code,{children:`paid`}),` ou `,_jsx(_components.code,{children:`unpaid`}),`, sem mapear `,_jsx(_components.code,{children:`{{variaveis}}`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Os gatilhos `,_jsx(_components.code,{children:`charge.paid`}),` e `,_jsx(_components.code,{children:`charge.expired`}),` iniciam uma automação quando qualquer cobrança da organização chega nesse status.`]}),`\n`,_jsx(Heading,{level:`2`,id:`referência`,children:`Referência`}),`\n`,_jsx(Heading,{level:`3`,id:`campos-da-cobrança`,children:`Campos da cobrança`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Campo`}),_jsx(_components.th,{children:`Regra`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`body`})}),_jsx(_components.td,{children:`Obrigatório, até 1024 caracteres.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`charge.referenceId`})}),_jsxs(_components.td,{children:[`Seu número da cobrança. Até 60 caracteres: letras, números, `,_jsx(_components.code,{children:`.`}),`, `,_jsx(_components.code,{children:`-`}),` e `,_jsx(_components.code,{children:`_`}),`. `,_jsx(_components.strong,{children:`Único por organização`}),`: é com ele que você dá baixa.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`charge.items`})}),_jsxs(_components.td,{children:[`De 1 a 10. `,_jsx(_components.code,{children:`name`}),` até 60 caracteres, `,_jsx(_components.code,{children:`amountCents`}),` e `,_jsx(_components.code,{children:`quantity`}),` positivos. `,_jsx(_components.code,{children:`id`}),` opcional (seu SKU).`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`charge.shippingCents`}),`, `,_jsx(_components.code,{children:`charge.discountCents`})]}),_jsx(_components.td,{children:`Opcionais, não negativos. O total do cartão é itens + frete − desconto.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`charge.expiresAt`})}),_jsx(_components.td,{children:`Opcional, epoch em segundos, pelo menos 5 minutos à frente.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`charge.pix`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`code`}),` (copia-e-cola), `,_jsx(_components.code,{children:`key`}),`, `,_jsx(_components.code,{children:`keyType`}),` (`,_jsx(_components.code,{children:`CPF`}),`, `,_jsx(_components.code,{children:`CNPJ`}),`, `,_jsx(_components.code,{children:`EMAIL`}),`, `,_jsx(_components.code,{children:`PHONE`}),` ou `,_jsx(_components.code,{children:`EVP`}),`) e `,_jsx(_components.code,{children:`merchantName`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`charge.paymentLink`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`url`}),` em `,_jsx(_components.code,{children:`https`}),`.`]})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`cobrança-e-contato`,children:`Cobrança e contato`}),`\n`,_jsx(_components.p,{children:`Toda cobrança fica ligada ao contato do telefone. Quando ela é paga, o contato tem o total gasto, o número de compras e a última compra atualizados.`}),`\n`,_jsx(Heading,{level:`3`,id:`consultar`,children:`Consultar`}),`\n`,_jsxs(_components.p,{children:[`Os caminhos `,_jsx(_components.code,{children:`/v1/charges/**`}),` aceitam chave de API: leitura pede a permissão `,_jsx(_components.code,{children:`READ`}),`, e a baixa direta (`,_jsx(_components.code,{children:`PUT /v1/charges/{id}/status`}),`) pede `,_jsx(_components.code,{children:`MESSAGES_SEND`}),`. Para acompanhar status no seu backend sem consultar, use os eventos `,_jsx(_components.code,{children:`charge.*`}),` do webhook.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,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:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`GET`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` /v1/charges?page=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`\u0026`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`size`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`20`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`\u0026`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`status`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`PENDING`})]}),`\n`]})})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Filtro`}),_jsx(_components.th,{children:`Valores`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`status`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`PENDING`}),`, `,_jsx(_components.code,{children:`PAID`}),`, `,_jsx(_components.code,{children:`FAILED`}),`, `,_jsx(_components.code,{children:`CANCELED`}),` ou `,_jsx(_components.code,{children:`EXPIRED`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`source`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`CONVERSATION`}),`, `,_jsx(_components.code,{children:`TEMPLATE`}),`, `,_jsx(_components.code,{children:`AUTOMATION`}),` ou `,_jsx(_components.code,{children:`HOOK`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`contactId`})}),_jsx(_components.td,{children:`Só as cobranças de um contato.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`receiver`})}),_jsx(_components.td,{children:`Só as cobranças de um telefone.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`q`})}),_jsx(_components.td,{children:`Busca por texto.`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`page`}),`, `,_jsx(_components.code,{children:`size`})]}),_jsx(_components.td,{children:`Paginação.`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Devolve `,_jsx(_components.code,{children:`{ data, pagination }`}),`. Cada item:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`18`,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:`18`,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:`\"3f1c9a20-5b7d-4e8a-9c11-2d4e6f8a0b12\"`}),_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:` \"referenceId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"pedido-1042\"`}),_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:`\"Plano mensal\"`}),_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:` \"totalCents\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`5990`}),_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:` \"method\"`}),_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:`,`})]}),`\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:`\"PAID\"`}),_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:` \"source\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"HOOK\"`}),_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:` \"contact\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},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:`\"a1b2c3d4-...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Ana\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"phone\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"5588999990000\"`}),_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:` \"customerNumber\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"5588999990000\"`}),_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:` \"automationId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0e4f3c1e-...\"`}),_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:` \"automationName\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Cobrança do plano mensal\"`}),_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:` \"runId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"7c1d2e90-...\"`}),_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-09-20T14:02:11Z\"`}),_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:` \"statusUpdatedAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-09-20T14:09:40Z\"`}),_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:` \"paidAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-09-20T14:09:40Z\"`}),_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:` \"expiresAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-09-21T12:00:00Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`method`}),` é `,_jsx(_components.code,{children:`PIX`}),` ou `,_jsx(_components.code,{children:`PAYMENT_LINK`}),`. `,_jsx(_components.code,{children:`contact`}),` pode vir `,_jsx(_components.code,{children:`null`}),`; `,_jsx(_components.code,{children:`automationId`}),`, `,_jsx(_components.code,{children:`automationName`}),` e `,_jsx(_components.code,{children:`runId`}),` só vêm preenchidos quando a cobrança saiu de uma automação. O código Pix e o link `,_jsx(_components.strong,{children:`não são guardados`}),` pela Arara.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Endpoint`}),_jsx(_components.th,{children:`O que devolve`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`GET /v1/charges/{id}`})}),_jsx(_components.td,{children:`Uma cobrança.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`GET /v1/charges?contactId={id}`})}),_jsx(_components.td,{children:`As cobranças de um contato.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`PUT /v1/charges/{id}/status`})}),_jsxs(_components.td,{children:[`Dá baixa direto: `,_jsx(_components.code,{children:`{ \"status\": \"PAID\" | \"CANCELED\" | \"FAILED\" }`}),`. Funciona com a conversa fechada; `,_jsx(_components.code,{children:`cardUpdated`}),` na resposta diz se o cartão no WhatsApp foi atualizado.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`GET /v1/charges/summary?days=30`})}),_jsx(_components.td,{children:`O resumo do período.`})]})]})]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,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:`8`,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:` \"pendingCount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`12`}),_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:` \"pendingCents\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`71880`}),_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:` \"paidCount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`48`}),_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:` \"paidCents\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`287520`}),_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:` \"expiredCount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`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:` \"conversionRate\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0.74`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Para receber cada mudança de status no seu backend, use os eventos `,_jsx(_components.a,{href:`/webhooks/events#cobran%C3%A7as`,children:_jsx(_components.code,{children:`charge.*`})}),`.`]}),`\n`,_jsx(Frame,{caption:`Cobranças: a lista com os filtros de status e origem, mostrando cobranças em aberto, pagas e vencidas.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/arara/581xFdBhHj9cwuGo/images/cobrancas-lista.png?fit=max\u0026auto=format\u0026n=581xFdBhHj9cwuGo\u0026q=85\u0026s=89159be9148b5576085460e7447328b8`,alt:`Lista de cobranças no dashboard da Arara, com filtros por status e origem`,\"data-og-width\":`790`,width:`790`,\"data-og-height\":`745`,height:`745`,\"data-path\":`images/cobrancas-lista.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/arara/581xFdBhHj9cwuGo/images/cobrancas-lista.png?w=280\u0026fit=max\u0026auto=format\u0026n=581xFdBhHj9cwuGo\u0026q=85\u0026s=3b5775332f459ef8d55a8639109034f9 280w, https://mintcdn.com/arara/581xFdBhHj9cwuGo/images/cobrancas-lista.png?w=560\u0026fit=max\u0026auto=format\u0026n=581xFdBhHj9cwuGo\u0026q=85\u0026s=a9c8144c2400892ca98370c243183c4d 560w, https://mintcdn.com/arara/581xFdBhHj9cwuGo/images/cobrancas-lista.png?w=840\u0026fit=max\u0026auto=format\u0026n=581xFdBhHj9cwuGo\u0026q=85\u0026s=80cb711eda5166b5690d3b304a1302da 840w, https://mintcdn.com/arara/581xFdBhHj9cwuGo/images/cobrancas-lista.png?w=1100\u0026fit=max\u0026auto=format\u0026n=581xFdBhHj9cwuGo\u0026q=85\u0026s=2eaa333edbd1516e318c95d8ea99fcc9 1100w, https://mintcdn.com/arara/581xFdBhHj9cwuGo/images/cobrancas-lista.png?w=1650\u0026fit=max\u0026auto=format\u0026n=581xFdBhHj9cwuGo\u0026q=85\u0026s=3bc907df1c1cbe24e98d344d13b5d3d2 1650w, https://mintcdn.com/arara/581xFdBhHj9cwuGo/images/cobrancas-lista.png?w=2500\u0026fit=max\u0026auto=format\u0026n=581xFdBhHj9cwuGo\u0026q=85\u0026s=4968e9dbb79330fc78ce2dbba5a50e85 2500w`})}),`\n`,_jsx(Heading,{level:`2`,id:`próximos-passos`,children:`Próximos passos`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Link da automação e pagamento`,icon:`link`,href:`/automacoes-webhook`,children:_jsx(_components.p,{children:`Dar baixa na cobrança pelo seu sistema.`})}),_jsx(Card,{title:`Automações pela API`,icon:`code`,href:`/automacoes-api`,children:_jsx(_components.p,{children:`Cobrança como passo de automação.`})}),_jsx(Card,{title:`Eventos de webhook`,icon:`webhook`,href:`/webhooks/events`,children:_jsx(_components.p,{children:`Eventos charge.*.`})})]})]})}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":"Cobranças (Pix e link de pagamento)","description":"Envie um cartão de pagamento dentro do WhatsApp, com Pix copia-e-cola ou link de pagamento, dê baixa quando o cliente pagar e use em conversas, templates e automações.","keywords":["pix","cobrança","pagamento","order_details","link de pagamento","copia e cola","baixa"],"href":"/cobrancas"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"O que é","slug":"o-que-é","depth":2,"children":[]},{"title":"Por que usar","slug":"por-que-usar","depth":2,"children":[]},{"title":"Como aparece no WhatsApp","slug":"como-aparece-no-whatsapp","depth":2,"children":[]},{"title":"Como faço","slug":"como-faço","depth":2,"children":[]},{"title":"O que pode dar errado","slug":"o-que-pode-dar-errado","depth":2,"children":[{"title":"A cobrança não muda de estado sozinha","slug":"a-cobrança-não-muda-de-estado-sozinha","depth":3,"children":[]},{"title":"Um meio de pagamento por cobrança","slug":"um-meio-de-pagamento-por-cobrança","depth":3,"children":[]},{"title":"O Pix é conferido antes de sair","slug":"o-pix-é-conferido-antes-de-sair","depth":3,"children":[]},{"title":"Cobrança encerrada não volta atrás","slug":"cobrança-encerrada-não-volta-atrás","depth":3,"children":[]}]},{"title":"Em automações","slug":"em-automações","depth":2,"children":[{"title":"Saber se pagou dentro da automação","slug":"saber-se-pagou-dentro-da-automação","depth":3,"children":[]}]},{"title":"Referência","slug":"referência","depth":2,"children":[{"title":"Campos da cobrança","slug":"campos-da-cobrança","depth":3,"children":[]},{"title":"Cobrança e contato","slug":"cobrança-e-contato","depth":3,"children":[]},{"title":"Consultar","slug":"consultar","depth":3,"children":[]}]},{"title":"Próximos passos","slug":"próximos-passos","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"dynamicCss":".mint-block {\n display: block\n}\n.mint-hidden {\n display: none\n}\n.dark\\:mint-block:is(.dark *) {\n display: block\n}\n.dark\\:mint-hidden:is(.dark *) {\n display: none\n}","subdomain":"arara","siteName":"Arara — API de WhatsApp Business","title":"Cobranças (Pix e link de pagamento) - Arara — API de WhatsApp Business","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-12T04:38:15.274Z","originalFileLocation":"cobrancas.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=\"Envie um cartão de pagamento dentro do WhatsApp, com Pix copia-e-cola ou link de pagamento, dê baixa quando o cliente pagar e use em conversas, templates e automações.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Arara — API de WhatsApp Business\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/arara/ZKxy14BdqHsUuTlk/_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/arara/ZKxy14BdqHsUuTlk/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/arara/ZKxy14BdqHsUuTlk/_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/arara/ZKxy14BdqHsUuTlk/_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/arara/ZKxy14BdqHsUuTlk/_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/arara/ZKxy14BdqHsUuTlk/_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/arara/ZKxy14BdqHsUuTlk/_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/arara/ZKxy14BdqHsUuTlk/_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/arara/ZKxy14BdqHsUuTlk/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Cobranças (Pix e link de pagamento) - Arara — API de WhatsApp Business\">\u003cmeta data-mint-head property=\"og:description\" content=\"Envie um cartão de pagamento dentro do WhatsApp, com Pix copia-e-cola ou link de pagamento, dê baixa quando o cliente pagar e use em conversas, templates e automações.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Arara — API de WhatsApp Business\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.ararahq.com/cobrancas\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://arara.mintlify.site/_mintlify/api/og/v2?division=Recursos\u0026amp;title=Cobran%C3%A7as+%28Pix+e+link+de+pagamento%29\u0026amp;description=Envie+um+cart%C3%A3o+de+pagamento+dentro+do+WhatsApp%2C+com+Pix+copia-e-cola+ou+link+de+pagamento%2C+d%C3%AA+baixa+quando+o+cliente+pagar+e+use+em+conversas%2C+templates+e+auto\u0026amp;theme=a3dadafe870c1b96c64cdd3d\u0026amp;signature=85b669bbd4c3254e5ad72021ec5739860e7e67aa00f58cc66bf9b66b183e88b9\">\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=\"Cobranças (Pix e link de pagamento) - Arara — API de WhatsApp Business\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Envie um cartão de pagamento dentro do WhatsApp, com Pix copia-e-cola ou link de pagamento, dê baixa quando o cliente pagar e use em conversas, templates e automações.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://arara.mintlify.site/_mintlify/api/og/v2?division=Recursos\u0026amp;title=Cobran%C3%A7as+%28Pix+e+link+de+pagamento%29\u0026amp;description=Envie+um+cart%C3%A3o+de+pagamento+dentro+do+WhatsApp%2C+com+Pix+copia-e-cola+ou+link+de+pagamento%2C+d%C3%AA+baixa+quando+o+cliente+pagar+e+use+em+conversas%2C+templates+e+auto\u0026amp;theme=a3dadafe870c1b96c64cdd3d\u0026amp;signature=85b669bbd4c3254e5ad72021ec5739860e7e67aa00f58cc66bf9b66b183e88b9\">\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/arara/ZKxy14BdqHsUuTlk/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Arara — API de WhatsApp Business\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1c99a7\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.ararahq.com/cobrancas\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/cobrancas.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.ararahq.com/#organization\",\"name\":\"Arara — API de WhatsApp Business\",\"url\":\"https://docs.ararahq.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/arara/ovMH8TBGwmFFaXL6/logo/arara-horizontal-light.svg?fit=max\u0026auto=format\u0026n=ovMH8TBGwmFFaXL6\u0026q=85\u0026s=8fef9120c75d5f9f411f505c5f9cd556\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.ararahq.com#website\",\"name\":\"Arara — API de WhatsApp Business\",\"url\":\"https://docs.ararahq.com\",\"publisher\":{\"@id\":\"https://docs.ararahq.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.ararahq.com/cobrancas#webpage\",\"url\":\"https://docs.ararahq.com/cobrancas\",\"name\":\"Cobranças (Pix e link de pagamento)\",\"description\":\"Envie um cartão de pagamento dentro do WhatsApp, com Pix copia-e-cola ou link de pagamento, dê baixa quando o cliente pagar e use em conversas, templates e automações.\",\"dateModified\":\"2026-10-12T04:38:15.274Z\",\"isPartOf\":{\"@id\":\"https://docs.ararahq.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.ararahq.com/cobrancas#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.ararahq.com/cobrancas#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Recursos\",\"item\":\"https://docs.ararahq.com/flows\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Cobranças (Pix e link de pagamento)\",\"item\":\"https://docs.ararahq.com/cobrancas\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.ararahq.com/cobrancas#article\",\"headline\":\"Cobranças (Pix e link de pagamento)\",\"name\":\"Cobranças (Pix e link de pagamento)\",\"description\":\"Envie um cartão de pagamento dentro do WhatsApp, com Pix copia-e-cola ou link de pagamento, dê baixa quando o cliente pagar e use em conversas, templates e automações.\",\"url\":\"https://docs.ararahq.com/cobrancas\",\"mainEntityOfPage\":{\"@id\":\"https://docs.ararahq.com/cobrancas#webpage\"},\"dateModified\":\"2026-10-12T04:38:15.274Z\",\"keywords\":\"pix, cobrança, pagamento, order_details, link de pagamento, copia e cola, baixa\",\"publisher\":{\"@id\":\"https://docs.ararahq.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.ararahq.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Arara — API de WhatsApp Business\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Arara — API de WhatsApp Business\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/cobrancas.md","siteName":"Arara — API de WhatsApp Business","nav":{"global":{"anchors":[{"anchor":"GitHub","icon":"github","href":"https://github.com/ararahq/"},{"anchor":"Landing Page","icon":"browser","href":"https://ararahq.com"}]},"tabs":[{"tab":"Comece aqui","pages":[{"title":"Comece aqui","href":""}]},{"tab":"Guias","groups":[{"group":"Receitas","pages":[{"title":"Receitas","href":"/recipes"},{"title":"Login com código por WhatsApp (OTP)","href":"/recipes/otp-login"},{"title":"Confirmação de pedido","href":"/recipes/order-confirmation"},{"title":"Carrinho abandonado","href":"/recipes/abandoned-cart"},{"title":"Campanha Black Friday","href":"/recipes/black-friday"},{"title":"Atendimento com vários atendentes","href":"/recipes/inbox-support"},{"title":"Várias organizações (agência)","href":"/recipes/multi-org"}]},{"group":"Recursos","pages":[{"title":"Formulários (WhatsApp Flows)","description":"Formulário nativo que abre dentro da conversa do WhatsApp: crie pelo painel, envie por template ou pela API e receba cada resposta no webhook com chaves estáveis.","href":"/flows"},{"title":"Cobranças (Pix e link de pagamento)","href":"/cobrancas"},{"title":"Recuperação de receita","description":"Receba eventos de carrinho abandonado, pagamento recusado, Pix gerado e boleto a vencer da sua plataforma e dispare automaticamente um template no WhatsApp com link de retorno rastreável.","href":"/recovery"},{"title":"Campanhas de marketing","href":"/marketing"},{"title":"Smart Links","href":"/smart-links"},{"title":"Atribuição de conversão","href":"/smart-links/attribution"}]},{"group":"Automações","pages":[{"title":"Automações com resposta","href":"/automacoes-com-resposta"},{"title":"Link da automação e pagamento","href":"/automacoes-webhook"},{"title":"Automações pela API","href":"/automacoes-api"}]},{"group":"Brain (IA)","pages":[{"title":"Brain","href":"/brain"},{"title":"AbacatePay (Pix)","href":"/brain/actions/abacate-pix"},{"title":"Cal.com","href":"/brain/actions/cal-com"},{"title":"Catálogo Meta","href":"/brain/actions/catalog"},{"title":"Stripe","href":"/brain/actions/stripe"}]},{"group":"Integrações","pages":[{"title":"Integrações","href":"/integracoes"},{"title":"Laravel","href":"/integracoes/laravel"},{"title":"Next.js","href":"/integracoes/nextjs"},{"title":"Shopify","href":"/integracoes/shopify"},{"title":"Eventos de parceiros","href":"/api-reference/events/partner-events"}]},{"group":"Migrar de","pages":[{"title":"Migrar do Twilio","href":"/migrate/twilio"},{"title":"Migrar do Z-API","href":"/migrate/z-api"},{"title":"Migrar do Baileys","href":"/migrate/baileys"},{"title":"Migrar da Take Blip","href":"/migrate/take-blip"}]}]},{"tab":"API","pages":[{"title":"API","href":"/api-reference/introduction"}]},{"tab":"SDKs e Ferramentas","pages":[{"title":"SDKs e Ferramentas","href":"/sdks"}]},{"tab":"Novidades","pages":[{"title":"Novidades","href":"/changelog"}]}]},"basePath":"","title":"Cobranças (Pix e link de pagamento) - Arara — API de WhatsApp Business","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["a74be98ba7","07c022d89b"],"chunks":["zoom-image-lightbox-BQ4tbj_9.js","lightbox-handle-r17bVUz3.js","Frame-D0FT0qQs.js","DynamicMarkdown-CQM9Bhbv.js"]}