Paynow

---

Sobre o projeto

Uma escola de programação, a CodePlay, decidiu lançar uma plataforma de cursos online de programação. Você já está trabalhando nesse projeto e agora vamos começar uma nova etapa: uma ferramenta de pagamentos capaz de configurar os meios de pagamentos e registrar as cobranças referentes a cada venda de curso na CodePlay. O objetivo deste projeto é construir o mínimo produto viável (MVP) dessa plataforma de pagamentos. Na plataforma de pagamentos temos dois perfis de usuários: os administradores da plataforma e os donos de negócios que querem vender seus produtos por meio da plataforma, como as pessoas da CodePlay, por exemplo. Os administradores devem cadastrar os meios de pagamento disponíveis, como boletos bancários, cartões de crédito, PIX etc, especificando detalhes de cada formato. Administradores também podem consultar os clientes da plataforma, consultar e avaliar solicitações de reembolso, bloquear compras por suspeita de fraudes etc. Já os donos de negócios devem ser capazes de cadastrar suas empresas e ativar uma conta escolhendo quais meios de pagamento serão utilizados. Devem ser cadastrados também os planos disponíveis para venda, incluindo seus valores e condições de desconto de acordo com o meio de pagamento. E a cada nova venda realizada, devem ser armazenados dados do cliente, do produto selecionado e do meio de pagamento escolhido. Um recibo deve ser emitido para cada pagamento e esse recibo deve ser acessível para os clientes finais, alunos da CodePlay no nosso contexto.

Requisitos Necessários:

• Ruby 3.0.1
• Rails 6.1.3.2

Gems adcionais

• Testes
• Rspec
• Capybara
• Shouda Matchers

• Autenticação/Autorização
• Devise

Funcionalidades

Usuários administradores

• Gerenciam meios de pagamentos
• Gerenciam empresas cadastradas na plataforma

Clientes Paynow

• Cadastram empresas na plataforma
• Contratam meios de pagamentos disponíveis
• Cadastram e gerenciam produtos na plataforma

Para executar o projeto:

• Clone em sua máquina

git clone https://github.com/weslley6216/PayNow.git

Instale as dependências

cd PayNow
bin/setup

Configure o Banco de Dados

Realize a criação de dados preexistentes no banco de dados com o comando

rails db:seed

Execute a aplicação

rails s

Acesse

http://localhost:3000

Demais observações

• Usuários administradores só podem ser cadastrados via console e tem como obrigatoriedade a utilização do domínio @paynow.com.br no momento do cadastro. Para logar com um usuário administrador pré-cadastrado acesse http://localhost:3000/admins/sign_in e faça login na aplicação com o email e senha abaixo:

email: [email protected], senha: 123456

• Usuários clientes podem ser cadastrados normalmente via homepage exceto com os domínios de públicos como gmail.com, hotmail.com, yahoo.com.br ou paynow.com.br.

• Também é possível logar como usuário pré-cadastrado com o seguinte email abaixo:

email: [email protected], senha: 123456

API

Registro de cliente final

POST /api/v1/final_clients

• o endpoint para criação e associação de um cliente externo e uma empresa cliente PayNow, espera receber os seguintes parâmetros:

 {
	"final_client": 
	 { 
		 "name": "João Silvaa", 
		 "cpf": "12345678900" 
	 },
	"company_token": "d9iYYR9T8Pm6CZ8VSoQ4"  
 }

Possíveis Respostas

• HTTP Status: 201 - Criado com Sucesso

Exemplo:

{
  "name": "João Silvaa",
  "cpf": "12345678900",
  "token": "TBuPqLQTTyjjyPcj3tB5"
}

• HTTP Status: 422 - Parâmetros inválidos para criação de cliente (parametros em branco ou não respeitando as validações)

Exemplo:

{
  "name": [
    "não pode ficar em branco"
  ],
  "cpf": [
    "não pode ficar em branco",
    "não é um número",
    "não possui o tamanho esperado (11 caracteres)"
  ]
}

post '/api/v1/charges'

• o endpoint para criação de cobrança:

{
	"charge": 
	{

          "company_token": "zwen2nD94hetVELagMdD",
          "product_token": "19qGYnK7WewzP1R33LnK",
          "payment_method_id": "1",
          "final_client_token": "EBSQz4UbZBnSt32A8tmN",
          "bank_slip_id": "1",
          "address": "Colméias, 83",
          "district": "Alvarenga",
          "zip_code": "09856-280",
          "city": "São Bernardo do Campo - SP"

        }
}

Possíveis Respostas

• HTTP Status: 201 - Criado com Sucesso

Exemplo:

{
  "original_value": "49.9",
  "discounted_amount": "40.918",
  "token": "W5N8iBaukrC76frPmz3h",
  "status": "pending",
  "card_number": null,
  "card_holder_name": null,
  "cvv": null,
  "address": "Colméias, 83",
  "district": "Alvarenga",
  "zip_code": "09856-280",
  "city": "São Bernardo do Campo - SP"
}

• HTTP Status: 422 - Parâmetros inválidos para criação de cliente (parametros em branco ou não respeitando as validações)

{
  "errors": "parâmetros inválidos"
}

get '/api/v1/charges'

• o endpoint para visualização de todas as cobranças:

  {
    "company_token": "zwen2nD94hetVELagMdD"
  }  
  

Possíveis Respostas

• HTTP Status: 200 - OK

Exemplo:

[
  {
    "original_value": "49.9",
    "discounted_amount": "40.9",
    "token": "2qXUtBZfdVDqGC7cvLNX",
    "status": "pending",
    "card_number": null,
    "card_holder_name": null,
    "cvv": null,
    "address": null,
    "district": null,
    "zip_code": null,
    "city": null
  }
]

• HTTP Status: 404 - Parâmetros inválidos para criação de cliente (parametros em branco ou não respeitando as validações)

{
  "errors": "parâmetros inválidos"
}