---
title: "Cobrança Pix no WhatsApp pela API: como enviar"
description: "Mandar o código Pix no WhatsApp resolve o pior ponto da cobrança digital: o cliente não precisa sair do app. Como enviar a cobrança pela API, tratar a confirmação e evitar os erros que transformam a facilidade em suporte."
url: "https://api-wa.me/blog/cobrar-pix-whatsapp-api"
language: "pt-BR"
og:type: "article"
og:site_name: "WAME API"
---

[Início](https://api-wa.me/)/[Blog da API do WhatsApp](https://api-wa.me/blog)/Cobrança por Pix dentro do WhatsApp pela API: como enviar e o que muda na conversão

Raphael Serafim· Publicado em 10 de setembro de 2026· 9 min de leitura

Compartilhar

# Cobrança por Pix dentro do WhatsApp pela API: como enviar e o que muda na conversão

Mandar o código Pix no WhatsApp resolve o pior ponto da cobrança digital: o cliente não precisa sair do app. Como enviar a cobrança pela API, tratar a confirmação e evitar os erros que transformam a facilidade em suporte.

Copiar para LLM[Ver como Markdown](https://api-wa.me/blog/cobrar-pix-whatsapp-api.md)

**A cobrança digital tem um ponto de fuga conhecido: a troca de aplicativo.** O cliente recebe o link, abre o navegador, espera carregar, copia o código, vai para o banco. Cada passo perde gente.

Mandar o Pix **dentro da conversa** elimina os passos do meio. O cliente copia o código onde já está e vai direto ao banco.

## Enviar a cobrança

```bash
curl -X POST "https://us.api-wa.me/SUA_KEY/message/pix" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "5566996852025",
    "items": [
      { "name": "Plano Profissional — outubro", "value": 8900 },
      { "name": "Usuário adicional", "value": 1900 }
    ],
    "total": 10800,
    "code": "00020126580014BR.GOV.BCB.PIX..."
  }'
```

Com o SDK:

```js
await wa.message.send({
  type: TypeMessage.PIX,
  body: {
    to,
    items: [{ name: 'Plano Profissional — outubro', value: 8900 }],
    total: 8900,
    code: codigoPix,
  },
});
```

**Valores em centavos.** `8900` é R$ 89,00. Este é o erro número um de quem integra na pressa, e ele aparece como cobrança de R$ 8.900,00 na conversa de um cliente real.

**O código Pix vem do seu banco ou provedor de pagamento.** A API entrega o código na conversa; ela não gera cobrança nem confirma pagamento.

## O fluxo completo

Cobrança sem confirmação vira trabalho de suporte. O ciclo inteiro:

```js
async function cobrar(pedidoId) {
  const pedido = await db.pedidos.buscar(pedidoId);

  // 1. gera no provedor de pagamento
  const cobranca = await pagamentos.criarPix({
    valor: pedido.total,
    referencia: `pedido-${pedido.id}`,
    expiraEm: '24h',
  });

  // 2. guarda a referência ANTES de enviar
  await db.cobrancas.criar({
    pedido_id: pedido.id,
    provedor_id: cobranca.id,
    status: 'aguardando',
  });

  // 3. envia na conversa
  await wa.message.send({
    type: TypeMessage.PIX,
    body: {
      to: pedido.cliente.whatsapp,
      items: pedido.itens.map((i) => ({ name: i.nome, value: i.valorCentavos })),
      total: pedido.totalCentavos,
      code: cobranca.codigoPix,
    },
  });
}

// 4. o provedor avisa quando pagar — NÃO o WhatsApp
async function aoConfirmarPagamento(evento) {
  const c = await db.cobrancas.porProvedorId(evento.id);
  await db.cobrancas.atualizar(c.id, { status: 'pago' });

  // 5. confirma na mesma conversa
  await wa.message.send({
    type: TypeMessage.TEXT,
    body: {
      to: c.pedido.cliente.whatsapp,
      text: `Pagamento confirmado! ✅ Seu pedido #${c.pedido.id} já está em separação.`,
    },
  });
}
```

**A confirmação vem do provedor de pagamento, nunca do WhatsApp.** Cliente mandando "paguei" é informação, não confirmação — e comprovante enviado como imagem também não é, porque é trivial de forjar.

## Onde funciona melhor

**Compra concluída.** O código sai na hora, enquanto a intenção está fresca.

**Lembrete de vencimento.** Um a três dias antes, em horário comercial, com o código junto — evita o "esqueci" que gera inadimplência sem má vontade.

**Recuperação de valor vencido.** Aqui o Pix na conversa costuma superar boleto por e-mail com folga, porque o atrito de pagar é menor. Mas exige cuidado com frequência: [insistência vira denúncia](https://api-wa.me/blog/lista-contatos-optin-optout-whatsapp), e denúncia derruba o número.

**Cobrança recorrente.** Assinatura mensal com o código chegando junto do aviso.

## O que dá errado

**Valor em reais em vez de centavos.** Já dito, e vale repetir: é o erro mais comum e o de pior consequência.

**Código sem prazo de expiração.** Um Pix gerado hoje e pago daqui a três meses vira conciliação manual. Defina expiração e trate a cobrança vencida.

**Reenviar o mesmo código depois de pago.** Sempre confira o status antes:

```js
if (cobranca.status === 'pago') return;   // não cobre de novo
```

Cobrar cliente que já pagou é a forma mais rápida de perdê-lo.

**Insistir sem limite.** Defina um teto de lembretes e pare. Depois disso é telefone ou e-mail, não mais mensagem.

**Mandar fora da janela sem template.** Na API oficial, [fora das 24 horas só sai template aprovado](https://api-wa.me/blog/templates-whatsapp-api-criar-aprovar-enviar) — e cobrança costuma acontecer justamente com a janela fechada. Planeje o template antes.

## Oficial ou não oficial

A mensagem de cobrança com Pix nativo é da linha não oficial, junto com [botões, listas e enquetes](https://api-wa.me/blog/api-nao-oficial-whatsapp-recursos-exemplos).

Na API oficial, o caminho é enviar o código Pix como texto dentro de um template aprovado. Funciona bem para lembrete de vencimento — o cliente copia o código do corpo da mensagem do mesmo jeito —, apenas sem o formato de cobrança nativo.

Como as duas convivem na mesma plataforma com o mesmo SDK, dá para usar a não oficial na cobrança e a oficial no atendimento, sem manter dois códigos.

## Medir

Três números dizem se está funcionando:

- **Tempo até o pagamento** — quanto menor, melhor o momento do envio
- **Taxa de pagamento por tipo** — compra concluída, lembrete, vencido
- **Bloqueios e denúncias** — se subirem, a frequência passou do ponto

O acompanhamento está em [métricas de campanha](https://api-wa.me/blog/metricas-campanha-whatsapp-api).

## Conclusão

Pix no WhatsApp é uma redução de atrito, não um recurso de marketing: o cliente recebe, copia e paga sem sair do aplicativo.

O que separa quem colhe o resultado de quem gera suporte são os detalhes chatos: centavos, expiração, confirmação vinda do provedor e limite de insistência. Nenhum deles é difícil — todos aparecem em produção quando não foram tratados.

Se você entrega isso dentro do sistema de um cliente, [notificações de pedido](https://api-wa.me/blog/notificacoes-pedido-whatsapp-api) são o complemento natural da cobrança.

### Pronto para automatizar seu WhatsApp?

Crie sua conta gratuita e comece a enviar mensagens pela API em minutos.

[Começar grátis](https://portal.api-wa.me/sign-up)

## Perguntas frequentes

Como enviar uma cobrança Pix pelo WhatsApp usando API?+

Pela mensagem de cobrança da API não oficial da WAME, que aceita os itens, os valores e o código Pix. O cliente recebe a cobrança dentro da conversa, com o código pronto para copiar, sem precisar abrir link, e-mail ou outro aplicativo além do banco.

Preciso de integração bancária para isso?+

Você precisa de uma forma de gerar o código Pix, que vem do seu banco ou do seu provedor de pagamento. A API do WhatsApp entrega esse código dentro da conversa; ela não gera cobrança nem confirma pagamento — isso continua sendo do lado financeiro.

Como sei que o cliente pagou?+

Pelo webhook do seu provedor de pagamento, não pelo do WhatsApp. O fluxo correto é: gera a cobrança, envia pelo WhatsApp, e quando o provedor confirmar o pagamento, o seu sistema envia a confirmação pela mesma conversa. Nunca confie no cliente dizendo que pagou.

Cobrança por Pix no WhatsApp funciona na API oficial?+

A mensagem de cobrança com Pix é um recurso da linha não oficial. Na API oficial você envia o código Pix como texto dentro de um template aprovado, o que funciona bem para lembrete de vencimento, ainda que sem o formato de cobrança nativo.

Qual o melhor momento para mandar a cobrança?+

Depende do tipo. Cobrança de compra concluída sai na hora, enquanto a intenção está fresca. Lembrete de vencimento funciona melhor um a três dias antes, em horário comercial. E cobrança de valor vencido pede cuidado redobrado com frequência, porque insistência vira denúncia.

## Continue lendo

[### Como criar um chatbot de IA com a API da OpenAI para responder no WhatsApp

Um webhook, uma chamada à API da OpenAI e uma resposta pela WAME API: o código completo de um chatbot de IA que atende no WhatsApp, Instagram e Messenger. Com memória por contato, controle de custo e o que fazer quando a IA não deve responder.](https://api-wa.me/blog/chatbot-ia-openai-whatsapp)[### Erros da API do WhatsApp: o que cada um significa e como tratar

A mensagem não saiu e o log diz apenas 'erro ao enviar'. Os erros que você vai encontrar de verdade — janela fechada, número inválido, template não aprovado, limite atingido, instância caída — e o tratamento certo para cada um.](https://api-wa.me/blog/erros-api-whatsapp-como-tratar)[### Disparo em massa no WhatsApp: fila, rate limit e retry (a engenharia que o for-loop não resolve)

Um laço for com 5.000 contatos falha na metade e você não sabe em quais. Como montar a fila, respeitar o rate limit da API, aplicar retry com backoff só nos erros que valem e retomar uma campanha interrompida sem enviar nada duas vezes.](https://api-wa.me/blog/fila-rate-limit-retry-disparo-whatsapp)

[Voltar ao blog](https://api-wa.me/blog)

## Structured data

```json
{
  "@context": "https://schema.org",
  "@type": "WebSite",
  "name": "WAME API",
  "alternateName": "API Oficial e Não Oficial de WhatsApp, Instagram e Messenger",
  "url": "https://api-wa.me",
  "inLanguage": "pt-BR",
  "publisher": {
    "@id": "https://api-wa.me/#organization",
    "@type": "Organization",
    "name": "WAME API",
    "url": "https://api-wa.me"
  }
}
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "@id": "https://api-wa.me/#organization",
  "name": "WAME API",
  "alternateName": [
    "WAME",
    "Wame API",
    "wame.api.br",
    "api-wa.me"
  ],
  "url": "https://api-wa.me",
  "logo": {
    "@type": "ImageObject",
    "url": "https://api-wa.me/images/web-app-manifest-512x512.png",
    "width": 512,
    "height": 512
  },
  "disambiguatingDescription": "WAME API é uma empresa brasileira de software, fundada em 2017 e parceira oficial da Meta (Meta Business Partner), que fornece APIs de WhatsApp, Instagram Direct e Messenger. Não tem relação com o wa.me, que é o encurtador de links operado pela WhatsApp LLC.",
  "identifier": {
    "@type": "PropertyValue",
    "propertyID": "INPI-BR",
    "name": "Pedido de registro de marca (INPI, classe NCL 42)",
    "value": "944724159"
  },
  "foundingDate": "2017",
  "slogan": "Parceira Oficial da Meta — WhatsApp, Instagram e Messenger numa instância só. Desde 2017.",
  "description": "Plataforma brasileira e Parceira Oficial da Meta (Meta Business Partner) para as APIs oficiais de WhatsApp (Cloud API), Instagram Direct e Messenger — os três numa única instância, com os mesmos endpoints e um único formato de webhook. Também oferece a API não oficial via QR Code, na mesma plataforma. No mercado desde 2017, com mais de 50 mil instâncias criadas, 99,9% de uptime e suporte humano 24/7 em português. SDKs oficiais para Node.js/TypeScript e PHP.",
  "knowsAbout": [
    "WhatsApp Cloud API oficial (Meta)",
    "API oficial de Instagram (Direct)",
    "API oficial de Messenger",
    "API multicanal Meta",
    "Meta Business Partner",
    "WhatsApp API",
    "API não oficial de WhatsApp",
    "automação de WhatsApp",
    "números virtuais",
    "webhooks"
  ],
  "sameAs": [
    "https://github.com/wame-api",
    "https://www.linkedin.com/company/wameapi",
    "https://www.instagram.com/wame.api/",
    "https://www.youtube.com/@wameapi"
  ],
  "contactPoint": {
    "@type": "ContactPoint",
    "contactType": "customer support",
    "url": "https://api-wa.me/contact",
    "availableLanguage": [
      "Portuguese"
    ]
  }
}
{
  "@context": "https://schema.org",
  "@type": "BlogPosting",
  "headline": "Cobrança por Pix dentro do WhatsApp pela API: como enviar e o que muda na conversão",
  "description": "Mandar o código Pix no WhatsApp resolve o pior ponto da cobrança digital: o cliente não precisa sair do app. Como enviar a cobrança pela API, tratar a confirmação e evitar os erros que transformam a facilidade em suporte.",
  "image": "https://api-wa.me/blog/cobrar-pix-whatsapp-api/opengraph-image",
  "datePublished": "2026-09-10",
  "dateModified": "2026-09-10",
  "author": {
    "@type": "Person",
    "name": "Raphael Serafim",
    "url": "https://github.com/raphaelvserafim",
    "sameAs": [
      "https://github.com/raphaelvserafim"
    ]
  },
  "publisher": {
    "@type": "Organization",
    "name": "api-wa.me",
    "logo": {
      "@type": "ImageObject",
      "url": "https://api-wa.me/images/screenshot.png"
    }
  },
  "mainEntityOfPage": {
    "@type": "WebPage",
    "@id": "https://api-wa.me/blog/cobrar-pix-whatsapp-api"
  },
  "keywords": "pix whatsapp api, cobrança pix whatsapp, enviar pix pelo whatsapp, cobrar cliente whatsapp, pix copia e cola api, cobrança automática whatsapp, recuperar boleto vencido whatsapp",
  "inLanguage": "pt-BR"
}
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Home",
      "item": "https://api-wa.me"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Blog da API do WhatsApp",
      "item": "https://api-wa.me/blog"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "Cobrança por Pix dentro do WhatsApp pela API: como enviar e o que muda na conversão",
      "item": "https://api-wa.me/blog/cobrar-pix-whatsapp-api"
    }
  ]
}
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Como enviar uma cobrança Pix pelo WhatsApp usando API?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Pela mensagem de cobrança da API não oficial da WAME, que aceita os itens, os valores e o código Pix. O cliente recebe a cobrança dentro da conversa, com o código pronto para copiar, sem precisar abrir link, e-mail ou outro aplicativo além do banco."
      }
    },
    {
      "@type": "Question",
      "name": "Preciso de integração bancária para isso?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Você precisa de uma forma de gerar o código Pix, que vem do seu banco ou do seu provedor de pagamento. A API do WhatsApp entrega esse código dentro da conversa; ela não gera cobrança nem confirma pagamento — isso continua sendo do lado financeiro."
      }
    },
    {
      "@type": "Question",
      "name": "Como sei que o cliente pagou?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Pelo webhook do seu provedor de pagamento, não pelo do WhatsApp. O fluxo correto é: gera a cobrança, envia pelo WhatsApp, e quando o provedor confirmar o pagamento, o seu sistema envia a confirmação pela mesma conversa. Nunca confie no cliente dizendo que pagou."
      }
    },
    {
      "@type": "Question",
      "name": "Cobrança por Pix no WhatsApp funciona na API oficial?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "A mensagem de cobrança com Pix é um recurso da linha não oficial. Na API oficial você envia o código Pix como texto dentro de um template aprovado, o que funciona bem para lembrete de vencimento, ainda que sem o formato de cobrança nativo."
      }
    },
    {
      "@type": "Question",
      "name": "Qual o melhor momento para mandar a cobrança?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Depende do tipo. Cobrança de compra concluída sai na hora, enquanto a intenção está fresca. Lembrete de vencimento funciona melhor um a três dias antes, em horário comercial. E cobrança de valor vencido pede cuidado redobrado com frequência, porque insistência vira denúncia."
      }
    }
  ]
}
```