Enviar Mensagem

Solicitar pagamento

POSThttps://api.nodinfra.com.br/send/request-payment

URL completa: https://api.nodinfra.com.br/send/request-payment

Envia uma solicitação de pagamento com o botão nativo "Revisar e pagar" do WhatsApp. O fluxo suporta PIX (estático, dinâmico ou desabilitado), boleto, link de pagamento e cartão, combinando tudo em uma única mensagem interativa.

Como funciona

Define o valor em amount (BRL por padrão) e opcionalmente personaliza título, texto e nota adicional.
Por padrão exige pixKey.
O arquivo apontado por fileUrl é anexado como documento (boleto ou fatura em PDF, por exemplo).
paymentLink habilita o botão externo.

Campos comuns

Este endpoint também suporta os campos padrão: delay, readchat, readmessages, replyid, mentions, track_source, track_id e async.

Corpo da requisição

numberstringobrigatório

ID do chat para o qual a mensagem será enviada. Pode ser um número de telefone em formato internacional, um ID de grupo (`@g.us`), um ID de usuário (com `@s.whatsapp.net` ou `@lid`).

exemplo: 5511999999999

titlestringopcional

Título que aparece no cabeçalho do fluxo

exemplo: Detalhes do pedido

textstringopcional

Mensagem exibida no corpo do fluxo

exemplo: Pedido #123 pronto para pagamento

footerstringopcional

Texto do rodapé da mensagem

exemplo: Loja Exemplo

itemNamestringopcional

Nome do item principal listado no fluxo

exemplo: Assinatura Plano Ouro

invoiceNumberstringopcional

Identificador ou número da fatura

exemplo: PED-123

amountnumberobrigatório

Valor da cobrança (em BRL por padrão)

exemplo: 199.9

pixKeystringopcional

Chave PIX estático (CPF/CNPJ/telefone/email/EVP)

exemplo: 123e4567-e89b-12d3-a456-426614174000

pixTypestringopcional

Tipo da chave PIX (`CPF`, `CNPJ`, `PHONE`, `EMAIL`, `EVP`). Padrão `EVP`

exemplo: EVP

pixNamestringopcional

Nome do recebedor exibido no fluxo (padrão usa o nome do perfil da instância)

exemplo: Loja Exemplo

paymentLinkstringopcional

URL externa para checkout (somente dominios homologados; veja lista acima)

exemplo: https://pagamentos.exemplo.com/checkout/abc

fileUrlstringopcional

URL ou caminho (base64) do documento a ser anexado (ex.: boleto PDF)

exemplo: https://cdn.exemplo.com/boleto-123.pdf

fileNamestringopcional

Nome do arquivo exibido no WhatsApp ao anexar `fileUrl`

exemplo: boleto-123.pdf

boletoCodestringopcional

Linha digitável do boleto (habilita o método boleto automaticamente)

exemplo: 34191.79001 01043.510047 91020.150008 5 91070026000

replyidstringopcional

ID da mensagem que será respondida

mentionsstringopcional

Números mencionados separados por vírgula

delayintegeropcional

Atraso em milissegundos antes do envio (exibe "digitando..." no WhatsApp)

readchatbooleanopcional

Marca o chat como lido após enviar a mensagem

readmessagesbooleanopcional

Marca mensagens recentes como lidas após o envio

asyncbooleanopcional

Enfileira o envio para processamento assíncrono

track_sourcestringopcional

Origem de rastreamento (ex.: chatwoot, crm-interno)

track_idstringopcional

Identificador de rastreamento (aceita valores duplicados)

Exemplo

PIX simples

{
  "number": "5511999999999",
  "amount": 199.9,
  "text": "Pedido #123 pronto para pagamento",
  "pixKey": "123e4567-e89b-12d3-a456-426614174000",
  "pixType": "EVP"
}

Respostas

200Solicitação de pagamento enviada com sucesso

400Requisição inválida

401Não autorizado

500Erro interno do servidor

curl -X POST 'https://api.nodinfra.com.br/send/request-payment' \ -H 'token: SEU_TOKEN' \ -H 'Content-Type: application/json' \ -d '{ "number": "5511999999999", "amount": 199.9, "text": "Pedido #123 pronto para pagamento", "pixKey": "123e4567-e89b-12d3-a456-426614174000", "pixType": "EVP" }'