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.
| CPF | Resultado |
|---|---|
111.444.777-35 | Tela 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-25 | auth_error com INVALID_CREDENTIALS imediatamente, sem tela de consentimento |
| Qualquer outro CPF | 422 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
| Etapa | Eventos |
|---|---|
| Criação (CPF de sucesso) | ITEM_CREATED, ITEM_WAITING_USER_INPUT (com consentUrl) |
| Criação (CPF de erro) | ITEM_CREATED, ITEM_ERROR |
| Autorizar | ITEM_LOGIN_SUCCEEDED, TRANSACTIONS_CREATED ×3, INVESTMENTS_UPDATED, ITEM_UPDATED |
| Recusar | ITEM_ERROR |
| Ressincronizar | ITEM_UPDATED |

