export interface PaymentRequestOptions { amountRials: number; callbackUrl: string; orderId?: string; mobile?: string; description?: string; } export interface PaymentRequestResult { result: number; trackId: string | number; message?: string; paymentUrl?: string; } export interface PaymentVerifyResult { result: number; refNumber?: string; cardNumber?: string; amount?: number; paidAt?: string; message?: string; } export interface PaymentInquiryResult { result: number; status?: number; amount?: number; refNumber?: string; cardNumber?: string; paidAt?: string; message?: string; } export interface GatewayHealthResult { gatewayName: string; status: 'ONLINE' | 'DEGRADED' | 'OFFLINE'; latencyMs: number; merchantConfigured: boolean; activeMerchant: string; message: string; checkedAt: Date; } /** * Standard Payment Gateway Interface (Strategy / Gateway Adapter Pattern) */ export interface IPaymentGateway { getGatewayName(): string; requestPayment(options: PaymentRequestOptions): Promise; verifyPayment(trackId: string | number): Promise; inquiryPayment(trackId: string | number): Promise; getStartUrl(trackId: string | number): string; checkHealth(): Promise; }