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 AurePay:
https://api-sandbox.aurepay.com.br - Dashboard AurePay:
https://app-sandbox.aurepay.com.br
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. |
| REFUND_PAID | Estorno de depósito Pix. |
| REFUND_FAILED | Falha no estorno de depósito Pix. |
| 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: todos os fluxos da API (saldo ↔ saldo, Pix IN/OUT e carteira on-chain) estão disponíveis no sandbox, com QR/endereço fictícios e cotação fixa.
- Na tabela de conversões, use Simular: Pix pago / Simular: USDT pago (entrada) ou Simular: Em processamento (origem em saldo), depois Simular: Concluído. Depósitos internos ligados à conversão não aparecem na lista de depósitos.
- Webhooks de conversão (
CONVERSION_*) e, nos fluxos com funding externo, de depósito interno (DEPOSIT_*) seguem a mesma sequência conceitual da produção.