Ambiente de testes
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. |
— |
| 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
- 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.
- Pelo portal, em Cobranças (seletor em Testes): Pagar como…, Expirar agora, Loja cancela, Estornar.
- 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é ativar um código novo) |
| Estornar uma cobrança paga | evento cobranca.estornada e status: "ESTORNADA" no GET |
Limites em testes
60 chamadas por minuto e 500 cobranças por dia por aplicativo; 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_INVALIDOcom a dica "use sua chave de produção"; códigoT-…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.