Files
canina/backend/src/payment/interfaces/payment-gateway.interface.ts
T

56 lines
1.3 KiB
TypeScript

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<PaymentRequestResult>;
verifyPayment(trackId: string | number): Promise<PaymentVerifyResult>;
inquiryPayment(trackId: string | number): Promise<PaymentInquiryResult>;
getStartUrl(trackId: string | number): string;
checkHealth(): Promise<GatewayHealthResult>;
}