Criando fintechs em minutos #1 — De trocos a mesadas
Recentemente fui finalista de um Hackathon da Ciab Febraban, apresentando um projeto que descarta a necessidade de um cartão &/ou bandeira em suas transações, deixando-as mais baratas e acessíveis tecnologicamente; no evento tive a oportunidade de presenciar milhares de ideias e projetos inovadores que iremos recriar suas funcionalidades de cobrança nessa serie de posts; o intuito dessa serie é mostrar a facilidade de criar soluções financeiras utilizando tecnologia CoinStock. Nenhuma das soluções cujo iremos desenvolver entrará em mercado ou sera levada para frente, portanto: Conteúdo exclusivo para fins educacionais!
Neste post, iremos modificar um dos projetos vencedores para que seja possível aplicarmos APIs da CoinStock, neste caso quase recriar ele por completo na parte tecnológica dando outro fim a ele, apenas inspiração.
Mãos na massa!
Nossa solução será um cartão de debito/credito cujo ira arredondar todas as transações para valores completos e transferir o monteante restante para outro cartão na forma de saldo… Iremos nomear o aplicativo de Minha Mesada
Historia: Eu, tenho um filho de 13 anos e gostaria de começar a dar mesada para o mesmo, então irei utilizar o minha mesada para sempre que minhas compras forem “quebradas” eu consiga arredondar o valor e transferir ao meu filho, exemplo: comprei uma caneca escrito “Alo Alo Marciano” e ela me custou R$17.49, O preço a ser debitado do cartão será R$17.49(Produto) + R$2.51(Serviços, no caso: Minha Mesada), totalizando R$20.00. O restante arredondado(R$2.51) será transferido pra conta declarada do Minha Mesada, neste caso a do meu filho.
Agora que já entendemos a parte tecnológica do aplicativo e ignoramos a parte de negócios pois não vem a finalidade deste post podemos começar a selecionar as APIs que iremos utilizar:
Como utilizaremos a biblioteca PHP das funções da CoinStock, a primeira que devemos conhecer é a createvirtualcard() — ela esta disponivel para chamada cURL, PHP, JavaScript, Java e Python!
Os parâmetros dela são chartext, type, country, includepreset(opcional), aonde chartext é o Nome que sera impresso no cartão virtual, tipo dele(atualmente a CoinStock esta disponibilizando abertamente só a função pré-pago, mas sua chamada é por debit) e caso haja um preset com as demais configurações de emissão( e muito chatas )
O retorno dessa função será um JSON, contendo as informações que passamos na função, no meu caso a presetBrasil é um aglomerado de funções necessárias pra solicitar o cartão, com dados gerados da internet que não pertencem a ninguém(pelo menos enquanto escrevia este post HAHA)
Response: 200 SUCCESS:
Como é crime armazenar as informações do cartão em seu banco de dados, iremos solicitar o token de transação! ele já lhe retornada todas essas informações de maneira mais segura e pratica:
Seu retorno sera um JSON, cujo seu cada é o token que iremos utilizar para efetuar as alterações sempre que o saldo não for inteiro, no nosso caso em nossa testnet o token é BRA3KD79S4P0JMQ e esta salvo na variável $token seu retorno JSON inteiro.
A CoinStock já disponibiliza uma serie de APIs incríveis, e estão sempre produzindo novas, para nossa felicidade já existe a API para verificar o saldo e arredondar a compra, vamos lá!
Simulando uma transação no dashboard CardDeveloper, fiz uma alteração de R$195.99. Se utilizarmos nossa API de consulta de saldo, que é a verifybalance() teremos um JSON com muitas informações, mas vamos focar em uma só:
Vimos que temos um valor quebrado, isso é o que queremos para criar nossa função de arredondar e transferir para outro cartão! mas a função que vai arredondar só solicita o valor e não o JSON inteiro, pra isso vamos utilizar a função do PHP: json_decode passando nossa verifybalance, e depois passar nossa função de arredondamento roundofftransaction() e depois a changebalance():
Agora vamos verificar o saldo da outra conta?
O retorno sera: 4.01!! como estamos no ambiente de testes não foram consumidas as taxas, para saber quanto custa cada API consulte a documentação da CoinStock clicando aqui
Temos aqui uma demonstração da facilidade do uso das APIs de consumo da CoinStock, o script acima esta pronto para inclusive funcionar em um cartão caso você execute um cronjob(em ambiente de testes, cujo as verificações de segurança estão desabilitadas).
Sabia que a CoinStock Hub esta chamando todos a um beta-fechado no Brasil? inscreva-se agora mesmo para utilizar essas APIs!
