Enviar Mensajes

Solicitar Pago

Envía una solicitud de pago con el botón nativo "Revisar y pagar" de WhatsApp. Es obligatorio enviar al menos un método de pago: `pixKey`, `boletoCode`, `paymentLink` o `allowCards: true`. Sin eso, la API devuelve error.

POSThttps://api.zapzapapi.com/api/v1/{instanceId}/send/request-payment

Autenticación con los encabezados x-api-key y x-api-secret.

Parámetros

Nombre	Tipo	Dónde	Obligatorio	Descripción
`number`	text	cuerpo	Sí	Número (con código de país)
`amount`	number	cuerpo	Sí	Monto (BRL)
`pixKey`	text	cuerpo	No	Clave PIX (CPF/CNPJ/teléfono/email/EVP)
`pixType`	select	cuerpo	No	Tipo de clave PIX
`itemName`	text	cuerpo	No	Nombre del ítem
`invoiceNumber`	text	cuerpo	No	Número de factura
`title`	text	cuerpo	No	Título del flujo
`footer`	text	cuerpo	No	Pie
`pixName`	text	cuerpo	No	Nombre del receptor (por defecto: nombre del perfil)
`text`	textarea	cuerpo	No	Texto del mensaje
`paymentLink`	text	cuerpo	No	Enlace de pago externo
`fileUrl`	text	cuerpo	No	URL del archivo adjunto
`fileName`	text	cuerpo	No	Nombre del archivo adjunto
`boletoCode`	text	cuerpo	No	Código del boleto
`allowCards`	select	cuerpo	No	Permitir tarjeta
`currency`	text	cuerpo	No	Moneda
`note`	text	cuerpo	No	Nota / Observación
`digitando`	select	cuerpo	No	Muestra un indicador automático de "escribiendo..." proporcional al tamaño del mensaje antes de enviarlo. Activado por defecto (humaniza y reduce el riesgo de bloqueo). Envía false para desactivarlo y responder más rápido. La respuesta sigue siendo síncrona.

Ejemplo de solicitud

curl

curl -X POST "https://api.zapzapapi.com/api/v1/{instanceId}/send/request-payment" \
  -H "x-api-key: TU_API_KEY" \
  -H "x-api-secret: TU_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"number":"5511999999999","amount":49.9}'

Node.js

const res = await fetch("https://api.zapzapapi.com/api/v1/{instanceId}/send/request-payment", {
  method: "POST",
  headers: {
    "x-api-key": "TU_API_KEY",
    "x-api-secret": "TU_API_SECRET",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "number": "5511999999999",
    "amount": 49.9
  }),
});
console.log(await res.json());

Python

import requests

res = requests.post(
    "https://api.zapzapapi.com/api/v1/{instanceId}/send/request-payment",
    headers={"x-api-key": "TU_API_KEY", "x-api-secret": "TU_API_SECRET"},
    json={"number":"5511999999999","amount":49.9},
)
print(res.json())

Ejemplo de respuesta

JSON

{
  "messageId": "ABCDEF123456",
  "status": "sent"
}

Los valores son ilustrativos; los campos siguen el formato real de la respuesta.

Otros endpoints de esta categoría

Ver la referencia completa

Consigue tus claves de API

Crea tu cuenta, conecta un número en minutos y empieza a usar la API. R$15 por número activo/mes, con un crédito de bienvenida al crear la cuenta, sujeto a la campaña vigente.

Crear cuenta gratis Ver la documentación