CompanyCreditPurchase

​

Campos

​

Relacionamentos

• Relaciona-se com CompanyCreditAccount.
• Relaciona-se com Company.
• Relaciona-se com Cooperative.
• Relaciona-se 1:1 com Payment.
• Relaciona-se com Organization.
• Relaciona-se com User, quando houver solicitante.

​

Regras de Negócio

• A Company deve escolher uma Cooperative no request de criação.
• A Cooperative deve estar ativa e possuir CooperativePaymentSettings ativa.
• A cobrança é criada no provider usando a conta externa da Cooperative.
• Payment.status é a fonte de verdade do estado financeiro e é retornado junto da compra para polling.
• Quando o Payment fica PAID, o valor aumenta purchasedAmount e availableAmount na CompanyCreditAccount exatamente uma vez.
• creditedAt funciona como marcador idempotente da incorporação ao saldo; não representa aprovação.
• A compra não cria Ticket.
• Créditos comprados ficam disponíveis para a Company distribuir aos funcionários.
• amount é armazenado em centavos.
• Payment não pago, recusado, cancelado ou estornado não cria novo saldo.
• O comprovante operacional combina code, amount, Cooperative, creditedAt e Payment.

​

Example

{
  "companyCreditPurchaseId": "01980d3b-5572-720b-a381-60129cd8b20b",
  "companyCreditAccountId": "01980d3a-4ae8-7d72-b569-5d6526736dd1",
  "organizationId": "0197a801-1690-7590-b3cf-19599b9be3e4",
  "companyId": "0197a801-6a42-79aa-9e56-d3c85148c0fa",
  "cooperativeId": "0197a800-24e6-76a2-90ed-ff0f6fba7b0c",
  "paymentId": "0197a816-281b-72e7-8f50-286fbfc5c08d",
  "purchasedByUserId": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "code": "CCP-20260704-0001",
  "amount": 1000000,
  "creditedAt": "2026-07-04T09:30:00.000Z",
  "payment": {
    "paymentId": "0197a816-281b-72e7-8f50-286fbfc5c08d",
    "status": "PAID",
    "method": "CREDIT_CARD",
    "amount": 1000000
  },
  "createdBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "createdAt": "2026-07-04T09:00:00.000Z",
  "updatedBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "updatedAt": "2026-07-04T09:30:00.000Z"
}