Openi DeveloperDeveloper

Sandbox

Conectores de teste, CPFs que escolhem o resultado e a sequência de webhooks no ambiente sandbox.

Aplicações de teste (chaves of_test_) enxergam exatamente dois conectores, ambos simulados:

  • Instituição de Teste: pessoa física, pede CPF.
  • Instituição de Teste Empresas: pessoa jurídica, pede CPF e CNPJ.

Eles conectam sem banco nenhum: o CPF escolhido decide o resultado. Todo o resto é real: o item passa pela mesma fila e sincronização e dispara os mesmos webhooks de um item de produção.

CPFs de teste

No widget Connect, o campo de CPF é uma lista com as opções abaixo, então não é preciso decorar nada.

CPFResultado
111.444.777-35Tela de consentimento; em Autorizar, synced com 2 contas bancárias, 1 cartão de crédito, 90 dias de transações e 2 investimentos
529.982.247-25auth_error com INVALID_CREDENTIALS imediatamente, sem tela de consentimento
Qualquer outro CPF422 com fields: ["cpf"] (só pela API; o widget oferece apenas a lista acima)
CNPJ ausente ou malformado (conector empresas)422 com fields: ["cnpj"]

Na tela de consentimento, Recusar leva a auth_error com USER_AUTHORIZATION_NOT_GRANTED.

Os dois CPFs têm dígito verificador válido, então passam por validações no cliente. No conector empresas, o CNPJ é livre: qualquer CNPJ bem formado funciona e só muda nomes e valores gerados.

Dados estáveis

O conjunto de dados de sucesso tem sempre o mesmo formato (filtrado pelos products pedidos), então asserções como accounts.length === 2 valem para sempre. Nomes e valores variam por documento, e ids variam por item. Nada muda com o passar do tempo: POST /v1/items/:id/resync gera as mesmas linhas de novo.

Sem o widget

Se você cria itens via POST /v1/items e nunca abre o Connect, avance o item manualmente. Enquanto o item está em waiting_user_input, GET /v1/items/:id retorna auth.consentUrl; o último segmento do caminho é o token:

curl -X POST "https://of.openi.com.br/public/stub/consents/$TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"decision": "authorize"}'   # ou "deny"

A chamada retorna na hora e o item se resolve de forma assíncrona; seu webhook recebe ITEM_LOGIN_SUCCEEDED, TRANSACTIONS_CREATED, INVESTMENTS_UPDATED e ITEM_UPDATED, nessa ordem. Cada token aceita uma única decisão e expira uma hora após emitido; depois disso a chamada retorna 404, e POST /v1/items/:id/request-reconnect emite um novo.

Sequência de webhooks

EtapaEventos
Criação (CPF de sucesso)ITEM_CREATED, ITEM_WAITING_USER_INPUT (com consentUrl)
Criação (CPF de erro)ITEM_CREATED, ITEM_ERROR
AutorizarITEM_LOGIN_SUCCEEDED, TRANSACTIONS_CREATED ×3, INVESTMENTS_UPDATED, ITEM_UPDATED
RecusarITEM_ERROR
RessincronizarITEM_UPDATED

On this page