Integração White Label

Como iniciar a jornada

💡

Para chamar a Jornada de Compartilhamento de Dados é necessário gerar um token no qual devem ser indicados client_id e client_secret da operação. Você encontra o token no painel da aplicação, no meu configurações.

URL de geração do Token - Sandbox

curl --location 'https://keycloak.celcoin.shared.fsapps.io/auth/realms/smart-keys/protocol/openid-connect/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'scopes=openid' \
--data-urlencode 'client_id=${CLIENT_ID} \
--data-urlencode 'client_secret=${CLIENT_SECRET}'

URL de geração do Token - Produção

curl --location 'https://keycloak.celcoin.shared.fsapps.io/auth/realms/smart-keys-prd/protocol/openid-connect/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'scopes=openid' \
--data-urlencode 'client_id=${CLIENT_ID} \
--data-urlencode 'client_secret=${CLIENT_SECRET}'

cURL para geração do Token

curl --location '${TOKEN_URL}' \
--header 'Content-Type: application/json' \
--data '{   
    "client_id":"...-2567-....-ace9-...",
    "client_secret": "...8136-....-42ce-..."
}'

Response

{
    "access_token": "...iJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJJUV96OE...",
    "expires_in": 3600,
    "refresh_expires_in": 0,
    "token_type": "Bearer",
    "not-before-policy": 0,
    "scope": "email profile"
}

⚠️

O token retornado no campo “access_token“ tem validade padrão de 1 hora e deve ser utilizado para realizar as chamadas subsequentes. Ele deve ser incluído no parâmetro Authentication do header da requisição, precedido da palavra “Bearer “, conforme exemplo abaixo.

'Authorization': 'Bearer eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJJUV96OE...'\

Com o token gerado, é necessário passá-lo no authorization da chamada consents, para obter o consentimento e informações do usuário que realizará o pagamento.

Este é o momento no qual é informado o máximo de informação necessária para a abertura do consentimento, como forma de otimizar a experiência do seu cliente.

Campos presentes da request e personalização da UC

Caso seja passada no parâmetro, a jornada apresenta o campo preenchido para o cliente.:

• CPF do usuário: obrigatório

• CNPJ da companhia: opcional, sempre atrelado ao CPF

• Nome: opcional

Exemplo de Request

curl 'https://onboard-ui.smartkeys.celcoin.dev.fsapps.io/api/portal/onboard/v1/reception' \
  -H 'authorization: Bearer {{token}}' \
  -H 'content-type: application/json' \
  --data-raw '{"cpf":"","name":""}'

Exemplo de Response da chamada

{
    "url": "https://smartkeys-wl.celcoin.dev.fsapps.io/?id=PS3sgqbEf6tSq392rzW7TZf8QcQokE2v"
}