gabriel-abn/pagarme-psp

Desafio Software Engineer, Back-end - Pagar.me

O desafio proposto é desenvolver uma versão super simplificada de um Payment Service Provider (PSP) como o Pagar.me aprender um pouco mais sobre como funcionam pagamentos no Brasil.

Contexto

Em sua essência um PSP tem duas funções muito importantes:

1. Permitir que nossos clientes processem transações ("cash-in")
2. Efetuar os pagamentos dos recebíveis para os nossos clientes ("cash-out")

No Pagar.me, nós temos duas entidades que representam essas informações:

• transactions: que representam as informações da compra, dados do cartão, valor, etc
• payables: que representam os recebíveis que pagaremos ao cliente

Nota: quando um cliente passa uma transação de crédito, ele normalmente recebe o valor em média apenas 30 dias depois (o que chamamos de D+30), porque é assim que a cadeia financeira (bancos, bandeiras, adquirentes) funciona. Porém é possível receber esse valor antes dos 30 dias através de um mecanismo chamado "antecipação". Se tiver curiosidade, a gente tem artigo que explica sobre isso, mas isso não é necessário para realizar esse desafio: https://pagarme.zendesk.com/hc/pt-br/articles/217029766-O-que-%C3%A9-antecipa%C3%A7%C3%A3o-

Requisitos

Você deve criar um serviço com os seguintes requisitos:

1. O serviço deve processar transações, recebendo as seguintes informações:
   • Valor da transação
   • Descrição da transação. Ex: 'Smartband XYZ 3.0'
   • Método de pagamento (debit_card ou credit_card)
   • Número do cartão
   • Nome do portador do cartão
   • Data de validade do cartão
   • Código de verificação do cartão (CVV)
2. O serviço deve retornar uma lista das transações já criadas
3. Como o número do cartão é uma informação sensível, o serviço só pode armazenar e retornar os 4 últimos dígitos do cartão.
4. O serviço deve criar os recebíveis do cliente (payables), com as seguintes regras:
   • Se a transação for feita com um cartão de débito:
     • O payable deve ser criado com status = paid (indicando que o cliente já recebeu esse valor)
     • O payable deve ser criado com a data de pagamento (payment_date) = data da criação da transação (D+0).
   • Se a transação for feita com um cartão de crédito:
     • O payable deve ser criado com status = waiting_funds (indicando que o cliente vai receber esse dinheiro no futuro)
     • O payable deve ser criado com a data de pagamento (payment_date) = data da criação da transação + 30 dias (D+30).
5. No momento de criação dos payables também deve ser descontado a taxa de processamento (que chamamos de fee) do cliente. Ex: se a taxa for 5% e o cliente processar uma transação de R$100,00, ele só receberá R$95,00. Considere as seguintes taxas:
   • 3% para transações feitas com um cartão de débito
   • 5% para transações feitas com um cartão de crédito
6. O serviço deve prover um meio de consulta para que o cliente visualize seu saldo com as seguintes informações:
   • Saldo available (disponível): tudo que o cliente já recebeu (payables paid)
   • Saldo waiting_funds (a receber): tudo que o cliente tem a receber (payables waiting_funds)

Nota: neste desafio, você não precisa se preocupar com parcelamento.

Restrições

1. O serviço deve ser escrito em Node.js
2. O serviço deve armazenar informações em um banco de dados. Você pode escolher o banco que achar melhor. Aqui no Pagar.me usamos amplamente PostgreSQL
3. O projeto deve ter um README.md com todas as instruções sobre como executar e testar o projeto e os serviços disponibilizados.
4. O projeto deve conter testes automatizados.