Pular para o conteúdo
SimPixSimPix Docs

Ambiente de testes (Sandbox)

O ambiente Demo (sandbox) da SimPix replica todo o fluxo Pix — criação de cobrança, confirmação, saques, disputas e webhooks — sem mover dinheiro de verdade. É o lugar para validar sua integração de ponta a ponta antes de ir para produção.

Valores mágicos de status

Seção intitulada “Valores mágicos de status”

No sandbox, o valor da cobrança determina o status final para o qual a transação será conduzida automaticamente. Assim você testa cada estado da máquina de status de forma determinística: basta criar uma transação com o valor correspondente.

Valor da cobrança Status resultante
11.11 PENDING — permanece pendente (não é confirmada)
12.22 FAILED
13.33 REFUNDED
14.44 EXPIRED
15.55 DISPUTE_NEEDS_RESPONSE
16.66 DISPUTE_IN_REVIEW
17.77 DISPUTE_WON
18.88 DISPUTE_LOST
qualquer outro valor CONFIRMED

Como testar

Seção intitulada “Como testar”

Crie uma transação normalmente, usando o valor correspondente ao status que deseja simular. A transação nasce como PENDING e, após um curto intervalo, o sandbox a conduz ao status alvo (nos casos de disputa, a transação é confirmada e a disputa é aberta e avançada até o sub-status indicado).

POST /api/transactions — Simular uma transação que falha
curl --request POST \
  --url https://api.simpixpagamentos.com/api/transactions \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <API_KEY>' \
  --header 'x-token: <TOKEN>' \
  --header 'idempotency-key: <UNIQUE_KEY>' \
  --data '{
    "amount": 12.22,
    "external_ref": "teste_falha_001",
    "payment_method": "Pix",
    "requester": {
      "name": "John Doe",
      "email": "john.doe@example.com",
      "phone": "11999999999",
      "document": "12468239008"
    }
  }'

Acompanhe a mudança de status consultando a transação ou, melhor ainda, registrando um webhook para receber cada transição em tempo real.

Veja também

Seção intitulada “Veja também”