Introdução

Normalmente, ao integrar um aplicativo com os serviços de API de pagamentos da Nuvende, cada cliente precisa inserir manualmente dados como client_id, client_secret, scopes e account_id para concluir a integração entre o parceiro e a API de pagamentos. Esse processo, embora funcional, pode gerar atritos devido à sua complexidade e à necessidade de manipulação manual de credenciais.

Para simplificar essa experiência, foi criado o Módulo de Parceiros, que introduz o recurso de Solicitação de Autorização. Esse recurso permite que toda a configuração da conta do cliente na integração Parceiro x API de Pagamentos seja feita de forma automática e segura, sem que o cliente precise inserir informações manualmente.

Credenciais de Parceiro

Quando um novo parceiro é cadastrado na Nuvende, ele recebe um Client ID e um Client Secret exclusivos.

Essas credenciais servem exclusivamente para o parceiro e permitem:

• Cadastrar novas aplicações
• Solicitar autorização de integração para clientes Nuvende

Solicitação de Autorização

O fluxo de autorização funciona da seguinte forma:

1. Solicitação enviada pelo parceiro
   O parceiro usa suas credenciais para solicitar autorização de integração para um cliente.
2. Notificação ao cliente no app Nuvende
   O cliente recebe uma notificação informando:
   • Nome do aplicativo solicitante
   • Opções de Aceitar ou Recusar

3. Decisão do cliente
   • Se Aceitar → a integração é autorizada e o webhook será disparado
   • Se Recusar → a integração é negada e o webhook será disparado

Tratamento via Webhooks

O parceiro deve implementar o recebimento e processamento de dois tipos de webhooks enviados pela Nuvende:

Webhook de Rejeição

Enviado quando o cliente recusa a integração.
O parceiro deve registrar essa resposta e não prosseguir com a configuração.

Webhook de Autorização

Enviado quando o cliente autoriza a integração.
Esse webhook contém:

• client_id e client_secret do cliente
• Escopos autorizados
• Outras informações necessárias para configurar a integração de pagamentos

Com esses dados, o parceiro consegue configurar automaticamente a integração de pagamentos sem que o cliente precise informar credenciais manualmente.

Fluxo de Integração

1. Parceiro envia a solicitação de autorização
2. Cliente recebe e decide (Aceitar/Recusar) no app Nuvende
3. API de pagamentos dispara o webhook correspondente para o parceiro
4. Parceiro configura a integração de pagamentos (em caso de aceitação)

Próximos Passos

Após compreender o fluxo completo, você pode:

1. Realizar Autenticação
2. Gerenciar aplicações
3. Criar solicitações de autorização
4. Configurar webhooks