From 3c21df6c1a991d314e8f229f70a70a882b4bcf7d Mon Sep 17 00:00:00 2001
From: arebra <are.brandt-gundersen@payex.com>
Date: Wed, 25 Sep 2024 14:05:07 +0200
Subject: [PATCH 1/2] DEVP-452: First edition of UI migration

---
 .../display-payment-ui/ui-migration.md        | 103 +++++++++++++++++
 .../checkout-v2/ui-migration.md               |  34 ++++++
 .../payment-menu-v2/ui-migration.md           | 109 ++++++++++++++++++
 3 files changed, 246 insertions(+)
 create mode 100644 checkout-v3/get-started/display-payment-ui/ui-migration.md
 create mode 100644 old-implementations/checkout-v2/ui-migration.md
 create mode 100644 old-implementations/payment-menu-v2/ui-migration.md

diff --git a/checkout-v3/get-started/display-payment-ui/ui-migration.md b/checkout-v3/get-started/display-payment-ui/ui-migration.md
new file mode 100644
index 0000000000..5584077980
--- /dev/null
+++ b/checkout-v3/get-started/display-payment-ui/ui-migration.md
@@ -0,0 +1,103 @@
+---
+title: Change UI Option
+permalink: /:path/ui-migration/
+description: |
+    Walking you through switching from Seamless View to Redirect
+menu_order: 7
+---
+
+Due to changes in [PCI-DSS requirements][pci]{:target="_blank"} coming with v4
+in March 2025, using [Seamless View][seamless-view] to display the payment UI
+will give you, as a merchant, more responsibilities than using our
+[Redirect][redirect] integration. This is because Seamless View is hosted by
+you. As the Redirect page is hosted by us, we also handle the responsibilities.
+
+To read more about how PCI-DSS affects you, we have further reading avaliable
+in [Danish][da]{:target="_blank"}, [Finnish][fi]{:target="_blank"},
+[Norwegian][no]{:target="_blank"} and [Swedish][se]{:target="_blank"}.
+
+If you currently have a Seamless View integration and don't want the impending
+responsibilities, switcing to Redirect is a very manageable task. Here's what
+you need to do:
+
+#### Use Redirect Operation
+
+In the operations node of the [payment response][post-response], right next to
+`view-checkout` which you should currently be using, you'll find
+`redirect-checkout`. The corresponding `href` contains a url which leads to the
+Redirect UI. All you need to do is send the payer to this address.
+
+{% capture response_content %}{
+    "operations": [
+        {
+          "method": "GET",
+          "href": "https://ecom.externalintegration.payex.com/payment/menu/b934d6f84a89a01852eea01190c2bbcc937ba29228ca7502df8592975ee3bb0d?_tc_tid=30f2168171e142d38bcd4af2c3721959",
+          "rel": "redirect-checkout",
+          "contentType": "text/html"
+        },
+    ]
+}{% endcapture %}
+
+ {% include code-example.html
+    title='Redirect-Checkout Operation'
+    header=response_header
+    json= response_content
+    %}
+
+#### Remove Seamless View Code
+
+You can remove all code related to the `<script>` element used to load the
+Seamless View.
+
+#### Change URLs
+
+Finally, you need to do some changes to the `urls` node in your
+[payment request][post-request]. The `hostUrls` and `paymentUrl` fields are
+specific to Seamless View and can be **removed**.
+
+The url you need to **add** is the `cancelUrl`, so we know where to redirect the
+payer if they chose to cancel, or you chose to abort the payment.
+
+If you have permission to [add your own logo][custom-logo], a `logoUrl` is also
+needed. If no `logoUrl` is added or no agreement is in place to have your own
+logo, Swedbank Pay's logo will be shown by default.
+
+The `completeUrl` and `callbackUrl` is universal and most be included regardless
+of your UI choice.
+
+{% capture request_content %}{
+        "urls": {
+            "hostUrls": [ "https://example.com", "https://example.net" ],
+            "paymentUrl": "https://example.com/perform-payment"
+        }
+}{% endcapture %}
+
+{% include code-example.html
+    title='Seamless View Specific URLs'
+    header=request_header
+    json= request_content
+    %}
+
+{% capture request_content %}{
+        "urls": {
+            "cancelUrl": "https://example.com/payment-cancelled",
+            "logoUrl": "https://example.com/logo.png" //Optional
+        }
+}{% endcapture %}
+
+{% include code-example.html
+    title='Redirect Specific URLs'
+    header=request_header
+    json= request_content
+    %}
+
+[custom-logo]: /checkout-v3/features/customize-ui/custom-logo/
+[post-response]: /checkout-v3/get-started/payment-request-3-1/#payment-order-response
+[post-request]: /checkout-v3/get-started/payment-request-3-1/#payment-order-request
+[pci]: https://www.swedbankpay.se/globalassets/global-documents/risk-and-security/pci-dss-v4-0-saq-a-r2.pdf
+[seamless-view]: /checkout-v3/get-started/display-payment-ui/seamless-view
+[redirect]: /checkout-v3/get-started/display-payment-ui/redirect
+[da]: https://www.swedbankpay.dk/risiko-og-sikkerhed/pci-sadan-bliver-du-pavirketswe
+[fi]: https://www.swedbankpay.fi/riskit-ja-turvallisuus/nain-pci-vaikuttaa-sinuun
+[no]: https://www.swedbankpay.no/risiko-og-sikkerhet/pci-slik-pavirkes-dus
+[se]: https://www.swedbankpay.se/risk-och-sakerhet/pci-sa-paverkas-du
diff --git a/old-implementations/checkout-v2/ui-migration.md b/old-implementations/checkout-v2/ui-migration.md
new file mode 100644
index 0000000000..eb986b81d2
--- /dev/null
+++ b/old-implementations/checkout-v2/ui-migration.md
@@ -0,0 +1,34 @@
+---
+title: Change UI Option
+permalink: /:path/ui-migration/
+description: |
+    Walking you through switching from Seamless View to Redirect
+menu_order: 11
+---
+
+Due to changes in [PCI-DSS requirements][pci]{:target="_blank"} coming with v4
+in March 2025, using [Seamless View][seamless-view] to display the payment UI
+will give you, as a merchant, more responsibilities than using our Redirect
+integration. This is because Seamless View is hosted by you. As the Redirect
+page is hosted by us, we also handle the responsibilities.
+
+To read more about how PCI-DSS affects you, we have further reading avaliable
+in [Danish][da]{:target="_blank"}, [Finnish][fi]{:target="_blank"},
+[Norwegian][no]{:target="_blank"} and [Swedish][se]{:target="_blank"}.
+
+If you currently have a Seamless View integration and don't want the impending
+responsibilities, switcing to Redirect is normally possible, but the Checkin
+module used in Checkout v2 is only available using Seamless View. As the Checkin
+function is sunsetting and will be deprecated during the summer of 2025, we
+**strongly recommend** switching to the newest version of [Digital Payments][dp]
+and choose the Redirect UI option. We have written a [migration guide][mp] to
+help you.
+
+[dp]: /checkout-v3/
+[mp]: /checkout-v3/migration-guide/
+[pci]: https://www.swedbankpay.se/globalassets/global-documents/risk-and-security/pci-dss-v4-0-saq-a-r2.pdf
+[seamless-view]: /old-implementations/checkout-v2/payment-menu/#step-4-display-the-payment-menu
+[da]: https://www.swedbankpay.dk/risiko-og-sikkerhed/pci-sadan-bliver-du-pavirketswe
+[fi]: https://www.swedbankpay.fi/riskit-ja-turvallisuus/nain-pci-vaikuttaa-sinuun
+[no]: https://www.swedbankpay.no/risiko-og-sikkerhet/pci-slik-pavirkes-dus
+[se]: https://www.swedbankpay.se/risk-och-sakerhet/pci-sa-paverkas-du
diff --git a/old-implementations/payment-menu-v2/ui-migration.md b/old-implementations/payment-menu-v2/ui-migration.md
new file mode 100644
index 0000000000..42e03731c4
--- /dev/null
+++ b/old-implementations/payment-menu-v2/ui-migration.md
@@ -0,0 +1,109 @@
+---
+title: Change UI Option
+permalink: /:path/ui-migration/
+description: |
+    Walking you through switching from Seamless View to Redirect
+menu_order: 11
+---
+
+Due to changes in [PCI-DSS requirements][pci]{:target="_blank"} coming with v4
+in March 2025, using [Seamless View][seamless-view] to display the payment UI
+will give you, as a merchant, more responsibilities than using our Redirect
+integration. This is because Seamless View is hosted by you. As the Redirect
+page is hosted by us, we also handle the responsibilities.
+
+To read more about how PCI-DSS affects you, we have further reading avaliable
+in [Danish][da]{:target="_blank"}, [Finnish][fi]{:target="_blank"},
+[Norwegian][no]{:target="_blank"} and [Swedish][se]{:target="_blank"}.
+
+If you currently have a Seamless View integration and don't want the impending
+responsibilities, switcing to Redirect is a very manageable task. While you can
+make the change and keep on using Payment Menu v2, we **strongly recommend**
+switching to the newest version of [Digital Payments][dp] when you are already
+making changes to your integration. We have written a [migration guide][mp] to
+help you.
+
+If you choose to stay on Payment Menu v2, here's what you need to do:
+
+#### Use Redirect Operation
+
+In the operations node of the [payment response][post-response], right next to
+`view-paymentorder` which you should currently be using, you'll find
+`redirect-paymentorder`. The corresponding `href` contains a url which leads to
+the Redirect payment UI. All you need to do is send the payer to this address.
+
+{% capture response_content %}{
+    "operations": [
+        {
+          "method": "GET",
+          "href": "https://ecom.externalintegration.payex.com/paymentmenu/5a17c24e-d459-4567-bbad-aa0f17a76119?_tc_tid=30f2168171e142d38bcd4af2c3721959",
+          "rel": "redirect-paymentorder",
+          "contentType": "text/html"
+        },
+    ]
+}{% endcapture %}
+
+ {% include code-example.html
+    title='Redirect-Paymentorder Operation'
+    header=response_header
+    json= response_content
+    %}
+
+#### Remove Seamless View Code
+
+You can remove all code related to the `<script>` element used to load the
+Seamless View.
+
+#### Change URLs
+
+Finally, you need to do some changes to the `urls` node in your
+[payment request][post-request]. The `hostUrls` and `paymentUrl` fields are
+specific to Seamless View and can be **removed**.
+
+The url you need to **add** is the `cancelUrl`, so we know where to redirect the
+payer if they chose to cancel, or you chose to abort the payment.
+
+If you have permission to [add your own logo][custom-logo], a `logoUrl` is also
+needed. If no `logoUrl` is added or no agreement is in place to have your own
+logo, Swedbank Pay's logo will be shown by default.
+
+The `completeUrl` and `callbackUrl` is universal and most be included regardless
+of your UI choice.
+
+{% capture request_content %}{
+        "urls": {
+            "hostUrls": [ "https://example.com", "https://example.net" ],
+            "paymentUrl": "https://example.com/perform-payment"
+        }
+}{% endcapture %}
+
+{% include code-example.html
+    title='Seamless View Specific URLs'
+    header=request_header
+    json= request_content
+    %}
+
+{% capture request_content %}{
+        "urls": {
+            "cancelUrl": "https://example.com/payment-cancelled",
+            "logoUrl": "https://example.com/logo.png" //Optional
+        }
+}{% endcapture %}
+
+{% include code-example.html
+    title='Redirect Specific URLs'
+    header=request_header
+    json= request_content
+    %}
+
+[custom-logo]: /old-implementations/payment-menu-v2/features/optional/custom-logo
+[dp]: /checkout-v3/
+[mp]: /checkout-v3/migration-guide/
+[pci]: https://www.swedbankpay.se/globalassets/global-documents/risk-and-security/pci-dss-v4-0-saq-a-r2.pdf
+[post-response]: /old-implementations/payment-menu-v2/payment-order/#payment-order-response
+[post-request]: /old-implementations/payment-menu-v2/payment-order/#payment-order-request
+[seamless-view]: /old-implementations/payment-menu-v2/payment-order/#step-2-display-the-payment-menu
+[da]: https://www.swedbankpay.dk/risiko-og-sikkerhed/pci-sadan-bliver-du-pavirketswe
+[fi]: https://www.swedbankpay.fi/riskit-ja-turvallisuus/nain-pci-vaikuttaa-sinuun
+[no]: https://www.swedbankpay.no/risiko-og-sikkerhet/pci-slik-pavirkes-dus
+[se]: https://www.swedbankpay.se/risk-och-sakerhet/pci-sa-paverkas-du

From e441776652df3a863eb6e1eb8be07b4fc3aaae85 Mon Sep 17 00:00:00 2001
From: arebra <are.brandt-gundersen@payex.com>
Date: Wed, 25 Sep 2024 14:07:21 +0200
Subject: [PATCH 2/2] DEVP-452: Cosmetic text change

---
 checkout-v3/get-started/display-payment-ui/ui-migration.md | 2 +-
 old-implementations/checkout-v2/ui-migration.md            | 2 +-
 old-implementations/payment-menu-v2/ui-migration.md        | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/checkout-v3/get-started/display-payment-ui/ui-migration.md b/checkout-v3/get-started/display-payment-ui/ui-migration.md
index 5584077980..e266e60100 100644
--- a/checkout-v3/get-started/display-payment-ui/ui-migration.md
+++ b/checkout-v3/get-started/display-payment-ui/ui-migration.md
@@ -12,7 +12,7 @@ will give you, as a merchant, more responsibilities than using our
 [Redirect][redirect] integration. This is because Seamless View is hosted by
 you. As the Redirect page is hosted by us, we also handle the responsibilities.
 
-To read more about how PCI-DSS affects you, we have further reading avaliable
+To learn more about how PCI-DSS affects you, we have further reading avaliable
 in [Danish][da]{:target="_blank"}, [Finnish][fi]{:target="_blank"},
 [Norwegian][no]{:target="_blank"} and [Swedish][se]{:target="_blank"}.
 
diff --git a/old-implementations/checkout-v2/ui-migration.md b/old-implementations/checkout-v2/ui-migration.md
index eb986b81d2..49521079ed 100644
--- a/old-implementations/checkout-v2/ui-migration.md
+++ b/old-implementations/checkout-v2/ui-migration.md
@@ -12,7 +12,7 @@ will give you, as a merchant, more responsibilities than using our Redirect
 integration. This is because Seamless View is hosted by you. As the Redirect
 page is hosted by us, we also handle the responsibilities.
 
-To read more about how PCI-DSS affects you, we have further reading avaliable
+To learn more about how PCI-DSS affects you, we have further reading avaliable
 in [Danish][da]{:target="_blank"}, [Finnish][fi]{:target="_blank"},
 [Norwegian][no]{:target="_blank"} and [Swedish][se]{:target="_blank"}.
 
diff --git a/old-implementations/payment-menu-v2/ui-migration.md b/old-implementations/payment-menu-v2/ui-migration.md
index 42e03731c4..8ea642a82e 100644
--- a/old-implementations/payment-menu-v2/ui-migration.md
+++ b/old-implementations/payment-menu-v2/ui-migration.md
@@ -12,7 +12,7 @@ will give you, as a merchant, more responsibilities than using our Redirect
 integration. This is because Seamless View is hosted by you. As the Redirect
 page is hosted by us, we also handle the responsibilities.
 
-To read more about how PCI-DSS affects you, we have further reading avaliable
+To learn more about how PCI-DSS affects you, we have further reading avaliable
 in [Danish][da]{:target="_blank"}, [Finnish][fi]{:target="_blank"},
 [Norwegian][no]{:target="_blank"} and [Swedish][se]{:target="_blank"}.