Integre pagamentos
sem perder o controle.

Introdução

Comece no ambiente sandbox e avance para produção somente após validar seu fluxo completo.

Autenticação

Envie sua API Key e assine requisições com o secret exibido uma única vez.

Ambientes

Sandbox não movimenta dinheiro. Produção permanecerá indisponível nesta fase.

Criar cliente

Cadastre o pagador antes de iniciar uma cobrança.

Criar cobrança PIX

Crie uma cobrança com valor em centavos, cliente e external_id único.

curl -X POST https://api.SEU_DOMINIO/v1/pix/charges \
  -H "Idempotency-Key: order_123" \
  -H "Content-Type: application/json" \
  -d '{"amount":25000,"customer":"cus_..."}'

Consultar PIX

Consulte pelo identificador público e acompanhe os estados da cobrança.

Saques

Saques estão disponíveis apenas como simulação nesta fase.

Webhooks

Eventos são assinados e cada tentativa de entrega fica registrada.

Erros

Todos os erros seguem um envelope consistente e incluem request_id.

{
  "error": {
    "code": "INSUFFICIENT_BALANCE",
    "message": "Saldo insuficiente.",
    "request_id": "req_..."
  }
}

Idempotência

Envie Idempotency-Key. Repetições equivalentes retornam a operação existente.