Jornada Otimizada - JSR
Esta página mostra como criar um vínculo de dispositivo da Jornada Sem Redirecionamento com a Jornada Otimizada, para obter também o consentimento de saldo e limite da conta vinculada. O conceito, a consulta do saldo, a revogação e os casos de erro estão em Jornada Otimizada (Saldo e Limite).
Antes de começarConfira se a marca escolhida pelo usuário tem
optimized-journey-enrollmentsemApiFamilyTypena listagem de marcas.
Criar o vínculo com a Jornada Otimizada
Use a mesma chamada de Criar Vínculo, acrescentando "isOptimizedJourney": true no objeto raiz do corpo.
POST /baas/v1/open/itp/enrollments/payment-initiation
curl --location '{{base_url}}/baas/v1/open/itp/enrollments/payment-initiation' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{application_token}}' \
--data '{
"brandId": "{{brand_id}}",
"redirectUrl": "https://seu-dominio.com/callback",
"isOptimizedJourney": true,
"data": {
"enrollment": {
"loggedUser": {
"document": {
"identification": "12345678909",
"rel": "CPF"
}
},
"permissions": ["PAYMENTS_INITIATE"]
},
"riskSignals": {
"deviceId": "00000000-54b3-e7c7-0000-000046bffd97",
"isRootedDevice": false,
"screenBrightness": 128,
"elapsedTimeSinceBoot": 3600000,
"osVersion": "Android 14",
"userTimeZoneOffset": "-03",
"language": "pt",
"screenDimensions": { "height": 1920, "width": 1080 },
"accountTenure": "2024-09-13"
}
}
}'A resposta mantém o formato de Criar Vínculo: id, journeySessionId, ofEnrollmentId e authorizationUrl. Redirecione o usuário para a authorizationUrl.
Escopos enviados à detentora
A Celcoin monta o PAR com os escopos dos dois consentimentos:
openid consent:{consentId} consents resources accounts enrollment:{enrollmentId} payments nrp-consentsCallback e consentimento de dados
O Callback do Vínculo continua retornando ofEnrollment (consentId, enrollmentId, status). Com a Jornada Otimizada, a resposta traz também o objeto ofDataConsent, com o URN e o status do consentimento de saldo e limite. Os campos estão descritos na página da Jornada Otimizada.
Depois do vínculo, siga normalmente com o FIDO e os pagamentos (PIX - v4), consultando antes o saldo com o consentimento de dados.
Regras específicas da JSR
- Aprovação conjunta. O vínculo e o compartilhamento são aprovados ou rejeitados juntos na detentora.
- Extensão de validade. Estender a validade do vínculo estende também o consentimento de dados, para a mesma data. Estender só o consentimento de dados é recusado com HTTP 422
ALTERACAO_NAO_PERMITIDA. - Revogação. Cancelar o vínculo revoga automaticamente o consentimento de dados. Revogar só o compartilhamento (
DELETE /baas/v1/open/dat/consents/{consent_id}) mantém o vínculo ativo.
Requisitos de experiência (Vinculação de Conta)
| Etapa | Requisito | O que a tela precisa ter |
|---|---|---|
| Solicitação | REQ.VC-00700 | Opção de compartilhar saldo e limite, opcional |
| Solicitação | REQ.VC-00800 | Opção desmarcada por padrão |
| Solicitação | REQ.VC-00900 | Aviso de que saldo e limite serão compartilhados |
| Solicitação | REQ.VC-01000 | Escopo dos dados compartilhados visível |
| Solicitação | REQ.VC-01100 | Nada que desvie o foco (links, botões, imagens) |
| Confirmação (detentora) | REQ.VC-05600, REQ.VC-05700 | Aviso de compartilhamento e escopo dos dados |
| Efetivação | REQ.VC-07100 | Informar que o compartilhamento pode ser cancelado na área de gestão |
| Efetivação | REQ.VC-07200 | Cancelar o compartilhamento não cancela o vínculo |
| Efetivação | REQ.VC-07300 | Cancelar o vínculo também cancela o compartilhamento |
| Erro | REQ.VC-10600 | Vínculo criado, mas o compartilhamento falhou |
| Erro | REQ.VC-10800 | Falha ao cancelar o compartilhamento |
Fonte: Guia de Experiência do Usuário v.26.00.00 do Open Finance Brasil.
Updated about 7 hours ago