← Blog

·

Forma de pagamento da API do WhatsApp: cartão, linha de crédito e quem paga a Meta

Atualizado em 29/10/2026

A Meta cobra a API do WhatsApp de duas formas: ou a própria empresa cadastra uma forma de pagamento (como cartão de crédito) na conta de mensagens, pelo Meta Business Suite, ou um provedor coloca a linha de crédito dele na conta e repassa o custo ao cliente. Sem forma de pagamento válida, as mensagens cobradas deixam de sair. Abaixo está como cada modelo funciona, onde a cobrança fica depois da mudança de setembro de 2026 e como evitar envio travado por problema de pagamento.

Para os valores por mensagem, veja quanto custa a API do WhatsApp no Brasil; para entender o que vem da Meta e o que vem do provedor numa fatura, veja taxa do provedor x taxa da Meta.

Onde a forma de pagamento fica: na conta de mensagens

Desde 23 de setembro de 2026, a Meta separou a antiga WABA em duas partes, segundo a documentação da evolução do modelo de contas:

  • Conta do WhatsApp: guarda os números de telefone, o perfil da empresa, nomes de usuário e catálogos.
  • Conta de mensagens: guarda os templates, as assinaturas de webhook e a cobrança e as formas de pagamento.

A forma de pagamento não fica “no número”, e sim na conta de mensagens. Cada conta de mensagens tem a sua forma de pagamento, independente das outras contas de mensagens e das contas de anúncio. Ou seja: o cartão que paga seus anúncios no Meta Ads não paga automaticamente o WhatsApp.

Cada parceiro que trabalha com uma empresa ganha a própria conta de mensagens, com templates, cobrança e métricas separados. A página de preços confirma que a cobrança vai para a conta de mensagens que enviou cada mensagem, e que cada uma mantém sua própria relação de cobrança, forma de pagamento e limites de gasto. Os detalhes da nova estrutura estão em conta do WhatsApp x conta de mensagens.

Modelo 1: cartão cadastrado pela empresa

É o caminho de quem integra direto com a Meta ou de quem usa um provedor que não tem linha de crédito. A empresa adiciona um cartão de crédito à conta e a Meta cobra o uso da API diretamente.

A documentação de parceiros descreve esse modelo assim: os Provedores de Tecnologia não têm linha de crédito, então os clientes que eles conectam precisam informar a própria forma de pagamento depois do cadastro; a Meta cobra o uso da API e o provedor cobra pelos outros serviços dele (visão geral de parceiros). A página de suporte para clientes de parceiros reforça: nesse caso, é preciso adicionar uma forma de pagamento à conta de mensagens antes de usar o app do parceiro.

Passo a passo geral:

  1. No Meta Business Suite, abra a Central de Cobrança (Billing Hub) e adicione o cartão.
  2. Vincule a forma de pagamento à conta de mensagens que envia as mensagens, não só ao portfólio.
  3. Confirme a moeda da conta de mensagens (veja abaixo) antes do primeiro envio.

Como os menus mudam com frequência, siga o artigo de ajuda “Como adicionar um cartão de crédito à sua conta da Plataforma do WhatsApp Business” se a interface estiver diferente.

Quem paga aqui: a empresa, direto para a Meta. O provedor (se houver) cobra só a parte dele.

Quer testar enquanto lê? Crie sua conta na Vectalk e envie a primeira mensagem pela API oficial. Criar conta grátis →

Modelo 2: linha de crédito do provedor

Alguns parceiros da Meta têm uma linha de crédito com a Meta e podem estendê-la às empresas que conectam. Segundo a visão geral de parceiros, nesse modelo o cliente pula a etapa de cadastrar forma de pagamento, e o parceiro pode faturar o cliente diretamente pelo uso da plataforma.

A página compartilhar e revogar linhas de crédito detalha a mecânica:

  • a empresa paga o parceiro, e o parceiro recebe uma fatura agregada da Meta;
  • o parceiro é a parte faturada (“Bill To Party”) de todas as empresas que usam a linha de crédito dele e responde à Meta por todo o gasto delas;
  • a linha de crédito é anexada à conta de mensagens do cliente e não pode ser trocada depois de anexada;
  • se o cliente deixa de compartilhar a conta com o parceiro, todo o envio dessa conta de mensagens é bloqueado para proteger a linha de crédito, e a Meta recomenda que o parceiro revogue a linha.

Quem paga aqui: o provedor paga a Meta; a empresa paga o provedor, nas condições que o provedor definir (pós-pago, pré-pago, pacote, etc.).

Cartão ou linha de crédito: comparação

PontoCartão da empresa na MetaLinha de crédito do provedor
Quem a Meta faturaA empresaO provedor
Cadastro de cartão na MetaObrigatórioNão precisa
Onde a cobrança ficaConta de mensagens da empresaConta de mensagens, com a linha do provedor anexada
Fatura do uso da APIDa Meta para a empresaDa Meta para o provedor; do provedor para a empresa
Controle de gastoLimites de gasto da conta de mensagensRegras do provedor (saldo, limite, plano)
Ao trocar de provedorO cartão continua com a empresaA linha sai junto com o provedor antigo

O cartão dá relação direta com a Meta; a linha de crédito simplifica o cadastro e junta tudo numa fatura só. A escolha costuma vir junto com a decisão de contratar direto da Meta ou por um provedor, e os tipos de parceiro estão explicados em o que é BSP e Tech Provider.

Moeda e fatura

Três regras da página de preços afetam a forma de pagamento:

  • A moeda é escolhida na criação da conta de mensagens e não pode ser alterada depois. A Meta oferece APIs de migração de moeda para quem precisa mudar. A plataforma tem 16 moedas habilitadas.
  • Faturamento em reais (BRL): clientes elegíveis podem criar contas de mensagens em BRL desde julho de 2026. As cobranças dessas contas são faturadas em reais pela entidade local da Meta no Brasil, o Facebook Brasil.
  • Prazo do BRL: clientes elegíveis precisam migrar todas as contas de mensagens do portfólio para BRL até 30 de junho de 2027; a partir de 1º de julho de 2027, a Meta deixa de entregar mensagens de contas de mensagens que não estejam em BRL.

Sobre a fatura em si: a Meta cobra só mensagens entregues, e só as cobradas contam para as faixas de volume (detalhes em descontos por volume). Quando há mais de um parceiro enviando pelo mesmo número, cada provedor só vê na fatura as mensagens da própria conta de mensagens. Tributos sobre a fatura não são tratados na documentação de preços: consulte seu contador.

O que acontece se o pagamento falhar

O que a documentação oficial confirma:

  • Erro 131042: a tabela de códigos de erro define esse código como “erro relacionado à sua forma de pagamento”. Entre as causas listadas: conta de pagamento não anexada, linha de crédito acima do limite, linha de crédito não definida ou inativa, conta suspensa ou excluída, fuso horário ou moeda não configurados.
  • Templates não saem: a página de suporte para clientes de parceiros diz que, quando o envio de templates falha, a causa provável é não haver forma de pagamento válida na conta.
  • Serviço acima da franquia não sai: desde 1º/10/2026 cada número tem 1.000 mensagens de serviço entregues grátis por mês. Sem forma de pagamento na conta de mensagens, a Meta entrega as mensagens de serviço dentro da franquia, mas não entrega as que passam dela (página de preços).
  • Conta descompartilhada: no modelo de linha de crédito, se a conta deixa de ser compartilhada com o parceiro, todo o envio daquela conta de mensagens é bloqueado.

Falha de pagamento trava justamente o que gera receita: avisos de pedido, lembretes de fatura e códigos de verificação.

Como detectar no código

Trate o 131042 separado: ele não se resolve com nova tentativa. Um exemplo em Python que lê o erro tanto da resposta síncrona da API quanto do webhook de status failed:

ERROS_PAGAMENTO = {131042}

def checar_erro_pagamento(evento):
    """evento: corpo da resposta de erro da API ou um item de 'statuses' do webhook."""
    codigos = []
    if "error" in evento:  # resposta síncrona da API
        codigos.append(evento["error"].get("code"))
    for e in evento.get("errors", []):  # status 'failed' no webhook
        codigos.append(e.get("code"))
    if any(c in ERROS_PAGAMENTO for c in codigos):
        alertar_financeiro("Envio bloqueado por forma de pagamento (131042)")
        return True
    return False

alertar_financeiro é a sua função de alerta. Pausar a fila ao detectar o erro evita gastar o lote inteiro em falhas. A lista completa de códigos está em erros da API do WhatsApp.

Checklist quando aparece o erro

  1. Confira se a conta de mensagens que envia tem forma de pagamento vinculada (não só o portfólio).
  2. Veja no Billing Hub se o cartão foi recusado. A página de suporte da Meta sugere falar com o banco emissor, esperar alguns dias ou trocar de cartão.
  3. Se o pagamento é por linha de crédito, fale com o provedor: o limite pode ter estourado ou a linha pode não estar ativa.
  4. Se nada resolver, abra um chamado no Suporte Direto da Meta com o tópico de cobrança e o ID da transação copiado do Billing Hub.

Trocar de provedor muda a forma de pagamento

Trocar de provedor é compartilhar a conta do WhatsApp com o novo parceiro, que passa a ter a própria conta de mensagens e, com ela, a própria cobrança. A linha de crédito do provedor antigo não vem junto, e a página de suporte da Meta cita que ainda compartilhar a linha de um parceiro anterior pode travar o cadastro com o novo. Planeje a troca com o passo a passo de como trocar de provedor sem perder o número.

Como funciona o pagamento na Vectalk

A Vectalk usa o modelo de linha de crédito, sem cartão na Meta:

  • a Vectalk coloca a linha de crédito dela no número do cliente;
  • o cliente paga a mensalidade do plano e carrega saldo pré-pago na plataforma;
  • cada mensagem entregue desconta do saldo; mensagem que falha não é debitada;
  • o cliente não cadastra cartão na Meta e recebe uma cobrança só, da Vectalk, que paga a Meta.

O painel tem uma área de planos e faturas. Como o saldo é pré-pago, você decide quanto carregar e acompanha o consumo por mensagem entregue. Para começar, crie a conta em apps.vectalk.com.br/register; a documentação técnica está em docs.vectalk.com.br e o guia da API oficial do WhatsApp explica os requisitos. Dúvidas sobre cobrança: Central de Ajuda.

Perguntas frequentes

Preciso de cartão de crédito para usar a API do WhatsApp?

Só se a sua conta de mensagens não tiver a linha de crédito de um provedor. Integração direta, ou por provedor sem linha de crédito, exige forma de pagamento própria.

O cartão do Meta Ads serve para o WhatsApp?

Não automaticamente. A Meta informa que a forma de pagamento de cada conta de mensagens é independente das contas de anúncio. É preciso vincular o pagamento à conta de mensagens.

Mensagem que falhou é cobrada?

Não. A Meta cobra só mensagens entregues. Na Vectalk, o saldo também só é debitado por mensagem entregue.

O que significa o erro 131042?

É um problema com a forma de pagamento: conta de pagamento não anexada, linha de crédito acima do limite ou inativa, conta suspensa, ou moeda e fuso não configurados. Resolva a cobrança antes de reenviar.


Fontes oficiais consultadas em 29/10/2026: Evolução do modelo de contas do WhatsApp, Preços na plataforma do WhatsApp Business, Visão geral de parceiros, Compartilhar e revogar linhas de crédito, Suporte para clientes de parceiros, Códigos de erro, Como adicionar um cartão de crédito à conta da Plataforma do WhatsApp Business.

Coloque o WhatsApp oficial da sua empresa para funcionar

Crie sua conta, conecte seu número à API oficial (dá para manter o app com coexistência) e comece a atender e enviar mensagens.