WysePayDocs

Modo teste

Integre e teste o caminho completo sem dinheiro real.

No modo teste tudo funciona como em produção, mas nada movimenta dinheiro: você cria cobranças e links, recebe webhooks e simula pagamentos. Ele não precisa de conta verificada.

Como usar

  • Pela API: use uma chave wyp_test_. Tudo que ela cria é de teste (livemode: false).
  • No painel: ligue Modo teste no topo da tela. Os dados de teste ficam separados dos reais.

O Pix de teste não pode ser pago

O código de um Pix de teste é de mentira de propósito: nenhum app de banco aceita. Para "pagar", simule:

curl -X POST https://api.wysepay.com.br/api/v1/sandbox/transactions/{id}/pay \
  -H "x-api-key: wyp_test_sua_chave"

Também dá para simular pelo painel, no botão Simular pagamento da tela do Pix ou da venda.

A simulação:

  • muda a cobrança para PAID;
  • envia o webhook transaction.paid aos seus endpoints de teste;
  • credita o saldo de teste, para você testar também o extrato e os saques no painel.

Só cobranças de teste podem ser simuladas. Com uma chave de produção, a rota responde 403.

Prazo

Um Pix de teste vence em 30 minutos, como um Pix real vence no prazo dele. Depois disso ele aparece como EXPIRED, e a simulação responde 400: gere outro.

Webhooks de teste

Cadastre o endpoint com o modo teste ligado. Ele recebe só eventos de teste; os de produção vão só para endpoints de produção.

Nesta página