Ambientes

Cada projeto da Allya Payments nasce com dois ambientes:

• sandbox
• production

Os ambientes isolam credenciais, API keys, gateways, pagamentos, webhooks e logs.

Sandbox

Use sandbox para testes de integração, validação de payloads e simulação do fluxo de pagamento.

API keys de sandbox usam o prefixo:

sk_test_

Production

Use production para cobranças reais e operação do cliente.

API keys de produção usam o prefixo:

sk_live_

Separação de dados

Uma chamada autenticada com sk_test_ resolve automaticamente o ambiente sandbox. Uma chamada com sk_live_ resolve o ambiente production.

Você não precisa enviar environmentId ao criar pagamento. O ambiente vem da API key.

Webhooks de gateway

URLs de webhook recebidas dos gateways usam um slug opaco por gateway configurado:

https://payments-api.allyasolutions.com/api/webhooks/{inboundWebhookSlug}

Esse slug resolve internamente o gateway e o ambiente, evitando expor ids internos e impedindo mistura entre eventos de sandbox e production.

Webhooks enviados ao cliente

Os endpoints de webhook do cliente também são configurados por ambiente. Um endpoint cadastrado no sandbox não recebe eventos de production.

Veja também

• API Keys: prefixos sk_test_ e sk_live_ por ambiente.
• Autenticação: header Authorization e o ambiente inferido.
• Gateways: credenciais por ambiente.
• Indo para produção: checklist de migração sandbox → production.