From 447c64047cd79b9d0c4b8fd75cbcc575dd823f08 Mon Sep 17 00:00:00 2001
From: mustapayev <mustapayev@publicplan.de>
Date: Mon, 27 Jan 2025 08:27:00 +0100
Subject: [PATCH] docs: added comments into docs and examples

---
 docs/THREED-PAYMENT-EXAMPLE.md                      |  5 +++++
 ...ED-SECURE-AND-PAY-PAYMENT-IN-MODALBOX-EXAMPLE.md |  5 +++++
 examples/_common-codes/3d-host/index.php            |  6 +++++-
 examples/_common-codes/3d/form.php                  | 13 ++++++++++++-
 examples/_templates/_credit_card_form.php           |  2 +-
 examples/_templates/_render_payment_response.php    | 10 +++++-----
 6 files changed, 33 insertions(+), 8 deletions(-)

diff --git a/docs/THREED-PAYMENT-EXAMPLE.md b/docs/THREED-PAYMENT-EXAMPLE.md
index aa7c6d27..a02c391d 100644
--- a/docs/THREED-PAYMENT-EXAMPLE.md
+++ b/docs/THREED-PAYMENT-EXAMPLE.md
@@ -226,6 +226,11 @@ try {
         $paymentModel,
         $transactionType,
         $card,
+        /**
+         * MODEL_3D_SECURE veya MODEL_3D_PAY ödemelerde kredi kart verileri olmadan
+         * form verisini oluşturmak için true yapabilirsiniz.
+         * Yine de bazı gatewaylerde kartsız form verisi oluşturulamıyor.
+         */
         false
     );
 } catch (\InvalidArgumentException $e) {
diff --git a/docs/THREED-SECURE-AND-PAY-PAYMENT-IN-MODALBOX-EXAMPLE.md b/docs/THREED-SECURE-AND-PAY-PAYMENT-IN-MODALBOX-EXAMPLE.md
index c58f81b6..85a2d85b 100644
--- a/docs/THREED-SECURE-AND-PAY-PAYMENT-IN-MODALBOX-EXAMPLE.md
+++ b/docs/THREED-SECURE-AND-PAY-PAYMENT-IN-MODALBOX-EXAMPLE.md
@@ -145,6 +145,11 @@ try {
         $paymentModel,
         $transactionType,
         $card,
+        /**
+         * MODEL_3D_SECURE veya MODEL_3D_PAY ödemelerde kredi kart verileri olmadan
+         * form verisini oluşturmak için true yapabilirsiniz.
+         * Yine de bazı gatewaylerde kartsız form verisi oluşturulamıyor.
+         */
         false
     );
 } catch (\InvalidArgumentException $e) {
diff --git a/examples/_common-codes/3d-host/index.php b/examples/_common-codes/3d-host/index.php
index 6e25bfdb..f927f3e6 100644
--- a/examples/_common-codes/3d-host/index.php
+++ b/examples/_common-codes/3d-host/index.php
@@ -66,7 +66,11 @@
 });
 
 try {
-    $formData = $pos->get3DFormData($order, PosInterface::MODEL_3D_HOST, $transaction);
+    $formData = $pos->get3DFormData(
+        $order,
+        PosInterface::MODEL_3D_HOST,
+        $transaction
+    );
 } catch (\LogicException $e) {
     // ödeme modeli veya işlem tipi desteklenmiyorsa bu exception'i alırsınız.
     dd($e);
diff --git a/examples/_common-codes/3d/form.php b/examples/_common-codes/3d/form.php
index a3c27f9b..e9b9ec05 100644
--- a/examples/_common-codes/3d/form.php
+++ b/examples/_common-codes/3d/form.php
@@ -162,7 +162,18 @@ function (RequestDataPreparedEvent $requestDataPreparedEvent): void {
 // ============================================================================================
 
 try {
-    $formData = $pos->get3DFormData($order, $paymentModel, $transaction, $card, false);
+    $formData = $pos->get3DFormData(
+        $order,
+        $paymentModel,
+        $transaction,
+        $card,
+        /**
+         * MODEL_3D_SECURE veya MODEL_3D_PAY ödemelerde kredi kart verileri olmadan
+         * form verisini oluşturmak için true yapabilirsiniz.
+         * Yine de bazı gatewaylerde kartsız form verisi oluşturulamıyor.
+         */
+        false
+    );
 } catch (\InvalidArgumentException $e) {
     // örneğin kart bilgisi sağlanmadığında bu exception'i alırsınız.
     dd($e);
diff --git a/examples/_templates/_credit_card_form.php b/examples/_templates/_credit_card_form.php
index b2e73f6f..a6324da7 100644
--- a/examples/_templates/_credit_card_form.php
+++ b/examples/_templates/_credit_card_form.php
@@ -35,7 +35,7 @@
                 <label for="year">Expire Year</label>
                 <select name="year" id="year" class="form-select input-lg">
                     <option value="">Year</option>
-                    <?php for ($i = date('Y'); $i <= date('Y') + 20; $i++) : ?>
+                    <?php for ($i = date('Y'); $i <= date('Y') + 30; $i++) : ?>
                         <option value="<?= $i; ?>" <?= $i == $card->getExpireYear('Y') ? 'selected': null ?>><?= $i; ?></option>
                     <?php endfor; ?>
                 </select>
diff --git a/examples/_templates/_render_payment_response.php b/examples/_templates/_render_payment_response.php
index 5ca015c2..3598e4e6 100644
--- a/examples/_templates/_render_payment_response.php
+++ b/examples/_templates/_render_payment_response.php
@@ -23,18 +23,18 @@
     </dl>
     <hr>
     <dl class="row">
-        <dt class="col-sm-3">RetRefNum (iade, iptal, durum soruglama icin kullnilacak numara):</dt>
+        <dt class="col-sm-3">RetRefNum <small>(iade, iptal, durum sorgulama icin kullanilacak numara)</small>:</dt>
         <dd class="col-sm-9"><?= $response['ref_ret_num'] ?: '-'; ?></dd>
     </dl>
     <hr>
     <dl class="row">
-        <dt class="col-sm-3">ProcReturnCode:</dt>
-        <dd class="col-sm-9"><?= $response['proc_return_code'] ?: '-'; ?></dd>
+        <dt class="col-sm-3">Transaction ID <small>(iade, iptal, durum sorgulama icin kullanilacak numara)</small>:</dt>
+        <dd class="col-sm-9"><?= $response['transaction_id'] ?: '-'; ?></dd>
     </dl>
     <hr>
     <dl class="row">
-        <dt class="col-sm-3">Transaction ID:</dt>
-        <dd class="col-sm-9"><?= $response['transaction_id'] ?: '-'; ?></dd>
+        <dt class="col-sm-3">ProcReturnCode:</dt>
+        <dd class="col-sm-9"><?= $response['proc_return_code'] ?: '-'; ?></dd>
     </dl>
     <hr>
     <dl class="row">