From b8e1189024c9ae4b947401a01f13384f6fd1f4e9 Mon Sep 17 00:00:00 2001
From: Bushra Asif <bushraasif931@gmail.com>
Date: Tue, 23 Jun 2026 13:21:18 +0000
Subject: [PATCH 1/3] Make CardWalletSession changes backward compatible

---
 src/Api/Ecommerce/PaymentRequest.php   | 12 +++++++++++-
 src/Api/Payments/CardWalletSession.php | 19 ++++++++++++++++++-
 2 files changed, 29 insertions(+), 2 deletions(-)

diff --git a/src/Api/Ecommerce/PaymentRequest.php b/src/Api/Ecommerce/PaymentRequest.php
index cb41a40..a8c5090 100644
--- a/src/Api/Ecommerce/PaymentRequest.php
+++ b/src/Api/Ecommerce/PaymentRequest.php
@@ -307,7 +307,7 @@ public function setSessionId($sessionId)
      */
     protected function configureOptions(OptionsResolver $resolver)
     {
-        $resolver->setRequired(['terminal', 'shop_orderid', 'amount', 'currency']);
+        $this->setupRequirements($resolver);
         $resolver->setDefined([
             'language',
             'transaction_info',
@@ -359,6 +359,16 @@ protected function configureOptions(OptionsResolver $resolver)
         });
     }
 
+    /**
+     * @param OptionsResolver $resolver
+     *
+     * @return void
+     */
+    protected function setupRequirements(OptionsResolver $resolver)
+    {
+        $resolver->setRequired(['terminal', 'shop_orderid', 'amount', 'currency']);
+    }
+
     /**
      * Handle response
      *
diff --git a/src/Api/Payments/CardWalletSession.php b/src/Api/Payments/CardWalletSession.php
index 62d648a..e90beef 100644
--- a/src/Api/Payments/CardWalletSession.php
+++ b/src/Api/Payments/CardWalletSession.php
@@ -68,6 +68,15 @@ public function setApplePayRequestData(array $applePayRequestData)
         return $this;
     }
 
+    /**
+     * @param OptionsResolver $resolver
+     *
+     * @return void
+     */
+    protected function setupRequirements(OptionsResolver $resolver)
+    {
+    }
+
     /**
      * Configure options
      *
@@ -79,7 +88,15 @@ protected function configureOptions(OptionsResolver $resolver)
     {
         parent::configureOptions($resolver);
 
-        $resolver->setDefined(['validationUrl', 'domain', 'applePayRequestData']);
+        $resolver->setDefined([
+            'terminal',
+            'shop_orderid',
+            'amount',
+            'currency',
+            'validationUrl',
+            'domain',
+            'applePayRequestData'
+        ]);
 
         $resolver->addAllowedTypes('validationUrl', 'string');
         $resolver->addAllowedTypes('domain', 'string');

From 952132bf3ea578b91a4174503b1c73f1680e7f18 Mon Sep 17 00:00:00 2001
From: Bushra Asif <bushraasif931@gmail.com>
Date: Tue, 23 Jun 2026 13:26:03 +0000
Subject: [PATCH 2/3] Update version and release notes

---
 CHANGELOG.md        | 2 +-
 src/AbstractApi.php | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index d7b502c..b2c2a1a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,7 +4,7 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [3.6.0] - 2026-05-22
+## [3.6.1] - 2026-06-23
 ### Added
 - Add support for new parameters in `cardWallet/session` and `cardWallet/authorize`.
 
diff --git a/src/AbstractApi.php b/src/AbstractApi.php
index 6c7083f..d7da726 100644
--- a/src/AbstractApi.php
+++ b/src/AbstractApi.php
@@ -55,7 +55,7 @@ abstract class AbstractApi
     /**
      * PHP API version
      */
-    const PHP_API_VERSION = '3.6.0';
+    const PHP_API_VERSION = '3.6.1';
 
     /**
      * Event dispatcher

From 57063e4fee937c911dd7ecd3ab7c103622b21deb Mon Sep 17 00:00:00 2001
From: Bushra Asif <bushraasif931@gmail.com>
Date: Wed, 8 Jul 2026 13:14:10 +0000
Subject: [PATCH 3/3] Add note in the CHANGELOG

---
 CHANGELOG.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index b2c2a1a..846e986 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -8,6 +8,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 - Add support for new parameters in `cardWallet/session` and `cardWallet/authorize`.
 
+> **Note:** This change is backward compatible for existing merchants using the legacy Apple Pay integration. Merchants who want to migrate to the new Apple Pay flow can follow the migration guide below:
+>
+> [Migration guideline for legacy Apple Pay integration](https://documentation.altapay.com/Content/Ecom/Payment%20Types/Payment%20Provider%20Specifics/Apple%20Pay.htm)
+
 ## [3.5.9] - 2026-05-08
 ### Added
 - Refactor `checkoutSession` to extend `PaymentRequest` to enable support for all standard payment parameters.