SaciPixAmbientes e sandbox
Diferenças entre teste e produção e como simular cada cenário.
Teste e produção
Os dois ambientes têm a mesma API e são isolados: saldo, cobranças, chaves, endpoints de webhook e segredo de assinatura são separados.
| Teste | Produção | |
|---|---|---|
| Chave | sk_test_ | sk_live_ |
| Conta aprovada | Não precisa | Obrigatória |
| Pix | QR Code simulado, não pode ser pago por um banco | Pix real |
| Saques | Enviados sem aprovação, sem sair dinheiro | Por padrão, aguardam aprovação |
| Cotação USDT | Fixa em R$ 5,50 e taxa de conversão de R$ 0,50 | Cotação de mercado |
| Webhooks | Reais, com o segredo de teste | Reais, com o segredo de produção |
Simular pagamento e estorno
Use POST /v1/sandbox/charges/{id}/pay para pagar uma cobrança pendente e POST /v1/sandbox/charges/{id}/refund para estornar uma paga. Os dois disparam os mesmos webhooks da produção. Com chave de produção, devolvem 403 forbidden.
curl -X POST "https://api.sacipix.com/v1/sandbox/charges/7c1e4f2a-3b58-4e0d-9a6c-2f8d1b7e5a10/pay" \
-H "Authorization: Bearer $GATEWAY_API_KEY"Simular falha em saque
Saques de teste terminam como paid em poucos segundos. Para testar o caminho de erro, use um amount terminado em 99 centavos:
| amount | Resultado |
|---|---|
10000 | Saque concluído, evento payout.paid. |
10099 | Saque falha, reserva devolvida, evento payout.failed com failureReason igual a sandbox_simulated_failure. |
Indo para produção
- 1Envie os dados e documentos da empresa no painel, em Configurações, na tela Empresa.
- 2Depois da aprovação, gere uma chave sk_live_.
- 3Cadastre os endpoints de webhook de produção e use o segredo de produção.
- 4Faça uma cobrança real de baixo valor e confirme o webhook.