Integração via APIs
Como iniciar a jornada
Para que uma empresa contratante da solução Open Keys possa acionar a Jornada de Iniciação de Pagamento, é necessário gerar um token no qual deverá ser indicado o client_id e client_secret da operação, indicados no painel do aplicativo, menu de 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-..."
}'
Liste os participantes do Open Finance de pagamento
A seguinte chamada de API traz todas as instituições financeiras que podem ser escolhidas para realizar a aprovação do pagamento/consentimento.
Solicitação de lista de participantes
Resposta da lista de participantes
Criar consentimento de pagamento
Agora, usando o token de acesso gerado, vamos chamar o endpoint Consent Creation.
O campo AuthorisationServerId é o Brand ID que usaremos para criar o consentimento de pagamento. Aqui temos que informar um uri de redirecionamento válido do Meu Primeiro App, caso contrário o acesso será negado.
Usaremos o Brand ID do Finansystech Mock (b09ede32-83db-4019-8ca3-a9a6f9376d0b) 3:03
Resposta de criação de consentimento
Será retornado um AuthorizationUrl para que possamos redirecionar o usuário para a página de login do banco. Execute o redirecionamento usando o URL de autorização. A página de login será mostrada.
O sistema apresentará a página Aprovação de Consentimento de Pagamento com as informações da transação. Clique no botão “CONFIRMAR PAGAMENTO” para consentir com o pagamento.
O sistema redirecionará o usuário de volta para Celcoin , com a mensagem de que a transação está em processamento. A página URI de redirecionamento receberá os seguintes parâmetros de string de consulta:
ticket=eyJhbGciO…
state=HVLeXYgP6…
https://celcoin.atlassian.net/wiki/spaces/DOK/pages/1234081900
Acompanhe o status da jornada
Acompanhe o status do pagamento
Para confirmar se o pagamento foi processado com sucesso e o status correspondente, você pode acompanhar via Webhook na Iniciação do Pagamento ou consultando o status do pagamento.
Após receber um retorno de um token dentro da tag “ticket”, você deve inseri-lo na próxima chamada de consulta ao recibo do PIX. Para isso, você pode utilizar o ID do Consentimento, o ID da Jornada ou o ID do Pagamento.
O parâmetro status pode receber os valores: "ACCEPTED", "AWAITING_APPROVAL" e "REJECTED"
O parâmetro status pode receber os valores: "ACCEPTED", "AWAITING_APPROVAL" e "REJECTED"
Continue sua jornada