From e5cba500e77707d3e6e4acb3291ca91e6a6dc3b1 Mon Sep 17 00:00:00 2001 From: Matthias Gohsen Date: Wed, 13 Mar 2024 08:23:27 +0100 Subject: [PATCH 1/2] Readd styling container to some API methods --- texts/ChapterAliasStore.md | 14 +++++++++++ texts/ChapterTransaction.md | 31 +++++++++++++++++++++++ texts/ContainerDictionary.md | 48 ++++++++++++++++++++++++++++++++++++ 3 files changed, 93 insertions(+) diff --git a/texts/ChapterAliasStore.md b/texts/ChapterAliasStore.md index eef6092..1cb3c7f 100644 --- a/texts/ChapterAliasStore.md +++ b/texts/ChapterAliasStore.md @@ -95,6 +95,20 @@ Possible values: CARD, BANK_ACCOUNT, POSTFINANCE, TWINT.
URL which is used to redirect the payer back to the shop.

This Url is used by Saferpay to redirect the shopper back to the merchant shop. You may add query string parameters to identify your session, but please be aware that the shopper could modify these parameters inside the browser!
The whole url including query string parameters should be as short as possible to prevent issues with specific browsers and must not exceed 2000 characters.
Note: you should not add sensitive data to the query string, as its contents is plainly visible inside the browser and will be logged by our web servers.
+ + + + + Styling
+ + + object + + + +
Custom styling resource for the Hosted Register form.
+ + diff --git a/texts/ChapterTransaction.md b/texts/ChapterTransaction.md index 9c88a3f..25036ab 100644 --- a/texts/ChapterTransaction.md +++ b/texts/ChapterTransaction.md @@ -175,6 +175,20 @@ Numeric[8..8]
URL which is used to redirect the payer back to the shop if the transaction requires some kind of browser redirection (3d-secure, dcc)

This Url is used by Saferpay to redirect the shopper back to the merchant shop. You may add query string parameters to identify your session, but please be aware that the shopper could modify these parameters inside the browser!
The whole url including query string parameters should be as short as possible to prevent issues with specific browsers and must not exceed 2000 characters.
Note: you should not add sensitive data to the query string, as its contents is plainly visible inside the browser and will be logged by our web servers.
+ + + + + Styling
+ + + object + + + +
Styling options
+ + @@ -289,6 +303,9 @@ Possible values: AMEX, BANCONTACT, BONUS, DINERS, DIRECTDEBIT, JCB, MAESTRO, MAS }, "ReturnUrl": { "Url": "[your shop payment url]" + }, + "Styling": { + "CssUrl": "[your shop css url]" } } @@ -3423,6 +3440,20 @@ Possible values: PAYPAL, POSTCARD, POSTFINANCE.
URL which is used to redirect the payer back to the shop if the transaction requires some kind of browser redirection (3d-secure, dcc)

This Url is used by Saferpay to redirect the shopper back to the merchant shop. You may add query string parameters to identify your session, but please be aware that the shopper could modify these parameters inside the browser!
The whole url including query string parameters should be as short as possible to prevent issues with specific browsers and must not exceed 2000 characters.
Note: you should not add sensitive data to the query string, as its contents is plainly visible inside the browser and will be logged by our web servers.
+ + + + + Styling
+ + + object + + + +
Custom styling resource
+ + diff --git a/texts/ContainerDictionary.md b/texts/ContainerDictionary.md index ebc41c7..fe4d8c5 100644 --- a/texts/ContainerDictionary.md +++ b/texts/ContainerDictionary.md @@ -3076,6 +3076,54 @@ Iso885915[1..100]
Creditor id, required for german direct debit payments.
+ + + + +

Container "Payment_Models_Data_ExtendedStyling"

+ + + + + + + + + + + + + From 4132ba87ed10488097b608b341fb9ba377a97e53 Mon Sep 17 00:00:00 2001 From: Matthias Gohsen Date: Wed, 13 Mar 2024 08:27:55 +0100 Subject: [PATCH 2/2] Update changelog to reflect Styling changes --- texts/Changelog.md | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/texts/Changelog.md b/texts/Changelog.md index e0631f9..89d5118 100644 --- a/texts/Changelog.md +++ b/texts/Changelog.md @@ -42,11 +42,7 @@ - available on Sandbox: 2024-03-01 - introduced version 1.39 - added value `1.39` for _SpecVersion_ -- removed `Styling` container from following requests in all API versions: - - [PaymentPage/Initialize](index.html#Payment_v1_PaymentPage_Initialize) - - [Transaction/Initialize](index.html#Payment_v1_Transaction_Initialize) - - [Transaction/RedirectPayment](index.html#Payment_v1_Transaction_RedirectPayment) - - [SecureCardData/AliasInsert](index.html#Payment_v1_Alias_Insert) +- removed `Styling` container from [PaymentPage/Initialize](index.html#Payment_v1_PaymentPage_Initialize) in all API versions - [PaymentPage/Assert](index.html#Payment_v1_PaymentPage_Assert) can now be called up to 120 hours for pending transactions (instead of 96 hours before) - removed `Transaction/QueryPaymentMeans` and `Transaction/AdjustAmount` methods from Saferpay Payment API - added `MandatoryFields` field to _BillingAddressForm_ container in [SecurePayGate Create SingleUsePaymentLink](index.html#rest_customers_[customerId]_terminals_[terminalId]_spg-offers)
+ Theme
+ + string + +
+
This parameter let you customize the appearance of the displayed payment pages. Per default a lightweight responsive styling will be applied.
If you don't want any styling use 'NONE'.
+ +Possible values: DEFAULT, SIX, NONE.
+ Example: DEFAULT +
+
+ CssUrl
+ + string + +
+
Custom styling resource (url) which will be referenced in web pages displayed by Saferpay to apply your custom styling.
This file must be hosted on a SSL/TLS secured web server (the url must start with https://).
If a custom CSS is provided, any design related settings set in the payment page config (PPConfig) will be ignored and the default design will be used.
+ +Max length: 2000
+ Example: https://merchanthost/merchant.css +
+
+ ContentSecurityEnabled
+ + boolean + +
+
When enabled, then ContentSecurity/SAQ-A is requested, which leads to the CSS being loaded from the saferpay server.
+ +