API pública

API REST para pagamentos PIX no Brasil. Crie cobranças, processe saques, configure webhooks assinados e teste tudo em sandbox antes de subir para produção.

Base https://api.treevopay.com

Autenticação

Toda requisição precisa do header Authorization com a sua API key emitida no painel de desenvolvedores.

# exemplo: criar cobrança PIX
curl -X POST https://api.treevopay.com/v1/pix/charge \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 1990,
    "description": "Pedido #1234",
    "external_id": "ord_1234",
    "expires_in": 3600
  }'

Endpoints principais

POST
/v1/pix/charge
Cria uma nova cobrança PIX (QR Code + copia-e-cola).
GET
/v1/transactions/{id}
Consulta o status de uma transação.
POST
/v1/pix/payout
Realiza um saque PIX para uma chave de destino.
POST
/v1/refunds
Solicita reembolso total ou parcial de uma transação.
GET
/v1/balance
Retorna saldo disponível e a liberar da conta.

Recursos

Sandbox

Use a mesma base URL com uma API key de teste (prefixo sk_test_). Pagamentos podem ser simulados via:

# simular pagamento de uma cobrança de teste
curl -X POST https://treevopay.com/sandbox/simulate-payment/TXN_ID \
  -H "Authorization: Bearer sk_test_..."