@criapix/saas-assinaturas-client/src/types/Status.ts

SDK JavaScript/TypeScript para o AssinaturasService - Sistema de gestão de assinaturas SaaS com processamento de pagamentos de faturas (cartão, PIX, débito), gerenciamento de métodos de pagamento, pagamentos recorrentes e análise de falhas de pagamento

import { SubscriptionStatus, InvoiceStatus } from '../enums';

export interface PaymentMethodInfoResponse {
  paymentMethodId: string;
  lastFourDigits: string;
  cardBrand: string;
  expiryDate: string;
  isDefault: boolean;
  cardHolderName?: string;
  isExpired: boolean;
  maskedCardNumber: string;
}

export interface SubscriptionStatusResponse {
  customerId: string;
  customerName: string;
  isActive: boolean;
  isDelinquent: boolean;
  hasOverdueInvoices: boolean;
  status: SubscriptionStatus;
  currentPeriodEnd?: string;
  nextInvoiceDate?: string;
  totalDue: number;
  overdueInvoices: number;
  daysOverdue: number;
  currentInvoice?: CurrentInvoiceInfo;
  paymentMethodInfo?: PaymentMethodInfoResponse;
  // Card expiry alerts
  paymentMethodExpiringSoon: boolean;
  paymentMethodExpiryDate?: string;
  daysUntilCardExpires?: number;
}

export interface CurrentInvoiceInfo {
  invoiceId: string;
  invoiceNumber: string;
  amount: number;
  amountPaid: number;
  amountDue: number;
  dueDate: string;
  status: InvoiceStatus;
  daysOverdue: number;
}

export interface SimpleActiveStatusResponse {
  isActive: boolean;
  isDelinquent: boolean;
}