spec release

Adyen · Sep 22, 2023 · 4355153 · 4355153
1 parent 1a70a37
commit 4355153
Show file tree

Hide file tree

Showing 2 changed files with 24 additions and 54 deletions.
diff --git a/json/PaymentService-v68.json b/json/PaymentService-v68.json
@@ -4131,7 +4131,7 @@
                   "additionalProperties" : {
                      "type" : "string"
                   },
-                  "description" : "This field allows merchants to use dynamic shopper statement in local character sets.\nThe local shopper statement field can be supplied in markets where localized merchant descriptors are used. Currently, Adyen only supports this in the Japanese market\n.The available character sets at the moment are:\n* Processing in Japan: **ja-Kana**\nThe character set **ja-Kana** supports UTF-8 based Katakana and alphanumeric and special characters.\nMerchants can use half-width or full-width characters.\nAn example request would be:\n> {\n  \"shopperStatement\" : \"ADYEN - SELLER-A\",\n  \"localizedShopperStatement\" : {\n    \"ja-Kana\" : \"ADYEN - セラーA\"\n  }\n}\nWe recommend merchants to always supply the field localizedShopperStatement in addition to the field shopperStatement.It is issuer dependent whether the localized shopper statement field is supported.\nIn the case of non-domestic transactions (e.g. US-issued cards processed in JP) the field `shopperStatement` is used to modify the statement of the shopper.\nAdyen handles the complexity of ensuring the correct descriptors are assigned.\nPlease note, this field can be used for only Visa and Mastercard transactions.",
+                  "description" : "The `localizedShopperStatement` field lets you use dynamic values for your shopper statement in a local character set.\nIf not supplied, left empty, or for cross-border transactions, **shopperStatement** is used.\n\nAdyen currently supports the ja-Kana character set for Visa and Mastercard payments in Japan using Japanese cards. This character set supports:\n\n* UTF-8 based Katakana, capital letters, numbers and special characters. \n* Half-width or full-width characters.",
                   "type" : "object"
                },
                "mandate" : {
@@ -4436,7 +4436,7 @@
                   "additionalProperties" : {
                      "type" : "string"
                   },
-                  "description" : "This field allows merchants to use dynamic shopper statement in local character sets.\nThe local shopper statement field can be supplied in markets where localized merchant descriptors are used. Currently, Adyen only supports this in the Japanese market\n.The available character sets at the moment are:\n* Processing in Japan: **ja-Kana**\nThe character set **ja-Kana** supports UTF-8 based Katakana and alphanumeric and special characters.\nMerchants can use half-width or full-width characters.\nAn example request would be:\n> {\n  \"shopperStatement\" : \"ADYEN - SELLER-A\",\n  \"localizedShopperStatement\" : {\n    \"ja-Kana\" : \"ADYEN - セラーA\"\n  }\n}\nWe recommend merchants to always supply the field localizedShopperStatement in addition to the field shopperStatement.It is issuer dependent whether the localized shopper statement field is supported.\nIn the case of non-domestic transactions (e.g. US-issued cards processed in JP) the field `shopperStatement` is used to modify the statement of the shopper.\nAdyen handles the complexity of ensuring the correct descriptors are assigned.\nPlease note, this field can be used for only Visa and Mastercard transactions.",
+                  "description" : "The `localizedShopperStatement` field lets you use dynamic values for your shopper statement in a local character set.\nIf not supplied, left empty, or for cross-border transactions, **shopperStatement** is used.\n\nAdyen currently supports the ja-Kana character set for Visa and Mastercard payments in Japan using Japanese cards. This character set supports:\n\n* UTF-8 based Katakana, capital letters, numbers and special characters. \n* Half-width or full-width characters.",
                   "type" : "object"
                },
                "mcc" : {
@@ -4730,7 +4730,7 @@
                   "additionalProperties" : {
                      "type" : "string"
                   },
-                  "description" : "This field allows merchants to use dynamic shopper statement in local character sets.\nThe local shopper statement field can be supplied in markets where localized merchant descriptors are used. Currently, Adyen only supports this in the Japanese market\n.The available character sets at the moment are:\n* Processing in Japan: **ja-Kana**\nThe character set **ja-Kana** supports UTF-8 based Katakana and alphanumeric and special characters.\nMerchants can use half-width or full-width characters.\nAn example request would be:\n> {\n  \"shopperStatement\" : \"ADYEN - SELLER-A\",\n  \"localizedShopperStatement\" : {\n    \"ja-Kana\" : \"ADYEN - セラーA\"\n  }\n}\nWe recommend merchants to always supply the field localizedShopperStatement in addition to the field shopperStatement.It is issuer dependent whether the localized shopper statement field is supported.\nIn the case of non-domestic transactions (e.g. US-issued cards processed in JP) the field `shopperStatement` is used to modify the statement of the shopper.\nAdyen handles the complexity of ensuring the correct descriptors are assigned.\nPlease note, this field can be used for only Visa and Mastercard transactions.",
+                  "description" : "The `localizedShopperStatement` field lets you use dynamic values for your shopper statement in a local character set.\nIf not supplied, left empty, or for cross-border transactions, **shopperStatement** is used.\n\nAdyen currently supports the ja-Kana character set for Visa and Mastercard payments in Japan using Japanese cards. This character set supports:\n\n* UTF-8 based Katakana, capital letters, numbers and special characters. \n* Half-width or full-width characters.",
                   "type" : "object"
                },
                "mcc" : {

diff --git a/yaml/PaymentService-v68.yaml b/yaml/PaymentService-v68.yaml
@@ -4245,23 +4245,13 @@ components:
           x-addedInVersion: '68'
           additionalProperties:
             type: string
-          description: "This field allows merchants to use dynamic shopper statement\
-            \ in local character sets.\nThe local shopper statement field can be supplied\
-            \ in markets where localized merchant descriptors are used. Currently,\
-            \ Adyen only supports this in the Japanese market\n.The available character\
-            \ sets at the moment are:\n* Processing in Japan: **ja-Kana**\nThe character\
-            \ set **ja-Kana** supports UTF-8 based Katakana and alphanumeric and special\
-            \ characters.\nMerchants can use half-width or full-width characters.\n\
-            An example request would be:\n> {\n  \"shopperStatement\" : \"ADYEN -\
-            \ SELLER-A\",\n  \"localizedShopperStatement\" : {\n    \"ja-Kana\" :\
-            \ \"ADYEN - \u30BB\u30E9\u30FCA\"\n  }\n}\nWe recommend merchants to always\
-            \ supply the field localizedShopperStatement in addition to the field\
-            \ shopperStatement.It is issuer dependent whether the localized shopper\
-            \ statement field is supported.\nIn the case of non-domestic transactions\
-            \ (e.g. US-issued cards processed in JP) the field `shopperStatement`\
-            \ is used to modify the statement of the shopper.\nAdyen handles the complexity\
-            \ of ensuring the correct descriptors are assigned.\nPlease note, this\
-            \ field can be used for only Visa and Mastercard transactions."
+          description: "The `localizedShopperStatement` field lets you use dynamic\
+            \ values for your shopper statement in a local character set.\nIf not\
+            \ supplied, left empty, or for cross-border transactions, **shopperStatement**\
+            \ is used.\n\nAdyen currently supports the ja-Kana character set for Visa\
+            \ and Mastercard payments in Japan using Japanese cards. This character\
+            \ set supports:\n\n* UTF-8 based Katakana, capital letters, numbers and\
+            \ special characters. \n* Half-width or full-width characters."
           type: object
         mandate:
           description: The mandate details to initiate recurring transaction.
@@ -4633,23 +4623,13 @@ components:
           x-addedInVersion: '68'
           additionalProperties:
             type: string
-          description: "This field allows merchants to use dynamic shopper statement\
-            \ in local character sets.\nThe local shopper statement field can be supplied\
-            \ in markets where localized merchant descriptors are used. Currently,\
-            \ Adyen only supports this in the Japanese market\n.The available character\
-            \ sets at the moment are:\n* Processing in Japan: **ja-Kana**\nThe character\
-            \ set **ja-Kana** supports UTF-8 based Katakana and alphanumeric and special\
-            \ characters.\nMerchants can use half-width or full-width characters.\n\
-            An example request would be:\n> {\n  \"shopperStatement\" : \"ADYEN -\
-            \ SELLER-A\",\n  \"localizedShopperStatement\" : {\n    \"ja-Kana\" :\
-            \ \"ADYEN - \u30BB\u30E9\u30FCA\"\n  }\n}\nWe recommend merchants to always\
-            \ supply the field localizedShopperStatement in addition to the field\
-            \ shopperStatement.It is issuer dependent whether the localized shopper\
-            \ statement field is supported.\nIn the case of non-domestic transactions\
-            \ (e.g. US-issued cards processed in JP) the field `shopperStatement`\
-            \ is used to modify the statement of the shopper.\nAdyen handles the complexity\
-            \ of ensuring the correct descriptors are assigned.\nPlease note, this\
-            \ field can be used for only Visa and Mastercard transactions."
+          description: "The `localizedShopperStatement` field lets you use dynamic\
+            \ values for your shopper statement in a local character set.\nIf not\
+            \ supplied, left empty, or for cross-border transactions, **shopperStatement**\
+            \ is used.\n\nAdyen currently supports the ja-Kana character set for Visa\
+            \ and Mastercard payments in Japan using Japanese cards. This character\
+            \ set supports:\n\n* UTF-8 based Katakana, capital letters, numbers and\
+            \ special characters. \n* Half-width or full-width characters."
           type: object
         mcc:
           x-addedInVersion: '12'
@@ -5012,23 +4992,13 @@ components:
           x-addedInVersion: '68'
           additionalProperties:
             type: string
-          description: "This field allows merchants to use dynamic shopper statement\
-            \ in local character sets.\nThe local shopper statement field can be supplied\
-            \ in markets where localized merchant descriptors are used. Currently,\
-            \ Adyen only supports this in the Japanese market\n.The available character\
-            \ sets at the moment are:\n* Processing in Japan: **ja-Kana**\nThe character\
-            \ set **ja-Kana** supports UTF-8 based Katakana and alphanumeric and special\
-            \ characters.\nMerchants can use half-width or full-width characters.\n\
-            An example request would be:\n> {\n  \"shopperStatement\" : \"ADYEN -\
-            \ SELLER-A\",\n  \"localizedShopperStatement\" : {\n    \"ja-Kana\" :\
-            \ \"ADYEN - \u30BB\u30E9\u30FCA\"\n  }\n}\nWe recommend merchants to always\
-            \ supply the field localizedShopperStatement in addition to the field\
-            \ shopperStatement.It is issuer dependent whether the localized shopper\
-            \ statement field is supported.\nIn the case of non-domestic transactions\
-            \ (e.g. US-issued cards processed in JP) the field `shopperStatement`\
-            \ is used to modify the statement of the shopper.\nAdyen handles the complexity\
-            \ of ensuring the correct descriptors are assigned.\nPlease note, this\
-            \ field can be used for only Visa and Mastercard transactions."
+          description: "The `localizedShopperStatement` field lets you use dynamic\
+            \ values for your shopper statement in a local character set.\nIf not\
+            \ supplied, left empty, or for cross-border transactions, **shopperStatement**\
+            \ is used.\n\nAdyen currently supports the ja-Kana character set for Visa\
+            \ and Mastercard payments in Japan using Japanese cards. This character\
+            \ set supports:\n\n* UTF-8 based Katakana, capital letters, numbers and\
+            \ special characters. \n* Half-width or full-width characters."
           type: object
         mcc:
           x-addedInVersion: '12'