Pular para o conteúdo

Ambiente de testes

Dados fictícios, celular de teste e cenários.

3 min de leitura

Nesta página

Com uma chave mn_test_…, a API responde igual à produção, mas sobre lojas, caixas e clientes fictícios que você mesmo cria. Nada encosta em loja real, cliente real ou dinheiro.

Dados de teste (portal → Dados de teste)

O quê Como Limite
Lojas de teste Nova loja (o nome é inventado se você deixar em branco). CNPJ fictício, com selo TESTE. 10 por aplicativo
Código de ativação Na loja, Gerar código → T-XXXX-XXXX, válido por 24 h, uso único. não se aplica
Caixas de teste Ligados pela API com o código T-… (POST /pontos-de-venda/ativar). 50 por aplicativo
Clientes de teste Novo cliente: saldo fictício editável (padrão R$ 500,00). 20 por aplicativo

Gerar dados de exemplo cria 1 loja, 2 clientes e 1 código de uma vez. Apagar todos os dados de teste limpa tudo (pede o código do e-mail). Dados sem uso há 30 dias são apagados sozinhos.

Não use dados de pessoas reais em nomes ou metadados.

Três jeitos de pagar uma cobrança de teste

  1. Celular de teste (portal → Dados de teste → Celular de teste): lê o QR que o seu caixa mostrou ou imprimiu, pela câmera ou colando o conteúdo. Escolha o cliente e use o PIN 1234. Erros iguais aos do app real: QR inválido, expirado, já pago, saldo insuficiente.
  2. Pelo portal, em Cobranças (seletor em Testes): Pagar como…, Expirar agora, Loja cancela, Estornar.
  3. Cenário automático, com um cabeçalho no POST /cobrancas:
Moeda-Nobre-Teste-Cenario O que acontece
pagar_em_3s Paga depois de 3 segundos
expirar_em_10s Expira depois de 10 segundos
loja_cancela_em_3s A loja cancela depois de 3 segundos
pagar_e_estornar Paga em 3 s e a loja estorna em 10 s

Com chave de produção, o cabeçalho é recusado (400 CENARIO_SO_EM_TESTE). Se você cancelar antes, o cenário perde a corrida e não faz nada.

O que a loja faria (portal → Dados de teste → loja)

Para ver o que o seu PDV recebe quando a loja mexe nas coisas:

Simulação O que o PDV recebe
Desligar caixa 422 PDV_INATIVO nas cobranças e o evento ponto_de_venda.desativado
Inativar loja 422 LOJA_INATIVA
Revogar integração 422 VINCULO_REVOGADO até restaurar a integração ou ativar um caixa com código novo. Os caixas ligados da loja desligam junto (evento ponto_de_venda.desativado de cada um), como quando a loja real desconecta o seu sistema
Restaurar integração 422 PDV_INATIVO até cada caixa ser reativado: restaurar não religa caixa. Na loja real, a autorização volta com um código novo e os outros caixas seguem desligados
Estornar uma cobrança paga evento cobranca.estornada e status: "ESTORNADA" no GET

Reativar um caixa com a integração revogada é recusado: restaure a integração antes. Com mais de uma simulação ligada, a API responde pela primeira que encontrar: VINCULO_REVOGADO, depois PDV_INATIVO, depois LOJA_INATIVA.

Limites em testes

60 chamadas por minuto por empresa (somando todos os aplicativos), 500 cobranças por dia por aplicativo e 30 cobranças por minuto por caixa. Em produção os limites são maiores e definidos pela TribeX.

Console de testes

Na Documentação do portal há um console que executa as chamadas da API em testes pelo servidor, com a chave que você escolher pelo nome: a chave nunca vai para o navegador. As chamadas do console não contam para a homologação: ela tem de ser provada pelo seu PDV.

Isolamento

  • Código real (XXXX-XXXX) com chave de teste → 422 CODIGO_ATIVACAO_INVALIDO com a dica "use sua chave de produção"; código T-… com chave de produção → a dica inversa.
  • Um QR de teste lido pelo app real é recusado como "QR inválido".
  • Chave de teste pedindo caixa ou cobrança real → 404.