Skip to main content
O domínio Billing gerencia o ciclo financeiro das vendas de passagens: pagamento, conciliação de recebíveis, saldo e transferência no provedor de billing. Quando uma compra usa crédito corporativo, o uso do crédito é registrado por Ticket no domínio Credit Grant. O Billing registra Payment, Receivable e Transfer apenas quando há valor externo ou dinheiro a cobrar; compras quitadas integralmente por crédito podem confirmar sem Payment.

​
Entidades

Payment Lifecycle

Métodos, status e fluxos de pagamento; confirmação via webhook do provedor.

Cash Settlements

Prestação de contas de dinheiro recebido em vendas.

Billing Provider

Contrato genérico de integração e configuração externa por Cooperative.

Receivables

Recebíveis sincronizados do provider para conciliação financeira.

Transfers

Saques do saldo da cooperativa no provedor de billing.

​
Fluxo de Billing

​
Conceitos-Chave

  • Payment é a cobrança financeira opcional de um Order (relação 1:1 opcional). A confirmação chega via webhook do provedor (PaymentStatus = PAID) ou pode nascer confirmada em POS/Driver App com dinheiro.
  • CashSettlement é a prestação individual criada e enviada automaticamente para cada CheckoutSession CASH confirmada.
  • Billing Provider define a superfície de integração para pagamentos, recebíveis e transferências.
  • PaymentMethod pertence ao Customer e funciona como proxy local do gateway.
  • CooperativePaymentSettings guarda a configuração externa de billing da cooperativa, incluindo a API key criptografada.
  • Receivable é o registro de conciliação de valores a receber por cooperativa, sincronizado do provedor. O gatewayFee é reportado pelo provedor.
  • Transfer é o saque do saldo disponível, consultado e executado no provedor de billing.
  • Entidades de billing carregam organizationId e cooperativeId para deixar explícita a cooperativa beneficiária.
  • Os métodos aceitos no modelo atual são dinheiro, PIX, cartão de crédito e cartão de débito. Crédito corporativo é ledger de Credit Grant, não PaymentMethod.
Todos os valores monetários são armazenados em centavos (integer). O gateway fee é reportado pelo provider e pode ter rate derivado para conciliação.