Integração via White Label
- Igor Dantas Silva (Unlicensed)
- Confluence Editor (Unlicensed)
A Jornada de Iniciação de Pagamentos da Finansystech possui como grande característica a flexibilidade para se adequar, de forma inteligente, às necessidades e contextos do seu negócio!
Com ela, a experiência do seu cliente será moldada de acordo com os parâmetros que você dispõe, o que nos permite atender a todos os contextos existentes no mercado.
Método de pagamento PIX Instantâneo
Ao conduzir o seu cliente para o momento de fechamento da compra, será necessário informar entre os métodos de pagamento PIX Via Open Finance, entre as demais opções convencionais do seu canal de vendas. O formato no qual a jornada será chamada, fica a cargo da estratégia que a sua empresa definir, podendo utilizar, por exemplo, QR Code ou link de acionamento da jornada, via botão.
Como iniciar a jornada
Para que uma empresa contratante da solução Open Keys possa chamar a Jornada de Iniciação de Pagamentos é necessário gerar um token no qual devem ser indicados client_id e client_secret da operação, que você encontra no painel da sua aplicação, menu 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-..."
}'
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 você poderá informar o máximo de informações necessárias para a abertura do consentimento, como forma de otimizar a experiência do seu cliente.
Campos presentes na request e personalização da UX
CPF - Caso seja passada no parâmetro, a jornada apresenta o campo preenchido para o seu cliente.
Valor da transação - Caso seja passada no parâmetro, a jornada apresenta o campo preenchido para o seu cliente.
Paymentview PIX Instantâneo (deposit-confirmation-simple) - Deve ser passada como data o dia da transação e o código reconhecerá que se trata de um PIX Instantâneo.
Você pode utilizar mais de uma conta para recebimento dos pagamentos. Para utilizar sempre a conta cadastrada na aplicação criada com a Finansystech, basta realizar a chamada utilizando, no campo Paymenttype, o parâmetro DICT. Caso a sua escolha seja por utilizar qualquer outra conta em sua operação, basta passar no campo Paymenttype o parâmetro MANU com as informações da conta desejada como campos de Creditor e CreditorAccount. Confira os exemplos abaixo.
Especificidade para o campo de Paymentttype
Paymenttype via DICT - apresenta os dados cadastrados no Painel da Aplicação, opção Configurar Jornadas, campo Dados de recebimento
Paymenttype via MANU - é necessário passar os blocos “creditor” e “creditorAccount, conforme exemplo no esboço abaixo.
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