alinemarjorie/api-pagarminho

api-pagarminho

Esse projeto consiste em criar uma versão simplificada de um Payment Service Provider (PSP) com o objetivo de estudos.

Requisitos básicos

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)