Sandbox (modo de teste)
Teste a integração inteira com transações simuladas, sem usar dinheiro de verdade.
Como usar
- 1. No painel, em Configurações, ative o modo Sandbox. A VamPay cria uma chave de teste que começa com
vp_sandbox_. - 2. Use essa chave no header
X-API-Key, no lugar da chave de produção. As cobranças criadas viram transações simuladas. - 3. Aprove um pagamento de teste com o endpoint abaixo e veja o seu sistema reagir, inclusive pelo webhook.
- 4. Quando quiser recomeçar, use Resetar Sandbox no painel: o saldo volta pra R$ 1.000,00 e o histórico de testes é apagado.
POST
/transactions/sandbox-approve/{id}Aprovar pagamento de teste
Marca como pago uma cobrança simulada que está pendente.
Parâmetros
| Parâmetro | Tipo | Descrição |
|---|---|---|
id* | string | transactionId da cobrança criada com a chave de sandbox |
Exemplo de Request
curlbash
curl -X POST "https://api.vampay.com.br/transactions/sandbox-approve/507f1f77bcf86cd799439011" \
-H "X-API-Key: vp_sandbox_sua_chave_de_teste"Erros
| Parâmetro | Tipo | Descrição |
|---|---|---|
403 | Sandbox mode is not enabled | O modo sandbox não está ligado na sua conta |
404 | Transação sandbox não encontrada ou já processada | O id não é de uma cobrança de teste pendente |
Sandbox é só pra teste: nada vira saldo real, e a chave de teste não funciona em produção. Antes de ir pro ar, troque pela chave normal.
