Docs/Sandbox

Ambiente sandbox

Teste integrações sem movimentar saldo de produção nem acionar PSPs, blockchain ou Binance. Use o mesmo X-Api-Key com a chave secreta sandbox gerada no painel.

Hosts

API AureEX: https://api-sandbox.aure-ex.com
Dashboard AureEX: https://app-sandbox.aure-ex.com

O ambiente é determinado pelo domínio.

Autenticação

X-Api-Key: mesmo ID da empresa (produção e sandbox).
X-Api-Secret: use a chave secreta sandbox exibida em Integrações > API Keys no painel sandbox. Não use a chave secreta de produção.
Saldo, pagamentos, conversões e webhooks ficam isolados.

Simulação na dashboard

No painel app-sandbox, use o menu de cada linha em depósitos, saques e conversões: Simular status. Apenas transições válidas são exibidas (ex.: pendente → pago ou expirado; pago → estornado).

Ao criar um depósito pela API, o webhook DEPOSIT_PENDING é enviado. Ao criar um saque, é enviado WITHDRAW_PENDING ou WITHDRAW_PROCESSING, conforme aprovação automática ou manual configurada na empresa. Cada mudança de status simulada na dashboard dispara o webhook correspondente.

Eventos de webhook

O formato é o mesmo da produção: { tipo }_{ status } em maiúsculas no campo event.

Evento	Quando ocorre
DEPOSIT_PAID	Depósito liquidado.
DEPOSIT_PENDING	Depósito aguardando pagamento.
DEPOSIT_EXPIRED	Depósito expirado.
DEPOSIT_CANCELED	Depósito cancelado.
WITHDRAW_PENDING	Saque aguardando aprovação.
WITHDRAW_PROCESSING	Saque em processamento.
WITHDRAW_PAID	Saque concluído.
WITHDRAW_FAILED	Saque falhou (motivo sanitizado).
WITHDRAW_CANCELED	Saque cancelado.
CONVERSION_PENDING	Conversão criada.
CONVERSION_PROCESSING	Conversão em processamento.
CONVERSION_PAID	Conversão concluída.

Conversões e USDT

Depósitos USDT retornam endereço e QR fictícios; sem monitor on-chain.
Saques USDT usam taxa de rede zero no sandbox.
Conversões balance_to_balance: crie pela API e simule pending → processing → paid na dashboard.
Fluxos com Pix externo, carteira on-chain ou split não estão disponíveis no sandbox.