> ## 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 no cartão

> Integra a venda no cartão de crédito: a página segura de pagamento e o 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ê |
| - | - | - | - |
| `GET` | `/v1/payments/methods` | `/payments/create-card` | confere se o cartão está liberado e o valor mínimo |
| `POST` | `/v1/payments` | `/payments/create-card` | cria a cobrança no cartão e devolve o `paymentUrl` |
| `GET` | `/v1/payments/:id` | `/payments/get` | consulta a situação |
| Webhook | `payment.paid` | - | avisa quando a cobrança foi paga |

## Prompt

```text theme={null}
Quero vender no cartão de crédito com a WyzeCash, em Node.js. Use as ferramentas do MCP da WyzeCash:
1. `ver_operacao` com `formas_de_pagamento` e `criar_cobranca`: GET /v1/payments/methods diz se o cartão está liberado e o valor mínimo.
2. `exemplo_codigo` com `criar_cobranca`: POST /v1/payments com `method: "card"`, o valor em centavos (à vista), a chave em BUKIOPAY_API_KEY e a Idempotency-Key com o código do pedido.
3. Mande o cliente para o `paymentUrl` da resposta: a página segura de pagamento vale 30 minutos e o número do cartão nunca passa pelo meu sistema.
4. Crie a rota do webhook `payment.paid` conferindo a assinatura X-Bukio-Signature e libere o pedido. A venda no cartão fica "A liberar" e entra no saldo disponível depois do prazo da conta.
5. Se o sistema mostrar a situação ao cliente, 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__cobranca-cartao` |
| VS Code | `/mcp.bukiopay.cobranca-cartao` |
| 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.