Gestão de Contas (parceiro)

Plataforma BaaS

Onboarding, webhooks da plataforma e contratos do parceiro integrador.

Área do integrador na plataforma BaaS: abrir contas e receber notificações da Nuvende. Movimentação da conta (Pix, saldo, etc.): Conta BaaS.

Autenticação

Token da plataforma BaaS. Pedidos assinados exigem Bearer + HMAC, exceto GET /api/v2/baas/status.

O que pertence à plataforma

Recurso	Path base	Guia
Onboarding	`/api/v2/baas/onboardings/...`	Onboarding
Webhooks da plataforma	`/api/v2/baas/seller-webhooks`	Webhooks da plataforma
Contratos (catálogo)	`GET /api/v2/baas/contracts`	Contratos

Webhooks da plataforma notificam eventos como AccountCredentials (credenciais da conta após onboarding). Não são os webhooks de Pix em /api/v2/baas/webhooks (esses ficam em Conta BaaS).

Fluxo típico

Onboarding: proposta → PF ou PJ → análise KYC.
Cadastrar webhooks da plataforma para receber AccountCredentials.
Após aprovação, persistir credenciais da conta e seguir em Conta BaaS.
Opcional: consultar contratos elegíveis do parceiro.

Pré-requisitos

Login plataforma com scopes de onboarding e baas.seller-webhooks.*.
hmac_secret do tenant configurado no ambiente.

Listar Contas

Liste e consulte contas digitais através da API BaaS

Webhooks da plataforma

Configure webhooks da plataforma BaaS para receber notificações da Nuvende (parceiro integrador).