Compartilhe esta publicação
Meus primeiros passos na Plataforma de Desenvolvedores Elo
A plataforma de APIs foi criada para atender diferentes perfis: emissores, credenciadores, estabelecimentos comerciais e desenvolvedores independentes. Seu lançamento em 2018 veio ao encontro da busca por novas tecnologias nacionais, estimulando cada vez mais o ecossistema de desenvolvedores brasileiros. Isso porque a plataforma foi elaborada para agir como um canal de comunicação direta com os desenvolvedores e assim poder disponibilizar de maneira contínua APIs que supram as necessidades de criação.
A estratégia é a co-criação de soluções, produtos e serviços que melhorem sua experiência como cliente e a gestão do seu próprio negócio. Para isso a Plataforma de Desenvolvedores da Elo se apoia na interatividade constante com desenvolvedores, alta performance e apresentação otimizada para os tomadores de decisão de negócios, utilizando documentação rica, ambiente de testes e de fácil implementação.
A partir de seu cadastro na plataforma você terá acesso a APIs de 4 categorias: Dados, Segurança, Pagamento e Benefícios. Entre elas:
- Tabela de BINs:
API de Tabela de Bins possui foco em e-commerces, sendo que ela possibilita aos estabelecimentos comerciais identificar uma transação Elo e realizar o roteamento adequado de autorização. Ela também facilita todo o processo, possibilitando a utilização destas informações na prevenção de fraudes.
O uso da API de Bins traz uma série de outras vantagens. Após o reconhecimento do BIN, o sistema disponibiliza um conjunto de dados úteis ao portador respondendo às seguintes perguntas:
O cartão pode ser utilizado em outros países?
Qual sua categoria de financiamento? Crédito, débito, múltiplo (ambos)?
Trata-se de um cartão físico ou virtual?
Que banco realizou sua emissão?
Qual é a bandeira do cartão?
Quais seus tipos de uso? (Crédito à Vista, Crédito Parcelado pela Loja, Débito...)
Quais benefícios ao portador o cartão oferece? (ex: Seguro Viagem)
- Elo Valida Dados:
Tal API apresenta um mecanismo de segurança que permite a obtenção de um score avaliando o risco de fraude. Ela toma como base o comportamento de consumo e as transações do portador de cartão.
A pontuação provida pela API irá auxiliar na identificação de possíveis fraudes. A partir dessas informações o cliente pode tomar decisões de cancelamento de cartão ou ações em pagamentos feitos por usuários. A API pode ser usada no processo de abertura de contas e é indicada para adquirentes e emissores de cartão.
- Elo Emailage - Verificação do risco de e-mail:
Esta API fornece uma avaliação de risco de fraudes da credencial de e-mails. O mecanismo de segurança da API apresenta um score que vai direcionar o cliente na identificação de e-mails provavelmente inseguros ou mesmo já conhecidos por fraudes.
Dependendo do score apresentado o cliente poderá negar o cadastro ou ações de um usuário em um sistema importante como o de meios de pagamentos. Pode ser utilizada na abertura de contas ou na manutenção das mesmas.
- Tokenização:
Amplia as opções de pagamento, indo além das limitações físicas do cartão, diminuindo a burocracia durante processo de pagamento e garantindo uma flexibilidade maior na abordagem. É importante destacar o benefício da segurança em função do token. Isso porque ocorre a guarda do CardId (identificador de cartão previamente cadastrado). O resultado é uma menor fricção, já que não há necessidade de pedir novamente as informações e também há redução do risco de perda de dados sensíveis e de fraudes
- Verificação de Conta:
Por meio de um mecanismo facilitado e seguro, a API ajuda Comerciantes e Adquirentes a efetuarem a verificação de contas tendo uma comunicação direta com os bancos.
- Cadastro do Portador:
Auxilia na experiência de cadastro e personaliza o serviço nas plataformas Elo e Apps de Parceiros.
Criando sua conta
Agora que você sabe um pouco mais sobre a Plataforma de Desenvolvedores da Elo, basta aprender os primeiros passos para realizar o seu cadastro:
1. Fique atento à Introdução ao GraphQL para conhecer exemplos reais de uso de nossas APIs.
O GraphQL é um padrão amplamente aceito dentro da comunidade de desenvolvedores e um dos seus maiores cases de sucesso foi a rede social Facebook. Trata-se de uma linguagem de consultas (QL - Query Language) para grafos na qual o desenvolvedor consulta os nós (nodes) e também as conexões entre eles (connection edges).
Seu diferencial dentre as outras abordagens, como a REST, é que no GraphQL há somente um endpoint para qual as consultas (queries) ou mutações (mutations) são enviadas. Um dos principais problemas encontrados na REST foi solucionado pelo GraphQL: fornecer exatamente o que o cliente precisa. O que significa navegar relacionamentos com outros nós em uma única consulta, melhorando o tráfego de informações ao cliente.
Dessa forma, a escolha do GraphQL na plataforma da Elo vem em resposta a uma série de benefícios que esta linguagem de consulta traz ao desenvolvimento de APIs modernas, seja facilitando o trabalho do desenvolvedor na hora de realizar requisições ou através de toda sua estrutura, formada principalmente por subscriptions, queries e mutations. Além disso, o GraphQL permite que o desenvolvedor trabalhe em conjunto com quaisquer outras linguagem para consumir uma API.
2. Crie um usuário no portal do desenvolvedor.
Antes que você inicie sua jornada dentro da Plataforma de APIs da Elo, é preciso que você crie um usuário. O cadastro pode ser realizado de 3 formas: utilizando login da conta Google, login da conta no GitHub ou outro email de sua preferência que não esteja vinculado a estas contas.
O cadastro realizado lhe dará a possibilidade de consumir as APIs da Elo e a criar novas aplicações para o consumo das mesmas. Quando já existir uma integração estabelecida do parceiro às APIs da Elo, ele poderá se tornar um dos quatro tipos de usuários abaixo:
Card Holder: usuário é portador de um ou mais cartões da bandeira Elo, podendo assim cadastrar, consultar, editar, deletar seus cartões ou mesmo associá-los as suas carteiras digitais;
Card Issuer: usuário emissor de cartões Elo;
Merchant: estabelecimento comercial que realiza transações com cartões Elo;
Acquirer: usuário captura transações feitas com cartões Elo em estabelecimentos.
Cada categoria possui sua forma de associação, sendo que o usuário pode ser ligado ao mesmo tempo a somente um tipo. Por exemplo, se um usuário está associado a um Card Holder e tenta se associar a um Merchant haverá um erro. Será necessário remover a associação do Card Holder do usuário e, apenas depois, efetuar a associação a nova categoria.
3. Cadastre sua primeira aplicação.
Assim que o cadastro no portal for concluído você poderá criar suas aplicações e a partir daí obterá acesso às APIs públicas da Elo. Nesse momento serão disponibilizadas duas chaves: client_id e client_secret. No primeiro caso trata-se de um identificador gerado após o desenvolvedor criar a aplicação no portal, senso utilizado pela API para averiguar e validar qual a aplicação está utilizando os recursos disponíveis.
Vale destacar que este usuário do portal da Elo não apresenta relação com o usuário da API de Cadastro de Portador.
4. Utilize o dashboard para acessar suas configurações de acesso.
5. Utilize o console de GraphQL.
Localizado na seção de referência, o console irá ajudar a explorar com mais agilidade as APIs na página de documentação. Ele também permite que você faça consultas de exemplo, assim como executar ou alterar suas aplicações.
O que fazer depois de criada minha aplicação?
É importante compreender que a Plataforma Elo apresenta dois ambientes: homologação e produção, sendo o primeiro uma área de testes. Portanto, sua aplicação já começa com acesso liberado no ambiente de homologação. Quando sua aplicação estiver finalizada e pronta para o usuário final você deverá ativar o ambiente de produção.
Dessa forma é necessário acessar "Minhas aplicações", selecionar sua aplicação na lista, e em seguida solicitar a ativação da sua URL de produção. Com isso será preciso que você responda um formulário. Após seu preenchimento, basta aguardar a análise do pedido e o posterior recebimento do link de produção.
Documentação técnica
Um componente essencial que vai auxiliar o desenvolvedor no melhor aproveitamento da plataforma da Elo é a documentação. A plataforma oferece um ambiente colaborativo no qual o usuário encontrará a documentação de cada uma de nossas APIs
Além de conter instruções de como utilizar a API fornecida, apresenta exemplos de consultas de APIs que podem ser copiados e colados no ambiente de teste, ajudando o desenvolvedor a colocar em prática seu trabalho.
Uma documentação rica é um dos pilares para aproveitar a API em sua totalidade e saber trabalhar com suas funcionalidades. Logo, para que os desenvolvedores possam dar início aos seus projetos é necessário que eles se apoiem em exemplos de consultas de APIs para criarem e evoluírem suas aplicações com mais facilidade ao longo do tempo. Caso a documentação técnica não se encontre atualizada e detalhada ela atuará como uma barreira para manutenções futuras.
Um código que poderá ser encontrado na documentação da plataforma é o snippet. Ele representa uma pequena parte do código fonte que pode ser utilizada para acelerar o desenvolvimento de código. A partir do uso de snippets codes o desenvolvedor não precisa digitar códigos repetitivos durante o curso da programação de rotina, ou seja, os códigos ficam mais padronizados.
Estes códigos auxiliam na formatação específica para funções. Algumas delas podem ser complexas demais ou mesmo apresentar uma sintaxe difícil de recordar. Através de códigos snippets o desenvolvedor consegue manter seu código como um todo mais consistente. Outro ponto que vale a pena mencionar: eles são compartilháveis.
Dessa forma, se você faz parte de uma equipe que trabalha em um projeto, utilizar códigos snippets garante que todos os membros desenvolveram os blocos de texto da mesma forma e faz com que o código seja mais legível no final.
Texto originalmento disponibilizado na plataforma da Elo
Este artigo foi escrito por Leandro Estrada e publicado originalmente em Prensa.li.