Como operar uma credencial BaaS
A credencial BaaS é emitida pela conta dona do BaaS, em Configurações → API BaaS → Nova credencial BaaS. O clientId usa o prefixo baas_. A autenticação continua sendo mTLS mais OAuth em POST /oauth/token. Veja Configurando o certificado e Configurando Token de acesso.
Base URL: https://secureapi.onz.finance/api/v2
O BaaS de cada chamada é o da credencial autenticada. Enviar outro valor em x-account-id não troca o BaaS.
Quando enviar x-account-id
O cabeçalho leva o id interno da conta filha, o mesmo retornado por GET /accounts. Não use o número da conta.
| Chamada | x-account-id |
|---|---|
GET /accounts e GET /accounts/{id} | Não envia |
POST /onboarding, POST /onboarding/{id}/images, GET /onboardings e GET /onboardings/{id} | Não envia |
| Saldo, extrato, Pix, chaves Pix, estatísticas, TED, boletos, cobranças, pagadores, transferências internas, infrações, CryptoRisk, CaaS e webhooks | Envia o id da conta filha |
Escopos da credencial BaaS
| Escopo | Uso |
|---|---|
baas.accounts.read | Listar e consultar contas filhas |
baas.onboarding.read | Consultar onboardings |
baas.onboarding.write | Criar onboarding e enviar documentos |
Para saldo, Pix, TED, boleto, cobrança, cripto e webhook na conta filha, a credencial BaaS também precisa do escopo daquela operação, além de x-account-id.
A jornada de bancarização não aceita credencial BaaS. Ela usa credencial de conta.