@xpayeg/sdk 2.2.0 → 2.3.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @xpayeg/sdk
 
+## 2.3.0
+### Minor Changes
+
+
+
+- [#471](https://github.com/xpayeg/xpay/pull/471) [`e76a6c3`](https://github.com/xpayeg/xpay/commit/e76a6c3e5f73f4dcf1f108b6be0e1a63dce5d1b9) Thanks [@Elmosh](https://github.com/Elmosh)! - Deferred Elements accept `paymentMethodTypes` (e.g. `["card"]`) to restrict which payment methods the element renders. Narrow-only: the list is intersected with the methods enabled for your account, so a type you have not enabled is never rendered, and an empty intersection fails with `loaderror` instead of rendering an empty frame. Fixed for the element's lifetime; pass the same values when your server creates the session so display and acceptance match. One method per element is the pattern for per-method rows in your own selector.
+
 ## 2.2.0
 ### Minor Changes
 

package/dist/index.d.cts

@@ -3611,6 +3611,8 @@ interface ElementsOptionsClientSecret {
     amount?: never;
     /** Currency is only applicable in deferred mode (`mode: "payment"`). */
     currency?: never;
+    /** Only applicable in deferred mode. Session-first elements render the session's own payment method types, set when the session is created. */
+    paymentMethodTypes?: never;
     /** Appearance overrides for the checkout UI */
     appearance?: Appearance;
     /** Locale for the payment form — `"en"` (default) or `"ar"` */
@@ -3643,6 +3645,16 @@ interface ElementsOptionsMode {
     amount: number;
     /** Three-letter currency code (e.g. `"EGP"`). */
     currency: string;
+    /**
+     * Restrict which payment method types the element renders (e.g. `["card"]`).
+     * Narrow-only: the list is intersected with the payment methods enabled for
+     * your account, so a type that is not enabled is never rendered. If nothing
+     * survives the intersection the element fails to load with a `loaderror`.
+     * Fixed for the element's lifetime. Omit to render every enabled method.
+     * The same values are passed as `paymentMethodTypes` when your server
+     * creates the session at pay time, so display and acceptance match.
+     */
+    paymentMethodTypes?: string[];
     /** Either use mode or clientSecret when creating an Elements group. */
     clientSecret?: never;
     /** Appearance overrides for the checkout UI */

package/dist/index.d.mts

@@ -3611,6 +3611,8 @@ interface ElementsOptionsClientSecret {
     amount?: never;
     /** Currency is only applicable in deferred mode (`mode: "payment"`). */
     currency?: never;
+    /** Only applicable in deferred mode. Session-first elements render the session's own payment method types, set when the session is created. */
+    paymentMethodTypes?: never;
     /** Appearance overrides for the checkout UI */
     appearance?: Appearance;
     /** Locale for the payment form — `"en"` (default) or `"ar"` */
@@ -3643,6 +3645,16 @@ interface ElementsOptionsMode {
     amount: number;
     /** Three-letter currency code (e.g. `"EGP"`). */
     currency: string;
+    /**
+     * Restrict which payment method types the element renders (e.g. `["card"]`).
+     * Narrow-only: the list is intersected with the payment methods enabled for
+     * your account, so a type that is not enabled is never rendered. If nothing
+     * survives the intersection the element fails to load with a `loaderror`.
+     * Fixed for the element's lifetime. Omit to render every enabled method.
+     * The same values are passed as `paymentMethodTypes` when your server
+     * creates the session at pay time, so display and acceptance match.
+     */
+    paymentMethodTypes?: string[];
     /** Either use mode or clientSecret when creating an Elements group. */
     clientSecret?: never;
     /** Appearance overrides for the checkout UI */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xpayeg/sdk",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "XPay JavaScript SDK — loader and TypeScript types for embedding XPay payments",
   "license": "MIT",
   "type": "module",