Homologação Técnica
Casos de uso
Cenários mínimos de validação técnica antes de produção na API Nuvende
A homologação técnica confirma que a sua aplicação chama a API de forma correta: autenticação, escopos, headers, tratamento de erros e, quando aplicável, webhooks. Os detalhes comerciais e o checklist oficial são alinhados com a Nuvende; esta página resume o que costuma ser pedido do ponto de vista de engenharia.
Princípios
- Sandbox primeiro: usar
https://api-h.nuvende.com.bre credenciais de homologação (Ambientes). - Escopos explícitos: o token deve ser obtido com todos os
scopenecessários aos fluxos que vai demonstrar; após alterar escopos, é obrigatório novo login. - Evidências reprodutíveis: ver Envio de evidências.
Casos de uso típicos (API pública v2)
Ajuste à sua integração real; exemplos comuns:
| # | Cenário | O que demonstrar |
|---|---|---|
| 1 | Autenticação | POST /api/v2/auth/login com Basic Auth e scope adequado; resposta com access_token e expires_in. |
| 2 | Conta | Pelo menos uma chamada bem-sucedida a Contas conforme o produto (ex.: saldo ou extrato) com token e escopos contas.* corretos. |
| 3 | Cobrança Pix (Cob) | Criar ou consultar cobrança conforme o seu fluxo (referência Cob / PUT txid). |
| 4 | Pix pagamentos | Um fluxo alinhado ao contrato em Pagamentos na referência (ex.: consulta ou pagamento, conforme habilitado). |
| 5 | Webhooks | Se integrar notificações: cadastro do URL, recebimento de payload de teste, resposta HTTP 2xx em tempo hábil. |
BaaS (parceiro)
Se a homologação incluir Banking as a Service, acrescente cenários com scopes baas.* e rotas /api/v2/baas/..., incluindo HMAC onde obrigatório. Ver Sobre o BaaS.
Documentação de apoio
- Introdução técnica: navegação geral
- Resolução de problemas (API v2)
- Códigos de erro