@paykit-sdk/gopay 1.3.0 → 1.3.2

package/dist/gopay-provider.d.mts

@@ -44,6 +44,7 @@ declare class GoPayProvider extends AbstractPayKitProvider implements PayKitProv
     private tokenManager;
     get _native(): null;
     constructor(opts: GoPayOptions);
+    private submitPayment;
     createCheckout: (params: CreateCheckoutSchema<GoPayMetadata["checkout"]>) => Promise<Checkout>;
     retrieveCheckout: (id: string) => Promise<Checkout | null>;
     updateCheckout: (id: string, params: UpdateCheckoutSchema) => Promise<Checkout>;
@@ -53,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

@@ -44,6 +44,7 @@ declare class GoPayProvider extends AbstractPayKitProvider implements PayKitProv
     private tokenManager;
     get _native(): null;
     constructor(opts: GoPayOptions);
+    private submitPayment;
     createCheckout: (params: CreateCheckoutSchema<GoPayMetadata["checkout"]>) => Promise<Checkout>;
     retrieveCheckout: (id: string) => Promise<Checkout | null>;
     updateCheckout: (id: string, params: UpdateCheckoutSchema) => Promise<Checkout>;
@@ -53,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.0";
+  providerVersion = "1.3.2";
   _client;
   baseUrl;
   isSandbox;
@@ -4321,6 +4332,23 @@ var GoPayProvider = class extends core.AbstractPayKitProvider {
   get _native() {
     return null;
   }
+  async submitPayment(request, method) {
+    const response = await this._client.post(
+      "/payments/payment",
+      {
+        body: JSON.stringify(request),
+        headers: await this.tokenManager.getAuthHeaders()
+      }
+    );
+    if (!response.ok) {
+      throw new core.OperationFailedError(method, this.providerName, {
+        cause: new Error(
+          `Failed to submit payment: ${JSON.stringify(response.error ?? response)}`
+        )
+      });
+    }
+    return response.value;
+  }
   createCheckout = async (params) => {
     const { error, data } = core.createCheckoutSchema.safeParse(params);
     if (error) {
@@ -4343,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) {
@@ -4396,23 +4424,11 @@ var GoPayProvider = class extends core.AbstractPayKitProvider {
         value: String(value)
       }))
     };
-    const response = await this._client.post(
-      "/payments/payment",
-      {
-        body: JSON.stringify(goPayRequest),
-        headers: await this.tokenManager.getAuthHeaders()
-      }
+    const responseValue = await this.submitPayment(
+      goPayRequest,
+      "createCheckout"
     );
-    if (!response.ok) {
-      throw new core.OperationFailedError(
-        "createCheckout",
-        this.providerName,
-        {
-          cause: new Error("Failed to create checkout")
-        }
-      );
-    }
-    return Checkout$inboundSchema(response.value);
+    return Checkout$inboundSchema(responseValue);
   };
   retrieveCheckout = async (id) => {
     const response = await this._client.get(
@@ -4491,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;
@@ -4508,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) {
@@ -4576,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,
@@ -4589,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) }))
@@ -4614,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"
         }
       );
     }
@@ -4749,8 +4833,11 @@ var GoPayProvider = class extends core.AbstractPayKitProvider {
       // automatically captures the payment
       additional_params: Object.entries({
         ...data.metadata,
+        // Must use the same key ("item", not "itemId") that
+        // Payment$inboundSchema reads back out of additional_params -
+        // createCheckout uses this same key for the same reason.
         [core.PAYKIT_METADATA_KEY]: JSON.stringify({
-          itemId: data.item_id,
+          item: data.item_id,
           qty: 1
         })
       }).map(([name, value]) => ({
@@ -4758,25 +4845,11 @@ var GoPayProvider = class extends core.AbstractPayKitProvider {
         value: String(value)
       }))
     };
-    const response = await this._client.post(
-      "/payments/payment",
-      {
-        body: JSON.stringify(goPayRequest),
-        headers: await this.tokenManager.getAuthHeaders()
-      }
+    const responseValue = await this.submitPayment(
+      goPayRequest,
+      "createPayment"
     );
-    if (!response.ok) {
-      throw new core.OperationFailedError(
-        "createPayment",
-        this.providerName,
-        {
-          cause: new Error(
-            `Failed to create payment: ${JSON.stringify(response.error ?? response)}`
-          )
-        }
-      );
-    }
-    return Payment$inboundSchema(response.value);
+    return Payment$inboundSchema(responseValue);
   };
   retrievePayment = async (id) => {
     const response = await this._client.get(

package/dist/gopay-provider.mjs

@@ -1,4 +1,4 @@
-import { schema, AbstractPayKitProvider, HTTPClient, OAuth2TokenManager, createCheckoutSchema, ValidationError, isEmailCustomer, InvalidTypeError, validateRequiredKeys, PAYKIT_METADATA_KEY, OperationFailedError, ProviderNotSupportedError, createSubscriptionSchema, isIdCustomer, createPaymentSchema, ConfigurationError, createRefundSchema, WebhookError, tryCatchAsync, paykitEvent$InboundSchema, omitInternalMetadata } from '@paykit-sdk/core';
+import { schema, AbstractPayKitProvider, HTTPClient, OAuth2TokenManager, OperationFailedError, createCheckoutSchema, ValidationError, isEmailCustomer, InvalidTypeError, validateRequiredKeys, PAYKIT_METADATA_KEY, ProviderNotSupportedError, createSubscriptionSchema, isIdCustomer, createPaymentSchema, ConfigurationError, createRefundSchema, WebhookError, tryCatchAsync, paykitEvent$InboundSchema, omitInternalMetadata } from '@paykit-sdk/core';
 import * as crypto from 'crypto';
 
 var __defProp = Object.defineProperty;
@@ -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.0";
+  providerVersion = "1.3.2";
   _client;
   baseUrl;
   isSandbox;
@@ -4299,6 +4310,23 @@ var GoPayProvider = class extends AbstractPayKitProvider {
   get _native() {
     return null;
   }
+  async submitPayment(request, method) {
+    const response = await this._client.post(
+      "/payments/payment",
+      {
+        body: JSON.stringify(request),
+        headers: await this.tokenManager.getAuthHeaders()
+      }
+    );
+    if (!response.ok) {
+      throw new OperationFailedError(method, this.providerName, {
+        cause: new Error(
+          `Failed to submit payment: ${JSON.stringify(response.error ?? response)}`
+        )
+      });
+    }
+    return response.value;
+  }
   createCheckout = async (params) => {
     const { error, data } = createCheckoutSchema.safeParse(params);
     if (error) {
@@ -4321,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) {
@@ -4374,23 +4402,11 @@ var GoPayProvider = class extends AbstractPayKitProvider {
         value: String(value)
       }))
     };
-    const response = await this._client.post(
-      "/payments/payment",
-      {
-        body: JSON.stringify(goPayRequest),
-        headers: await this.tokenManager.getAuthHeaders()
-      }
+    const responseValue = await this.submitPayment(
+      goPayRequest,
+      "createCheckout"
     );
-    if (!response.ok) {
-      throw new OperationFailedError(
-        "createCheckout",
-        this.providerName,
-        {
-          cause: new Error("Failed to create checkout")
-        }
-      );
-    }
-    return Checkout$inboundSchema(response.value);
+    return Checkout$inboundSchema(responseValue);
   };
   retrieveCheckout = async (id) => {
     const response = await this._client.get(
@@ -4469,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;
@@ -4486,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) {
@@ -4554,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,
@@ -4567,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) }))
@@ -4592,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"
         }
       );
     }
@@ -4727,8 +4811,11 @@ var GoPayProvider = class extends AbstractPayKitProvider {
       // automatically captures the payment
       additional_params: Object.entries({
         ...data.metadata,
+        // Must use the same key ("item", not "itemId") that
+        // Payment$inboundSchema reads back out of additional_params -
+        // createCheckout uses this same key for the same reason.
         [PAYKIT_METADATA_KEY]: JSON.stringify({
-          itemId: data.item_id,
+          item: data.item_id,
           qty: 1
         })
       }).map(([name, value]) => ({
@@ -4736,25 +4823,11 @@ var GoPayProvider = class extends AbstractPayKitProvider {
         value: String(value)
       }))
     };
-    const response = await this._client.post(
-      "/payments/payment",
-      {
-        body: JSON.stringify(goPayRequest),
-        headers: await this.tokenManager.getAuthHeaders()
-      }
+    const responseValue = await this.submitPayment(
+      goPayRequest,
+      "createPayment"
     );
-    if (!response.ok) {
-      throw new OperationFailedError(
-        "createPayment",
-        this.providerName,
-        {
-          cause: new Error(
-            `Failed to create payment: ${JSON.stringify(response.error ?? response)}`
-          )
-        }
-      );
-    }
-    return Payment$inboundSchema(response.value);
+    return Payment$inboundSchema(responseValue);
   };
   retrievePayment = async (id) => {
     const response = await this._client.get(

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.0";
+  providerVersion = "1.3.2";
   _client;
   baseUrl;
   isSandbox;
@@ -4321,6 +4332,23 @@ var GoPayProvider = class extends core.AbstractPayKitProvider {
   get _native() {
     return null;
   }
+  async submitPayment(request, method) {
+    const response = await this._client.post(
+      "/payments/payment",
+      {
+        body: JSON.stringify(request),
+        headers: await this.tokenManager.getAuthHeaders()
+      }
+    );
+    if (!response.ok) {
+      throw new core.OperationFailedError(method, this.providerName, {
+        cause: new Error(
+          `Failed to submit payment: ${JSON.stringify(response.error ?? response)}`
+        )
+      });
+    }
+    return response.value;
+  }
   createCheckout = async (params) => {
     const { error, data } = core.createCheckoutSchema.safeParse(params);
     if (error) {
@@ -4343,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) {
@@ -4396,23 +4424,11 @@ var GoPayProvider = class extends core.AbstractPayKitProvider {
         value: String(value)
       }))
     };
-    const response = await this._client.post(
-      "/payments/payment",
-      {
-        body: JSON.stringify(goPayRequest),
-        headers: await this.tokenManager.getAuthHeaders()
-      }
+    const responseValue = await this.submitPayment(
+      goPayRequest,
+      "createCheckout"
     );
-    if (!response.ok) {
-      throw new core.OperationFailedError(
-        "createCheckout",
-        this.providerName,
-        {
-          cause: new Error("Failed to create checkout")
-        }
-      );
-    }
-    return Checkout$inboundSchema(response.value);
+    return Checkout$inboundSchema(responseValue);
   };
   retrieveCheckout = async (id) => {
     const response = await this._client.get(
@@ -4491,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;
@@ -4508,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) {
@@ -4576,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,
@@ -4589,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) }))
@@ -4614,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"
         }
       );
     }
@@ -4749,8 +4833,11 @@ var GoPayProvider = class extends core.AbstractPayKitProvider {
       // automatically captures the payment
       additional_params: Object.entries({
         ...data.metadata,
+        // Must use the same key ("item", not "itemId") that
+        // Payment$inboundSchema reads back out of additional_params -
+        // createCheckout uses this same key for the same reason.
         [core.PAYKIT_METADATA_KEY]: JSON.stringify({
-          itemId: data.item_id,
+          item: data.item_id,
           qty: 1
         })
       }).map(([name, value]) => ({
@@ -4758,25 +4845,11 @@ var GoPayProvider = class extends core.AbstractPayKitProvider {
         value: String(value)
       }))
     };
-    const response = await this._client.post(
-      "/payments/payment",
-      {
-        body: JSON.stringify(goPayRequest),
-        headers: await this.tokenManager.getAuthHeaders()
-      }
+    const responseValue = await this.submitPayment(
+      goPayRequest,
+      "createPayment"
     );
-    if (!response.ok) {
-      throw new core.OperationFailedError(
-        "createPayment",
-        this.providerName,
-        {
-          cause: new Error(
-            `Failed to create payment: ${JSON.stringify(response.error ?? response)}`
-          )
-        }
-      );
-    }
-    return Payment$inboundSchema(response.value);
+    return Payment$inboundSchema(responseValue);
   };
   retrievePayment = async (id) => {
     const response = await this._client.get(

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { schema, validateRequiredKeys, AbstractPayKitProvider, HTTPClient, OAuth2TokenManager, createCheckoutSchema, ValidationError, isEmailCustomer, InvalidTypeError, PAYKIT_METADATA_KEY, OperationFailedError, ProviderNotSupportedError, createSubscriptionSchema, isIdCustomer, createPaymentSchema, ConfigurationError, createRefundSchema, WebhookError, tryCatchAsync, paykitEvent$InboundSchema, omitInternalMetadata } from '@paykit-sdk/core';
+import { schema, validateRequiredKeys, AbstractPayKitProvider, HTTPClient, OAuth2TokenManager, OperationFailedError, createCheckoutSchema, ValidationError, isEmailCustomer, InvalidTypeError, PAYKIT_METADATA_KEY, ProviderNotSupportedError, createSubscriptionSchema, isIdCustomer, createPaymentSchema, ConfigurationError, createRefundSchema, WebhookError, tryCatchAsync, paykitEvent$InboundSchema, omitInternalMetadata } from '@paykit-sdk/core';
 import * as crypto from 'crypto';
 
 var __defProp = Object.defineProperty;
@@ -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.0";
+  providerVersion = "1.3.2";
   _client;
   baseUrl;
   isSandbox;
@@ -4299,6 +4310,23 @@ var GoPayProvider = class extends AbstractPayKitProvider {
   get _native() {
     return null;
   }
+  async submitPayment(request, method) {
+    const response = await this._client.post(
+      "/payments/payment",
+      {
+        body: JSON.stringify(request),
+        headers: await this.tokenManager.getAuthHeaders()
+      }
+    );
+    if (!response.ok) {
+      throw new OperationFailedError(method, this.providerName, {
+        cause: new Error(
+          `Failed to submit payment: ${JSON.stringify(response.error ?? response)}`
+        )
+      });
+    }
+    return response.value;
+  }
   createCheckout = async (params) => {
     const { error, data } = createCheckoutSchema.safeParse(params);
     if (error) {
@@ -4321,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) {
@@ -4374,23 +4402,11 @@ var GoPayProvider = class extends AbstractPayKitProvider {
         value: String(value)
       }))
     };
-    const response = await this._client.post(
-      "/payments/payment",
-      {
-        body: JSON.stringify(goPayRequest),
-        headers: await this.tokenManager.getAuthHeaders()
-      }
+    const responseValue = await this.submitPayment(
+      goPayRequest,
+      "createCheckout"
     );
-    if (!response.ok) {
-      throw new OperationFailedError(
-        "createCheckout",
-        this.providerName,
-        {
-          cause: new Error("Failed to create checkout")
-        }
-      );
-    }
-    return Checkout$inboundSchema(response.value);
+    return Checkout$inboundSchema(responseValue);
   };
   retrieveCheckout = async (id) => {
     const response = await this._client.get(
@@ -4469,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;
@@ -4486,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) {
@@ -4554,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,
@@ -4567,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) }))
@@ -4592,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"
         }
       );
     }
@@ -4727,8 +4811,11 @@ var GoPayProvider = class extends AbstractPayKitProvider {
       // automatically captures the payment
       additional_params: Object.entries({
         ...data.metadata,
+        // Must use the same key ("item", not "itemId") that
+        // Payment$inboundSchema reads back out of additional_params -
+        // createCheckout uses this same key for the same reason.
         [PAYKIT_METADATA_KEY]: JSON.stringify({
-          itemId: data.item_id,
+          item: data.item_id,
           qty: 1
         })
       }).map(([name, value]) => ({
@@ -4736,25 +4823,11 @@ var GoPayProvider = class extends AbstractPayKitProvider {
         value: String(value)
       }))
     };
-    const response = await this._client.post(
-      "/payments/payment",
-      {
-        body: JSON.stringify(goPayRequest),
-        headers: await this.tokenManager.getAuthHeaders()
-      }
+    const responseValue = await this.submitPayment(
+      goPayRequest,
+      "createPayment"
     );
-    if (!response.ok) {
-      throw new OperationFailedError(
-        "createPayment",
-        this.providerName,
-        {
-          cause: new Error(
-            `Failed to create payment: ${JSON.stringify(response.error ?? response)}`
-          )
-        }
-      );
-    }
-    return Payment$inboundSchema(response.value);
+    return Payment$inboundSchema(responseValue);
   };
   retrievePayment = async (id) => {
     const response = await this._client.get(

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.0",
+  "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.0"
+    "@paykit-sdk/core": "1.3.2"
   },
   "publishConfig": {
     "access": "public"