@aibrains/shared-types 0.9.2 → 0.10.1

package/dist/schemas/finance/payment.schema.d.ts

@@ -0,0 +1,794 @@
+/**
+ * Payment & Receipt Schemas
+ *
+ * Gateway-agnostic payment types supporting eSewa, Khalti, and manual methods.
+ * The frontend NEVER handles gateway credentials — all secrets stay server-side.
+ *
+ * Payment lifecycle: pending → processing → completed | failed | cancelled → refunded
+ */
+import { z } from 'zod';
+export declare const refundResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    paymentId: z.ZodString;
+    amount: z.ZodNumber;
+    reason: z.ZodString;
+    gatewayRefundId: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<["pending", "completed", "failed"]>;
+    refundedAt: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: "completed" | "pending" | "failed";
+    createdAt: string;
+    reason: string;
+    id: string;
+    amount: number;
+    paymentId: string;
+    refundedAt: string | null;
+    gatewayRefundId?: string | undefined;
+}, {
+    status: "completed" | "pending" | "failed";
+    createdAt: string;
+    reason: string;
+    id: string;
+    amount: number;
+    paymentId: string;
+    refundedAt: string | null;
+    gatewayRefundId?: string | undefined;
+}>;
+export type Refund = z.infer<typeof refundResponseSchema>;
+export declare const paymentResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    invoiceId: z.ZodString;
+    studentAccountId: z.ZodString;
+    schoolId: z.ZodString;
+    amount: z.ZodNumber;
+    currency: z.ZodEnum<["NPR"]>;
+    gateway: z.ZodEnum<["esewa", "khalti", "fonepay", "connectips", "stripe", "cash", "bank_transfer", "cheque"]>;
+    gatewayTransactionId: z.ZodOptional<z.ZodString>;
+    gatewaySessionId: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<["pending", "processing", "completed", "failed", "cancelled", "refunded", "partially_refunded"]>;
+    paidAt: z.ZodNullable<z.ZodString>;
+    paidBy: z.ZodNullable<z.ZodString>;
+    receiptNumber: z.ZodNullable<z.ZodString>;
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    refunds: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        paymentId: z.ZodString;
+        amount: z.ZodNumber;
+        reason: z.ZodString;
+        gatewayRefundId: z.ZodOptional<z.ZodString>;
+        status: z.ZodEnum<["pending", "completed", "failed"]>;
+        refundedAt: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        status: "completed" | "pending" | "failed";
+        createdAt: string;
+        reason: string;
+        id: string;
+        amount: number;
+        paymentId: string;
+        refundedAt: string | null;
+        gatewayRefundId?: string | undefined;
+    }, {
+        status: "completed" | "pending" | "failed";
+        createdAt: string;
+        reason: string;
+        id: string;
+        amount: number;
+        paymentId: string;
+        refundedAt: string | null;
+        gatewayRefundId?: string | undefined;
+    }>, "many">>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: "completed" | "pending" | "failed" | "cancelled" | "processing" | "refunded" | "partially_refunded";
+    createdAt: string;
+    updatedAt: string;
+    schoolId: string;
+    id: string;
+    amount: number;
+    currency: "NPR";
+    studentAccountId: string;
+    invoiceId: string;
+    gateway: "esewa" | "khalti" | "fonepay" | "connectips" | "stripe" | "cash" | "bank_transfer" | "cheque";
+    paidAt: string | null;
+    paidBy: string | null;
+    receiptNumber: string | null;
+    metadata: Record<string, unknown>;
+    refunds: {
+        status: "completed" | "pending" | "failed";
+        createdAt: string;
+        reason: string;
+        id: string;
+        amount: number;
+        paymentId: string;
+        refundedAt: string | null;
+        gatewayRefundId?: string | undefined;
+    }[];
+    gatewayTransactionId?: string | undefined;
+    gatewaySessionId?: string | undefined;
+}, {
+    status: "completed" | "pending" | "failed" | "cancelled" | "processing" | "refunded" | "partially_refunded";
+    createdAt: string;
+    updatedAt: string;
+    schoolId: string;
+    id: string;
+    amount: number;
+    currency: "NPR";
+    studentAccountId: string;
+    invoiceId: string;
+    gateway: "esewa" | "khalti" | "fonepay" | "connectips" | "stripe" | "cash" | "bank_transfer" | "cheque";
+    paidAt: string | null;
+    paidBy: string | null;
+    receiptNumber: string | null;
+    gatewayTransactionId?: string | undefined;
+    gatewaySessionId?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    refunds?: {
+        status: "completed" | "pending" | "failed";
+        createdAt: string;
+        reason: string;
+        id: string;
+        amount: number;
+        paymentId: string;
+        refundedAt: string | null;
+        gatewayRefundId?: string | undefined;
+    }[] | undefined;
+}>;
+export type Payment = z.infer<typeof paymentResponseSchema>;
+/** Frontend sends this to initiate a gateway payment */
+export declare const initiatePaymentSchema: z.ZodObject<{
+    invoiceId: z.ZodString;
+    gateway: z.ZodEnum<["esewa", "khalti", "fonepay", "connectips", "stripe", "cash", "bank_transfer", "cheque"]>;
+    amount: z.ZodNumber;
+    currency: z.ZodDefault<z.ZodEnum<["NPR"]>>;
+    returnUrl: z.ZodString;
+    cancelUrl: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    amount: number;
+    currency: "NPR";
+    invoiceId: string;
+    gateway: "esewa" | "khalti" | "fonepay" | "connectips" | "stripe" | "cash" | "bank_transfer" | "cheque";
+    returnUrl: string;
+    cancelUrl: string;
+}, {
+    amount: number;
+    invoiceId: string;
+    gateway: "esewa" | "khalti" | "fonepay" | "connectips" | "stripe" | "cash" | "bank_transfer" | "cheque";
+    returnUrl: string;
+    cancelUrl: string;
+    currency?: "NPR" | undefined;
+}>;
+export type InitiatePaymentRequest = z.infer<typeof initiatePaymentSchema>;
+/** Backend responds with redirect URL to gateway payment page */
+export declare const initiatePaymentResponseSchema: z.ZodObject<{
+    paymentSessionId: z.ZodString;
+    redirectUrl: z.ZodString;
+    expiresAt: z.ZodString;
+    /** For form_post gateways (eSewa), the form fields to auto-submit */
+    formData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    /** 'redirect' for simple URL redirect, 'form_post' for hidden form auto-submit */
+    method: z.ZodDefault<z.ZodEnum<["redirect", "form_post"]>>;
+}, "strip", z.ZodTypeAny, {
+    expiresAt: string;
+    paymentSessionId: string;
+    redirectUrl: string;
+    method: "redirect" | "form_post";
+    formData?: Record<string, string> | undefined;
+}, {
+    expiresAt: string;
+    paymentSessionId: string;
+    redirectUrl: string;
+    formData?: Record<string, string> | undefined;
+    method?: "redirect" | "form_post" | undefined;
+}>;
+export type InitiatePaymentResponse = z.infer<typeof initiatePaymentResponseSchema>;
+export declare const recordManualPaymentSchema: z.ZodObject<{
+    invoiceId: z.ZodString;
+    gateway: z.ZodEnum<["cash", "bank_transfer", "cheque"]>;
+    amount: z.ZodNumber;
+    currency: z.ZodDefault<z.ZodEnum<["NPR"]>>;
+    referenceNumber: z.ZodOptional<z.ZodString>;
+    notes: z.ZodOptional<z.ZodString>;
+    paidDate: z.ZodOptional<z.ZodString>;
+    idempotencyKey: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    amount: number;
+    currency: "NPR";
+    invoiceId: string;
+    gateway: "cash" | "bank_transfer" | "cheque";
+    notes?: string | undefined;
+    referenceNumber?: string | undefined;
+    paidDate?: string | undefined;
+    idempotencyKey?: string | undefined;
+}, {
+    amount: number;
+    invoiceId: string;
+    gateway: "cash" | "bank_transfer" | "cheque";
+    notes?: string | undefined;
+    currency?: "NPR" | undefined;
+    referenceNumber?: string | undefined;
+    paidDate?: string | undefined;
+    idempotencyKey?: string | undefined;
+}>;
+export type RecordManualPaymentDto = z.infer<typeof recordManualPaymentSchema>;
+export declare const verifyPaymentResponseSchema: z.ZodObject<{
+    payment: z.ZodObject<{
+        id: z.ZodString;
+        invoiceId: z.ZodString;
+        studentAccountId: z.ZodString;
+        schoolId: z.ZodString;
+        amount: z.ZodNumber;
+        currency: z.ZodEnum<["NPR"]>;
+        gateway: z.ZodEnum<["esewa", "khalti", "fonepay", "connectips", "stripe", "cash", "bank_transfer", "cheque"]>;
+        gatewayTransactionId: z.ZodOptional<z.ZodString>;
+        gatewaySessionId: z.ZodOptional<z.ZodString>;
+        status: z.ZodEnum<["pending", "processing", "completed", "failed", "cancelled", "refunded", "partially_refunded"]>;
+        paidAt: z.ZodNullable<z.ZodString>;
+        paidBy: z.ZodNullable<z.ZodString>;
+        receiptNumber: z.ZodNullable<z.ZodString>;
+        metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        refunds: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            paymentId: z.ZodString;
+            amount: z.ZodNumber;
+            reason: z.ZodString;
+            gatewayRefundId: z.ZodOptional<z.ZodString>;
+            status: z.ZodEnum<["pending", "completed", "failed"]>;
+            refundedAt: z.ZodNullable<z.ZodString>;
+            createdAt: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            status: "completed" | "pending" | "failed";
+            createdAt: string;
+            reason: string;
+            id: string;
+            amount: number;
+            paymentId: string;
+            refundedAt: string | null;
+            gatewayRefundId?: string | undefined;
+        }, {
+            status: "completed" | "pending" | "failed";
+            createdAt: string;
+            reason: string;
+            id: string;
+            amount: number;
+            paymentId: string;
+            refundedAt: string | null;
+            gatewayRefundId?: string | undefined;
+        }>, "many">>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        status: "completed" | "pending" | "failed" | "cancelled" | "processing" | "refunded" | "partially_refunded";
+        createdAt: string;
+        updatedAt: string;
+        schoolId: string;
+        id: string;
+        amount: number;
+        currency: "NPR";
+        studentAccountId: string;
+        invoiceId: string;
+        gateway: "esewa" | "khalti" | "fonepay" | "connectips" | "stripe" | "cash" | "bank_transfer" | "cheque";
+        paidAt: string | null;
+        paidBy: string | null;
+        receiptNumber: string | null;
+        metadata: Record<string, unknown>;
+        refunds: {
+            status: "completed" | "pending" | "failed";
+            createdAt: string;
+            reason: string;
+            id: string;
+            amount: number;
+            paymentId: string;
+            refundedAt: string | null;
+            gatewayRefundId?: string | undefined;
+        }[];
+        gatewayTransactionId?: string | undefined;
+        gatewaySessionId?: string | undefined;
+    }, {
+        status: "completed" | "pending" | "failed" | "cancelled" | "processing" | "refunded" | "partially_refunded";
+        createdAt: string;
+        updatedAt: string;
+        schoolId: string;
+        id: string;
+        amount: number;
+        currency: "NPR";
+        studentAccountId: string;
+        invoiceId: string;
+        gateway: "esewa" | "khalti" | "fonepay" | "connectips" | "stripe" | "cash" | "bank_transfer" | "cheque";
+        paidAt: string | null;
+        paidBy: string | null;
+        receiptNumber: string | null;
+        gatewayTransactionId?: string | undefined;
+        gatewaySessionId?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        refunds?: {
+            status: "completed" | "pending" | "failed";
+            createdAt: string;
+            reason: string;
+            id: string;
+            amount: number;
+            paymentId: string;
+            refundedAt: string | null;
+            gatewayRefundId?: string | undefined;
+        }[] | undefined;
+    }>;
+    invoice: z.ZodObject<{
+        id: z.ZodString;
+        invoiceNumber: z.ZodString;
+        status: z.ZodString;
+        amountDue: z.ZodNumber;
+        grandTotal: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        status: string;
+        id: string;
+        invoiceNumber: string;
+        grandTotal: number;
+        amountDue: number;
+    }, {
+        status: string;
+        id: string;
+        invoiceNumber: string;
+        grandTotal: number;
+        amountDue: number;
+    }>;
+    receipt: z.ZodNullable<z.ZodLazy<z.ZodObject<{
+        receiptNumber: z.ZodString;
+        paymentId: z.ZodString;
+        invoiceNumber: z.ZodString;
+        transactionId: z.ZodString;
+        studentName: z.ZodString;
+        studentId: z.ZodString;
+        schoolName: z.ZodString;
+        schoolAddress: z.ZodOptional<z.ZodString>;
+        schoolPhone: z.ZodOptional<z.ZodString>;
+        paidDate: z.ZodString;
+        amount: z.ZodNumber;
+        currency: z.ZodEnum<["NPR"]>;
+        gateway: z.ZodEnum<["esewa", "khalti", "fonepay", "connectips", "stripe", "cash", "bank_transfer", "cheque"]>;
+        gatewayDisplayName: z.ZodString;
+        lineItems: z.ZodArray<z.ZodObject<{
+            description: z.ZodString;
+            amount: z.ZodNumber;
+            taxAmount: z.ZodNumber;
+            total: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            total: number;
+            description: string;
+            amount: number;
+            taxAmount: number;
+        }, {
+            total: number;
+            description: string;
+            amount: number;
+            taxAmount: number;
+        }>, "many">;
+        subtotal: z.ZodNumber;
+        taxTotal: z.ZodNumber;
+        discountTotal: z.ZodNumber;
+        grandTotal: z.ZodNumber;
+        taxBreakdown: z.ZodObject<{
+            panNumber: z.ZodOptional<z.ZodString>;
+            vatNumber: z.ZodOptional<z.ZodString>;
+            taxableAmount: z.ZodNumber;
+            taxAmount: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            taxAmount: number;
+            taxableAmount: number;
+            panNumber?: string | undefined;
+            vatNumber?: string | undefined;
+        }, {
+            taxAmount: number;
+            taxableAmount: number;
+            panNumber?: string | undefined;
+            vatNumber?: string | undefined;
+        }>;
+        paidBy: z.ZodString;
+        notes: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        schoolName: string;
+        studentId: string;
+        studentName: string;
+        amount: number;
+        currency: "NPR";
+        invoiceNumber: string;
+        lineItems: {
+            total: number;
+            description: string;
+            amount: number;
+            taxAmount: number;
+        }[];
+        subtotal: number;
+        taxTotal: number;
+        discountTotal: number;
+        grandTotal: number;
+        paymentId: string;
+        gateway: "esewa" | "khalti" | "fonepay" | "connectips" | "stripe" | "cash" | "bank_transfer" | "cheque";
+        paidBy: string;
+        receiptNumber: string;
+        paidDate: string;
+        transactionId: string;
+        gatewayDisplayName: string;
+        taxBreakdown: {
+            taxAmount: number;
+            taxableAmount: number;
+            panNumber?: string | undefined;
+            vatNumber?: string | undefined;
+        };
+        notes?: string | undefined;
+        schoolAddress?: string | undefined;
+        schoolPhone?: string | undefined;
+    }, {
+        schoolName: string;
+        studentId: string;
+        studentName: string;
+        amount: number;
+        currency: "NPR";
+        invoiceNumber: string;
+        lineItems: {
+            total: number;
+            description: string;
+            amount: number;
+            taxAmount: number;
+        }[];
+        subtotal: number;
+        taxTotal: number;
+        discountTotal: number;
+        grandTotal: number;
+        paymentId: string;
+        gateway: "esewa" | "khalti" | "fonepay" | "connectips" | "stripe" | "cash" | "bank_transfer" | "cheque";
+        paidBy: string;
+        receiptNumber: string;
+        paidDate: string;
+        transactionId: string;
+        gatewayDisplayName: string;
+        taxBreakdown: {
+            taxAmount: number;
+            taxableAmount: number;
+            panNumber?: string | undefined;
+            vatNumber?: string | undefined;
+        };
+        notes?: string | undefined;
+        schoolAddress?: string | undefined;
+        schoolPhone?: string | undefined;
+    }>>>;
+    status: z.ZodEnum<["completed", "failed", "cancelled"]>;
+}, "strip", z.ZodTypeAny, {
+    status: "completed" | "failed" | "cancelled";
+    invoice: {
+        status: string;
+        id: string;
+        invoiceNumber: string;
+        grandTotal: number;
+        amountDue: number;
+    };
+    payment: {
+        status: "completed" | "pending" | "failed" | "cancelled" | "processing" | "refunded" | "partially_refunded";
+        createdAt: string;
+        updatedAt: string;
+        schoolId: string;
+        id: string;
+        amount: number;
+        currency: "NPR";
+        studentAccountId: string;
+        invoiceId: string;
+        gateway: "esewa" | "khalti" | "fonepay" | "connectips" | "stripe" | "cash" | "bank_transfer" | "cheque";
+        paidAt: string | null;
+        paidBy: string | null;
+        receiptNumber: string | null;
+        metadata: Record<string, unknown>;
+        refunds: {
+            status: "completed" | "pending" | "failed";
+            createdAt: string;
+            reason: string;
+            id: string;
+            amount: number;
+            paymentId: string;
+            refundedAt: string | null;
+            gatewayRefundId?: string | undefined;
+        }[];
+        gatewayTransactionId?: string | undefined;
+        gatewaySessionId?: string | undefined;
+    };
+    receipt: {
+        schoolName: string;
+        studentId: string;
+        studentName: string;
+        amount: number;
+        currency: "NPR";
+        invoiceNumber: string;
+        lineItems: {
+            total: number;
+            description: string;
+            amount: number;
+            taxAmount: number;
+        }[];
+        subtotal: number;
+        taxTotal: number;
+        discountTotal: number;
+        grandTotal: number;
+        paymentId: string;
+        gateway: "esewa" | "khalti" | "fonepay" | "connectips" | "stripe" | "cash" | "bank_transfer" | "cheque";
+        paidBy: string;
+        receiptNumber: string;
+        paidDate: string;
+        transactionId: string;
+        gatewayDisplayName: string;
+        taxBreakdown: {
+            taxAmount: number;
+            taxableAmount: number;
+            panNumber?: string | undefined;
+            vatNumber?: string | undefined;
+        };
+        notes?: string | undefined;
+        schoolAddress?: string | undefined;
+        schoolPhone?: string | undefined;
+    } | null;
+}, {
+    status: "completed" | "failed" | "cancelled";
+    invoice: {
+        status: string;
+        id: string;
+        invoiceNumber: string;
+        grandTotal: number;
+        amountDue: number;
+    };
+    payment: {
+        status: "completed" | "pending" | "failed" | "cancelled" | "processing" | "refunded" | "partially_refunded";
+        createdAt: string;
+        updatedAt: string;
+        schoolId: string;
+        id: string;
+        amount: number;
+        currency: "NPR";
+        studentAccountId: string;
+        invoiceId: string;
+        gateway: "esewa" | "khalti" | "fonepay" | "connectips" | "stripe" | "cash" | "bank_transfer" | "cheque";
+        paidAt: string | null;
+        paidBy: string | null;
+        receiptNumber: string | null;
+        gatewayTransactionId?: string | undefined;
+        gatewaySessionId?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        refunds?: {
+            status: "completed" | "pending" | "failed";
+            createdAt: string;
+            reason: string;
+            id: string;
+            amount: number;
+            paymentId: string;
+            refundedAt: string | null;
+            gatewayRefundId?: string | undefined;
+        }[] | undefined;
+    };
+    receipt: {
+        schoolName: string;
+        studentId: string;
+        studentName: string;
+        amount: number;
+        currency: "NPR";
+        invoiceNumber: string;
+        lineItems: {
+            total: number;
+            description: string;
+            amount: number;
+            taxAmount: number;
+        }[];
+        subtotal: number;
+        taxTotal: number;
+        discountTotal: number;
+        grandTotal: number;
+        paymentId: string;
+        gateway: "esewa" | "khalti" | "fonepay" | "connectips" | "stripe" | "cash" | "bank_transfer" | "cheque";
+        paidBy: string;
+        receiptNumber: string;
+        paidDate: string;
+        transactionId: string;
+        gatewayDisplayName: string;
+        taxBreakdown: {
+            taxAmount: number;
+            taxableAmount: number;
+            panNumber?: string | undefined;
+            vatNumber?: string | undefined;
+        };
+        notes?: string | undefined;
+        schoolAddress?: string | undefined;
+        schoolPhone?: string | undefined;
+    } | null;
+}>;
+export type VerifyPaymentResponse = z.infer<typeof verifyPaymentResponseSchema>;
+export declare const voidPaymentSchema: z.ZodObject<{
+    reason: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    reason: string;
+}, {
+    reason: string;
+}>;
+export type VoidPaymentDto = z.infer<typeof voidPaymentSchema>;
+export declare const createRefundSchema: z.ZodObject<{
+    amount: z.ZodNumber;
+    reason: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    reason: string;
+    amount: number;
+}, {
+    reason: string;
+    amount: number;
+}>;
+export type CreateRefundDto = z.infer<typeof createRefundSchema>;
+export declare const receiptLineItemSchema: z.ZodObject<{
+    description: z.ZodString;
+    amount: z.ZodNumber;
+    taxAmount: z.ZodNumber;
+    total: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    total: number;
+    description: string;
+    amount: number;
+    taxAmount: number;
+}, {
+    total: number;
+    description: string;
+    amount: number;
+    taxAmount: number;
+}>;
+export declare const receiptSchema: z.ZodObject<{
+    receiptNumber: z.ZodString;
+    paymentId: z.ZodString;
+    invoiceNumber: z.ZodString;
+    transactionId: z.ZodString;
+    studentName: z.ZodString;
+    studentId: z.ZodString;
+    schoolName: z.ZodString;
+    schoolAddress: z.ZodOptional<z.ZodString>;
+    schoolPhone: z.ZodOptional<z.ZodString>;
+    paidDate: z.ZodString;
+    amount: z.ZodNumber;
+    currency: z.ZodEnum<["NPR"]>;
+    gateway: z.ZodEnum<["esewa", "khalti", "fonepay", "connectips", "stripe", "cash", "bank_transfer", "cheque"]>;
+    gatewayDisplayName: z.ZodString;
+    lineItems: z.ZodArray<z.ZodObject<{
+        description: z.ZodString;
+        amount: z.ZodNumber;
+        taxAmount: z.ZodNumber;
+        total: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        total: number;
+        description: string;
+        amount: number;
+        taxAmount: number;
+    }, {
+        total: number;
+        description: string;
+        amount: number;
+        taxAmount: number;
+    }>, "many">;
+    subtotal: z.ZodNumber;
+    taxTotal: z.ZodNumber;
+    discountTotal: z.ZodNumber;
+    grandTotal: z.ZodNumber;
+    taxBreakdown: z.ZodObject<{
+        panNumber: z.ZodOptional<z.ZodString>;
+        vatNumber: z.ZodOptional<z.ZodString>;
+        taxableAmount: z.ZodNumber;
+        taxAmount: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        taxAmount: number;
+        taxableAmount: number;
+        panNumber?: string | undefined;
+        vatNumber?: string | undefined;
+    }, {
+        taxAmount: number;
+        taxableAmount: number;
+        panNumber?: string | undefined;
+        vatNumber?: string | undefined;
+    }>;
+    paidBy: z.ZodString;
+    notes: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    schoolName: string;
+    studentId: string;
+    studentName: string;
+    amount: number;
+    currency: "NPR";
+    invoiceNumber: string;
+    lineItems: {
+        total: number;
+        description: string;
+        amount: number;
+        taxAmount: number;
+    }[];
+    subtotal: number;
+    taxTotal: number;
+    discountTotal: number;
+    grandTotal: number;
+    paymentId: string;
+    gateway: "esewa" | "khalti" | "fonepay" | "connectips" | "stripe" | "cash" | "bank_transfer" | "cheque";
+    paidBy: string;
+    receiptNumber: string;
+    paidDate: string;
+    transactionId: string;
+    gatewayDisplayName: string;
+    taxBreakdown: {
+        taxAmount: number;
+        taxableAmount: number;
+        panNumber?: string | undefined;
+        vatNumber?: string | undefined;
+    };
+    notes?: string | undefined;
+    schoolAddress?: string | undefined;
+    schoolPhone?: string | undefined;
+}, {
+    schoolName: string;
+    studentId: string;
+    studentName: string;
+    amount: number;
+    currency: "NPR";
+    invoiceNumber: string;
+    lineItems: {
+        total: number;
+        description: string;
+        amount: number;
+        taxAmount: number;
+    }[];
+    subtotal: number;
+    taxTotal: number;
+    discountTotal: number;
+    grandTotal: number;
+    paymentId: string;
+    gateway: "esewa" | "khalti" | "fonepay" | "connectips" | "stripe" | "cash" | "bank_transfer" | "cheque";
+    paidBy: string;
+    receiptNumber: string;
+    paidDate: string;
+    transactionId: string;
+    gatewayDisplayName: string;
+    taxBreakdown: {
+        taxAmount: number;
+        taxableAmount: number;
+        panNumber?: string | undefined;
+        vatNumber?: string | undefined;
+    };
+    notes?: string | undefined;
+    schoolAddress?: string | undefined;
+    schoolPhone?: string | undefined;
+}>;
+export type Receipt = z.infer<typeof receiptSchema>;
+export declare const paymentFilterSchema: z.ZodObject<{
+    status: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["pending", "processing", "completed", "failed", "cancelled", "refunded", "partially_refunded"]>, z.ZodArray<z.ZodEnum<["pending", "processing", "completed", "failed", "cancelled", "refunded", "partially_refunded"]>, "many">]>>;
+    gateway: z.ZodOptional<z.ZodEnum<["esewa", "khalti", "fonepay", "connectips", "stripe", "cash", "bank_transfer", "cheque"]>>;
+    invoiceId: z.ZodOptional<z.ZodString>;
+    studentId: z.ZodOptional<z.ZodString>;
+    dateFrom: z.ZodOptional<z.ZodString>;
+    dateTo: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status?: "completed" | "pending" | "failed" | "cancelled" | "processing" | "refunded" | "partially_refunded" | ("completed" | "pending" | "failed" | "cancelled" | "processing" | "refunded" | "partially_refunded")[] | undefined;
+    studentId?: string | undefined;
+    dateFrom?: string | undefined;
+    dateTo?: string | undefined;
+    invoiceId?: string | undefined;
+    gateway?: "esewa" | "khalti" | "fonepay" | "connectips" | "stripe" | "cash" | "bank_transfer" | "cheque" | undefined;
+}, {
+    status?: "completed" | "pending" | "failed" | "cancelled" | "processing" | "refunded" | "partially_refunded" | ("completed" | "pending" | "failed" | "cancelled" | "processing" | "refunded" | "partially_refunded")[] | undefined;
+    studentId?: string | undefined;
+    dateFrom?: string | undefined;
+    dateTo?: string | undefined;
+    invoiceId?: string | undefined;
+    gateway?: "esewa" | "khalti" | "fonepay" | "connectips" | "stripe" | "cash" | "bank_transfer" | "cheque" | undefined;
+}>;
+export type PaymentFilterDto = z.infer<typeof paymentFilterSchema>;
+export declare const currencyFormatOptionsSchema: z.ZodObject<{
+    locale: z.ZodDefault<z.ZodEnum<["en", "ne"]>>;
+    showSymbol: z.ZodDefault<z.ZodBoolean>;
+    decimals: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    locale: "en" | "ne";
+    showSymbol: boolean;
+    decimals: number;
+}, {
+    locale?: "en" | "ne" | undefined;
+    showSymbol?: boolean | undefined;
+    decimals?: number | undefined;
+}>;
+export type CurrencyFormatOptions = z.infer<typeof currencyFormatOptionsSchema>;
+//# sourceMappingURL=payment.schema.d.ts.map