Callback de Dados

A página

A Página de Redirecionamento é um link que recebe 3 parâmetros por query string ao final do fluxo de pagamento.

1. Informações sobre o token utilizado no processo de pagamento
   • ticket=eyJhbGciO…
2. ID de consentimento
   state=HVLeXYgP6…
3. Parâmetro opcional presente apenas na jornada white label
   journey-id=iUT7Rhfk8…

Por exemplo, o parâmetro state traz o ID de consentimento, então é possível utilizar a API Get Data by ConsentId, conforme abaixo:

curl --location 'https://api-smartkeys.celcoin.prd.fsapps.io/api/smart-keys/data-reception/v1/consents/HVLeXYgP6…' \
--header 'Authorization: Bearer <PUT_HERE_THE_ACCESS_TOKEN>' \

A resposta é algo como abaixo:

{
  "_id": "JyDgkL9-Y8Xm6UV1b_84I6IiqlBU4u2qKQBXm9CPLzw",
  "permissions": [
    "ACCOUNTS_READ",
    "ACCOUNTS_OVERDRAFT_LIMITS_READ",
    "ACCOUNTS_BALANCES_READ",
    "ACCOUNTS_TRANSACTIONS_READ",
    "RESOURCES_READ"
  ],
  "creationDateTime": "2023-09-29T20:28:24.816Z",
  "status": "AUTHORISED",
  "statusUpdateDateTime": "2023-09-29T20:28:54.056Z",
  "expirationDateTime": "2023-12-30T00:00:00.000Z",
  "loggedUser": {
    "document": {
      "identification": "12345678909",
      "rel": "CPF"
    }
  },
  "kind": "DATA",
  "brandId": "b0e14b00-9686-4764-bdac-5fe415b1dc1a",
  "clientId": "aefea86f-9838-46f7-87de-862a2074ba99",
  "consentId": "urn:celcoin:726a2026-d4ee-459f-b3e2-0aca5455d0b7",
  "organizationName": "Celcoin",
  "organizationLogo": "https://www.celcoin.com.br/img/rede-celcoin-logo.svg",
}

ℹ️

É importante não chamar essas APIs de uma página pública, pois para gerar um token é necessário utilizar seu ID e API secret e ele pode ser exposto se utilizado em um site público do cliente.

Modelos de tela de efetivação por definição do Open Finance

Com essas informações, é possível criar uma página de sucesso ou uma tela de falha. As empresas contratantes do Open Keys® são responsáveis por criar e apresentar a tela de Efetivação da Jornada, conforme os modelos apresentados como sugestão, abaixo.

Exemplo de tela disponível no Guia de UX do Open Finance, no item do sumário Etapa 6: Efetivação IR para IT.

Informações obrigatórias na tela de efetivação

• Identificação do cliente.
• Data e hora da confirmação.
• Validade do consentimento (prazo e data final).
  A data final deve ser exibida em casos de prazo determinado e no caso de prazo indeterminado, identificar para o cliente como “Indeterminado” ou termo similar.
• Finalidade de uso dos dados compartilhados.
• Escopo de dados do compartilhamento (p.ex.: cadastrais, conta, cartões de créditos, operações de crédito).