Skip to main content
O modo test é um universo paralelo ao live: mesmos endpoints, mesmas regras, mesmo livro-razão — mas isolado e sem tocar nenhum provedor de pagamento. Use chaves pk_test_… / sk_test_….
  • Depósitos em test recebem um emv sintético (não é um PIX pagável de verdade).
  • Você “paga” via POST /v1/test/deposits/{id}/pay — isso roda o fluxo real (status → PAID, crédito no saldo test, webhook deposit.paid assinado).
  • Saldos, extratos e saques em test são totalmente separados do live.
# 1. cria (test)
curl -X POST .../v1/deposits -H "x-api-key: pk_test_…" -H "x-api-secret: sk_test_…" \
  -d '{"amount_cents":10000,"external_id":"t1","payer":{...}}'

# 2. paga (simulação)
curl -X POST .../v1/test/deposits/dep_xxx/pay -H "x-api-key: pk_test_…" -H "x-api-secret: sk_test_…"
# → status PAID + webhook deposit.paid assinado disparado
/v1/test/deposits/.../pay só aceita chave test. Com chave live, responde 403 TEST_ONLY.
Quando tudo funcionar em test — inclusive a verificação da assinatura do webhook — troque as chaves para live e o player passa a pagar PIX de verdade. Nenhuma mudança de código.