feat: ( payment ) create provider interface + types

apps/edr-passenger-api/src/modules/payments/payments.types.ts

@@ -0,0 +1,34 @@
+import { PaymentIntentStatus, PaymentMethodType } from '@prisma/client';
+
+export interface ClientAction {
+  type: 'REDIRECT';
+  url: string;
+}
+
+export interface ProviderInitiationInput {
+  merchantOrderId: string;
+  bookingRef: string;
+  amountMinor: number;
+  currency: string;
+}
+
+export interface ProviderInitiationResult {
+  providerOrderId: string;
+  clientAction: ClientAction;
+  expiresAt: Date;
+  rawInitiation: Record<string, unknown>;
+}
+
+export interface ProviderStatus {
+  status: PaymentIntentStatus;
+  providerTxnId?: string;
+  failureCode?: string;
+  failureMessage?: string;
+  rawResponse: Record<string, unknown>;
+}
+
+export interface PaymentProvider {
+  readonly method: PaymentMethodType;
+  initiate(input: ProviderInitiationInput): Promise<ProviderInitiationResult>;
+  queryStatus(merchantOrderId: string): Promise<ProviderStatus>;
+}

apps/edr-passenger-api/src/modules/payments/providers/payment-provider.interface.ts

@@ -0,0 +1,9 @@
+export type {
+  PaymentProvider,
+  ProviderInitiationInput,
+  ProviderInitiationResult,
+  ProviderStatus,
+  ClientAction,
+} from '../payments.types';
+
+export const PAYMENT_PROVIDERS = Symbol('PAYMENT_PROVIDERS');