# Solicitar pagamento

`POST /send/request-payment`

Pasta: **Enviar Mensagem**

## Autenticação

```http
token: {{token}}
```

## Descrição

# Solicitar pagamento

Envia um pedido de pagamento (compatível UAZAPI) com PIX, boleto e/ou link. Use para cobrar um valor em BRL com instruções claras.

## Endpoint

```http
POST {{baseUrl}}/send/request-payment
```

## Autenticação

Envie o token da instância no header:

```http
token: {{token}}
```

## Corpo da requisição

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| number | string | Sim* | Destinatário |
| chatid | string | Sim* | Alternativa a number |
| amount | number | Sim | Valor em reais (ex.: 149.90) |
| title | string | Não | Título do pedido |
| text | string | Não | Texto/descrição |
| footer | string | Não | Rodapé |
| itemName | string | Não | Nome do item cobrado |
| invoiceNumber | string | Não | Número da fatura |
| pixKey | string | Condicional | Chave PIX |
| pixType | string | Não | PHONE, EMAIL, CPF, CNPJ, EVP/RANDOM |
| pixName | string | Não | Nome do recebedor PIX |
| paymentLink | string | Condicional | Link de pagamento |
| boletoCode | string | Condicional | Linha digitável do boleto |
| additionalNote | string | Não | Nota adicional |

## Exemplo de Requisição

```bash
curl -X POST "{{baseUrl}}/send/request-payment" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{"number": "{{remoteJid}}", "amount": 149.9, "title": "Plano Pro", "text": "Confirme o pagamento para ativar a assinatura.", "itemName": "Assinatura Pro", "invoiceNumber": "INV-2026-001", "pixKey": "financeiro@empresa.com", "pixType": "EMAIL", "pixName": "Empresa LTDA", "additionalNote": "Liberação automática após confirmação"}'
```

## Resposta de Sucesso

```json
{
  "success": true,
  "message": {
    "id": "3EB0A1B2C3D4E5F6",
    "timestamp": "2026-07-17T12:34:56Z",
    "sender": "5511888888888@s.whatsapp.net"
  }
}
```

## Erros comuns

- `amount must be greater than zero`
- `missing pixKey, boletoCode or paymentLink`
- Destinatário ausente

## Observações

- É obrigatório informar pelo menos um meio: `pixKey`, `boletoCode` ou `paymentLink`.

## Corpo (exemplo)

```json
{
  "number": "{{remoteJid}}",
  "amount": 149.9,
  "title": "Plano Pro",
  "text": "Confirme o pagamento para ativar a assinatura.",
  "itemName": "Assinatura Pro",
  "invoiceNumber": "INV-2026-001",
  "pixKey": "financeiro@empresa.com",
  "pixType": "EMAIL",
  "pixName": "Empresa LTDA",
  "additionalNote": "Liberação automática após confirmação"
}
```

## cURL

```bash
curl -X POST "{{baseUrl}}/send/request-payment" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "number": "{{remoteJid}}",
  "amount": 149.9,
  "title": "Plano Pro",
  "text": "Confirme o pagamento para ativar a assinatura.",
  "itemName": "Assinatura Pro",
  "invoiceNumber": "INV-2026-001",
  "pixKey": "financeiro@empresa.com",
  "pixType": "EMAIL",
  "pixName": "Empresa LTDA",
  "additionalNote": "Liberação automática após confirmação"
}'
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=enviar-mensagem/solicitar-pagamento)