spec release

Author: Adyen Automation

json/BalancePlatformConfigurationNotification-v1.json

@@ -929,13 +929,13 @@
             "additionalProperties" : false,
             "properties" : {
                "currency" : {
-                  "description" : "The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes#currency-codes).",
+                  "description" : "The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes#currency-codes) of the amount.",
                   "maxLength" : 3,
                   "minLength" : 3,
                   "type" : "string"
                },
                "value" : {
-                  "description" : "The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes#minor-units).",
+                  "description" : "The numeric value of the amount, in [minor units](https://docs.adyen.com/development-resources/currency-codes#minor-units).",
                   "format" : "int64",
                   "type" : "integer"
                }
@@ -1416,7 +1416,7 @@
                   "type" : "string"
                },
                "configuration" : {
-                  "description" : "Settings required when creating a physical or a virtual card. \n\nReach out to your Adyen contact to get the values that you can send in this object.",
+                  "description" : "Contains information about the configuration profile for your cards. The configuration profile consists of settings required when creating a physical or a virtual card. You identify a configuration profile with its `configurationProfileId`.\n\nWhen you provide this field in a request, you can override the settings of an existing configuration profile.\n\nReach out to your Adyen contact to get the values that you can send in this object.",
                   "$ref" : "#/components/schemas/CardConfiguration"
                },
                "cvc" : {
@@ -1461,16 +1461,15 @@
                "formFactor",
                "cardholderName",
                "brand",
-               "brandVariant",
-               "number"
+               "brandVariant"
             ],
             "type" : "object"
          },
          "CardConfiguration" : {
             "additionalProperties" : false,
             "properties" : {
                "activation" : {
-                  "description" : "Overrides the activation label design ID defined in the `configurationProfileId`. The activation label is attached to the card and contains the activation instructions.",
+                  "description" : "The activation label attached to the card that contains the activation instructions.\n\nThis field overrides the activation label design ID defined in the card configuration profile.",
                   "type" : "string"
                },
                "activationUrl" : {
@@ -1479,51 +1478,51 @@
                   "type" : "string"
                },
                "bulkAddress" : {
-                  "description" : "Overrides the shipment bulk address defined in the `configurationProfileId`.",
+                  "description" : "Overrides the shipment bulk address defined in the card configuration profile.",
                   "$ref" : "#/components/schemas/BulkAddress"
                },
                "cardImageId" : {
-                  "description" : "The ID of the card image. This is the image that will be printed on the full front of the card.",
+                  "description" : "The unique identifier of the card image. This image is printed on the full front of the card.",
                   "type" : "string"
                },
                "carrier" : {
-                  "description" : "Overrides the carrier design ID defined in the `configurationProfileId`. The carrier is the letter or packaging to which the card is attached.",
+                  "description" : "The letter or packaging to which the card is attached.\n\nThis field overrides the carrier design ID defined in the card configuration profile. ",
                   "type" : "string"
                },
                "carrierImageId" : {
-                  "description" : "The ID of the carrier image. This is the image that will printed on the letter to which the card is attached.",
+                  "description" : "The unique identifier of the carrier image. This image is printed on the letter to which the card is attached.",
                   "type" : "string"
                },
                "configurationProfileId" : {
-                  "description" : "The ID of the card configuration profile that contains the settings of the card. For example, the envelope and PIN mailer designs or the logistics company handling the shipment. All the settings in the profile are applied to the card, unless you provide other fields to override them.\n\nFor example, send the `shipmentMethod` to override the logistics company defined in the card configuration profile.",
+                  "description" : "The unique identifier of the card configuration profile that contains the settings that are applied to the card. For example, the envelope and PIN mailer designs or the logistics company handling the shipment.\n\nYou can override some of the existing settings in the configuration profile by providing the corresponding fields in the `configuration` object. For example, send the `shipmentMethod` to override the logistics company defined in the card configuration profile.",
                   "type" : "string"
                },
                "currency" : {
-                  "description" : "The three-letter [ISO-4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the card. For example, **EUR**.",
+                  "description" : "The three-letter [ISO-4217](https://en.wikipedia.org/wiki/ISO_4217) currency code of the card. For example, **EUR**.\n\nThis field overrides the existing currency setting on the card configuration profile.",
                   "type" : "string"
                },
                "envelope" : {
-                  "description" : "Overrides the envelope design ID defined in the `configurationProfileId`. ",
+                  "description" : "Overrides the envelope design ID defined in the card configuration profile. ",
                   "type" : "string"
                },
                "insert" : {
-                  "description" : "Overrides the insert design ID defined in the `configurationProfileId`. An insert is any additional material, such as marketing materials, that are shipped together with the card.",
+                  "description" : "Any additional material, such as marketing material, that is shipped together with the card.\n\nThis field overrides the insert design ID defined in the card configuration profile.",
                   "type" : "string"
                },
                "language" : {
                   "description" : "The two-letter [ISO-639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language code of the card. For example, **en**.",
                   "type" : "string"
                },
                "logoImageId" : {
-                  "description" : "The ID of the logo image. This is the image that will be printed on the partial front of the card, such as a logo on the upper right corner.",
+                  "description" : "The unique identifier of the logo image. This image is printed on the partial front of the card, for example, a logo on the upper right corner.",
                   "type" : "string"
                },
                "pinMailer" : {
-                  "description" : "Overrides the PIN mailer design ID defined in the `configurationProfileId`. The PIN mailer is the letter on which the PIN is printed.",
+                  "description" : "The letter on which the PIN of the card is printed.\n\nThis field overrides the PIN mailer design ID defined in the card configuration profile.",
                   "type" : "string"
                },
                "shipmentMethod" : {
-                  "description" : "Overrides the logistics company defined in the `configurationProfileId`.",
+                  "description" : "The logistics company that ships the card.\n\nThis field overrides the logistics company defined in the card configuration profile.",
                   "type" : "string"
                }
             },
@@ -1810,7 +1809,7 @@
                   "type" : "array"
                },
                "wallet" : {
-                  "description" : "Contains information about the wallet for which the network token is provisioned.",
+                  "description" : "Contains information about the wallet for which the network token is provisioned.\n\nReturned only when `type` is **wallet**.",
                   "$ref" : "#/components/schemas/Wallet"
                }
             },
@@ -2255,6 +2254,7 @@
                      "refusedByCustomer",
                      "routeNotFound",
                      "scaFailed",
+                     "schemeAdvice",
                      "transferInstrumentDoesNotExist",
                      "unknown"
                   ],