> ## 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.

# Exemplos

> O que pedir para a IA e o que ela faz por trás, ferramenta por ferramenta.

## Integrar o Pix do zero

Sem chave. A IA lê a rota e escreve o código no seu projeto.

**1. Você pede**

"Use o MCP da WyzeCash e integre a cobrança Pix no meu checkout em Node.js."

**2. A IA consulta a rota**

```json ver_operacao theme={null}
{ "operacao": "criar_cobranca" }
```

**3. A IA pega o código pronto**

```json exemplo_codigo theme={null}
{ "operacao": "criar_cobranca", "linguagem": "node" }
```

**4. A IA busca os webhooks**

```json buscar_documentacao theme={null}
{ "busca": "webhooks" }
```

E cria a rota que recebe o `payment.paid` conferindo a assinatura.

## Testar a chave

**1. Você pede**

"Teste a minha chave da WyzeCash."

**2. A IA chama testar\_chave**

```text Resposta theme={null}
Chave válida.
- Conta: Maria Souza
- Chave: IA do Cursor (bk_live_7KQ2...)
- Permissões: payments:create, payments:get, payments:list, account:balance
- Ferramentas da conta liberadas: criar_cobranca, formas_de_pagamento, listar_cobrancas, consultar_cobranca, saldo
- Saque, Pix enviado e estorno não saem pelo MCP, mesmo com a permissão na chave.
```

## Criar uma cobrança de teste

Com a chave e a permissão `/payments/create`.

**1. Você pede**

"Crie uma cobrança Pix de R\$ 5,00 com a descrição Teste."

**2. A IA chama criar\_cobranca**

```json criar_cobranca theme={null}
{ "amount": 500, "description": "Teste", "method": "pix", "idempotencyKey": "teste-001" }
```

**3. A resposta**

```json Resposta theme={null}
{
  "id": "BKY-8K2M4QZ7XN3P",
  "status": "pending",
  "method": "pix",
  "amount": 500,
  "total": 500,
  "fee": 50,
  "netAmount": 450,
  "copyPaste": "00020126...",
  "expiresAt": "2026-10-15T12:30:00.000Z"
}
```

A cobrança é real: vale 30 minutos e, paga, entra no seu saldo.

## Criar um link de pagamento

Com a permissão `/payment-links/create`.

```text Você pede theme={null}
Crie um link de pagamento de R$ 49,90 chamado "Plano mensal" e me mande o endereço.
```

```json criar_link theme={null}
{ "title": "Plano mensal", "amount": 4990 }
```

## Resumo do dia

Com as permissões `/account/balance` e `/account/statement`.

```text Você pede theme={null}
Mostre o meu saldo na WyzeCash e o que entrou hoje.
```

A IA chama `saldo` e `extrato` com `{ "days": 0 }` e soma as entradas do dia.

> [!TIP]
>
> Para saber quando uma cobrança foi paga no seu sistema, use o webhook `payment.paid`, não a IA consultando de tempos em tempos.


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