HP

HubPay

Documentação do produto e da API

Live demo

HubPay

Sistema simples para gestão de clientes, cobranças e pagamentos

HubPay é a nova apresentação do projeto HubPay. O foco agora é deixar claro, na primeira abertura, como cadastrar clientes, criar cobranças e acompanhar recebimentos sem fricção.

Direção de produto

Público ideal

Pequenos negócios, freelancers, autônomos e profissionais que precisam controlar clientes e recebimentos sem complexidade.

Experiência principal

Dashboard com resumo do mês, status das cobranças, clientes recentes e atalhos para nova cobrança e novo cliente.

Arquitetura técnica

A arquitetura original foi preservada: API + Application + Domain + Infrastructure.

Camada Responsabilidade
HubPay.DomainEntidades, regras de negócio e value objects.
HubPay.ApplicationCasos de uso, DTOs e serviços de aplicação.
HubPay.InfrastructurePersistência com EF Core e repositórios.
HubPay.APIMinimal API, autenticação e console web.

Endpoints principais

Conta

POST /merchants
POST /merchants/{id}/api-keys
POST /merchants/{id}/api-keys/revoke

Clientes

POST /customers
GET /customers
GET /customers/{id}

Cobranças e pagamentos

POST /payments
GET /payments
GET /payments/{id}
GET /payments/{id}/events
POST /payments/{id}/authorize
POST /payments/{id}/pay
POST /payments/{id}/refuse
POST /payments/{id}/cancel

Webhooks (opcional)

POST /webhooks
GET /webhooks
POST /webhooks/{id}/disable

Fluxo principal de uso

  1. Crie a conta da loja e gere a chave de API.
  2. Cadastre clientes.
  3. Crie cobranças por cliente.
  4. Acompanhe o status da cobrança (pendente, em análise, pago, recusado, cancelado).
  5. Use o histórico de eventos para auditar alterações.

Stack

.NET 10 ASP.NET Core Minimal API EF Core PostgreSQL Swagger