Callback de Dados
Configure a jornada
A página
A Página de Redirecionamento é um link que recebe 3 parâmetros por query string ao final do fluxo de pagamento.
- Informações sobre o token utilizado no processo de pagamento
• ticket=eyJhbGciO… - ID de consentimento
state=HVLeXYgP6… - 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).
Updated 6 months ago