Teste e produção

Como o ambiente de teste (Sandbox) e o de produção se separam, e o que muda entre eles.

A Valora tem dois ambientes. O Sandbox serve para integrar e testar sem dinheiro real. A produção cobra e paga de verdade. Os dois usam a mesma URL e os mesmos endpoints: quem decide o ambiente é a chave de API.

A chave define o ambiente

	Sandbox	Produção
Chave	criada com o ambiente Sandbox	criada com o ambiente Production
Dinheiro	nenhum dinheiro real se move	cobranças e saques reais
Campo livemode	false	true
Saldo (GET /v1/balance)	saldo de teste	saldo real
Webhooks	entregues de verdade, com livemode: false	entregues com livemode: true

Não existe parâmetro para trocar de ambiente numa requisição. Para mudar, troque a chave.

Todo objeto da API traz livemode. Confira esse campo no webhook antes de liberar um pedido: um evento de teste nunca deve liberar uma venda real.

Conta em análise

Logo depois do cadastro, a sua empresa passa por uma análise. Enquanto isso, o Sandbox já funciona normalmente. Os pagamentos reais só ficam disponíveis depois da aprovação.

Mesma URL, dados separados

• Base da API: https://api.valorapayments.com.br
• Checkout: https://pay.valorapayments.com.br

Pagamentos, sessões de checkout e saldo de teste ficam separados dos reais. Produtos, clientes e webhooks cadastrados pertencem ao negócio e são vistos pelas duas chaves.

Cada webhook cadastrado recebe os eventos dos dois ambientes. Se o mesmo servidor atende teste e produção, separe pelo campo livemode do evento. Um evento com livemode: false nunca deve liberar uma venda real.

Próximos passos

Chaves de API

Como criar, limitar e revogar chaves.

Testes

Roteiro de testes para cada forma de pagamento.