@flopay/react 0.5.14 → 0.5.17

package/README.md

@@ -83,6 +83,33 @@ function CheckoutPage() {
 
 The mode can also be set on the session itself via the billing API's `checkoutMode` field. The `checkoutMode` prop overrides the session value.
 
+#### Expired Sessions
+
+When `FloPayCheckout` or `FloPayAutomaticPaymentButton` loads a checkout session whose `status` is `expired`, the component calls `onError` with a `FloPayError` so your app can route the customer into a recovery flow.
+
+The error has:
+
+- `message: 'Checkout session has expired.'`
+- `type: 'api_error'`
+- `code: 'checkout_session_expired'`
+
+Use this code to create or request a fresh checkout session, then send the customer back through checkout:
+
+```tsx
+<FloPayCheckout
+  sessionId={sessionId}
+  onComplete={() => router.push('/success')}
+  onError={(error) => {
+    if (error.code === 'checkout_session_expired') {
+      router.push('/checkout/expired');
+      return;
+    }
+
+    console.error(error);
+  }}
+/>
+```
+
 ### Automatic Payment Buttons
 
 Use `FloPayAutomaticPaymentButton` when you want a single reusable button that:

package/dist/index.cjs

@@ -3611,6 +3611,11 @@ function FloPayCheckout({
           onSessionCompletedRef.current?.(sess.successUrl ?? "");
           return;
         }
+        if (sess.status === "expired") {
+          throw new import_shared7.FloPayError("Checkout session has expired.", "api_error", {
+            code: "checkout_session_expired"
+          });
+        }
         const effectiveMode = checkoutModeProp ?? sess.checkoutMode ?? "full";
         setCurrentMode(effectiveMode);
         const hasPayPalRedirectParams = typeof window !== "undefined" && new URLSearchParams(window.location.search).has("payment_intent");
@@ -3782,8 +3787,10 @@ function FloPayCheckout({
     ] });
   }
   if (loadError) {
-    if (errorNode) return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(import_jsx_runtime7.Fragment, { children: errorNode(loadError) });
-    return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
+    if (errorNode) {
+      return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(CheckoutContext.Provider, { value: checkoutValue, children: errorNode(loadError) });
+    }
+    return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(CheckoutContext.Provider, { value: checkoutValue, children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
       "div",
       {
         style: {
@@ -3794,7 +3801,7 @@ function FloPayCheckout({
         },
         children: loadError.message
       }
-    );
+    ) });
   }
   if (shouldShowInterimButtons) {
     return /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(import_jsx_runtime7.Fragment, { children: [
@@ -4933,6 +4940,11 @@ function FloPayAutomaticPaymentButton({
       });
       return;
     }
+    if (session.status === "expired") {
+      throw new import_shared10.FloPayError("Checkout session has expired.", "api_error", {
+        code: "checkout_session_expired"
+      });
+    }
     try {
       let paymentResult = null;
       const redirectResult = getRedirectResultFromCheckoutProcessError(apiResult.autoProcessingError);