@mohasinac/appkit 4.41.17 → 4.42.0

package/dist/features/tester/seed-data/authored/buying__buying-checkout.js

@@ -266,21 +266,21 @@ export const authored = {
         expectedData: { defaultChannel: "email" },
         endResult: "The order is placed after the WhatsApp code verifies. With no real Meta credentials configured this case is unreachable — answer null rather than reporting the missing option as a bug.",
     },
-    "checklist-buying-buying-checkout-checkout-razorpay-charge-includes-shipping": {
+    "checklist-buying-buying-checkout-checkout-phonepe-charge-includes-shipping": {
         roles: ["buyer"],
         startPage: "/checkout",
         steps: [
-            "Sign in as admin@letitrip.in / TempPass123! and confirm Site Settings → Payments → Razorpay is enabled and the seller store-beyblade-arena has a configured shipping fee.",
+            "Sign in as admin@letitrip.in / TempPass123!, open /admin/site, switch to the Shipping tab and confirm the 'PhonePe (online card/UPI) enabled' toggle is ON, and confirm the seller store-beyblade-arena has a configured shipping fee.",
             "Sign in as rehan.sheikh@gmail.com / TempPass123!.",
             "Open /products/product-beyblade-burst-valkyrie (price ₹999, store-beyblade-arena) and click 'Add to Cart'.",
             "Complete Steps 1 and 2 of checkout.",
-            "On Step 3, select 'Razorpay' (online payment).",
-            "Read the amount shown in the Order Summary before clicking the Razorpay pay button.",
-            "Click the Razorpay pay button and observe the amount displayed inside the Razorpay checkout modal.",
+            "On Step 3, select 'Pay Online (PhonePe)'.",
+            "Read the amount shown in the Order Summary before clicking the button.",
+            "Click 'Pay Online (PhonePe)' and observe the amount displayed inside the PhonePe checkout iframe.",
         ],
-        expectedBehaviour: "The amount shown inside the Razorpay checkout modal must exactly match the Total shown in the Order Summary panel, including the seller's shipping fee. No discrepancy between the gateway charge and the recorded order total.",
-        expectedUiState: "The Razorpay modal opens and shows a rupee amount that exactly matches the Total in the Order Summary (e.g. if the Order Summary shows ₹1,149.00, the Razorpay modal shows ₹1,149.00 — not ₹999.00 or any other amount).",
-        endResult: "After payment, the order confirmation page shows a Total that matches the Razorpay modal amount exactly.",
+        expectedBehaviour: "The amount shown inside the PhonePe checkout iframe must exactly match the Total shown in the Order Summary panel, including the seller's shipping fee. No discrepancy between the gateway charge and the recorded order total. This regression was originally fixed against Razorpay in 2026-08-20; PhonePe replaced Razorpay entirely and the pre-charge amount is built by the same fee-calculation code, so it is reachable through the new gateway too.",
+        expectedUiState: "The PhonePe iframe opens and shows a rupee amount that exactly matches the Total in the Order Summary (e.g. if the Order Summary shows ₹1,149.00, the PhonePe iframe shows ₹1,149.00 — not ₹999.00 or any other amount).",
+        endResult: "After payment, the order confirmation page shows a Total that matches the PhonePe iframe amount exactly.",
     },
     "checklist-buying-buying-checkout-emi-checkout-flow": {
         roles: ["buyer"],
@@ -392,10 +392,10 @@ export const authored = {
             "On Step 3 (Payment), read the available payment methods.",
             "Select 'COD' (Cash on Delivery) if available and observe the UI.",
             "Select 'UPI / Cash' (manual payment) and observe the UI.",
-            "If Razorpay is listed, select it and observe the UI.",
+            "If 'Pay Online (PhonePe)' is listed, select it and observe the UI.",
         ],
         inputs: { productId: "product-beyblade-burst-valkyrie" },
-        expectedBehaviour: "Each payment method option can be selected and the UI adapts accordingly — COD shows a COD confirmation, manual payment shows a how-it-works guide and consent checkbox, Razorpay (when enabled) offers to open the payment gateway.",
+        expectedBehaviour: "Each payment method option can be selected and the UI adapts accordingly — COD shows a COD confirmation, manual payment shows a how-it-works guide and consent checkbox, PhonePe (when enabled) opens the hosted checkout iframe.",
         expectedUiState: "Step 3 lists the available payment methods as selectable options. Selecting each one changes the lower section of the form to show method-specific instructions or controls. At least COD and UPI/Cash are shown.",
         endResult: "Nothing persists until payment is actually submitted.",
     },

package/dist/features/tester/seed-data/authored/buying__offers.js

@@ -531,20 +531,21 @@ export const authored = {
         expectedUiState: "The suspension entry names an actor, a timestamp and a reason. After restoring, both transitions are listed in order.",
         endResult: "The second store is back to its original status, with both entries recorded.",
     },
-    "checklist-buying-offers-payout-failure-reasons-survive-retries": {
+    "checklist-buying-offers-payout-marked-failed-shows-in-timeline": {
         roles: ["admin"],
         startPage: "/admin/payouts",
         steps: [
             "Sign in as admin@letitrip.in / TempPass123!.",
-            "Open /admin/payouts and find a payout that has failed more than once.",
-            "Open its history and read every entry.",
-            "Check BOTH failure reasons are present rather than only the most recent.",
-            "Check the pending-to-processing transitions are also recorded.",
-            "Count the entries against the number of attempts.",
-        ],
-        expectedBehaviour: "Batch payout writes thread a RUNNING copy of the record rather than the original snapshot. Diffing the last write against the first snapshot loses everything in between — a pending, processing, failed sequence would record only the final state and the dispatch attempt would vanish.",
-        expectedUiState: "Every attempt appears with its own reason, oldest first, including the intermediate processing transitions. Only the latest reason showing is the snapshot-diff failure.",
-        endResult: "Read-only. If no twice-failed payout exists, answer null rather than forcing a failure.",
+            "Open /admin/payouts and find a pending payout.",
+            "Open it and set its status to Failed with an admin note, then save.",
+            "Reopen the payout and read its History block.",
+            "Set the same payout to Failed again with a DIFFERENT admin note, then save.",
+            "Reopen the payout and read its History block again.",
+        ],
+        inputs: { firstFailureNote: "Bank rejected the transfer", secondFailureNote: "Retried with corrected IFSC, still rejected" },
+        expectedBehaviour: "Seller payouts are fully manual — there is no automated dispatch/retry job (PhonePe has no payout API, so the earlier RazorpayX auto-dispatch job that used to write razorpayPayoutId/razorpayStatus/failureCount/lastFailureReason was deleted outright when Razorpay was replaced). Each manual status change goes through the payout's status-history primitive, which appends rather than overwrites, so both Failed entries must be visible with the admin as actor.",
+        expectedUiState: "After the second save, the History block lists BOTH Failed entries in order, each with its own note ('Bank rejected the transfer' then 'Retried with corrected IFSC, still rejected') — not just the most recent one.",
+        endResult: "After reloading the payout detail page, both History entries are still present.",
     },
     "checklist-buying-offers-bid-timeline-explains-forfeited": {
         roles: ["buyer"],

package/dist/features/tester/seed-data/authored/cta-layout__checkout-bottom-bar.js

@@ -47,7 +47,7 @@ export const authored = {
         ],
         inputs: { viewportWidth: 320 },
         expectedBehaviour: "A label too long for one line makes its button taller rather than truncating. Height is cheap in a bottom bar; a clipped verb is not, because the buyer cannot tell what the button will do.",
-        expectedUiState: "'Pay Online (Razorpay)' is shown complete, wrapping onto two lines if it needs to. An ellipsis anywhere in the bar is a failure, on any payment method.",
+        expectedUiState: "'Pay Online (PhonePe)' is shown complete, wrapping onto two lines if it needs to. An ellipsis anywhere in the bar is a failure, on any payment method.",
         endResult: "Layout-only; nothing persists. Restore the window width afterwards.",
     },
 };

package/dist/features/tester/seed-data/tester-checklist-seed-data.js

@@ -671,7 +671,7 @@ const rawTesterChecklistItems = [
                     label: "The \"Send via WhatsApp instead\" option is NOT offered when the selected delivery address has no phone number on it, even with WhatsApp OTP enabled",
                     description: "Added 2026-08-21. The phone is resolved server-side from the selected address (never from anything the browser sends), so an address with no phone has nowhere to send the code. Select/create a delivery address with the phone field empty and confirm the WhatsApp option is absent rather than appearing and then failing.",
                 },
-                { key: "payment-method-selection", label: "Choosing between COD, UPI/manual, and Razorpay (when enabled) at checkout works" },
+                { key: "payment-method-selection", label: "Choosing between COD, UPI/manual, and PhonePe (when enabled) at checkout works" },
                 { key: "payment-window-countdown", label: "Manual-payment orders show a 15-minute countdown timer on the payment page" },
                 { key: "payment-proof-upload", label: "Uploading manual payment proof (screenshot, UTR, mark-as-paid + agreement checkboxes) works" },
                 { key: "payment-proof-reupload", label: "Requesting a proof re-upload extends the buyer's payment window and the buyer can successfully re-submit" },
@@ -701,9 +701,9 @@ const rawTesterChecklistItems = [
                     href: "/checkout",
                 },
                 {
-                    key: "checkout-razorpay-charge-includes-shipping",
-                    label: "When Razorpay online payment is enabled, the amount charged in the Razorpay checkout modal matches the order's recorded Total exactly, including shipping fee",
-                    description: "Fixed 2026-08-20 — the Razorpay pre-charge amount (computed before opening the payment modal) omitted the seller's shipping fee entirely, while the order created afterward recorded a higher total that included it, so the buyer was silently charged less via the gateway than what got recorded as owed. Only testable when Site Settings → Payments → Razorpay is enabled and the seller has a configured shipping fee. Compare the amount shown in the Razorpay modal against the order's Total on the confirmation page — they should match exactly.",
+                    key: "checkout-phonepe-charge-includes-shipping",
+                    label: "When PhonePe online payment is enabled, the amount charged in the PhonePe checkout iframe matches the order's recorded Total exactly, including shipping fee",
+                    description: "Originally fixed 2026-08-20 against Razorpay; PhonePe replaced Razorpay entirely in this same migration and the pre-charge amount is built by the identical fee-calculation code, so the same regression is reachable through the new gateway. Only testable when the \"PhonePe (online card/UPI) enabled\" toggle under Site Settings → Shipping → Payment methods is ON and the seller has a configured shipping fee. Note the amount shown inside the PhonePe iframe before paying, then compare it against the order's Total on the confirmation page — they should match exactly.",
                     href: "/checkout",
                 },
                 /*
@@ -1310,8 +1310,8 @@ const rawTesterChecklistItems = [
                 },
                 {
                     key: "platform-fee-all-methods",
-                    label: "The platform fee is charged on every payment method — COD, UPI-manual/cash and Razorpay all include it; COD additionally shows the COD handling fee and the 10% token",
-                    description: "It used to be added only on the Razorpay path, so COD and UPI buyers were never charged it. Compare the same cart across each available method.",
+                    label: "The platform fee is charged on every payment method — COD, UPI-manual/cash and PhonePe all include it; COD additionally shows the COD handling fee and the 10% token",
+                    description: "It used to be added only on the online-gateway path (Razorpay, since replaced by PhonePe), so COD and UPI buyers were never charged it. Compare the same cart across each available method.",
                     href: "/checkout",
                 },
                 {
@@ -1328,7 +1328,7 @@ const rawTesterChecklistItems = [
                 {
                     key: "cart-checkout-order-totals-agree",
                     label: "For the same cart, the expanded cart breakdown, the sum of the per-seller card fee lines, the checkout Order Summary and the created orders all show the SAME total",
-                    description: "Repeat on COD, UPI-manual and Razorpay. Acceptance test for the whole pricing change — if any two of those four disagree, something is reading a different source than it charges from.",
+                    description: "Repeat on COD, UPI-manual and PhonePe. Acceptance test for the whole pricing change — if any two of those four disagree, something is reading a different source than it charges from.",
                     href: "/checkout",
                 },
                 {
@@ -1625,9 +1625,9 @@ const rawTesterChecklistItems = [
                     href: "/admin/stores",
                 },
                 {
-                    key: "payout-failure-reasons-survive-retries",
-                    label: "A payout that failed twice shows BOTH reasons, not just the last",
-                    description: "`lastFailureReason` is overwritten by every retry, so the timeline is the only place earlier attempts survive. Also confirm the four dispatch fields (razorpayPayoutId, razorpayStatus, failureCount, lastFailureReason) render — they were written by the batch and UNDECLARED on the document until 2026-08-26, so nothing could safely surface them.",
+                    key: "payout-marked-failed-shows-in-timeline",
+                    label: "Manually marking a payout Failed records the change on its own status timeline, and doing it a second time does not erase the first entry",
+                    description: "Seller payouts are fully manual (there is no automated dispatch/retry job — PhonePe has no payout API, so the earlier RazorpayX auto-dispatch job and its `razorpayPayoutId`/`razorpayStatus`/`failureCount`/`lastFailureReason` fields were deleted outright rather than migrated). Mark a pending payout Failed from /admin/payouts, reopen it, and confirm the History block shows a Failed entry with the admin as actor. Mark it Failed again and confirm the FIRST entry is still listed rather than being overwritten by the second.",
                     href: "/admin/payouts",
                 },
                 {
@@ -4873,7 +4873,7 @@ const rawTesterChecklistItems = [
                 {
                     key: "coupon-admin-usage-visible",
                     label: "The admin coupon list shows usage counts that go up after a buyer redeems the coupon",
-                    description: "Note the current usage, have a buyer complete an order with the coupon, then refresh the admin list. Check this for BOTH a cash/UPI order and (if Razorpay is enabled) an online-payment order — online payments previously did not record usage at all.",
+                    description: "Note the current usage, have a buyer complete an order with the coupon, then refresh the admin list. Check this for BOTH a cash/UPI order and (if PhonePe is enabled) an online-payment order — online payments previously did not record usage at all.",
                 },
             ],
         },
@@ -5193,6 +5193,18 @@ const rawTesterChecklistItems = [
             href: "/admin/site",
             cases: [
                 { key: "site-settings-admin", label: "Admin site settings page saves correctly", href: "/admin/site" },
+                {
+                    key: "phonepe-credentials-persist",
+                    label: "Site Settings → Integrations saves the PhonePe Client ID, Client Secret, Client Version, Environment and both webhook credentials — and they survive a reload",
+                    description: "Open /admin/site and switch to the Integrations tab (?tab=integrations). Fill in the PhonePe Client ID, Client Secret, Client Version, Environment (sandbox/production) and Webhook Username/Password, then save and hard-reload. The Client Secret and both webhook credential fields are masked on reload (dots, not the raw value) — that is correct. Confirm by changing an unrelated field on the same tab, saving again, and verifying the masked fields still work (checkout still reaches PhonePe) rather than being silently overwritten with the mask value.",
+                    href: "/admin/site",
+                },
+                {
+                    key: "phonepe-enabled-toggle-persists",
+                    label: "Site Settings → Shipping: the \"PhonePe (online card/UPI) enabled\" toggle persists after save + reload, and gates the checkout payment option",
+                    description: "The toggle lives under the Shipping tab's \"Payment methods\" section (?tab=shipping), not a dedicated Payments tab. With it OFF, /checkout must not offer 'Pay Online (PhonePe)' — only manual UPI/cash and COD (whichever are separately enabled). Turn it ON, save, reload the settings page to confirm it's still ON, then open /checkout and confirm 'Pay Online (PhonePe)' now appears as a payment option.",
+                    href: "/admin/site",
+                },
                 {
                     key: "whatsapp-credentials-persist",
                     label: "Site Settings → WhatsApp saves the Phone Number ID, Cloud API token, admin notify numbers, template language and all 6 template names — and they survive a reload",
@@ -6042,7 +6054,7 @@ const rawTesterChecklistItems = [
                 {
                     key: "no-truncation-anywhere",
                     label: "No CTA label is ever cut off — long ones wrap to two lines",
-                    description: "Check the payment step, whose primary reads 'Pay Online (Razorpay)'. BEFORE: a label too long for its share was clipped with an ellipsis. AFTER: the button grows taller and shows the whole label on two lines. An ellipsis anywhere in the bar is a failure.",
+                    description: "Check the payment step, whose primary reads 'Pay Online (PhonePe)'. BEFORE: a label too long for its share was clipped with an ellipsis. AFTER: the button grows taller and shows the whole label on two lines. An ellipsis anywhere in the bar is a failure.",
                 },
             ],
         },

package/dist/features/wishlist/schemas/index.d.ts

@@ -23,8 +23,8 @@ export declare const wishlistItemSchema: z.ZodObject<{
     addedAt: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     id: string;
-    userId: string;
     productId: string;
+    userId: string;
     productTitle?: string | undefined;
     productImage?: string | undefined;
     addedAt?: string | undefined;
@@ -34,8 +34,8 @@ export declare const wishlistItemSchema: z.ZodObject<{
     productStatus?: string | undefined;
 }, {
     id: string;
-    userId: string;
     productId: string;
+    userId: string;
     productTitle?: string | undefined;
     productImage?: string | undefined;
     addedAt?: string | undefined;

package/dist/index.d.ts

@@ -169,17 +169,14 @@ export { arrayRemove } from "./contracts/index";
 export { arrayUnion } from "./contracts/index";
 export { deleteField } from "./contracts/index";
 export { getClientAuthProvider } from "./contracts/index";
-export { getClientPaymentGateway } from "./contracts/index";
 export { getClientRealtimeProvider } from "./contracts/index";
 export { getClientSessionAdapter } from "./contracts/index";
 export { getCollectionHooks } from "./contracts/index";
 export { getProviders } from "./contracts/index";
-export { getRegisteredPaymentGateways } from "./contracts/index";
 export { increment } from "./contracts/index";
 export { mergeFilterDefinitions } from "./contracts/index";
 export { mergeSortDefinitions } from "./contracts/index";
 export { registerClientAuthProvider } from "./contracts/index";
-export { registerClientPaymentGateway } from "./contracts/index";
 export { registerClientRealtimeProvider } from "./contracts/index";
 export { registerClientSessionAdapter } from "./contracts/index";
 export { registerFieldOps } from "./contracts/index";
@@ -211,11 +208,9 @@ export type { FieldSentinel } from "./contracts/index";
 export type { FilterDefinition } from "./contracts/index";
 export type { FilterOption } from "./contracts/index";
 export type { FilterType } from "./contracts/index";
-export type { GatewayPaymentResponse } from "./contracts/index";
 export type { IAuthProvider } from "./contracts/index";
 export type { ICacheProvider } from "./contracts/index";
 export type { IClientAuthProvider } from "./contracts/index";
-export type { IClientPaymentGateway } from "./contracts/index";
 export type { IClientRealtimeProvider } from "./contracts/index";
 export type { IClientSessionAdapter } from "./contracts/index";
 export type { IDbProvider } from "./contracts/index";
@@ -235,7 +230,6 @@ export type { IStyleAdapter } from "./contracts/index";
 export type { IWriteRepository } from "./contracts/index";
 export type { LayoutSlots } from "./contracts/index";
 export type { NavItem } from "./contracts/index";
-export type { OpenGatewayOptions } from "./contracts/index";
 export type { PagedResult } from "./contracts/index";
 export type { PaymentCapture } from "./contracts/index";
 export type { PaymentOrder } from "./contracts/index";
@@ -327,7 +321,7 @@ export { handleApiError } from "./errors/index";
 export { isAppError } from "./errors/index";
 export { logError } from "./errors/index";
 export type { ErrorCode } from "./errors/index";
-export { RazorpayUnreachableError } from "./errors/index";
+export { PaymentProviderUnreachableError } from "./errors/index";
 export { mapToHttpError, HTTP_ERROR_CODES } from "./errors/index";
 export type { MappedError, HttpErrorCode } from "./errors/index";
 export { ERROR_DISPLAY_MAP, getErrorDisplay } from "./errors/index";
@@ -846,20 +840,10 @@ export type { ResendProviderOptions } from "./providers/email-resend/index";
 export { FirebaseClientAuthProvider } from "./providers/firebase-client/index";
 export { FirebaseClientRealtimeProvider } from "./providers/firebase-client/index";
 export type { FirebaseClientRealtimeConfig } from "./providers/firebase-client/index";
-export { RazorpayProvider } from "./providers/payment-razorpay/index";
-export { createRazorpayOrder } from "./providers/payment-razorpay/index";
-export { createRazorpayRefund } from "./providers/payment-razorpay/index";
-export { fetchRazorpayOrder } from "./providers/payment-razorpay/index";
-export { paiseToRupees } from "./providers/payment-razorpay/index";
-export { rupeesToPaise } from "./providers/payment-razorpay/index";
-export { verifyPaymentSignature } from "./providers/payment-razorpay/index";
-export { verifyPaymentSignatureWithKeys } from "./providers/payment-razorpay/index";
-export { verifyWebhookSignature } from "./providers/payment-razorpay/index";
-export type { RazorpayConfig } from "./providers/payment-razorpay/index";
-export type { RazorpayOrder } from "./providers/payment-razorpay/index";
-export type { RazorpayOrderOptions } from "./providers/payment-razorpay/index";
-export type { RazorpayPaymentResult } from "./providers/payment-razorpay/index";
-export type { RazorpayRefundResult } from "./providers/payment-razorpay/index";
+export { PhonePeProvider } from "./providers/payment-phonepe/index";
+export { paiseToRupees } from "./core/money";
+export { rupeesToPaise } from "./core/money";
+export type { PhonePeConfig } from "./providers/payment-phonepe/index";
 export { ManualPaymentProvider } from "./providers/payment-manual/index";
 export { ManualShippingProvider } from "./providers/shipping-manual/index";
 export { STORAGE_PATHS } from "./providers/storage-firebase/client";
@@ -2168,7 +2152,6 @@ export type { RefundHistoryTableProps } from "./features/orders/index";
 export { RefundRequestView } from "./features/orders/index";
 export type { RefundRequestViewProps } from "./features/orders/index";
 export type { RefundRequestSubmission } from "./features/orders/components/RefundRequestView";
-export { PaymentGatewayValues } from "./features/orders/index";
 export { PaymentMethodValues } from "./features/orders/index";
 export { OutOfStockPolicyValues } from "./features/orders/index";
 export type { OutOfStockPolicy } from "./features/orders/index";
@@ -2211,7 +2194,6 @@ export type { OrderListResponse } from "./features/orders/index";
 export type { OrderPayoutStatus } from "./features/orders/index";
 export type { OrderTimeline } from "./features/orders/index";
 export type { OrderUpdateInput } from "./features/orders/index";
-export type { PaymentGateway } from "./features/orders/index";
 export type { RefundStatus } from "./features/orders/index";
 export type { ShippingMethod } from "./features/orders/index";
 export { cancelOrderForUser } from "./features/orders/server";
@@ -2264,10 +2246,6 @@ export { PayoutStatusValues } from "./features/payments/index";
 export { buildPaymentColumns } from "./features/payments/index";
 export { createPayoutId } from "./features/payments/index";
 export { paymentAdminColumns } from "./features/payments/index";
-export { paymentGatewayConfigSchema } from "./features/payments/index";
-export { paymentGatewaySchema } from "./features/payments/index";
-export { paymentRecordSchema } from "./features/payments/index";
-export { paymentStatusSchema } from "./features/payments/index";
 export { payoutQueryHelpers } from "./features/payments/index";
 export { payoutStatusSchema } from "./features/payments/index";
 export { usePaymentEvent } from "./features/payments/index";
@@ -3019,7 +2997,7 @@ export type { RoleGateProps, ProtectedRouteProps, AuthGuardUser, AuthRouteConfig
 export { CartItemRow, CartDrawer, CartView, CartSummary, ShippingPicker } from "./features/cart/index";
 export type { ShippingPickerProps } from "./features/cart/index";
 export { CheckoutView, CheckoutAddressStep, CheckoutSuccessView } from "./features/cart/index";
-export { CheckoutStepper, useCheckout } from "./features/checkout/index";
+export { CheckoutStepper } from "./features/checkout/index";
 export { useProfile as useCurrentProfile, useUpdateProfile as useUpdateCurrentProfile } from "./features/account/index";
 export { useLogout } from "./features/auth/index";
 export { Text, Label, Span } from "./ui/index";

package/dist/index.js

@@ -315,9 +315,6 @@ export { deleteField } from "./contracts/index";
 // getClientAuthProvider - Helper for get client auth provider.
 export { getClientAuthProvider } from "./contracts/index";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
-// getClientPaymentGateway - Helper for get client payment gateway.
-export { getClientPaymentGateway } from "./contracts/index";
-// [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
 // getClientRealtimeProvider - Helper for get client realtime provider.
 export { getClientRealtimeProvider } from "./contracts/index";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
@@ -330,9 +327,6 @@ export { getCollectionHooks } from "./contracts/index";
 // getProviders - Helper for get providers.
 export { getProviders } from "./contracts/index";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
-// getRegisteredPaymentGateways - Helper for get registered payment gateways.
-export { getRegisteredPaymentGateways } from "./contracts/index";
-// [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
 // increment - Shared export for increment.
 export { increment } from "./contracts/index";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
@@ -345,9 +339,6 @@ export { mergeSortDefinitions } from "./contracts/index";
 // registerClientAuthProvider - Helper for register client auth provider.
 export { registerClientAuthProvider } from "./contracts/index";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
-// registerClientPaymentGateway - Helper for register client payment gateway.
-export { registerClientPaymentGateway } from "./contracts/index";
-// [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
 // registerClientRealtimeProvider - Helper for register client realtime provider.
 export { registerClientRealtimeProvider } from "./contracts/index";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
@@ -558,8 +549,8 @@ export { isAppError } from "./errors/index";
 // logError - Helper for log error.
 export { logError } from "./errors/index";
 // [UTIL]-Pure utility — no framework or runtime dependency; safe to import from any environment.
-// RazorpayUnreachableError - Thrown when Razorpay API exhausts retries.
-export { RazorpayUnreachableError } from "./errors/index";
+// PaymentProviderUnreachableError - Thrown when the payment gateway API exhausts retries.
+export { PaymentProviderUnreachableError } from "./errors/index";
 // [UTIL]-Pure utility — server boundary code/HTTP mapper for any thrown value.
 // mapToHttpError - Map any thrown value to { status, code, message, issues? }.
 export { mapToHttpError, HTTP_ERROR_CODES } from "./errors/index";
@@ -1717,34 +1708,16 @@ export { FirebaseClientAuthProvider } from "./providers/firebase-client/index";
 // [CLIENT-ONLY]-Cannot run in SSR mode â€" uses browser-only APIs (window, navigator, localStorage, matchMedia, DOM events) that do not exist in Node.js.
 // FirebaseClientRealtimeProvider - Component for firebase client realtime provider.
 export { FirebaseClientRealtimeProvider } from "./providers/firebase-client/index";
-// ./providers/payment-razorpay/index
-// [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
-// RazorpayProvider - Component for razorpay provider.
-export { RazorpayProvider } from "./providers/payment-razorpay/index";
+// ./providers/payment-phonepe/index
 // [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
-// createRazorpayOrder - Helper for create razorpay order.
-export { createRazorpayOrder } from "./providers/payment-razorpay/index";
-// [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
-// createRazorpayRefund - Helper for create razorpay refund.
-export { createRazorpayRefund } from "./providers/payment-razorpay/index";
-// [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
-// fetchRazorpayOrder - Shared export for fetch razorpay order.
-export { fetchRazorpayOrder } from "./providers/payment-razorpay/index";
+// PhonePeProvider - Component for phonepe provider.
+export { PhonePeProvider } from "./providers/payment-phonepe/index";
 // [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
 // paiseToRupees - Shared export for paise to rupees. // audit-money-units-ok: names the boundary conversion function itself
-export { paiseToRupees } from "./providers/payment-razorpay/index";
+export { paiseToRupees } from "./core/money";
 // [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
 // rupeesToPaise - Shared export for rupees to paise. // audit-money-units-ok: names the boundary conversion function itself
-export { rupeesToPaise } from "./providers/payment-razorpay/index";
-// [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
-// verifyPaymentSignature - Shared export for verify payment signature.
-export { verifyPaymentSignature } from "./providers/payment-razorpay/index";
-// [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
-// verifyPaymentSignatureWithKeys - Shared export for verify payment signature with keys.
-export { verifyPaymentSignatureWithKeys } from "./providers/payment-razorpay/index";
-// [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
-// verifyWebhookSignature - Shared export for verify webhook signature.
-export { verifyWebhookSignature } from "./providers/payment-razorpay/index";
+export { rupeesToPaise } from "./core/money";
 // ./providers/payment-manual/index
 // [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
 // ManualPaymentProvider - the default IPaymentProvider implementation (no gateway).
@@ -3995,9 +3968,6 @@ export { OfferPhaseTimeline } from "./features/seller/components/OfferPhaseTimel
 export { RefundHistoryTable } from "./features/orders/index";
 export { RefundRequestView } from "./features/orders/index";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
-// PaymentGatewayValues - Model for payment gateway values.
-export { PaymentGatewayValues } from "./features/orders/index";
-// [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
 // PaymentMethodValues - Model for payment method values.
 export { PaymentMethodValues } from "./features/orders/index";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
@@ -4139,18 +4109,6 @@ export { createPayoutId } from "./features/payments/index";
 // paymentAdminColumns - Shared export for payment admin columns.
 export { paymentAdminColumns } from "./features/payments/index";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
-// paymentGatewayConfigSchema - Model for payment gateway config schema.
-export { paymentGatewayConfigSchema } from "./features/payments/index";
-// [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
-// paymentGatewaySchema - Model for payment gateway schema.
-export { paymentGatewaySchema } from "./features/payments/index";
-// [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
-// paymentRecordSchema - Model for payment record schema.
-export { paymentRecordSchema } from "./features/payments/index";
-// [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
-// paymentStatusSchema - Model for payment status schema.
-export { paymentStatusSchema } from "./features/payments/index";
-// [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
 // payoutQueryHelpers - Shared export for payout query helpers.
 export { payoutQueryHelpers } from "./features/payments/index";
 // [CLIENT-SSR]-Runs in both SSR and browser â€" React component or hook that does not depend on browser-only APIs.
@@ -5374,8 +5332,7 @@ export { RoleGate, ProtectedRoute, SocialAuthButtons, AuthStatusPanel, LoginForm
 // Missing cart and checkout feature components
 export { CartItemRow, CartDrawer, CartView, CartSummary, ShippingPicker } from "./features/cart/index";
 export { CheckoutView, CheckoutAddressStep, CheckoutSuccessView } from "./features/cart/index";
-export { CheckoutStepper, useCheckout } from "./features/checkout/index";
-// PaymentGateway already exported from checkout types above
+export { CheckoutStepper } from "./features/checkout/index";
 // Missing account hooks
 export { useProfile as useCurrentProfile, useUpdateProfile as useUpdateCurrentProfile } from "./features/account/index";
 // Missing auth hooks

package/dist/jobs.d.ts

@@ -20,7 +20,7 @@
  *     listingProcessorHandler,
  *   } from "@mohasinac/appkit/jobs";
  */
-export { couponExpiryHandler, offerExpiryHandler, cartPruneHandler, notificationPruneHandler, pageViewRollupHandler, pageViewPruneHandler, dailyDataCleanupHandler, cleanupRtdbEventsHandler, auctionSettlementHandler, autoPayoutEligibilityHandler, countersReconcileHandler, onOrderCreateHandler, onOrderStatusChangeHandler, onReviewWriteHandler, promotionsHandler, mediaTmpCleanupHandler, pendingOrderTimeoutHandler, productStatsSyncHandler, positionsReconcileHandler, payoutBatchHandler, weeklyPayoutEligibilityHandler, onCategoryWriteHandler, onProductWriteHandler, onStoreWriteHandler, adminAnalyticsHandler, storeAnalyticsHandler, listingProcessorHandler, supportedListingCollections, onPrizeDrawPaymentConfirmedHandler, prizeDrawSoldOutRevealHandler, prizeDrawExpiryRevealHandler, bundleStockSyncHandler, onProductStockChangeHandler, triggerEventRaffleHandler, assignSpinPrizeHandler, draftPruneHandler, onSupportTicketCreateHandler, onSupportTicketUpdateHandler, onUserBanChangeHandler, onScamReportCreateHandler, onScamReportUpdateHandler, bindSchedule, bindDocumentWritten, bindDocumentCreated, bindDocumentUpdated, bindCallable, bindHttps, bindToFirebase, } from "./_internal/server/jobs/index.js";
+export { couponExpiryHandler, offerExpiryHandler, cartPruneHandler, notificationPruneHandler, pageViewRollupHandler, pageViewPruneHandler, dailyDataCleanupHandler, cleanupRtdbEventsHandler, auctionSettlementHandler, autoPayoutEligibilityHandler, countersReconcileHandler, onOrderCreateHandler, onOrderStatusChangeHandler, onReviewWriteHandler, promotionsHandler, mediaTmpCleanupHandler, pendingOrderTimeoutHandler, productStatsSyncHandler, positionsReconcileHandler, weeklyPayoutEligibilityHandler, onCategoryWriteHandler, onProductWriteHandler, onStoreWriteHandler, adminAnalyticsHandler, storeAnalyticsHandler, listingProcessorHandler, supportedListingCollections, onPrizeDrawPaymentConfirmedHandler, prizeDrawSoldOutRevealHandler, prizeDrawExpiryRevealHandler, bundleStockSyncHandler, onProductStockChangeHandler, triggerEventRaffleHandler, assignSpinPrizeHandler, draftPruneHandler, onSupportTicketCreateHandler, onSupportTicketUpdateHandler, onUserBanChangeHandler, onScamReportCreateHandler, onScamReportUpdateHandler, bindSchedule, bindDocumentWritten, bindDocumentCreated, bindDocumentUpdated, bindCallable, bindHttps, bindToFirebase, } from "./_internal/server/jobs/index.js";
 export { defineFunction, mergeFunctionRegistries, bindAllFromRegistry, APPKIT_FUNCTIONS, APPKIT_FUNCTIONS_BY_NAME, } from "./_internal/server/functions/index.js";
 export { orderRepository, siteSettingsRepository } from "./repositories/index.js";
 export type { OrderDocument, OrderDocumentItem } from "./features/orders/index.js";

package/dist/jobs.js

@@ -22,7 +22,7 @@
  */
 export { 
 // S4–S5: Job handlers (pure, framework-agnostic)
-couponExpiryHandler, offerExpiryHandler, cartPruneHandler, notificationPruneHandler, pageViewRollupHandler, pageViewPruneHandler, dailyDataCleanupHandler, cleanupRtdbEventsHandler, auctionSettlementHandler, autoPayoutEligibilityHandler, countersReconcileHandler, onOrderCreateHandler, onOrderStatusChangeHandler, onReviewWriteHandler, promotionsHandler, mediaTmpCleanupHandler, pendingOrderTimeoutHandler, productStatsSyncHandler, positionsReconcileHandler, payoutBatchHandler, weeklyPayoutEligibilityHandler, onCategoryWriteHandler, onProductWriteHandler, onStoreWriteHandler, adminAnalyticsHandler, storeAnalyticsHandler, listingProcessorHandler, supportedListingCollections, 
+couponExpiryHandler, offerExpiryHandler, cartPruneHandler, notificationPruneHandler, pageViewRollupHandler, pageViewPruneHandler, dailyDataCleanupHandler, cleanupRtdbEventsHandler, auctionSettlementHandler, autoPayoutEligibilityHandler, countersReconcileHandler, onOrderCreateHandler, onOrderStatusChangeHandler, onReviewWriteHandler, promotionsHandler, mediaTmpCleanupHandler, pendingOrderTimeoutHandler, productStatsSyncHandler, positionsReconcileHandler, weeklyPayoutEligibilityHandler, onCategoryWriteHandler, onProductWriteHandler, onStoreWriteHandler, adminAnalyticsHandler, storeAnalyticsHandler, listingProcessorHandler, supportedListingCollections, 
 // SB1-L (S7-PrizeDraws) — prize-draw reveal redesigned to a fully-automatic model.
 onPrizeDrawPaymentConfirmedHandler, prizeDrawSoldOutRevealHandler, prizeDrawExpiryRevealHandler, bundleStockSyncHandler, 
 // SB-UNI-V — Firestore onWrite trigger for product stock changes.

package/dist/providers/payment-phonepe/index.d.ts

@@ -0,0 +1,117 @@
+/**
+ * @mohasinac/payment-phonepe — PhonePe Standard Checkout v2 IPaymentProvider implementation
+ *
+ * Implements the @mohasinac/contracts IPaymentProvider interface using the
+ * official `phonepe-pg-sdk-node` package. Accepts credentials via
+ * constructor — no Firestore or DB dependency (mirrors `payment-manual`'s
+ * shape, not the old `payment-razorpay` three-layer file: every caller goes
+ * through `getProviders().payment`, there is no separate "deprecated
+ * standalone helper" bypass layer here).
+ *
+ * PhonePe's flow differs from a client-side-modal gateway in two structural
+ * ways every caller of this provider must account for:
+ *
+ *   1. `createOrder()` returns a `checkoutUrl` (PhonePe's `redirectUrl`) —
+ *      the browser opens/embeds this page. There is no publishable key to
+ *      hand the client and no client-side signature to verify afterward.
+ *   2. The definitive payment result is never returned to the browser. The
+ *      caller must poll `getOrder()`/`capturePayment()` (both wrap PhonePe's
+ *      Order Status API) or rely on the webhook (`verifyWebhook`) as the
+ *      source of truth.
+ *
+ * @example
+ * ```ts
+ * import { PhonePeProvider } from "@mohasinac/payment-phonepe";
+ * import { registerProviders } from "../../contracts";
+ *
+ * registerProviders({
+ *   payment: new PhonePeProvider({
+ *     clientId: process.env.PHONEPE_CLIENT_ID!,
+ *     clientSecret: process.env.PHONEPE_CLIENT_SECRET!,
+ *     clientVersion: process.env.PHONEPE_CLIENT_VERSION ?? "1",
+ *     environment: (process.env.PHONEPE_ENVIRONMENT as "sandbox" | "production") ?? "sandbox",
+ *     webhookUsername: process.env.PHONEPE_WEBHOOK_USERNAME,
+ *     webhookPassword: process.env.PHONEPE_WEBHOOK_PASSWORD,
+ *   }),
+ * });
+ * ```
+ */
+import type { JsonValue } from "@mohasinac/appkit";
+import { IPaymentProvider } from "../../contracts";
+import type { PaymentOrder, PaymentCapture, Refund } from "../../contracts";
+/**
+ * PhonePe's `metaInfo` (udf1-udf5, ≤256 chars each) is the only channel that
+ * survives from `createOrder()` through to BOTH the Order Status API AND the
+ * webhook payload. Checkout uses it to carry the buyer's checkout intent
+ * (uid / addressId / outOfStockPolicy / notes) so the webhook — which fires
+ * with no buyer session — can place the order on its own if the buyer closes
+ * the tab mid-payment. See `confirmAndPlacePhonePeOrderAction` in
+ * `_internal/server/features/checkout/actions.ts`.
+ */
+export interface PhonePeCheckoutIntent {
+    uid: string;
+    addressId?: string;
+    outOfStockPolicy?: string;
+    notes?: string;
+}
+export interface PhonePeConfig {
+    clientId: string;
+    clientSecret: string;
+    /** PhonePe's client version — a small integer, stored as a string across this codebase's credential convention. */
+    clientVersion: string;
+    environment: "sandbox" | "production";
+    /** Username/password configured in PhonePe's dashboard Webhook tab (SHA/Basic auth mode). Required for `verifyWebhook()` to do anything but return `false`. */
+    webhookUsername?: string;
+    webhookPassword?: string;
+}
+export declare class PhonePeProvider extends IPaymentProvider {
+    readonly name = "phonepe";
+    private readonly client;
+    private readonly webhookUsername?;
+    private readonly webhookPassword?;
+    constructor(config: PhonePeConfig);
+    /**
+     * Creates a PhonePe order and returns its hosted checkout page.
+     *
+     * `metadata.redirectUrl` is REQUIRED — PhonePe's API mandates a
+     * `merchantUrls.redirectUrl` on every order (used only as the fallback
+     * destination if the buyer's browser degrades out of IFRAME mode into a
+     * full page navigation). `metadata.uid` is REQUIRED — it (plus the
+     * optional `addressId`/`outOfStockPolicy`/`notes`) is packed into
+     * PhonePe's `metaInfo` so the webhook can reconstruct and place the order
+     * with no buyer session (see `PhonePeCheckoutIntent` above). The returned
+     * `PaymentOrder.id` is OUR generated `merchantOrderId` — the key every
+     * subsequent lookup (status, refund, webhook correlation) uses.
+     */
+    createOrder(amount: number, currency?: string, metadata?: Record<string, JsonValue>): Promise<PaymentOrder>;
+    /**
+     * Validates a webhook request. `signature` is the raw `Authorization`
+     * header value; `payload` is the raw request body string. Requires
+     * `webhookUsername`/`webhookPassword` to be configured — returns `false`
+     * otherwise (same fail-closed shape Razorpay's provider used for a
+     * missing webhook secret).
+     *
+     * This only reports validity — it does NOT return the parsed callback
+     * body. Callers that need the parsed event (type + payload) should
+     * `JSON.parse` the raw body themselves after this returns `true`, same as
+     * the existing webhook route already does.
+     */
+    verifyWebhook(payload: string, signature: string): boolean;
+    /** Wraps the Order Status API. `orderId` here is our `merchantOrderId`. */
+    capturePayment(orderId: string): Promise<PaymentCapture>;
+    /**
+     * Initiates a refund. `paymentId` here is actually the original
+     * `merchantOrderId` — PhonePe refunds are order-keyed
+     * (`originalMerchantOrderId`), not payment-keyed. The inherited parameter
+     * name from `IPaymentProvider` is misleading for this provider; kept only
+     * because the base contract is shared with `ManualPaymentProvider`.
+     */
+    refund(paymentId: string, amount?: number): Promise<Refund>;
+    /**
+     * Wraps the Order Status API. `orderId` here is our `merchantOrderId`.
+     * `metadata` is the buyer's checkout intent, unpacked from PhonePe's
+     * `metaInfo` — the primary reason the checkout action calls this rather
+     * than `capturePayment()` when confirming a payment.
+     */
+    getOrder(orderId: string): Promise<PaymentOrder>;
+}