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

# Cobrança Pix

> Integra a cobrança Pix no seu sistema: código, QR Code e webhook.

> [!NOTE]
>
> Funciona sem chave: a IA lê a documentação e escreve o código no seu projeto.

## Endpoints usados

| Método | Rota | Permissão | Para quê |
| - | - | - | - |
| `POST` | `/v1/payments` | `/payments/create` | cria a cobrança e devolve o Pix Copia e Cola |
| `GET` | `/v1/payments/:id` | `/payments/get` | consulta a situação, só na tela de aguardando |
| Webhook | `payment.paid` · `payment.expired` | - | avisa quando foi paga ou venceu |

## Prompt

```text theme={null}
Quero receber por Pix com a WyzeCash no meu sistema, em Node.js. Use as ferramentas do MCP da WyzeCash:
1. `ver_operacao` com `criar_cobranca` para ver os campos de POST /v1/payments.
2. `exemplo_codigo` com `criar_cobranca` na minha linguagem e adapte ao meu projeto: POST /v1/payments com `method: "pix"`, o valor em centavos, a chave de API na variável de ambiente BUKIOPAY_API_KEY e a Idempotency-Key com o código do pedido.
3. Mostre ao cliente o Pix Copia e Cola (`copyPaste`), o QR Code gerado a partir dele e o prazo (`expiresAt`, 30 minutos).
4. `buscar_documentacao` com `webhooks` e crie a rota que recebe `payment.paid` e `payment.expired`, confere a assinatura X-Bukio-Signature com o corpo cru e atualiza o pedido, ignorando eventos repetidos pelo `id`.
5. Na tela de "aguardando pagamento", GET /v1/payments/:id no máximo a cada 2 segundos e só com a tela aberta; quem confirma o pedido é o webhook.
```

Troque `Node.js` pela linguagem do seu projeto.

## Como chamar

| IA | Como |
| - | - |
| Claude Code | `/mcp__bukiopay__criar-cobranca-pix` |
| VS Code | `/mcp.bukiopay.criar-cobranca-pix` |
| Cursor, Codex e Claude Desktop | Copie o prompt acima e cole no chat |

## Parâmetros

| Parâmetro | O que é |
| - | - |
| `linguagem` | A linguagem ou o framework do projeto (ex.: Node.js, PHP, Python). |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.