Primeiros passos

Ambientes

A API é versionada por caminho (/v1) e hoje opera em ambiente de produção (LIVE).

Base URL

Todas as requisições partem da base de produção e usam o prefixo de versão /v1. Mudanças incompatíveis virão sob uma nova versão de caminho.

Ambiente LIVE

As chaves sk_live_… operam contra o ambiente real: cobranças geram PIX reais e movimentam saldo. Use valores baixos durante a integração.

Sandbox em breve

Um ambiente de testes isolado (chaves sk_test_…) está no roadmap. Por enquanto, integre em LIVE com valores reduzidos e cobranças de baixo valor.

Versionamento

Adicionar campos opcionais a respostas e novos endpoints é considerado retrocompatível. Sempre ignore campos desconhecidos no seu parser para não quebrar com novas adições.

Collection do Postman

Baixe a collection com todos os endpoints e variáveis prontas na página Postman.

Endpoints

# Base URL (produção)
https://apiv2.onnixpay.com

# Todos os endpoints são versionados sob /v1
POST https://apiv2.onnixpay.com/v1/charges
GET  https://apiv2.onnixpay.com/v1/charges/:id

AnteriorAutenticação Próximo Idempotência