Bunne

API Documentation

Playground

Test whitelabel acquirers and the real API.

Paste a seller API key and run the full flow against the public API. The key stays only in this browser's memory.

Security

The API key is never stored by the playground. Requests go directly to /api/v1 with Bearer auth — prefer test keys when possible and avoid exposing live keys on shared machines.

Credenciais do teste

A API key é usada apenas neste navegador para chamar a API real. Ela nunca é salva nem enviada para outro lugar além do endpoint da Bunne.

/api/v1

Forma de pagamento

Escolha o rail a testar. Cartão executa tokenização, captura e estorno. Pix e boleto criam a charge e consultam o status (QR code ou linha digitável na resposta).

Cartão

Preencha os dados do cartão neste navegador. Eles são enviados apenas para tokenizar e nunca são salvos pelo playground. O PAN completo e o CVV aparecem mascarados nos logs abaixo.

Comprador

Obrigatório para toda charge (cartão, Pix e boleto) desde CORE-011/ CORE-012 — nome, e-mail, telefone, documento e endereço de cobrança. Em TEST usamos os dados de sandbox por padrão.

Parâmetros

Fluxo: token → charge → consulta → captura (manual) → estorno.

1. Tokenizar cartão

POST /payment-methods/tokenize — troca os dados do cartão por um tok_ reutilizável.

Aguardando

POST /api/v1/payment-methods/tokenize

2. Criar charge

POST /charges — usa o tok_ para autorizar (manual) ou pagar (automatic).

Aguardando

POST /api/v1/charges

3. Consultar charge

GET /charges/{id} — confirma o status canonical da charge.

Aguardando

GET /api/v1/charges/{id}

4. Capturar charge

POST /charges/{id}/capture — captura uma charge de cartão autorizada (somente manual).

Aguardando

POST /api/v1/charges/{id}/capture

5. Estornar charge

POST /charges/{id}/refund — estorna o valor capturado para não deixar dinheiro de teste na adquirente.

Aguardando

POST /api/v1/charges/{id}/refund