Sandbox

Uma loja sandbox permite testar o tratamento de pagamentos sem enviar criptomoeda real. Cada lojista pode ter uma loja sandbox.

Crie uma loja separada com "sandbox": true. Uma loja real já existente não pode ser convertida para o modo sandbox.

Teste uma fatura

1. Crie uma fatura na loja sandbox usando o início rápido.
2. Salve o id dela como seu issuance_id.
3. Simule um pagamento recebido confirmado:

curl -X POST 'https://platform.invoise.me/api/v1/shops/{shop_id}/sandbox/simulate' \
  -H 'Authorization: Bearer ivk_...' \
  -H 'Idempotency-Key: <saved-unique-key>' \
  -H 'Content-Type: application/json' \
  -d '{"issuance_id":"<issuance-id>","kind":"transfer.confirmed","amount":"10000000"}'

Use o valor real da fatura em unidades base. Um corpo {} vazio não identifica um pagamento e vai falhar.

No sandbox, uma fatura ou transferência simulada pode ter no máximo 10.000 tokens; um valor maior retorna 400 sandbox_amount_limit. Faturas e endereços de depósito do sandbox são contados separadamente da produção. Veja Limites.

Leia o endpoint de status novamente. Uma fatura totalmente paga chega a funded; os assinantes de webhook podem receber transfer.confirmed. A simulação insere o evento solicitado, não um pagamento real completo na blockchain.

Para simular o fechamento da fatura após o pagamento, envie uma nova chave de idempotência com:

{"issuance_id":"<issuance-id>","kind":"invoice.closed","amount":"0"}

Isso testa o estado settled. Para testar correções, simule transfer.reverted com reference_event_id definido como o ID do evento anterior. Use uma chave salva diferente para cada novo evento simulado.

Comece um teste limpo

POST /api/v1/shops/{shop_id}/sandbox/reset apaga o histórico de pagamentos do sandbox. Exige uma sessão de proprietário, MFA recente se habilitado, e uma Idempotency-Key.

Chaves de idempotência antigas mantêm seus resultados originais após o reset. Use chaves novas para novos pagamentos de teste.

Antes de aceitar pagamentos reais

O sandbox verifica sua API e o tratamento de eventos. Ele não comprova confirmações reais de rede, custos de gas ou recebimento em uma corretora. Teste um pequeno pagamento real separadamente antes de confiar nesse fluxo.