# Collections e ambiente Postman

## Arquivos

| Arquivo | URL |
|---|---|
| Collection (JSON válido) | `/collection.json` |
| Environment de sandbox | `/ValidaPay-Sandbox.postman_environment.json` |
| Contrato OpenAPI 3.1 | `/openapi.json` |

A collection publicada em `/collection.json` tem os bodies como JSON válido e a documentação de cada campo na descrição da requisição — importe essa versão.

## Como importar

1. No Postman, **Import** e selecione a collection.
2. Importe também o environment de sandbox.
3. Selecione o environment no canto superior direito.
4. Preencha `client_id` e `client_secret` com as credenciais de sandbox obtidas em `https://app.validapay.com.br/integracao/api`.
5. Execute a requisição de autenticação primeiro — ela popula a variável de token usada pelas demais.

## Gerando um SDK a partir do OpenAPI

O contrato em `/openapi.json` é OpenAPI 3.1 e pode alimentar geradores de cliente:

```bash
npx @hey-api/openapi-ts -i https://docs.validapay.com.br/openapi.json -o src/validapay
```

```bash
npx orval --input https://docs.validapay.com.br/openapi.json --output src/validapay/client.ts
```

Um cliente tipado elimina a maior parte dos erros de integração, porque o compilador valida o payload antes da chamada.