# Sandbox

O ambiente de sandbox permite integrar e testar a API Movvia com dados sintéticos, sem impacto em produção.

Estado atual
O acesso ao sandbox não é self-service. As credenciais são provisionadas manualmente pela equipe Movvia. Envie uma solicitação conforme descrito abaixo.

## Como solicitar acesso

Envie um email para [comercial@movvia.com.br](mailto:comercial@movvia.com.br) com:

- Nome e empresa
- Persona que você quer integrar (Parceiros, Vision Dados ou Estabelecimentos Comerciais)
- Descrição em uma ou duas linhas do caso de uso
- Volume estimado (para dimensionamento de limites de sandbox)


A equipe Movvia retorna com as credenciais em dias úteis.

## O que você recebe

- Credenciais de Basic Auth para o ambiente de homologação
- Host: `hml.api.pedagioeletronico.com.br`
- Dados sintéticos para simular passagens, pedidos e eventos


## Diferenças entre sandbox e produção

| Aspecto | Sandbox | Produção |
|  --- | --- | --- |
| Host | `hml.api.pedagioeletronico.com.br` | `api.pedagioeletronico.com.br` |
| Dados | Sintéticos | Reais |
| Rate limits | Mais restritivos | Conforme plano contratado |
| Webhooks | Entregues ao endpoint configurado | Entregues ao endpoint configurado |
| SLA | Sem garantia | Conforme contrato |


## Próximos passos após receber as credenciais

1. Faça a chamada de descoberta de identidade (`GET /me`) para obter seu identificador.
2. Siga o guia de [autenticação](/compartilhado/seguranca/basic-auth) para configurar o header `Authorization`.
3. Teste o fluxo principal da sua persona usando os exemplos da referência de API.
4. Quando estiver pronto para produção, informe a equipe Movvia para provisionar as credenciais de produção e acertar o plano comercial.


Postman Collection
A Movvia mantém uma Postman Collection atualizada em CI. Solicite o link no mesmo email de onboarding.