@paykit-sdk/gopay 1.3.1 → 1.3.2

package/dist/gopay-provider.d.mts

@@ -54,7 +54,22 @@ declare class GoPayProvider extends AbstractPayKitProvider implements PayKitProv
     deleteCustomer: (id: string) => Promise<null>;
     retrieveCustomer: (id: string) => Promise<Customer | null>;
     createSubscription: (params: CreateSubscriptionSchema<GoPayMetadata["subscription"]>) => Promise<Subscription>;
-    updateSubscription: (id: string, params: UpdateSubscriptionSchema) => Promise<Subscription>;
+    /**
+     * `updateSubscription` is GoPay's real mechanism for collecting each
+     * charge on an ON_DEMAND recurring mandate - GoPay never charges these
+     * automatically, so every subsequent payment has to be triggered
+     * explicitly via `POST /payments/payment/{id}/create-recurrence`.
+     * Supply the charge via `provider_metadata.amount` (and optionally
+     * `currency`/`order_number`/`order_description`/`items`); `params.metadata`
+     * is stored on that charge the same way createCheckout/createPayment do.
+     *
+     * For AUTO cycles (DAY/WEEK/MONTH), GoPay already charges on its own
+     * schedule and there's nothing to trigger - calling this without
+     * `provider_metadata.amount` just re-fetches the current subscription.
+     *
+     * @see https://doc.gopay.com/#recurring-payments
+     */
+    updateSubscription: (id: string, params: UpdateSubscriptionSchema<GoPayMetadata["subscription"]>) => Promise<Subscription>;
     cancelSubscription: (id: string) => Promise<Subscription>;
     deleteSubscription: (id: string) => Promise<null>;
     retrieveSubscription: (id: string) => Promise<Subscription | null>;

package/dist/gopay-provider.d.ts

@@ -54,7 +54,22 @@ declare class GoPayProvider extends AbstractPayKitProvider implements PayKitProv
     deleteCustomer: (id: string) => Promise<null>;
     retrieveCustomer: (id: string) => Promise<Customer | null>;
     createSubscription: (params: CreateSubscriptionSchema<GoPayMetadata["subscription"]>) => Promise<Subscription>;
-    updateSubscription: (id: string, params: UpdateSubscriptionSchema) => Promise<Subscription>;
+    /**
+     * `updateSubscription` is GoPay's real mechanism for collecting each
+     * charge on an ON_DEMAND recurring mandate - GoPay never charges these
+     * automatically, so every subsequent payment has to be triggered
+     * explicitly via `POST /payments/payment/{id}/create-recurrence`.
+     * Supply the charge via `provider_metadata.amount` (and optionally
+     * `currency`/`order_number`/`order_description`/`items`); `params.metadata`
+     * is stored on that charge the same way createCheckout/createPayment do.
+     *
+     * For AUTO cycles (DAY/WEEK/MONTH), GoPay already charges on its own
+     * schedule and there's nothing to trigger - calling this without
+     * `provider_metadata.amount` just re-fetches the current subscription.
+     *
+     * @see https://doc.gopay.com/#recurring-payments
+     */
+    updateSubscription: (id: string, params: UpdateSubscriptionSchema<GoPayMetadata["subscription"]>) => Promise<Subscription>;
     cancelSubscription: (id: string) => Promise<Subscription>;
     deleteSubscription: (id: string) => Promise<null>;
     retrieveSubscription: (id: string) => Promise<Subscription | null>;

package/dist/gopay-provider.js

@@ -4178,7 +4178,7 @@ var Invoice$inboundSchema = (data, isSubscription) => {
   };
 };
 var Subscription$inboundSchema = (data) => {
-  const { item } = JSON.parse(
+  const { item, billing_interval: storedBillingInterval } = JSON.parse(
     decodeHtmlEntities(
       data.additional_params?.find(
         (param) => param.name === core.PAYKIT_METADATA_KEY
@@ -4191,7 +4191,18 @@ var Subscription$inboundSchema = (data) => {
     MONTH: "month",
     ON_DEMAND: "month"
   };
-  const billingInterval = billingIntervalMap[data.recurrence?.recurrence_cycle ?? "ON_DEMAND"];
+  const parseStoredBillingInterval = (stored) => {
+    if (typeof stored !== "string") return null;
+    if (stored === "day" || stored === "week" || stored === "month" || stored === "year") {
+      return stored;
+    }
+    const customMatch = /^custom:(\d+)ms$/.exec(stored);
+    if (customMatch) {
+      return { type: "custom", durationMs: Number(customMatch[1]) };
+    }
+    return null;
+  };
+  const billingInterval = parseStoredBillingInterval(storedBillingInterval) ?? billingIntervalMap[data.recurrence?.recurrence_cycle ?? "ON_DEMAND"];
   const recurrencePeriod = data.recurrence?.recurrence_period ?? 1;
   const recurrenceCycle = data.recurrence?.recurrence_cycle;
   const currentPeriodEnd = new Date(
@@ -4313,7 +4324,7 @@ var GoPayProvider = class extends core.AbstractPayKitProvider {
     });
   }
   providerName = providerName;
-  providerVersion = "1.3.1";
+  providerVersion = "1.3.2";
   _client;
   baseUrl;
   isSandbox;
@@ -4360,7 +4371,7 @@ var GoPayProvider = class extends core.AbstractPayKitProvider {
     }
     const { amount, currency = "CZK" } = core.validateRequiredKeys(
       ["amount", "currency"],
-      data.provider_metadata,
+      data.provider_metadata ?? {},
       "The following fields must be present in the provider_metadata of createCheckout: {keys}"
     );
     if (this.opts.debug) {
@@ -4496,7 +4507,7 @@ var GoPayProvider = class extends core.AbstractPayKitProvider {
     }
     const { success_url } = core.validateRequiredKeys(
       ["success_url"],
-      data.provider_metadata,
+      data.provider_metadata ?? {},
       "The following fields must be present in the provider_metadata of createSubscription: {keys}"
     );
     const billingInterval = data.billing_interval;
@@ -4513,22 +4524,22 @@ var GoPayProvider = class extends core.AbstractPayKitProvider {
     if (this.opts.debug) {
       if (isYear) {
         console.info(
-          "[PayKit/GoPay] GoPay does not support yearly recurrence. Falling back to ON_DEMAND \u2014 you must trigger each charge manually via createRecurrence(parentPaymentId, ...). See: https://doc.gopay.com/#recurring-on-demand"
+          "[PayKit/GoPay] GoPay does not support yearly recurrence. Falling back to ON_DEMAND \u2014 trigger each charge via paykit.subscriptions.update(id, { provider_metadata: { amount } }). See: https://doc.gopay.com/#recurring-on-demand"
         );
       }
       if (isCustom) {
         const durationMs = billingInterval.durationMs;
         console.info(
-          `[PayKit/GoPay] Custom interval (${durationMs}ms) is not supported by GoPay. Falling back to ON_DEMAND \u2014 trigger charges manually via createRecurrence(parentPaymentId, ...). See: https://doc.gopay.com/#recurring-on-demand`
+          `[PayKit/GoPay] Custom interval (${durationMs}ms) is not supported by GoPay. Falling back to ON_DEMAND \u2014 trigger each charge via paykit.subscriptions.update(id, { provider_metadata: { amount } }). See: https://doc.gopay.com/#recurring-on-demand`
         );
       }
       if (!isOnDemand) {
         console.info(
-          `[PayKit/GoPay] AUTO recurrence (${recurrenceCycle}) \u2014 GoPay charges automatically each cycle. No createRecurrence() call is needed. Set provider_metadata.end_date (ISO string, e.g. "2027-01-01") to control when the subscription ends. Defaults to 1 year from today.`
+          `[PayKit/GoPay] AUTO recurrence (${recurrenceCycle}) \u2014 GoPay charges automatically each cycle. No manual update() call is needed to collect charges. Set provider_metadata.end_date (ISO string, e.g. "2027-01-01") to control when the subscription ends. Defaults to 1 year from today.`
         );
       } else {
         console.info(
-          "[PayKit/GoPay] ON_DEMAND recurrence \u2014 you MUST call createRecurrence(parentPaymentId, ...) for each subsequent charge. GoPay will NOT charge automatically. Set provider_metadata.end_date (ISO string) to control the authorization window. Defaults to 1 year (custom interval) or 5 years (yearly interval)."
+          "[PayKit/GoPay] ON_DEMAND recurrence \u2014 you MUST call paykit.subscriptions.update(id, { provider_metadata: { amount } }) for each subsequent charge. GoPay will NOT charge automatically. Set provider_metadata.end_date (ISO string) to control the authorization window. Defaults to 1 year (custom interval) or 5 years (yearly interval)."
         );
       }
       if (!data.provider_metadata?.description) {
@@ -4581,7 +4592,8 @@ var GoPayProvider = class extends core.AbstractPayKitProvider {
         {
           name: data.item_id,
           amount: Number(data.amount),
-          count: data.quantity ?? 1
+          count: data.quantity ?? 1,
+          type: "ITEM"
         }
       ],
       recurrence,
@@ -4594,7 +4606,9 @@ var GoPayProvider = class extends core.AbstractPayKitProvider {
         [core.PAYKIT_METADATA_KEY]: JSON.stringify({
           item: data.item_id,
           qty: data.quantity,
-          // Store the original interval so createRecurrence callers know the intended cadence
+          // Store the original interval so Subscription$inboundSchema can
+          // recover it later - GoPay's recurrence_cycle collapses year and
+          // custom intervals down to ON_DEMAND and can't tell them apart.
           billing_interval: isCustom ? `custom:${billingInterval.durationMs}ms` : billingInterval
         })
       }).map(([name, value]) => ({ name, value: String(value) }))
@@ -4619,15 +4633,80 @@ var GoPayProvider = class extends core.AbstractPayKitProvider {
     }
     return Subscription$inboundSchema(response.value);
   };
+  /**
+   * `updateSubscription` is GoPay's real mechanism for collecting each
+   * charge on an ON_DEMAND recurring mandate - GoPay never charges these
+   * automatically, so every subsequent payment has to be triggered
+   * explicitly via `POST /payments/payment/{id}/create-recurrence`.
+   * Supply the charge via `provider_metadata.amount` (and optionally
+   * `currency`/`order_number`/`order_description`/`items`); `params.metadata`
+   * is stored on that charge the same way createCheckout/createPayment do.
+   *
+   * For AUTO cycles (DAY/WEEK/MONTH), GoPay already charges on its own
+   * schedule and there's nothing to trigger - calling this without
+   * `provider_metadata.amount` just re-fetches the current subscription.
+   *
+   * @see https://doc.gopay.com/#recurring-payments
+   */
   updateSubscription = async (id, params) => {
+    const chargeParams = params.provider_metadata;
+    if (chargeParams?.amount) {
+      const body = {
+        amount: chargeParams.amount,
+        currency: (chargeParams.currency ?? "CZK").toUpperCase(),
+        order_number: chargeParams.order_number ?? crypto__namespace.randomBytes(8).toString("hex").slice(0, 15),
+        order_description: chargeParams.order_description ?? `Recurring charge for payment ${id}`,
+        items: chargeParams.items ?? [
+          {
+            name: "recurring_charge",
+            amount: chargeParams.amount,
+            count: 1
+          }
+        ],
+        additional_params: Object.entries(params.metadata ?? {}).map(
+          ([name, value]) => ({ name, value: String(value) })
+        )
+      };
+      const response = await this._client.post(
+        `/payments/payment/${id}/create-recurrence`,
+        {
+          body: JSON.stringify(body),
+          headers: await this.tokenManager.getAuthHeaders()
+        }
+      );
+      if (!response.ok) {
+        throw new core.OperationFailedError(
+          "updateSubscription",
+          this.providerName,
+          {
+            cause: new Error(
+              `[PayKit/GoPay] Failed to create on-demand recurrence charge: ${JSON.stringify(response.error ?? response)}`
+            )
+          }
+        );
+      }
+      const parent = await this.retrieveSubscription(id);
+      if (!parent) {
+        throw new core.OperationFailedError(
+          "updateSubscription",
+          this.providerName,
+          {
+            cause: new Error(
+              "Failed to retrieve subscription after recurrence charge"
+            )
+          }
+        );
+      }
+      return parent;
+    }
     const subscription = await this.retrieveSubscription(id);
     if (!subscription) {
       throw new core.ProviderNotSupportedError(
         "updateSubscription",
         this.providerName,
         {
-          reason: "Gopay doesn't support updating subscriptions",
-          alternative: "Use the payment API instead and update the subscription manually"
+          reason: "GoPay doesn't support updating subscription fields directly",
+          alternative: "Pass provider_metadata.amount to trigger an on-demand recurrence charge instead"
         }
       );
     }

package/dist/gopay-provider.mjs

@@ -4156,7 +4156,7 @@ var Invoice$inboundSchema = (data, isSubscription) => {
   };
 };
 var Subscription$inboundSchema = (data) => {
-  const { item } = JSON.parse(
+  const { item, billing_interval: storedBillingInterval } = JSON.parse(
     decodeHtmlEntities(
       data.additional_params?.find(
         (param) => param.name === PAYKIT_METADATA_KEY
@@ -4169,7 +4169,18 @@ var Subscription$inboundSchema = (data) => {
     MONTH: "month",
     ON_DEMAND: "month"
   };
-  const billingInterval = billingIntervalMap[data.recurrence?.recurrence_cycle ?? "ON_DEMAND"];
+  const parseStoredBillingInterval = (stored) => {
+    if (typeof stored !== "string") return null;
+    if (stored === "day" || stored === "week" || stored === "month" || stored === "year") {
+      return stored;
+    }
+    const customMatch = /^custom:(\d+)ms$/.exec(stored);
+    if (customMatch) {
+      return { type: "custom", durationMs: Number(customMatch[1]) };
+    }
+    return null;
+  };
+  const billingInterval = parseStoredBillingInterval(storedBillingInterval) ?? billingIntervalMap[data.recurrence?.recurrence_cycle ?? "ON_DEMAND"];
   const recurrencePeriod = data.recurrence?.recurrence_period ?? 1;
   const recurrenceCycle = data.recurrence?.recurrence_cycle;
   const currentPeriodEnd = new Date(
@@ -4291,7 +4302,7 @@ var GoPayProvider = class extends AbstractPayKitProvider {
     });
   }
   providerName = providerName;
-  providerVersion = "1.3.1";
+  providerVersion = "1.3.2";
   _client;
   baseUrl;
   isSandbox;
@@ -4338,7 +4349,7 @@ var GoPayProvider = class extends AbstractPayKitProvider {
     }
     const { amount, currency = "CZK" } = validateRequiredKeys(
       ["amount", "currency"],
-      data.provider_metadata,
+      data.provider_metadata ?? {},
       "The following fields must be present in the provider_metadata of createCheckout: {keys}"
     );
     if (this.opts.debug) {
@@ -4474,7 +4485,7 @@ var GoPayProvider = class extends AbstractPayKitProvider {
     }
     const { success_url } = validateRequiredKeys(
       ["success_url"],
-      data.provider_metadata,
+      data.provider_metadata ?? {},
       "The following fields must be present in the provider_metadata of createSubscription: {keys}"
     );
     const billingInterval = data.billing_interval;
@@ -4491,22 +4502,22 @@ var GoPayProvider = class extends AbstractPayKitProvider {
     if (this.opts.debug) {
       if (isYear) {
         console.info(
-          "[PayKit/GoPay] GoPay does not support yearly recurrence. Falling back to ON_DEMAND \u2014 you must trigger each charge manually via createRecurrence(parentPaymentId, ...). See: https://doc.gopay.com/#recurring-on-demand"
+          "[PayKit/GoPay] GoPay does not support yearly recurrence. Falling back to ON_DEMAND \u2014 trigger each charge via paykit.subscriptions.update(id, { provider_metadata: { amount } }). See: https://doc.gopay.com/#recurring-on-demand"
         );
       }
       if (isCustom) {
         const durationMs = billingInterval.durationMs;
         console.info(
-          `[PayKit/GoPay] Custom interval (${durationMs}ms) is not supported by GoPay. Falling back to ON_DEMAND \u2014 trigger charges manually via createRecurrence(parentPaymentId, ...). See: https://doc.gopay.com/#recurring-on-demand`
+          `[PayKit/GoPay] Custom interval (${durationMs}ms) is not supported by GoPay. Falling back to ON_DEMAND \u2014 trigger each charge via paykit.subscriptions.update(id, { provider_metadata: { amount } }). See: https://doc.gopay.com/#recurring-on-demand`
         );
       }
       if (!isOnDemand) {
         console.info(
-          `[PayKit/GoPay] AUTO recurrence (${recurrenceCycle}) \u2014 GoPay charges automatically each cycle. No createRecurrence() call is needed. Set provider_metadata.end_date (ISO string, e.g. "2027-01-01") to control when the subscription ends. Defaults to 1 year from today.`
+          `[PayKit/GoPay] AUTO recurrence (${recurrenceCycle}) \u2014 GoPay charges automatically each cycle. No manual update() call is needed to collect charges. Set provider_metadata.end_date (ISO string, e.g. "2027-01-01") to control when the subscription ends. Defaults to 1 year from today.`
         );
       } else {
         console.info(
-          "[PayKit/GoPay] ON_DEMAND recurrence \u2014 you MUST call createRecurrence(parentPaymentId, ...) for each subsequent charge. GoPay will NOT charge automatically. Set provider_metadata.end_date (ISO string) to control the authorization window. Defaults to 1 year (custom interval) or 5 years (yearly interval)."
+          "[PayKit/GoPay] ON_DEMAND recurrence \u2014 you MUST call paykit.subscriptions.update(id, { provider_metadata: { amount } }) for each subsequent charge. GoPay will NOT charge automatically. Set provider_metadata.end_date (ISO string) to control the authorization window. Defaults to 1 year (custom interval) or 5 years (yearly interval)."
         );
       }
       if (!data.provider_metadata?.description) {
@@ -4559,7 +4570,8 @@ var GoPayProvider = class extends AbstractPayKitProvider {
         {
           name: data.item_id,
           amount: Number(data.amount),
-          count: data.quantity ?? 1
+          count: data.quantity ?? 1,
+          type: "ITEM"
         }
       ],
       recurrence,
@@ -4572,7 +4584,9 @@ var GoPayProvider = class extends AbstractPayKitProvider {
         [PAYKIT_METADATA_KEY]: JSON.stringify({
           item: data.item_id,
           qty: data.quantity,
-          // Store the original interval so createRecurrence callers know the intended cadence
+          // Store the original interval so Subscription$inboundSchema can
+          // recover it later - GoPay's recurrence_cycle collapses year and
+          // custom intervals down to ON_DEMAND and can't tell them apart.
           billing_interval: isCustom ? `custom:${billingInterval.durationMs}ms` : billingInterval
         })
       }).map(([name, value]) => ({ name, value: String(value) }))
@@ -4597,15 +4611,80 @@ var GoPayProvider = class extends AbstractPayKitProvider {
     }
     return Subscription$inboundSchema(response.value);
   };
+  /**
+   * `updateSubscription` is GoPay's real mechanism for collecting each
+   * charge on an ON_DEMAND recurring mandate - GoPay never charges these
+   * automatically, so every subsequent payment has to be triggered
+   * explicitly via `POST /payments/payment/{id}/create-recurrence`.
+   * Supply the charge via `provider_metadata.amount` (and optionally
+   * `currency`/`order_number`/`order_description`/`items`); `params.metadata`
+   * is stored on that charge the same way createCheckout/createPayment do.
+   *
+   * For AUTO cycles (DAY/WEEK/MONTH), GoPay already charges on its own
+   * schedule and there's nothing to trigger - calling this without
+   * `provider_metadata.amount` just re-fetches the current subscription.
+   *
+   * @see https://doc.gopay.com/#recurring-payments
+   */
   updateSubscription = async (id, params) => {
+    const chargeParams = params.provider_metadata;
+    if (chargeParams?.amount) {
+      const body = {
+        amount: chargeParams.amount,
+        currency: (chargeParams.currency ?? "CZK").toUpperCase(),
+        order_number: chargeParams.order_number ?? crypto.randomBytes(8).toString("hex").slice(0, 15),
+        order_description: chargeParams.order_description ?? `Recurring charge for payment ${id}`,
+        items: chargeParams.items ?? [
+          {
+            name: "recurring_charge",
+            amount: chargeParams.amount,
+            count: 1
+          }
+        ],
+        additional_params: Object.entries(params.metadata ?? {}).map(
+          ([name, value]) => ({ name, value: String(value) })
+        )
+      };
+      const response = await this._client.post(
+        `/payments/payment/${id}/create-recurrence`,
+        {
+          body: JSON.stringify(body),
+          headers: await this.tokenManager.getAuthHeaders()
+        }
+      );
+      if (!response.ok) {
+        throw new OperationFailedError(
+          "updateSubscription",
+          this.providerName,
+          {
+            cause: new Error(
+              `[PayKit/GoPay] Failed to create on-demand recurrence charge: ${JSON.stringify(response.error ?? response)}`
+            )
+          }
+        );
+      }
+      const parent = await this.retrieveSubscription(id);
+      if (!parent) {
+        throw new OperationFailedError(
+          "updateSubscription",
+          this.providerName,
+          {
+            cause: new Error(
+              "Failed to retrieve subscription after recurrence charge"
+            )
+          }
+        );
+      }
+      return parent;
+    }
     const subscription = await this.retrieveSubscription(id);
     if (!subscription) {
       throw new ProviderNotSupportedError(
         "updateSubscription",
         this.providerName,
         {
-          reason: "Gopay doesn't support updating subscriptions",
-          alternative: "Use the payment API instead and update the subscription manually"
+          reason: "GoPay doesn't support updating subscription fields directly",
+          alternative: "Pass provider_metadata.amount to trigger an on-demand recurrence charge instead"
         }
       );
     }

package/dist/index.js

@@ -4178,7 +4178,7 @@ var Invoice$inboundSchema = (data, isSubscription) => {
   };
 };
 var Subscription$inboundSchema = (data) => {
-  const { item } = JSON.parse(
+  const { item, billing_interval: storedBillingInterval } = JSON.parse(
     decodeHtmlEntities(
       data.additional_params?.find(
         (param) => param.name === core.PAYKIT_METADATA_KEY
@@ -4191,7 +4191,18 @@ var Subscription$inboundSchema = (data) => {
     MONTH: "month",
     ON_DEMAND: "month"
   };
-  const billingInterval = billingIntervalMap[data.recurrence?.recurrence_cycle ?? "ON_DEMAND"];
+  const parseStoredBillingInterval = (stored) => {
+    if (typeof stored !== "string") return null;
+    if (stored === "day" || stored === "week" || stored === "month" || stored === "year") {
+      return stored;
+    }
+    const customMatch = /^custom:(\d+)ms$/.exec(stored);
+    if (customMatch) {
+      return { type: "custom", durationMs: Number(customMatch[1]) };
+    }
+    return null;
+  };
+  const billingInterval = parseStoredBillingInterval(storedBillingInterval) ?? billingIntervalMap[data.recurrence?.recurrence_cycle ?? "ON_DEMAND"];
   const recurrencePeriod = data.recurrence?.recurrence_period ?? 1;
   const recurrenceCycle = data.recurrence?.recurrence_cycle;
   const currentPeriodEnd = new Date(
@@ -4313,7 +4324,7 @@ var GoPayProvider = class extends core.AbstractPayKitProvider {
     });
   }
   providerName = providerName;
-  providerVersion = "1.3.1";
+  providerVersion = "1.3.2";
   _client;
   baseUrl;
   isSandbox;
@@ -4360,7 +4371,7 @@ var GoPayProvider = class extends core.AbstractPayKitProvider {
     }
     const { amount, currency = "CZK" } = core.validateRequiredKeys(
       ["amount", "currency"],
-      data.provider_metadata,
+      data.provider_metadata ?? {},
       "The following fields must be present in the provider_metadata of createCheckout: {keys}"
     );
     if (this.opts.debug) {
@@ -4496,7 +4507,7 @@ var GoPayProvider = class extends core.AbstractPayKitProvider {
     }
     const { success_url } = core.validateRequiredKeys(
       ["success_url"],
-      data.provider_metadata,
+      data.provider_metadata ?? {},
       "The following fields must be present in the provider_metadata of createSubscription: {keys}"
     );
     const billingInterval = data.billing_interval;
@@ -4513,22 +4524,22 @@ var GoPayProvider = class extends core.AbstractPayKitProvider {
     if (this.opts.debug) {
       if (isYear) {
         console.info(
-          "[PayKit/GoPay] GoPay does not support yearly recurrence. Falling back to ON_DEMAND \u2014 you must trigger each charge manually via createRecurrence(parentPaymentId, ...). See: https://doc.gopay.com/#recurring-on-demand"
+          "[PayKit/GoPay] GoPay does not support yearly recurrence. Falling back to ON_DEMAND \u2014 trigger each charge via paykit.subscriptions.update(id, { provider_metadata: { amount } }). See: https://doc.gopay.com/#recurring-on-demand"
         );
       }
       if (isCustom) {
         const durationMs = billingInterval.durationMs;
         console.info(
-          `[PayKit/GoPay] Custom interval (${durationMs}ms) is not supported by GoPay. Falling back to ON_DEMAND \u2014 trigger charges manually via createRecurrence(parentPaymentId, ...). See: https://doc.gopay.com/#recurring-on-demand`
+          `[PayKit/GoPay] Custom interval (${durationMs}ms) is not supported by GoPay. Falling back to ON_DEMAND \u2014 trigger each charge via paykit.subscriptions.update(id, { provider_metadata: { amount } }). See: https://doc.gopay.com/#recurring-on-demand`
         );
       }
       if (!isOnDemand) {
         console.info(
-          `[PayKit/GoPay] AUTO recurrence (${recurrenceCycle}) \u2014 GoPay charges automatically each cycle. No createRecurrence() call is needed. Set provider_metadata.end_date (ISO string, e.g. "2027-01-01") to control when the subscription ends. Defaults to 1 year from today.`
+          `[PayKit/GoPay] AUTO recurrence (${recurrenceCycle}) \u2014 GoPay charges automatically each cycle. No manual update() call is needed to collect charges. Set provider_metadata.end_date (ISO string, e.g. "2027-01-01") to control when the subscription ends. Defaults to 1 year from today.`
         );
       } else {
         console.info(
-          "[PayKit/GoPay] ON_DEMAND recurrence \u2014 you MUST call createRecurrence(parentPaymentId, ...) for each subsequent charge. GoPay will NOT charge automatically. Set provider_metadata.end_date (ISO string) to control the authorization window. Defaults to 1 year (custom interval) or 5 years (yearly interval)."
+          "[PayKit/GoPay] ON_DEMAND recurrence \u2014 you MUST call paykit.subscriptions.update(id, { provider_metadata: { amount } }) for each subsequent charge. GoPay will NOT charge automatically. Set provider_metadata.end_date (ISO string) to control the authorization window. Defaults to 1 year (custom interval) or 5 years (yearly interval)."
         );
       }
       if (!data.provider_metadata?.description) {
@@ -4581,7 +4592,8 @@ var GoPayProvider = class extends core.AbstractPayKitProvider {
         {
           name: data.item_id,
           amount: Number(data.amount),
-          count: data.quantity ?? 1
+          count: data.quantity ?? 1,
+          type: "ITEM"
         }
       ],
       recurrence,
@@ -4594,7 +4606,9 @@ var GoPayProvider = class extends core.AbstractPayKitProvider {
         [core.PAYKIT_METADATA_KEY]: JSON.stringify({
           item: data.item_id,
           qty: data.quantity,
-          // Store the original interval so createRecurrence callers know the intended cadence
+          // Store the original interval so Subscription$inboundSchema can
+          // recover it later - GoPay's recurrence_cycle collapses year and
+          // custom intervals down to ON_DEMAND and can't tell them apart.
           billing_interval: isCustom ? `custom:${billingInterval.durationMs}ms` : billingInterval
         })
       }).map(([name, value]) => ({ name, value: String(value) }))
@@ -4619,15 +4633,80 @@ var GoPayProvider = class extends core.AbstractPayKitProvider {
     }
     return Subscription$inboundSchema(response.value);
   };
+  /**
+   * `updateSubscription` is GoPay's real mechanism for collecting each
+   * charge on an ON_DEMAND recurring mandate - GoPay never charges these
+   * automatically, so every subsequent payment has to be triggered
+   * explicitly via `POST /payments/payment/{id}/create-recurrence`.
+   * Supply the charge via `provider_metadata.amount` (and optionally
+   * `currency`/`order_number`/`order_description`/`items`); `params.metadata`
+   * is stored on that charge the same way createCheckout/createPayment do.
+   *
+   * For AUTO cycles (DAY/WEEK/MONTH), GoPay already charges on its own
+   * schedule and there's nothing to trigger - calling this without
+   * `provider_metadata.amount` just re-fetches the current subscription.
+   *
+   * @see https://doc.gopay.com/#recurring-payments
+   */
   updateSubscription = async (id, params) => {
+    const chargeParams = params.provider_metadata;
+    if (chargeParams?.amount) {
+      const body = {
+        amount: chargeParams.amount,
+        currency: (chargeParams.currency ?? "CZK").toUpperCase(),
+        order_number: chargeParams.order_number ?? crypto__namespace.randomBytes(8).toString("hex").slice(0, 15),
+        order_description: chargeParams.order_description ?? `Recurring charge for payment ${id}`,
+        items: chargeParams.items ?? [
+          {
+            name: "recurring_charge",
+            amount: chargeParams.amount,
+            count: 1
+          }
+        ],
+        additional_params: Object.entries(params.metadata ?? {}).map(
+          ([name, value]) => ({ name, value: String(value) })
+        )
+      };
+      const response = await this._client.post(
+        `/payments/payment/${id}/create-recurrence`,
+        {
+          body: JSON.stringify(body),
+          headers: await this.tokenManager.getAuthHeaders()
+        }
+      );
+      if (!response.ok) {
+        throw new core.OperationFailedError(
+          "updateSubscription",
+          this.providerName,
+          {
+            cause: new Error(
+              `[PayKit/GoPay] Failed to create on-demand recurrence charge: ${JSON.stringify(response.error ?? response)}`
+            )
+          }
+        );
+      }
+      const parent = await this.retrieveSubscription(id);
+      if (!parent) {
+        throw new core.OperationFailedError(
+          "updateSubscription",
+          this.providerName,
+          {
+            cause: new Error(
+              "Failed to retrieve subscription after recurrence charge"
+            )
+          }
+        );
+      }
+      return parent;
+    }
     const subscription = await this.retrieveSubscription(id);
     if (!subscription) {
       throw new core.ProviderNotSupportedError(
         "updateSubscription",
         this.providerName,
         {
-          reason: "Gopay doesn't support updating subscriptions",
-          alternative: "Use the payment API instead and update the subscription manually"
+          reason: "GoPay doesn't support updating subscription fields directly",
+          alternative: "Pass provider_metadata.amount to trigger an on-demand recurrence charge instead"
         }
       );
     }

package/dist/index.mjs

@@ -4156,7 +4156,7 @@ var Invoice$inboundSchema = (data, isSubscription) => {
   };
 };
 var Subscription$inboundSchema = (data) => {
-  const { item } = JSON.parse(
+  const { item, billing_interval: storedBillingInterval } = JSON.parse(
     decodeHtmlEntities(
       data.additional_params?.find(
         (param) => param.name === PAYKIT_METADATA_KEY
@@ -4169,7 +4169,18 @@ var Subscription$inboundSchema = (data) => {
     MONTH: "month",
     ON_DEMAND: "month"
   };
-  const billingInterval = billingIntervalMap[data.recurrence?.recurrence_cycle ?? "ON_DEMAND"];
+  const parseStoredBillingInterval = (stored) => {
+    if (typeof stored !== "string") return null;
+    if (stored === "day" || stored === "week" || stored === "month" || stored === "year") {
+      return stored;
+    }
+    const customMatch = /^custom:(\d+)ms$/.exec(stored);
+    if (customMatch) {
+      return { type: "custom", durationMs: Number(customMatch[1]) };
+    }
+    return null;
+  };
+  const billingInterval = parseStoredBillingInterval(storedBillingInterval) ?? billingIntervalMap[data.recurrence?.recurrence_cycle ?? "ON_DEMAND"];
   const recurrencePeriod = data.recurrence?.recurrence_period ?? 1;
   const recurrenceCycle = data.recurrence?.recurrence_cycle;
   const currentPeriodEnd = new Date(
@@ -4291,7 +4302,7 @@ var GoPayProvider = class extends AbstractPayKitProvider {
     });
   }
   providerName = providerName;
-  providerVersion = "1.3.1";
+  providerVersion = "1.3.2";
   _client;
   baseUrl;
   isSandbox;
@@ -4338,7 +4349,7 @@ var GoPayProvider = class extends AbstractPayKitProvider {
     }
     const { amount, currency = "CZK" } = validateRequiredKeys(
       ["amount", "currency"],
-      data.provider_metadata,
+      data.provider_metadata ?? {},
       "The following fields must be present in the provider_metadata of createCheckout: {keys}"
     );
     if (this.opts.debug) {
@@ -4474,7 +4485,7 @@ var GoPayProvider = class extends AbstractPayKitProvider {
     }
     const { success_url } = validateRequiredKeys(
       ["success_url"],
-      data.provider_metadata,
+      data.provider_metadata ?? {},
       "The following fields must be present in the provider_metadata of createSubscription: {keys}"
     );
     const billingInterval = data.billing_interval;
@@ -4491,22 +4502,22 @@ var GoPayProvider = class extends AbstractPayKitProvider {
     if (this.opts.debug) {
       if (isYear) {
         console.info(
-          "[PayKit/GoPay] GoPay does not support yearly recurrence. Falling back to ON_DEMAND \u2014 you must trigger each charge manually via createRecurrence(parentPaymentId, ...). See: https://doc.gopay.com/#recurring-on-demand"
+          "[PayKit/GoPay] GoPay does not support yearly recurrence. Falling back to ON_DEMAND \u2014 trigger each charge via paykit.subscriptions.update(id, { provider_metadata: { amount } }). See: https://doc.gopay.com/#recurring-on-demand"
         );
       }
       if (isCustom) {
         const durationMs = billingInterval.durationMs;
         console.info(
-          `[PayKit/GoPay] Custom interval (${durationMs}ms) is not supported by GoPay. Falling back to ON_DEMAND \u2014 trigger charges manually via createRecurrence(parentPaymentId, ...). See: https://doc.gopay.com/#recurring-on-demand`
+          `[PayKit/GoPay] Custom interval (${durationMs}ms) is not supported by GoPay. Falling back to ON_DEMAND \u2014 trigger each charge via paykit.subscriptions.update(id, { provider_metadata: { amount } }). See: https://doc.gopay.com/#recurring-on-demand`
         );
       }
       if (!isOnDemand) {
         console.info(
-          `[PayKit/GoPay] AUTO recurrence (${recurrenceCycle}) \u2014 GoPay charges automatically each cycle. No createRecurrence() call is needed. Set provider_metadata.end_date (ISO string, e.g. "2027-01-01") to control when the subscription ends. Defaults to 1 year from today.`
+          `[PayKit/GoPay] AUTO recurrence (${recurrenceCycle}) \u2014 GoPay charges automatically each cycle. No manual update() call is needed to collect charges. Set provider_metadata.end_date (ISO string, e.g. "2027-01-01") to control when the subscription ends. Defaults to 1 year from today.`
         );
       } else {
         console.info(
-          "[PayKit/GoPay] ON_DEMAND recurrence \u2014 you MUST call createRecurrence(parentPaymentId, ...) for each subsequent charge. GoPay will NOT charge automatically. Set provider_metadata.end_date (ISO string) to control the authorization window. Defaults to 1 year (custom interval) or 5 years (yearly interval)."
+          "[PayKit/GoPay] ON_DEMAND recurrence \u2014 you MUST call paykit.subscriptions.update(id, { provider_metadata: { amount } }) for each subsequent charge. GoPay will NOT charge automatically. Set provider_metadata.end_date (ISO string) to control the authorization window. Defaults to 1 year (custom interval) or 5 years (yearly interval)."
         );
       }
       if (!data.provider_metadata?.description) {
@@ -4559,7 +4570,8 @@ var GoPayProvider = class extends AbstractPayKitProvider {
         {
           name: data.item_id,
           amount: Number(data.amount),
-          count: data.quantity ?? 1
+          count: data.quantity ?? 1,
+          type: "ITEM"
         }
       ],
       recurrence,
@@ -4572,7 +4584,9 @@ var GoPayProvider = class extends AbstractPayKitProvider {
         [PAYKIT_METADATA_KEY]: JSON.stringify({
           item: data.item_id,
           qty: data.quantity,
-          // Store the original interval so createRecurrence callers know the intended cadence
+          // Store the original interval so Subscription$inboundSchema can
+          // recover it later - GoPay's recurrence_cycle collapses year and
+          // custom intervals down to ON_DEMAND and can't tell them apart.
           billing_interval: isCustom ? `custom:${billingInterval.durationMs}ms` : billingInterval
         })
       }).map(([name, value]) => ({ name, value: String(value) }))
@@ -4597,15 +4611,80 @@ var GoPayProvider = class extends AbstractPayKitProvider {
     }
     return Subscription$inboundSchema(response.value);
   };
+  /**
+   * `updateSubscription` is GoPay's real mechanism for collecting each
+   * charge on an ON_DEMAND recurring mandate - GoPay never charges these
+   * automatically, so every subsequent payment has to be triggered
+   * explicitly via `POST /payments/payment/{id}/create-recurrence`.
+   * Supply the charge via `provider_metadata.amount` (and optionally
+   * `currency`/`order_number`/`order_description`/`items`); `params.metadata`
+   * is stored on that charge the same way createCheckout/createPayment do.
+   *
+   * For AUTO cycles (DAY/WEEK/MONTH), GoPay already charges on its own
+   * schedule and there's nothing to trigger - calling this without
+   * `provider_metadata.amount` just re-fetches the current subscription.
+   *
+   * @see https://doc.gopay.com/#recurring-payments
+   */
   updateSubscription = async (id, params) => {
+    const chargeParams = params.provider_metadata;
+    if (chargeParams?.amount) {
+      const body = {
+        amount: chargeParams.amount,
+        currency: (chargeParams.currency ?? "CZK").toUpperCase(),
+        order_number: chargeParams.order_number ?? crypto.randomBytes(8).toString("hex").slice(0, 15),
+        order_description: chargeParams.order_description ?? `Recurring charge for payment ${id}`,
+        items: chargeParams.items ?? [
+          {
+            name: "recurring_charge",
+            amount: chargeParams.amount,
+            count: 1
+          }
+        ],
+        additional_params: Object.entries(params.metadata ?? {}).map(
+          ([name, value]) => ({ name, value: String(value) })
+        )
+      };
+      const response = await this._client.post(
+        `/payments/payment/${id}/create-recurrence`,
+        {
+          body: JSON.stringify(body),
+          headers: await this.tokenManager.getAuthHeaders()
+        }
+      );
+      if (!response.ok) {
+        throw new OperationFailedError(
+          "updateSubscription",
+          this.providerName,
+          {
+            cause: new Error(
+              `[PayKit/GoPay] Failed to create on-demand recurrence charge: ${JSON.stringify(response.error ?? response)}`
+            )
+          }
+        );
+      }
+      const parent = await this.retrieveSubscription(id);
+      if (!parent) {
+        throw new OperationFailedError(
+          "updateSubscription",
+          this.providerName,
+          {
+            cause: new Error(
+              "Failed to retrieve subscription after recurrence charge"
+            )
+          }
+        );
+      }
+      return parent;
+    }
     const subscription = await this.retrieveSubscription(id);
     if (!subscription) {
       throw new ProviderNotSupportedError(
         "updateSubscription",
         this.providerName,
         {
-          reason: "Gopay doesn't support updating subscriptions",
-          alternative: "Use the payment API instead and update the subscription manually"
+          reason: "GoPay doesn't support updating subscription fields directly",
+          alternative: "Pass provider_metadata.amount to trigger an on-demand recurrence charge instead"
         }
       );
     }

package/dist/utils/mapper.js

@@ -113,7 +113,7 @@ var Invoice$inboundSchema = (data, isSubscription) => {
   };
 };
 var Subscription$inboundSchema = (data) => {
-  const { item } = JSON.parse(
+  const { item, billing_interval: storedBillingInterval } = JSON.parse(
     decodeHtmlEntities(
       data.additional_params?.find(
         (param) => param.name === core.PAYKIT_METADATA_KEY
@@ -126,7 +126,18 @@ var Subscription$inboundSchema = (data) => {
     MONTH: "month",
     ON_DEMAND: "month"
   };
-  const billingInterval = billingIntervalMap[data.recurrence?.recurrence_cycle ?? "ON_DEMAND"];
+  const parseStoredBillingInterval = (stored) => {
+    if (typeof stored !== "string") return null;
+    if (stored === "day" || stored === "week" || stored === "month" || stored === "year") {
+      return stored;
+    }
+    const customMatch = /^custom:(\d+)ms$/.exec(stored);
+    if (customMatch) {
+      return { type: "custom", durationMs: Number(customMatch[1]) };
+    }
+    return null;
+  };
+  const billingInterval = parseStoredBillingInterval(storedBillingInterval) ?? billingIntervalMap[data.recurrence?.recurrence_cycle ?? "ON_DEMAND"];
   const recurrencePeriod = data.recurrence?.recurrence_period ?? 1;
   const recurrenceCycle = data.recurrence?.recurrence_cycle;
   const currentPeriodEnd = new Date(

package/dist/utils/mapper.mjs

@@ -111,7 +111,7 @@ var Invoice$inboundSchema = (data, isSubscription) => {
   };
 };
 var Subscription$inboundSchema = (data) => {
-  const { item } = JSON.parse(
+  const { item, billing_interval: storedBillingInterval } = JSON.parse(
     decodeHtmlEntities(
       data.additional_params?.find(
         (param) => param.name === PAYKIT_METADATA_KEY
@@ -124,7 +124,18 @@ var Subscription$inboundSchema = (data) => {
     MONTH: "month",
     ON_DEMAND: "month"
   };
-  const billingInterval = billingIntervalMap[data.recurrence?.recurrence_cycle ?? "ON_DEMAND"];
+  const parseStoredBillingInterval = (stored) => {
+    if (typeof stored !== "string") return null;
+    if (stored === "day" || stored === "week" || stored === "month" || stored === "year") {
+      return stored;
+    }
+    const customMatch = /^custom:(\d+)ms$/.exec(stored);
+    if (customMatch) {
+      return { type: "custom", durationMs: Number(customMatch[1]) };
+    }
+    return null;
+  };
+  const billingInterval = parseStoredBillingInterval(storedBillingInterval) ?? billingIntervalMap[data.recurrence?.recurrence_cycle ?? "ON_DEMAND"];
   const recurrencePeriod = data.recurrence?.recurrence_period ?? 1;
   const recurrenceCycle = data.recurrence?.recurrence_cycle;
   const currentPeriodEnd = new Date(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paykit-sdk/gopay",
-  "version": "1.3.1",
+  "version": "1.3.2",
   "description": "GoPay provider for PayKit",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -31,7 +31,7 @@
     "tsup": "^8.5.0",
     "typescript": "^5.9.2",
     "zod": "^3.24.2",
-    "@paykit-sdk/core": "1.3.1"
+    "@paykit-sdk/core": "1.3.2"
   },
   "publishConfig": {
     "access": "public"