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çar

Confira se a marca escolhida pelo usuário tem optimized-journey-enrollments em ApiFamilyType na 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-consents

Callback 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)

EtapaRequisitoO que a tela precisa ter
SolicitaçãoREQ.VC-00700Opção de compartilhar saldo e limite, opcional
SolicitaçãoREQ.VC-00800Opção desmarcada por padrão
SolicitaçãoREQ.VC-00900Aviso de que saldo e limite serão compartilhados
SolicitaçãoREQ.VC-01000Escopo dos dados compartilhados visível
SolicitaçãoREQ.VC-01100Nada que desvie o foco (links, botões, imagens)
Confirmação (detentora)REQ.VC-05600, REQ.VC-05700Aviso de compartilhamento e escopo dos dados
EfetivaçãoREQ.VC-07100Informar que o compartilhamento pode ser cancelado na área de gestão
EfetivaçãoREQ.VC-07200Cancelar o compartilhamento não cancela o vínculo
EfetivaçãoREQ.VC-07300Cancelar o vínculo também cancela o compartilhamento
ErroREQ.VC-10600Vínculo criado, mas o compartilhamento falhou
ErroREQ.VC-10800Falha ao cancelar o compartilhamento

Fonte: Guia de Experiência do Usuário v.26.00.00 do Open Finance Brasil.


Did this page help you?