@paykit-sdk/gopay 1.1.2 → 1.1.4

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, ConfigurationError, createPaymentSchema, createRefundSchema, WebhookError, tryCatchAsync, paykitEvent$InboundSchema, omitInternalMetadata } from '@paykit-sdk/core';
+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 * as crypto from 'crypto';
 
 var __defProp = Object.defineProperty;
@@ -4049,10 +4049,12 @@ var NEVER = INVALID;
 var decodeHtmlEntities = (str) => {
   return str.replace(/"/g, '"').replace(/'/g, "'").replace(/"/g, '"').replace(/'/g, "'");
 };
-var paykitPayment$InboundSchema = (data) => {
+var Payment$inboundSchema = (data) => {
   const { item } = JSON.parse(
     decodeHtmlEntities(
-      data.additional_params?.find((param) => param.name === PAYKIT_METADATA_KEY)?.value ?? "{}"
+      data.additional_params?.find(
+        (param) => param.name === PAYKIT_METADATA_KEY
+      )?.value ?? "{}"
     )
   );
   const metadata = omitInternalMetadata(
@@ -4079,7 +4081,7 @@ var paykitPayment$InboundSchema = (data) => {
     id: data.id.toString(),
     amount: data.amount,
     currency: data.currency,
-    customer: data.payer?.contact?.email ? { email: data.payer.contact.email } : "",
+    customer: data.payer?.contact?.email ? { email: data.payer.contact.email } : null,
     status: statusMap[data.state],
     item_id: item,
     metadata,
@@ -4087,10 +4089,12 @@ var paykitPayment$InboundSchema = (data) => {
     payment_url: data.gw_url ?? null
   };
 };
-var paykitCheckout$InboundSchema = (data) => {
+var Checkout$inboundSchema = (data) => {
   const { item, qty, type } = JSON.parse(
     decodeHtmlEntities(
-      data.additional_params?.find((param) => param.name === PAYKIT_METADATA_KEY)?.value ?? "{}"
+      data.additional_params?.find(
+        (param) => param.name === PAYKIT_METADATA_KEY
+      )?.value ?? "{}"
     )
   );
   const metadata = omitInternalMetadata(
@@ -4106,24 +4110,28 @@ var paykitCheckout$InboundSchema = (data) => {
     id: data.id.toString(),
     amount: data.amount,
     currency: data.currency,
-    customer: data.payer?.contact?.email ? { email: data.payer.contact.email } : "",
+    customer: data.payer?.contact?.email ? { email: data.payer.contact.email } : null,
     payment_url: data.gw_url ?? "",
     metadata,
     session_type: type,
     products: [{ id: item, quantity: parseInt(qty) }]
   };
 };
-var paykitInvoice$InboundSchema = (data, isSubscription) => {
+var Invoice$inboundSchema = (data, isSubscription) => {
   const { item, qty } = JSON.parse(
     decodeHtmlEntities(
-      data.additional_params?.find((param) => param.name === PAYKIT_METADATA_KEY)?.value ?? "{}"
+      data.additional_params?.find(
+        (param) => param.name === PAYKIT_METADATA_KEY
+      )?.value ?? "{}"
     )
   );
   const status = (() => {
     if (data.state === "PAID") return "paid";
     return "open";
   })();
-  const paidAt = isSubscription ? new Date(data.recurrence?.recurrence_date_to ?? "") : /* @__PURE__ */ new Date();
+  const paidAt = isSubscription ? new Date(
+    data.recurrence?.recurrence_date_to ?? ""
+  ) : /* @__PURE__ */ new Date();
   const metadata = omitInternalMetadata(
     data.additional_params?.reduce(
       (acc, param) => {
@@ -4137,7 +4145,7 @@ var paykitInvoice$InboundSchema = (data, isSubscription) => {
     id: data.id.toString(),
     amount_paid: data.amount,
     currency: data.currency,
-    customer: data.payer?.contact?.email ? { email: data.payer.contact.email } : "",
+    customer: data.payer?.contact?.email ? { email: data.payer.contact.email } : null,
     status,
     paid_at: paidAt.toISOString(),
     metadata: metadata ?? {},
@@ -4147,10 +4155,12 @@ var paykitInvoice$InboundSchema = (data, isSubscription) => {
     line_items: [{ id: item, quantity: parseInt(qty) }]
   };
 };
-var paykitSubscription$InboundSchema = (data) => {
+var Subscription$inboundSchema = (data) => {
   const { item } = JSON.parse(
     decodeHtmlEntities(
-      data.additional_params?.find((param) => param.name === PAYKIT_METADATA_KEY)?.value ?? "{}"
+      data.additional_params?.find(
+        (param) => param.name === PAYKIT_METADATA_KEY
+      )?.value ?? "{}"
     )
   );
   const billingIntervalMap = {
@@ -4162,7 +4172,9 @@ var paykitSubscription$InboundSchema = (data) => {
   const billingInterval = billingIntervalMap[data.recurrence?.recurrence_cycle ?? "ON_DEMAND"];
   const recurrencePeriod = data.recurrence?.recurrence_period ?? 1;
   const recurrenceCycle = data.recurrence?.recurrence_cycle;
-  const currentPeriodEnd = new Date(data.recurrence?.recurrence_date_to ?? "");
+  const currentPeriodEnd = new Date(
+    data.recurrence?.recurrence_date_to ?? ""
+  );
   const currentPeriodStart = (() => {
     if (!currentPeriodEnd) return /* @__PURE__ */ new Date();
     const endDate = new Date(currentPeriodEnd);
@@ -4192,21 +4204,21 @@ var paykitSubscription$InboundSchema = (data) => {
     ) ?? {}
   );
   const requiresAction = data.state === "CREATED" ? true : false;
-  const status = (() => {
-    if (data.state === "CREATED") return "pending";
-    if (data.state === "PAID") return "active";
-    if (data.state === "CANCELED") return "canceled";
-    if (data.state === "TIMEOUTED") return "canceled";
-    if (data.state === "REFUNDED") return "canceled";
-    if (data.state === "PARTIALLY_REFUNDED") return "canceled";
-    if (data.state === "AUTHORIZED") return "active";
-    if (data.state === "PAYMENT_METHOD_CHOSEN") return "active";
-    return "pending";
-  })();
+  const subscriptionStatusMap = {
+    CREATED: "pending",
+    PAID: "active",
+    CANCELED: "canceled",
+    TIMEOUTED: "canceled",
+    REFUNDED: "canceled",
+    PARTIALLY_REFUNDED: "canceled",
+    AUTHORIZED: "active",
+    PAYMENT_METHOD_CHOSEN: "active"
+  };
+  const status = subscriptionStatusMap[data.state] ?? "expired";
   return {
     id: data.id.toString(),
     status,
-    customer: data.payer?.contact?.email ? { email: data.payer.contact.email } : "",
+    customer: data.payer?.contact?.email ? { email: data.payer.contact.email } : null,
     item_id: item,
     billing_interval: billingInterval,
     currency: data.currency,
@@ -4219,7 +4231,7 @@ var paykitSubscription$InboundSchema = (data) => {
     payment_url: requiresAction ? data.gw_url ?? null : null
   };
 };
-var paykitRefund$InboundSchema = (data) => {
+var Refund$inboundSchema = (data) => {
   return {
     id: data.id.toString(),
     amount: data.amount,
@@ -4245,6 +4257,7 @@ var GoPayProvider = class extends AbstractPayKitProvider {
   constructor(opts) {
     super(gopayOptionsSchema, opts, providerName);
     this.opts = opts;
+    this.isSandbox = opts.isSandbox;
     const debug = opts.debug ?? true;
     this.baseUrl = opts.isSandbox ? "https://gw.sandbox.gopay.com/api" : "https://gate.gopay.cz/api";
     this._client = new HTTPClient({
@@ -4256,7 +4269,10 @@ var GoPayProvider = class extends AbstractPayKitProvider {
       client: this._client,
       provider: this.providerName,
       tokenEndpoint: "/oauth2/token",
-      credentials: { username: opts.clientId, password: opts.clientSecret },
+      credentials: {
+        username: opts.clientId,
+        password: opts.clientSecret
+      },
       responseAdapter: (response) => ({
         accessToken: response.access_token,
         expiresIn: response.expires_in
@@ -4277,15 +4293,30 @@ var GoPayProvider = class extends AbstractPayKitProvider {
   providerName = providerName;
   _client;
   baseUrl;
+  isSandbox;
   tokenManager;
+  get _native() {
+    return null;
+  }
   createCheckout = async (params) => {
     const { error, data } = createCheckoutSchema.safeParse(params);
-    if (error) throw ValidationError.fromZodError(error, "gopay", "createCheckout");
+    if (error) {
+      throw ValidationError.fromZodError(
+        error,
+        "gopay",
+        "createCheckout"
+      );
+    }
     if (!isEmailCustomer(data.customer)) {
-      throw new InvalidTypeError("customer", "object (customer) with email", "string", {
-        provider: this.providerName,
-        method: "createCheckout"
-      });
+      throw new InvalidTypeError(
+        "customer",
+        "object (customer) with email",
+        "string",
+        {
+          provider: this.providerName,
+          method: "createCheckout"
+        }
+      );
     }
     const { amount, currency = "CZK" } = validateRequiredKeys(
       ["amount", "currency"],
@@ -4312,9 +4343,9 @@ var GoPayProvider = class extends AbstractPayKitProvider {
       },
       target: { type: "ACCOUNT", goid: parseInt(this.opts.goId) },
       amount: Number(amount),
-      currency,
+      currency: currency.toUpperCase(),
       order_number: crypto.randomBytes(8).toString("hex").slice(0, 15),
-      order_description: data.metadata?.description || "Checkout",
+      order_description: `Payment for ${data.item_id} by ${data.customer.email}`,
       items: [
         {
           name: data.item_id,
@@ -4324,7 +4355,10 @@ var GoPayProvider = class extends AbstractPayKitProvider {
         }
       ],
       lang: data.provider_metadata?.language ? data.provider_metadata.language : "EN",
-      callback: { return_url: data.success_url, notification_url: this.opts.webhookUrl },
+      callback: {
+        return_url: data.success_url,
+        notification_url: this.opts.webhookUrl
+      },
       additional_params: Object.entries({
         ...data.metadata,
         [PAYKIT_METADATA_KEY]: JSON.stringify({
@@ -4345,11 +4379,15 @@ var GoPayProvider = class extends AbstractPayKitProvider {
       }
     );
     if (!response.ok) {
-      throw new OperationFailedError("createCheckout", this.providerName, {
-        cause: new Error("Failed to create checkout")
-      });
+      throw new OperationFailedError(
+        "createCheckout",
+        this.providerName,
+        {
+          cause: new Error("Failed to create checkout")
+        }
+      );
     }
-    return paykitCheckout$InboundSchema(response.value);
+    return Checkout$inboundSchema(response.value);
   };
   retrieveCheckout = async (id) => {
     const response = await this._client.get(
@@ -4362,11 +4400,15 @@ var GoPayProvider = class extends AbstractPayKitProvider {
       }
     );
     if (!response.ok) {
-      throw new OperationFailedError("retrieveCheckout", this.providerName, {
-        cause: new Error("Failed to retrieve checkout")
-      });
+      throw new OperationFailedError(
+        "retrieveCheckout",
+        this.providerName,
+        {
+          cause: new Error("Failed to retrieve checkout")
+        }
+      );
     }
-    return paykitCheckout$InboundSchema(response.value);
+    return Checkout$inboundSchema(response.value);
   };
   updateCheckout = async (id, params) => {
     if (this.opts.debug) {
@@ -4384,91 +4426,116 @@ var GoPayProvider = class extends AbstractPayKitProvider {
     });
   };
   createCustomer = async (params) => {
-    if (this.cloudClient) {
-      return this.cloudClient.customers.create(params);
-    }
     throw new ProviderNotSupportedError("createCustomer", "gopay", {
-      reason: "Gopay doesn't support creating customers, use the cloud API instead by setting `cloudApiKey` in the options"
+      reason: "Gopay doesn't support creating customers"
     });
   };
   updateCustomer = async (id, params) => {
-    if (this.cloudClient) {
-      return this.cloudClient.customers.update(id, params);
-    }
     throw new ProviderNotSupportedError("updateCustomer", "gopay", {
-      reason: "Gopay doesn't support updating customers, use the cloud API instead by setting `cloudApiKey` in the options"
+      reason: "Gopay doesn't support updating customers"
     });
   };
   deleteCustomer = async (id) => {
-    if (this.cloudClient) {
-      this.cloudClient.customers.delete(id);
-      return null;
-    }
     throw new ProviderNotSupportedError("deleteCustomer", "gopay", {
-      reason: "Gopay doesn't support deleting customers, use the cloud API instead by setting `cloudApiKey` in the options"
+      reason: "Gopay doesn't support deleting customers"
     });
   };
   retrieveCustomer = async (id) => {
-    if (this.cloudClient) {
-      return this.cloudClient.customers.retrieve(id);
-    }
     throw new ProviderNotSupportedError("retrieveCustomer", "gopay", {
-      reason: "Gopay doesn't support retrieving customers, use the cloud API instead by setting `cloudApiKey` in the options"
+      reason: "Gopay doesn't support retrieving customers"
     });
   };
   createSubscription = async (params) => {
     const { error, data } = createSubscriptionSchema.safeParse(params);
-    if (error) throw ValidationError.fromZodError(error, "gopay", "createSubscription");
-    if (typeof data.customer == "string" || typeof data.customer === "object" && !data.customer.email) {
-      throw new InvalidTypeError("customer", "object (customer) with email", "string", {
-        provider: this.providerName,
-        method: "createCheckout"
-      });
+    if (error)
+      throw ValidationError.fromZodError(
+        error,
+        "gopay",
+        "createSubscription"
+      );
+    if (!isEmailCustomer(data.customer)) {
+      throw new InvalidTypeError(
+        "customer",
+        "object with email",
+        isIdCustomer(data.customer) ? "object with id" : typeof data.customer,
+        {
+          provider: this.providerName,
+          method: "createSubscription"
+        }
+      );
     }
     const { success_url } = validateRequiredKeys(
       ["success_url"],
       data.provider_metadata,
-      "The following fields must be present in the provider_metadata of createCheckout: {keys}"
+      "The following fields must be present in the provider_metadata of createSubscription: {keys}"
     );
+    const billingInterval = data.billing_interval;
+    const isCustom = typeof billingInterval === "object" && billingInterval.type === "custom";
+    const isYear = billingInterval === "year";
+    const isOnDemand = isCustom || isYear;
+    const intervalMap = {
+      day: "DAY",
+      week: "WEEK",
+      month: "MONTH",
+      year: "ON_DEMAND"
+    };
+    const recurrenceCycle = isCustom ? "ON_DEMAND" : intervalMap[billingInterval];
     if (this.opts.debug) {
-      if (data.billing_interval === "year") {
+      if (isYear) {
         console.info(
-          "GoPay does not support yearly subscriptions, the available options are `day`, `week`, `month` and `ON_DEMAND` \n raise an issue at https://github.com/usepaykit/paykit-sdk/issues if you need this feature"
+          "[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"
+        );
+      }
+      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`
+        );
+      }
+      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.`
+        );
+      } 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)."
         );
       }
       if (!data.provider_metadata?.description) {
         console.info(
-          `No description provided for the subscription \`provider_metadata.description\`, using default description \`Subscription by ${data.customer.email}\``
+          `[PayKit/GoPay] No \`provider_metadata.description\` provided. Using default: "Subscription by ${data.customer.email}"`
         );
       }
     }
-    const intervalMap = {
-      day: "DAY",
-      week: "WEEK",
-      month: "MONTH",
-      year: "ON_DEMAND"
+    const toDateString = (ms) => {
+      const d = new Date(ms);
+      return d.toISOString().split("T")[0];
     };
-    const recurrenceCycle = intervalMap?.[data.billing_interval] ?? "ON_DEMAND";
-    const currentPeriodEnd = (() => {
-      if (recurrenceCycle === "DAY") {
-        return new Date(Date.now() + 1 * 24 * 60 * 60 * 1e3).toISOString();
-      }
-      if (recurrenceCycle === "WEEK") {
-        return new Date(Date.now() + 7 * 24 * 60 * 60 * 1e3).toISOString();
-      }
-      if (recurrenceCycle === "MONTH") {
-        return new Date(Date.now() + 30 * 24 * 60 * 60 * 1e3).toISOString();
+    const GOPAY_MAX_DATE = "2099-12-30";
+    const endDateOverride = data.provider_metadata?.end_date;
+    const recurrenceDateTo = (() => {
+      if (endDateOverride) {
+        return endDateOverride < GOPAY_MAX_DATE ? endDateOverride : GOPAY_MAX_DATE;
       }
       if (recurrenceCycle === "ON_DEMAND") {
-        throw new ConfigurationError(
-          "ON_DEMAND subscriptions is not yet implemented by PayKit, please open an issue at https://github.com/usepaykit/paykit-sdk/issues",
-          {
-            provider: this.providerName
-          }
+        if (isCustom) {
+          return toDateString(Date.now() + 365 * 24 * 60 * 60 * 1e3);
+        }
+        return toDateString(
+          Date.now() + 5 * 365 * 24 * 60 * 60 * 1e3
         );
       }
-      throw new Error("Invalid billing interval: " + data.billing_interval);
+      return toDateString(Date.now() + 365 * 24 * 60 * 60 * 1e3);
     })();
+    const recurrencePeriod = data.provider_metadata?.recurrence_period ?? 1;
+    const recurrence = isOnDemand ? {
+      recurrence_cycle: recurrenceCycle,
+      recurrence_date_to: recurrenceDateTo
+    } : {
+      recurrence_cycle: recurrenceCycle,
+      recurrence_period: recurrencePeriod,
+      recurrence_date_to: recurrenceDateTo
+    };
     const goPaySubscriptionOptions = {
       payer: {
         allowed_payment_instruments: ["PAYMENT_CARD"],
@@ -4479,24 +4546,28 @@ var GoPayProvider = class extends AbstractPayKitProvider {
       amount: Number(data.amount),
       currency: data.currency ?? "CZK",
       order_number: crypto.randomBytes(8).toString("hex").slice(0, 15),
-      order_description: data.provider_metadata?.description ? data.provider_metadata.description : "Subscription by " + data.customer.email,
-      items: [{ name: data.item_id, amount: Number(data.amount), count: data.quantity }],
-      recurrence: {
-        recurrence_cycle: recurrenceCycle,
-        recurrence_period: data.quantity,
-        recurrence_date_to: currentPeriodEnd
+      order_description: data.provider_metadata?.description ? data.provider_metadata.description : `Subscription by ${data.customer.email}`,
+      items: [
+        {
+          name: data.item_id,
+          amount: Number(data.amount),
+          count: data.quantity ?? 1
+        }
+      ],
+      recurrence,
+      callback: {
+        return_url: success_url,
+        notification_url: this.opts.webhookUrl
       },
-      callback: { return_url: success_url, notification_url: this.opts.webhookUrl },
       additional_params: Object.entries({
         ...data.metadata,
         [PAYKIT_METADATA_KEY]: JSON.stringify({
           item: data.item_id,
-          qty: data.quantity
+          qty: data.quantity,
+          // Store the original interval so createRecurrence callers know the intended cadence
+          billing_interval: isCustom ? `custom:${billingInterval.durationMs}ms` : billingInterval
         })
-      }).map(([name, value]) => ({
-        name,
-        value: String(value)
-      }))
+      }).map(([name, value]) => ({ name, value: String(value) }))
     };
     const response = await this._client.post(
       "/payments/payment",
@@ -4506,28 +4577,42 @@ var GoPayProvider = class extends AbstractPayKitProvider {
       }
     );
     if (!response.ok) {
-      throw new OperationFailedError("createSubscription", this.providerName, {
-        cause: new Error("Failed to create subscription")
-      });
+      throw new OperationFailedError(
+        "createSubscription",
+        this.providerName,
+        {
+          cause: new Error(
+            `[PayKit/GoPay] Failed to create subscription. Error: ${response.error}`
+          )
+        }
+      );
     }
-    return paykitSubscription$InboundSchema(response.value);
+    return Subscription$inboundSchema(response.value);
   };
   updateSubscription = async (id, params) => {
     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"
-      });
+      throw new ProviderNotSupportedError(
+        "updateSubscription",
+        this.providerName,
+        {
+          reason: "Gopay doesn't support updating subscriptions",
+          alternative: "Use the payment API instead and update the subscription manually"
+        }
+      );
     }
     return subscription;
   };
   cancelSubscription = async (id) => {
     const existingSubscription = await this.retrieveSubscription(id);
     if (!existingSubscription) {
-      throw new OperationFailedError("cancelSubscription", this.providerName, {
-        cause: new Error("Failed to retrieve subscription")
-      });
+      throw new OperationFailedError(
+        "cancelSubscription",
+        this.providerName,
+        {
+          cause: new Error("Failed to retrieve subscription")
+        }
+      );
     }
     const response = await this._client.post(`/payments/payment/${id}/void-recurrence`, {
       headers: {
@@ -4537,7 +4622,9 @@ var GoPayProvider = class extends AbstractPayKitProvider {
     });
     return {
       ...existingSubscription,
-      ...response.value?.result == "FINISHED" && { status: "canceled" }
+      ...response.value?.result == "FINISHED" && {
+        status: "canceled"
+      }
     };
   };
   deleteSubscription = async (id) => {
@@ -4552,21 +4639,35 @@ var GoPayProvider = class extends AbstractPayKitProvider {
       }
     );
     if (!response.ok) {
-      throw new OperationFailedError("retrieveSubscription", this.providerName, {
-        cause: new Error("Failed to retrieve subscription")
-      });
+      throw new OperationFailedError(
+        "retrieveSubscription",
+        this.providerName,
+        {
+          cause: new Error("Failed to retrieve subscription")
+        }
+      );
     }
-    return paykitSubscription$InboundSchema(response.value);
+    return Subscription$inboundSchema(response.value);
   };
   createPayment = async (params) => {
     const { error, data } = createPaymentSchema.safeParse(params);
-    if (error)
-      throw ValidationError.fromZodError(error, this.providerName, "createPayment");
-    if (typeof data.customer == "string" || typeof data.customer === "object" && !data.customer?.email) {
-      throw new InvalidTypeError("customer", "object (customer) with email", "string", {
-        provider: this.providerName,
-        method: "createPayment"
-      });
+    if (error) {
+      throw ValidationError.fromZodError(
+        error,
+        this.providerName,
+        "createPayment"
+      );
+    }
+    if (!isEmailCustomer(data.customer)) {
+      throw new InvalidTypeError(
+        "customer",
+        "object with email",
+        isIdCustomer(data.customer) ? "object with id" : typeof data.customer,
+        {
+          provider: this.providerName,
+          method: "createPayment"
+        }
+      );
     }
     if (!data.item_id) {
       throw new ConfigurationError(
@@ -4577,23 +4678,54 @@ var GoPayProvider = class extends AbstractPayKitProvider {
         }
       );
     }
+    const successUrl = data.provider_metadata?.success_url;
+    if (!successUrl) {
+      throw new ConfigurationError(
+        "success_url is required, this is the URL to redirect the user to the success page after the payment is successful",
+        {
+          provider: this.providerName,
+          missingKeys: ["success_url"]
+        }
+      );
+    }
     const goPayRequest = {
       payer: {
         allowed_payment_instruments: ["PAYMENT_CARD", "BANK_ACCOUNT"],
         default_payment_instrument: "PAYMENT_CARD",
-        contact: { email: data.customer.email }
+        contact: { email: data.customer.email },
+        ...data.billing && {
+          city: data.billing.address.city,
+          postal_code: data.billing.address.postal_code,
+          country_code: data.billing.address.country,
+          phone_number: data.billing.address.phone
+        }
       },
       target: { type: "ACCOUNT", goid: parseInt(this.opts.goId) },
-      amount: data.amount,
+      amount: Number(data.amount),
       currency: data.currency ?? "CZK",
       order_number: crypto.randomBytes(8).toString("hex").slice(0, 15),
       order_description: `Payment for ${data.item_id} by ${data.customer.email}`,
-      items: [{ name: data.item_id, amount: data.amount, count: 1 }],
+      items: [
+        {
+          name: data.item_id,
+          amount: data.amount,
+          count: 1,
+          type: "ITEM"
+        }
+      ],
+      lang: data.provider_metadata?.language ? data.provider_metadata.language : "EN",
+      callback: {
+        return_url: successUrl,
+        notification_url: this.opts.webhookUrl
+      },
       preauthorization: false,
       // automatically captures the payment
       additional_params: Object.entries({
         ...data.metadata,
-        [PAYKIT_METADATA_KEY]: JSON.stringify({ itemId: data.item_id, qty: 1 })
+        [PAYKIT_METADATA_KEY]: JSON.stringify({
+          itemId: data.item_id,
+          qty: 1
+        })
       }).map(([name, value]) => ({
         name,
         value: String(value)
@@ -4607,11 +4739,17 @@ var GoPayProvider = class extends AbstractPayKitProvider {
       }
     );
     if (!response.ok) {
-      throw new OperationFailedError("createPayment", this.providerName, {
-        cause: new Error("Failed to create payment")
-      });
+      throw new OperationFailedError(
+        "createPayment",
+        this.providerName,
+        {
+          cause: new Error(
+            `Failed to create payment: ${JSON.stringify(response.error ?? response)}`
+          )
+        }
+      );
     }
-    return paykitPayment$InboundSchema(response.value);
+    return Payment$inboundSchema(response.value);
   };
   retrievePayment = async (id) => {
     const response = await this._client.get(
@@ -4624,17 +4762,25 @@ var GoPayProvider = class extends AbstractPayKitProvider {
       }
     );
     if (!response.ok) {
-      throw new OperationFailedError("retrievePayment", this.providerName, {
-        cause: new Error("Failed to retrieve payment")
-      });
+      throw new OperationFailedError(
+        "retrievePayment",
+        this.providerName,
+        {
+          cause: new Error("Failed to retrieve payment")
+        }
+      );
     }
-    return paykitPayment$InboundSchema(response.value);
+    return Payment$inboundSchema(response.value);
   };
   deletePayment = async (id) => {
-    throw new ProviderNotSupportedError("deletePayment", this.providerName, {
-      reason: "GoPay does not support deleting payments, use the",
-      alternative: "Use createRefund() instead to refund payments"
-    });
+    throw new ProviderNotSupportedError(
+      "deletePayment",
+      this.providerName,
+      {
+        reason: "GoPay does not support deleting payments, use the",
+        alternative: "Use createRefund() instead to refund payments"
+      }
+    );
   };
   capturePayment = async (id, params) => {
     const payment = await this._client.get(
@@ -4642,32 +4788,39 @@ var GoPayProvider = class extends AbstractPayKitProvider {
       { headers: await this.tokenManager.getAuthHeaders() }
     );
     if (!payment.ok) {
-      throw new OperationFailedError("capturePayment", this.providerName, {
-        cause: new Error("Failed to retrieve payment")
-      });
+      throw new OperationFailedError(
+        "capturePayment",
+        this.providerName,
+        {
+          cause: new Error("Failed to retrieve payment")
+        }
+      );
     }
     const { item, qty } = JSON.parse(
       decodeHtmlEntities(
-        payment.value.additional_params?.find((param) => param.name === PAYKIT_METADATA_KEY)?.value ?? "{}"
+        payment.value.additional_params?.find(
+          (param) => param.name === PAYKIT_METADATA_KEY
+        )?.value ?? "{}"
       )
     );
     if (!payment) {
-      throw new OperationFailedError("capturePayment", this.providerName, {
-        cause: new Error("Payment not found after capture")
-      });
+      throw new OperationFailedError(
+        "capturePayment",
+        this.providerName,
+        {
+          cause: new Error("Payment not found after capture")
+        }
+      );
     }
     const captureBody = {
       amount: params.amount,
       items: [{ name: item, amount: params.amount, count: qty }]
     };
-    await this._client.post(
-      `/payments/payment/${id}/capture`,
-      {
-        body: JSON.stringify(captureBody),
-        headers: await this.tokenManager.getAuthHeaders()
-      }
-    );
-    return paykitPayment$InboundSchema(payment.value);
+    await this._client.post(`/payments/payment/${id}/capture`, {
+      body: JSON.stringify(captureBody),
+      headers: await this.tokenManager.getAuthHeaders()
+    });
+    return Payment$inboundSchema(payment.value);
   };
   cancelPayment = async (id) => {
     await this._client.post(
@@ -4676,9 +4829,13 @@ var GoPayProvider = class extends AbstractPayKitProvider {
     );
     const payment = await this.retrievePayment(id);
     if (!payment) {
-      throw new OperationFailedError("cancelPayment", this.providerName, {
-        cause: new Error("Payment not found after cancellation")
-      });
+      throw new OperationFailedError(
+        "cancelPayment",
+        this.providerName,
+        {
+          cause: new Error("Payment not found after cancellation")
+        }
+      );
     }
     return payment;
   };
@@ -4689,34 +4846,52 @@ var GoPayProvider = class extends AbstractPayKitProvider {
     console.info("Gopay doesn't support updating payments");
     const existing = await this.retrievePayment(id);
     if (!existing) {
-      throw new OperationFailedError("updatePayment", this.providerName, {
-        cause: new Error("Failed to retrieve payment")
-      });
+      throw new OperationFailedError(
+        "updatePayment",
+        this.providerName,
+        {
+          cause: new Error("Failed to retrieve payment")
+        }
+      );
     }
     return existing;
   };
   async createRefund(params) {
     const { error, data } = createRefundSchema.safeParse(params);
     if (error) {
-      throw ValidationError.fromZodError(error, this.providerName, "createRefund");
+      throw ValidationError.fromZodError(
+        error,
+        this.providerName,
+        "createRefund"
+      );
     }
     const payment = await this.retrievePayment(data.payment_id);
     if (!payment) {
-      throw new OperationFailedError("createRefund", this.providerName, {
-        cause: new Error("Failed to retrieve payment")
-      });
+      throw new OperationFailedError(
+        "createRefund",
+        this.providerName,
+        {
+          cause: new Error("Failed to retrieve payment")
+        }
+      );
     }
     const response = await this._client.post(`/payments/payment/${data.payment_id}/refund`, {
-      body: new URLSearchParams({ amount: String(data.amount) }).toString(),
+      body: new URLSearchParams({
+        amount: String(data.amount)
+      }).toString(),
       headers: {
         ...await this.tokenManager.getAuthHeaders(),
         "Content-Type": "application/x-www-form-urlencoded"
       }
     });
     if (!response.ok) {
-      throw new OperationFailedError("createRefund", this.providerName, {
-        cause: new Error("Failed to create refund")
-      });
+      throw new OperationFailedError(
+        "createRefund",
+        this.providerName,
+        {
+          cause: new Error("Failed to create refund")
+        }
+      );
     }
     return {
       id: crypto.randomBytes(8).toString("hex").slice(0, 15),
@@ -4726,23 +4901,28 @@ var GoPayProvider = class extends AbstractPayKitProvider {
       metadata: data.metadata
     };
   }
-  handleWebhook = async (payload) => {
+  handleWebhook = async (payload, webhookSecret) => {
     const { fullUrl } = payload;
     const paymentId = new URL(fullUrl).searchParams.get("id");
     const parentId = new URL(fullUrl).searchParams.get("parent_id");
     if (!paymentId) {
-      throw new WebhookError("Payment ID is required", { provider: this.providerName });
+      throw new WebhookError("Payment ID is required", {
+        provider: this.providerName
+      });
     }
     if (this.opts.debug) {
       console.info("Received GoPay webhook for payment:", paymentId);
     }
     const [payment, error] = await tryCatchAsync(
-      this._client.get(`/payments/payment/${paymentId}`, {
-        headers: {
-          ...await this.tokenManager.getAuthHeaders(),
-          "Content-Type": "application/x-www-form-urlencoded"
+      this._client.get(
+        `/payments/payment/${paymentId}`,
+        {
+          headers: {
+            ...await this.tokenManager.getAuthHeaders(),
+            "Content-Type": "application/x-www-form-urlencoded"
+          }
         }
-      })
+      )
     );
     if (error) {
       throw new WebhookError("Failed to retrieve payment", {
@@ -4750,10 +4930,15 @@ var GoPayProvider = class extends AbstractPayKitProvider {
       });
     }
     if (!payment.value) {
-      throw new WebhookError("Payment not found", { provider: this.providerName });
+      throw new WebhookError("Payment not found", {
+        provider: this.providerName
+      });
     }
     if (this.opts.debug) {
-      console.info("Webhook verified successfully, status:", payment.value.state);
+      console.info(
+        "Webhook verified successfully, status:",
+        payment.value.state
+      );
     }
     const statusMap = {
       CREATED: "pending",
@@ -4772,7 +4957,7 @@ var GoPayProvider = class extends AbstractPayKitProvider {
       __INDETERMINATE: (data) => {
         const isRefundEvent = data.state === "REFUNDED" || data.state === "PARTIALLY_REFUNDED";
         if (isRefundEvent) {
-          const refund = paykitRefund$InboundSchema(data);
+          const refund = Refund$inboundSchema(data);
           return [
             paykitEvent$InboundSchema({
               type: "refund.created",
@@ -4785,7 +4970,7 @@ var GoPayProvider = class extends AbstractPayKitProvider {
         return [];
       },
       pending: (data) => {
-        const payment2 = paykitPayment$InboundSchema(data);
+        const payment2 = Payment$inboundSchema(data);
         return [
           paykitEvent$InboundSchema({
             type: "payment.created",
@@ -4796,7 +4981,7 @@ var GoPayProvider = class extends AbstractPayKitProvider {
         ];
       },
       processing: (data) => {
-        const payment2 = paykitPayment$InboundSchema(data);
+        const payment2 = Payment$inboundSchema(data);
         return [
           paykitEvent$InboundSchema({
             type: "payment.updated",
@@ -4807,7 +4992,7 @@ var GoPayProvider = class extends AbstractPayKitProvider {
         ];
       },
       requires_capture: (data) => {
-        const payment2 = paykitPayment$InboundSchema(data);
+        const payment2 = Payment$inboundSchema(data);
         return [
           paykitEvent$InboundSchema({
             type: "payment.updated",
@@ -4818,9 +5003,9 @@ var GoPayProvider = class extends AbstractPayKitProvider {
         ];
       },
       canceled: (data) => {
-        const payment2 = paykitPayment$InboundSchema(data);
+        const payment2 = Payment$inboundSchema(data);
         const isCancellingSubscription = parentId && data.recurrence?.recurrence_state == "STOPPED";
-        const subscription = paykitSubscription$InboundSchema(
+        const subscription = Subscription$inboundSchema(
           data
         );
         const subscriptionCanceledWebhookEvent = {
@@ -4830,9 +5015,13 @@ var GoPayProvider = class extends AbstractPayKitProvider {
           data: subscription
         };
         return [
-          ...isCancellingSubscription ? [paykitEvent$InboundSchema(subscriptionCanceledWebhookEvent)] : [],
+          ...isCancellingSubscription ? [
+            paykitEvent$InboundSchema(
+              subscriptionCanceledWebhookEvent
+            )
+          ] : [],
           paykitEvent$InboundSchema({
-            type: "payment.canceled",
+            type: "payment.failed",
             created: (/* @__PURE__ */ new Date()).getTime(),
             id: crypto.randomBytes(8).toString("hex").slice(0, 15),
             data: payment2
@@ -4840,10 +5029,10 @@ var GoPayProvider = class extends AbstractPayKitProvider {
         ];
       },
       failed: (data) => {
-        const payment2 = paykitPayment$InboundSchema(data);
+        const payment2 = Payment$inboundSchema(data);
         return [
           paykitEvent$InboundSchema({
-            type: "payment.canceled",
+            type: "payment.failed",
             created: (/* @__PURE__ */ new Date()).getTime(),
             id: crypto.randomBytes(8).toString("hex").slice(0, 15),
             data: payment2
@@ -4851,9 +5040,9 @@ var GoPayProvider = class extends AbstractPayKitProvider {
         ];
       },
       succeeded: (data) => {
-        const payment2 = paykitPayment$InboundSchema(data);
-        const invoice = paykitInvoice$InboundSchema(data, !!parentId);
-        const subscription = paykitSubscription$InboundSchema(
+        const payment2 = Payment$inboundSchema(data);
+        const invoice = Invoice$inboundSchema(data, !!parentId);
+        const subscription = Subscription$inboundSchema(
           data
         );
         const subscriptionCreatedWebhookEvent = {
@@ -4863,7 +5052,11 @@ var GoPayProvider = class extends AbstractPayKitProvider {
           data: subscription
         };
         return [
-          ...parentId ? [paykitEvent$InboundSchema(subscriptionCreatedWebhookEvent)] : [],
+          ...parentId ? [
+            paykitEvent$InboundSchema(
+              subscriptionCreatedWebhookEvent
+            )
+          ] : [],
           paykitEvent$InboundSchema({
             type: "invoice.generated",
             created: (/* @__PURE__ */ new Date()).getTime(),
@@ -4871,7 +5064,7 @@ var GoPayProvider = class extends AbstractPayKitProvider {
             data: invoice
           }),
           paykitEvent$InboundSchema({
-            type: "payment.created",
+            type: "payment.succeeded",
             created: (/* @__PURE__ */ new Date()).getTime(),
             id: crypto.randomBytes(8).toString("hex").slice(0, 15),
             data: payment2
@@ -4879,7 +5072,7 @@ var GoPayProvider = class extends AbstractPayKitProvider {
         ];
       },
       requires_action: (data) => {
-        const payment2 = paykitPayment$InboundSchema(data);
+        const payment2 = Payment$inboundSchema(data);
         return [
           paykitEvent$InboundSchema({
             type: "payment.updated",