Uma API que não surpreende

Primeira cobrança

Uma chamada cria uma cobrança Pix com QR pronto para exibir. Sem SDK obrigatório.

curl -X POST https://api.aurixpay.ws/v1/payments \
  -H "Authorization: Bearer $AURIX_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 12990,
    "currency": "BRL",
    "payment_method": { "type": "pix" },
    "reference": "pedido-4417"
  }'

Princípios do contrato

• Dinheiro é inteiro, em centavos
  R$ 129,90 é 12990. Nunca decimal, nunca float. Arredondamento de ponto flutuante não perde centavo em produção porque o centavo nunca vira fração.
• Estrito na entrada, aberto na saída
  Campo desconhecido na requisição devolve 422 em vez de ser ignorado — um "expires_sec" sem o "s" aceito em silêncio é uma cobrança com prazo errado. Já a resposta pode ganhar campo novo a qualquer momento, e o seu cliente deve ignorar o que não conhece.
• Um recurso para os dois métodos
  Pix e cartão são o mesmo recurso `payment`, com o mesmo formato de id e o mesmo par status/sub_status. Ligar cartão depois de integrar Pix não é uma segunda integração.
• Saída de dinheiro chama payout
  Em toda a API, no banco, no webhook e no painel. O par é payin/payout — nunca "withdrawal" nem "saque". Um nome só para cada coisa.

O que perguntam antes de integrar

• Tem ambiente de teste?
  Chaves sk_test_ existem, mas o isolamento entre teste e produção ainda é parcial — hoje ele cobre o cadastro de clientes, não a base inteira. Se o seu processo de homologação depende de sandbox completa, fale com a gente antes de começar: essa é uma das prioridades atuais e não queremos que você descubra no meio da integração.
• Como funcionam os webhooks?
  Eventos de Pix chegam com assinatura para você verificar a origem. O cadastro do endpoint é feito com o time no provisionamento, não em tela de autoatendimento — o CRUD de webhook pelo painel está em construção.
• E se a mesma requisição for enviada duas vezes?
  Use reference com um valor único por pedido: ele é a sua âncora para identificar a cobrança e reconciliar. Uma chave de idempotência dedicada no cabeçalho está no caminho.
• Dá para consultar saldo e extrato?
  Dá — e isso é raro em orquestrador. /v1/balance e /v1/extract respondem em tempo real, com a tarifa em lançamento próprio, sem embutir no líquido.