> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oxenty.api.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Enviar PIX

> Envia mensagem interativa de pagamento PIX

Envia uma mensagem interativa de pagamento PIX com QR code. O destinatário pode escanear ou copiar o código PIX para realizar o pagamento.

## Request Body

<ParamField body="sessionId" type="string" required>
  ID da sessão WhatsApp.
</ParamField>

<ParamField body="to" type="string" required>
  Número do destinatário ou JID de grupo.
</ParamField>

<ParamField body="pixKey" type="string" required>
  Chave PIX (CPF, CNPJ, email, telefone ou chave aleatória).
</ParamField>

<ParamField body="pixKeyType" type="string" required>
  Tipo da chave PIX.

  **Valores:** `cpf`, `cnpj`, `email`, `phone`, `random`
</ParamField>

<ParamField body="merchantName" type="string" required>
  Nome do recebedor (comerciante).
</ParamField>

<ParamField body="amount" type="number">
  Valor do pagamento em reais (opcional).
</ParamField>

<ParamField body="referenceId" type="string">
  ID de referência da transação (opcional).
</ParamField>

<ParamField body="itemName" type="string">
  Nome do item/serviço sendo pago (opcional).
</ParamField>

<ParamField body="buttonText" default="Pagar" type="string">
  Texto do botão de pagamento.
</ParamField>

## Resposta

<ResponseField name="messageId" type="string">
  ID único da mensagem enviada.
</ResponseField>

<RequestExample>
  ```bash cURL theme={"system"}
  curl -X POST "https://api.oxenty.api.br/api/messages/pix" \
    -H "X-API-Key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "sessionId": "550e8400-e29b-41d4-a716-446655440000",
      "to": "5511999999999",
      "pixKey": "12345678901",
      "pixKeyType": "cpf",
      "merchantName": "Loja Exemplo",
      "amount": 99.90,
      "itemName": "Pedido #12345",
      "buttonText": "Pagar R$ 99,90"
    }'
  ```

  ```typescript TypeScript theme={"system"}
  const result = await client.messages.sendPix({
    sessionId: '550e8400-e29b-41d4-a716-446655440000',
    to: '5511999999999',
    pixKey: '12345678901',
    pixKeyType: 'cpf',
    merchantName: 'Loja Exemplo',
    amount: 99.90,
    itemName: 'Pedido #12345',
    buttonText: 'Pagar R$ 99,90',
  });
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={"system"}
  {
    "messageId": "3EB0A1B2C3D4E5F6",
    "status": "sent"
  }
  ```
</ResponseExample>

<Tip>
  O PIX é um método de pagamento instantâneo brasileiro. A mensagem gerada inclui um QR code que o destinatário pode escanear com seu app de banco.
</Tip>