From e15e1e6159efa608f1fb64eac4da8d5341d2d832 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jakub=20Jasi=C5=84ski?= <jakub.jasinski@checkout.com>
Date: Wed, 4 Mar 2026 11:43:32 +0100
Subject: [PATCH 1/2] feat: add apm additional data to dc

---
 examples/dynamic-checkout/index.html          |  9 ++--
 src/dynamic-checkout/config/payment-config.ts |  4 ++
 src/dynamic-checkout/payment-methods/apm.ts   | 31 +++++++++----
 .../payment-methods/saved-apm.ts              |  8 +++-
 src/processout/processout.ts                  | 46 ++++++++++++-------
 5 files changed, 69 insertions(+), 29 deletions(-)

diff --git a/examples/dynamic-checkout/index.html b/examples/dynamic-checkout/index.html
index e8c126b..f2b1835 100644
--- a/examples/dynamic-checkout/index.html
+++ b/examples/dynamic-checkout/index.html
@@ -10,8 +10,8 @@
     <script>
       document.addEventListener("DOMContentLoaded", function () {
         // You need to replace these values with your own
-        const projectId = "test-proj_zkSfc1Cz6vPjhcLkapSpO7UtmCeYuavb"
-        const invoiceId = "iv_3AFPfYuavbUBf4rerB2VMHKUnmQjke59"
+        const projectId = "test-proj_qEi1u5BwoYcZb6mOMKDWIm4mpqKCq6bN"
+        const invoiceId = "iv_3ATdtCq6bNZf0KiXoF8x0F5t48HlHlmC"
         const clientSecret = ""
 
         const client = new ProcessOut.ProcessOut(projectId)
@@ -22,7 +22,10 @@
           capturePayments: false,
           allowFallbackToSale: false,
           showStatusMessage: false,
-          locale: "de",
+          locale: "en",
+          additionalData: {
+            issuer_id: "1234",
+          },
         })
 
         dynamicCheckout.mount("#dynamic-cko-container")
diff --git a/src/dynamic-checkout/config/payment-config.ts b/src/dynamic-checkout/config/payment-config.ts
index 8aa9a21..d787cc6 100644
--- a/src/dynamic-checkout/config/payment-config.ts
+++ b/src/dynamic-checkout/config/payment-config.ts
@@ -10,6 +10,7 @@ module ProcessOut {
     allowFallbackToSale?: boolean
     showStatusMessage?: boolean
     payButtonText?: string
+    additionalData?: Record<string, string>
   }
 
   export type DynamicCheckoutInternalConfigType = {
@@ -28,6 +29,7 @@ module ProcessOut {
     allowFallbackToSale: DynamicCheckoutPublicConfigType["allowFallbackToSale"] = false
     showStatusMessage: DynamicCheckoutPublicConfigType["showStatusMessage"] = true
     payButtonText: DynamicCheckoutPublicConfigType["payButtonText"] = ""
+    additionalData: DynamicCheckoutPublicConfigType["additionalData"] = {}
     invoiceDetails: DynamicCheckoutInternalConfigType["invoiceDetails"]
 
     constructor(config: DynamicCheckoutPublicConfigType) {
@@ -43,6 +45,7 @@ module ProcessOut {
         capturePayments: this.capturePayments,
         allowFallbackToSale: this.allowFallbackToSale,
         showStatusMessage: this.showStatusMessage,
+        additionalData: this.additionalData,
       }
     }
 
@@ -64,6 +67,7 @@ module ProcessOut {
       this.capturePayments = config.capturePayments || false
       this.allowFallbackToSale = config.allowFallbackToSale || false
       this.payButtonText = config.payButtonText || ""
+      this.additionalData = config.additionalData || {}
 
       if (config.showStatusMessage !== undefined && config.showStatusMessage !== null) {
         this.showStatusMessage = config.showStatusMessage
diff --git a/src/dynamic-checkout/payment-methods/apm.ts b/src/dynamic-checkout/payment-methods/apm.ts
index 552d79b..25267a9 100644
--- a/src/dynamic-checkout/payment-methods/apm.ts
+++ b/src/dynamic-checkout/payment-methods/apm.ts
@@ -86,15 +86,22 @@ module ProcessOut {
       requestOptions: RequestOptions,
     ) {
       const { apm } = this.paymentMethod
+      const { additionalData } = this.paymentConfig
+
+      const redirectUrl = additionalData
+        ? this.processOutInstance.appendAdditionalDataToUrl(apm.redirect_url, additionalData)
+        : apm.redirect_url
 
       DynamicCheckoutEventsUtils.dispatchPaymentSubmittedEvent({
         payment_method_name: apm.gateway_name,
       })
 
       this.processOutInstance.handleAction(
-        apm.redirect_url,
+        redirectUrl,
         paymentToken => {
-          this.resetContainerHtml().appendChild(new DynamicCheckoutInvoiceLoadingView(this.paymentConfig.locale).element)
+          this.resetContainerHtml().appendChild(
+            new DynamicCheckoutInvoiceLoadingView(this.paymentConfig.locale).element,
+          )
 
           this.processOutInstance.makeCardPayment(
             this.paymentConfig.invoiceId,
@@ -129,7 +136,8 @@ module ProcessOut {
             requestOptions,
             invoiceId => {
               this.resetContainerHtml().appendChild(
-                new DynamicCheckoutPaymentPendingView(this.processOutInstance, this.paymentConfig).element,
+                new DynamicCheckoutPaymentPendingView(this.processOutInstance, this.paymentConfig)
+                  .element,
               )
 
               DynamicCheckoutEventsUtils.dispatchPaymentPendingEvent(invoiceId, {
@@ -193,7 +201,8 @@ module ProcessOut {
 
           if (outcome === OUTCOME.Pending && !data.customer_action) {
             this.resetContainerHtml().appendChild(
-              new DynamicCheckoutPaymentPendingView(this.processOutInstance, this.paymentConfig).element,
+              new DynamicCheckoutPaymentPendingView(this.processOutInstance, this.paymentConfig)
+                .element,
             )
 
             DynamicCheckoutEventsUtils.dispatchPaymentPendingEvent(this.paymentConfig.invoiceId, {
@@ -206,7 +215,9 @@ module ProcessOut {
           this.processOutInstance.handleAction(
             data.customer_action.value,
             paymentToken => {
-              this.resetContainerHtml().appendChild(new DynamicCheckoutInvoiceLoadingView(this.paymentConfig.locale).element)
+              this.resetContainerHtml().appendChild(
+                new DynamicCheckoutInvoiceLoadingView(this.paymentConfig.locale).element,
+              )
 
               this.processOutInstance.makeCardPayment(
                 this.paymentConfig.invoiceId,
@@ -259,7 +270,10 @@ module ProcessOut {
                 requestOptions,
                 invoiceId => {
                   this.resetContainerHtml().appendChild(
-                    new DynamicCheckoutPaymentPendingView(this.processOutInstance, this.paymentConfig).element,
+                    new DynamicCheckoutPaymentPendingView(
+                      this.processOutInstance,
+                      this.paymentConfig,
+                    ).element,
                   )
 
                   DynamicCheckoutEventsUtils.dispatchPaymentPendingEvent(invoiceId, {
@@ -371,8 +385,9 @@ module ProcessOut {
         {
           tagName: "button",
           classNames: ["dco-payment-method-button-pay-button"],
-          textContent: this.paymentConfig.payButtonText
-            || `${Translations.getText(
+          textContent:
+            this.paymentConfig.payButtonText ||
+            `${Translations.getText(
               "continue-with-apm-button",
               this.paymentConfig.locale,
             )} ${this.paymentMethod.display.name}`,
diff --git a/src/dynamic-checkout/payment-methods/saved-apm.ts b/src/dynamic-checkout/payment-methods/saved-apm.ts
index 9d031a2..26a1b97 100644
--- a/src/dynamic-checkout/payment-methods/saved-apm.ts
+++ b/src/dynamic-checkout/payment-methods/saved-apm.ts
@@ -104,12 +104,18 @@ module ProcessOut {
       this.setButtonLoading()
 
       if (apm_customer_token.redirect_url) {
+        const { additionalData } = this.paymentConfig
+
+        const redirectUrl = additionalData
+          ? this.processOutInstance.appendAdditionalDataToUrl(apm_customer_token.redirect_url, additionalData)
+          : apm_customer_token.redirect_url
+
         DynamicCheckoutEventsUtils.dispatchPaymentSubmittedEvent({
           payment_method_name: apm.gateway_name,
         })
 
         return this.processOutInstance.handleAction(
-          apm_customer_token.redirect_url,
+          redirectUrl,
           paymentToken => {
             this.processOutInstance.makeCardPayment(
               invoiceId,
diff --git a/src/processout/processout.ts b/src/processout/processout.ts
index ecdebf6..2dced5e 100644
--- a/src/processout/processout.ts
+++ b/src/processout/processout.ts
@@ -1007,6 +1007,31 @@ module ProcessOut {
       })
     }
 
+    public appendAdditionalDataToUrl(url: string, additionalData: any): string {
+      if (!additionalData || Object.keys(additionalData).length === 0) {
+        return url
+      }
+
+      var query = this.buildAdditionalDataQuery(additionalData)
+
+      if (!query) {
+        return url
+      }
+
+      var separator = url.includes("?") ? "&" : "?"
+      return url + separator + query.substring(1)
+    }
+
+    public buildAdditionalDataQuery(additionalData: any): string {
+      var query = "?"
+
+      for (var key in additionalData) {
+        query += `${encodeURIComponent(`additional_data[${key}]`)}=${encodeURIComponent(additionalData[key])}&`
+      }
+
+      return query.substring(0, query.length - 1)
+    }
+
     /**
      * Returns the invoice action URL.
      * @param {InvoiceActionUrlProps} config
@@ -1022,17 +1047,10 @@ module ProcessOut {
         )
       }
 
-      var suffix = "?"
-      var additionalData = config.additionalData
-      for (var key in additionalData) {
-        suffix += `additional_data[${key}]=${encodeURI(additionalData[key])}&`
-      }
+      var suffix = this.buildAdditionalDataQuery(config.additionalData)
 
       var tokenSuffix = config.customerTokenId ? `/tokenized/${config.customerTokenId}` : ""
-      var path = `/${this.getProjectID()}/${invoiceId}/redirect/${gatewayConfID}${tokenSuffix}${suffix.substring(
-        0,
-        suffix.length - 1,
-      )}`
+      var path = `/${this.getProjectID()}/${invoiceId}/redirect/${gatewayConfID}${tokenSuffix}${suffix}`
       return this.endpoint("checkout", path)
     }
 
@@ -1265,17 +1283,11 @@ module ProcessOut {
         )
       }
 
-      var suffix = "?"
-      for (var key in additionalData) {
-        suffix += `additional_data[${key}]=${encodeURI(additionalData[key])}&`
-      }
+      var suffix = this.buildAdditionalDataQuery(additionalData)
 
       return this.endpoint(
         "checkout",
-        `/${this.getProjectID()}/${customerID}/${tokenID}/redirect/${gatewayConfID}${suffix.substring(
-          0,
-          suffix.length - 1,
-        )}`,
+        `/${this.getProjectID()}/${customerID}/${tokenID}/redirect/${gatewayConfID}${suffix}`,
       )
     }
 

From 80377739d6a8913bcc770decd0e5d253564fdf2c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jakub=20Jasi=C5=84ski?= <jakub.jasinski@checkout.com>
Date: Wed, 4 Mar 2026 11:44:23 +0100
Subject: [PATCH 2/2] bump version

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 681d0e0..ebf02f0 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "processout.js",
-  "version": "1.7.8",
+  "version": "1.7.9",
   "description": "ProcessOut.js is a JavaScript library for ProcessOut's payment processing API.",
   "scripts": {
     "build:processout": "tsc -p src/processout && uglifyjs --compress --keep-fnames --ie8 dist/processout.js -o dist/processout.js",