spec release

json/BalancePlatformAccountingNotification-v3.json

@@ -5,7 +5,7 @@
       "x-publicVersion" : true,
       "title" : "Accounting notifications",
       "description" : "Adyen sends notifications through webhooks to inform your system about incoming and outgoing transfers in your platform.\n\nYou can use these webhooks to build your implementation. For example, you can use this information to update balances in your own dashboards or to keep track of incoming funds.",
-      "x-timestamp" : "2023-02-01T15:28:04Z",
+      "x-timestamp" : "2023-02-10T11:25:40Z",
       "termsOfService" : "https://www.adyen.com/legal/terms-and-conditions",
       "contact" : {
          "name" : "Adyen Developer Experience team",
@@ -837,7 +837,7 @@
                },
                "transactionRule" : {
                   "description" : "Contains information about the transaction rule.",
-                  "$ref" : "#/components/schemas/ResourceReference"
+                  "$ref" : "#/components/schemas/TransactionRuleReference"
                },
                "transactionRuleSource" : {
                   "description" : "Contains the type and ID of the resource to which the transaction rule is linked.",
@@ -845,6 +845,22 @@
                }
             }
          },
+         "TransactionRuleReference" : {
+            "properties" : {
+               "description" : {
+                  "description" : "The description of the resource.",
+                  "type" : "string"
+               },
+               "id" : {
+                  "description" : "The unique identifier of the resource.",
+                  "type" : "string"
+               },
+               "reference" : {
+                  "description" : "The reference for the resource.",
+                  "type" : "string"
+               }
+            }
+         },
          "TransactionRuleSource" : {
             "properties" : {
                "id" : {
@@ -1004,7 +1020,7 @@
                },
                "transactionId" : {
                   "x-addedInVersion" : "3",
-                  "description" : "The id of the transaction that is related to this accounting event. Only sent for events of type accounting where the balance changes",
+                  "description" : "The id of the transaction that is related to this accounting event. Only sent for events of type **accounting** where the balance changes.",
                   "type" : "string"
                },
                "type" : {
@@ -1048,6 +1064,10 @@
                   "$ref" : "#/components/schemas/ResourceReference"
                },
                "balanceAccountId" : {
+                  "x-addedInVersion" : "3",
+                  "deprecated" : true,
+                  "x-deprecatedInVersion" : "3",
+                  "x-deprecatedMessage" : "Use the [id](https://docs.adyen.com/api-explorer/accounting-webhooks/latest/post/balancePlatform.transfer.created#request-data-balanceAccount-id) in the `balanceAccount` object instead.",
                   "description" : "The unique identifier of the source [balance account](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/post/balanceAccounts__resParam_id).",
                   "type" : "string"
                },
@@ -1141,8 +1161,9 @@
                },
                "priority" : {
                   "x-addedInVersion" : "3",
-                  "description" : "The priority for the bank transfer. This sets the speed at which the transfer is sent and the fees that you have to pay. Required for transfers with `category` **bank**.\n\nPossible values:\n\n* **regular**: For normal, low-value transactions.\n\n* **fast**: Faster way to transfer funds but has higher fees. Recommended for high-priority, low-value transactions.\n\n* **wire**: Fastest way to transfer funds but has the highest fees. Recommended for high-priority, high-value transactions.\n\n* **instant**: Instant way to transfer funds in [SEPA countries](https://www.ecb.europa.eu/paym/integration/retail/sepa/html/index.en.html).",
+                  "description" : "The priority for the bank transfer. This sets the speed at which the transfer is sent and the fees that you have to pay. Required for transfers with `category` **bank**.\n\nPossible values:\n\n* **regular**: For normal, low-value transactions.\n\n* **fast**: Faster way to transfer funds but has higher fees. Recommended for high-priority, low-value transactions.\n\n* **wire**: Fastest way to transfer funds but has the highest fees. Recommended for high-priority, high-value transactions.\n\n* **instant**: Instant way to transfer funds in [SEPA countries](https://www.ecb.europa.eu/paym/integration/retail/sepa/html/index.en.html)\n\n.* **crossBorder**: High value transfer to receipt in a different country. ",
                   "enum" : [
+                     "crossBorder",
                      "directDebit",
                      "fast",
                      "instant",
@@ -1288,7 +1309,10 @@
                },
                "transactionId" : {
                   "x-addedInVersion" : "3",
-                  "description" : "The ID of the transaction that is created based on the transfer. Deprecated; use the transactionId in the events instead.",
+                  "deprecated" : true,
+                  "x-deprecatedInVersion" : "3",
+                  "x-deprecatedMessage" : "Use the [transactionId](https://docs.adyen.com/api-explorer/accounting-webhooks/latest/post/balancePlatform.transfer.created#request-data-events-transactionId) in the `events` array instead.",
+                  "description" : "The ID of the transaction that is created based on the transfer.",
                   "type" : "string"
                },
                "transactionRulesResult" : {

json/BalancePlatformPaymentNotification-v1.json

@@ -5,7 +5,7 @@
       "x-publicVersion" : true,
       "title" : "Payment notifications (deprecated)",
       "description" : "The payment notification webhooks are deprecated. Use the [accounting webhooks](https://docs.adyen.com/api-explorer/accounting-webhooks/latest/overview) instead.\n\nAdyen sends notifications through webhooks to inform your system about the creation of payment resources and money movements in your platform.\n\nYou can use these webhooks to build your implementation. For example, you can use this information to update balances in your own dashboards or to keep track of incoming funds.",
-      "x-timestamp" : "2023-02-03T12:25:07Z",
+      "x-timestamp" : "2023-02-10T11:25:38Z",
       "termsOfService" : "https://www.adyen.com/legal/terms-and-conditions",
       "contact" : {
          "name" : "Adyen Developer Experience team",
@@ -1027,7 +1027,7 @@
                },
                "transactionRule" : {
                   "description" : "Contains information about the transaction rule.",
-                  "$ref" : "#/components/schemas/ResourceReference"
+                  "$ref" : "#/components/schemas/TransactionRuleReference"
                },
                "transactionRuleSource" : {
                   "description" : "Contains the type and ID of the resource to which the transaction rule is linked.",
@@ -1156,6 +1156,22 @@
                "counterparty"
             ]
          },
+         "TransactionRuleReference" : {
+            "properties" : {
+               "description" : {
+                  "description" : "The description of the resource.",
+                  "type" : "string"
+               },
+               "id" : {
+                  "description" : "The unique identifier of the resource.",
+                  "type" : "string"
+               },
+               "reference" : {
+                  "description" : "The reference for the resource.",
+                  "type" : "string"
+               }
+            }
+         },
          "TransactionRuleSource" : {
             "properties" : {
                "id" : {

json/TransferService-v1.json

@@ -10,7 +10,7 @@
       "x-publicVersion" : true,
       "title" : "Transfers API",
       "description" : "The Transfers API provides endpoints that you can use to get information about all your transactions, move funds within your balance platform or send funds from your balance platform to a [transfer instrument](https://docs.adyen.com/api-explorer/#/legalentity/latest/post/transferInstruments).\n\n## Authentication\nYour Adyen contact will provide your API credential and an API key. To connect to the API, add an `X-API-Key` header with the API key as the value, for example:\n\n ```\ncurl\n-H \"Content-Type: application/json\" \\\n-H \"X-API-Key: YOUR_API_KEY\" \\\n...\n```\n\nAlternatively, you can use the username and password to connect to the API using basic authentication. For example:\n\n```\ncurl\n-H \"Content-Type: application/json\" \\\n-U \"ws@BalancePlatform.YOUR_BALANCE_PLATFORM\":\"YOUR_WS_PASSWORD\" \\\n...\n```\n## Roles and permissions\nTo use the Transfers API, you need an additional role for your API credential. Transfers must also be enabled for the source balance account. Your Adyen contact will set up the roles and permissions for you.\n## Versioning\nThe Transfers API supports [versioning](https://docs.adyen.com/development-resources/versioning) using a version suffix in the endpoint URL. This suffix has the following format: \"vXX\", where XX is the version number.\n\nFor example:\n```\nhttps://balanceplatform-api-test.adyen.com/btl/v1/transfers\n```\n## Going live\nWhen going live, your Adyen contact will provide your API credential for the live environment. You can then use the username and password to send requests to `https://balanceplatform-api-live.adyen.com/btl/v1`.\n\n",
-      "x-timestamp" : "2023-02-01T15:28:04Z",
+      "x-timestamp" : "2023-02-09T22:20:55Z",
       "termsOfService" : "https://www.adyen.com/legal/terms-and-conditions",
       "contact" : {
          "name" : "Adyen Developer Experience team",
@@ -59,6 +59,15 @@
                      "type" : "string"
                   }
                },
+               {
+                  "description" : "Unique identifier of the [payment instrument](https://docs.adyen.com/api-explorer/balanceplatform/latest/get/paymentInstruments/_id_).",
+                  "name" : "paymentInstrumentId",
+                  "in" : "query",
+                  "required" : false,
+                  "schema" : {
+                     "type" : "string"
+                  }
+               },
                {
                   "description" : "Unique identifier of the [account holder](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/get/accountHolders/{id}__queryParam_id).",
                   "name" : "accountHolderId",

json/TransferService-v2.json

@@ -10,7 +10,7 @@
       "x-publicVersion" : true,
       "title" : "Transfers API",
       "description" : "The Transfers API provides endpoints that you can use to get information about all your transactions, move funds within your balance platform or send funds from your balance platform to a [transfer instrument](https://docs.adyen.com/api-explorer/#/legalentity/latest/post/transferInstruments).\n\n## Authentication\nYour Adyen contact will provide your API credential and an API key. To connect to the API, add an `X-API-Key` header with the API key as the value, for example:\n\n ```\ncurl\n-H \"Content-Type: application/json\" \\\n-H \"X-API-Key: YOUR_API_KEY\" \\\n...\n```\n\nAlternatively, you can use the username and password to connect to the API using basic authentication. For example:\n\n```\ncurl\n-H \"Content-Type: application/json\" \\\n-U \"ws@BalancePlatform.YOUR_BALANCE_PLATFORM\":\"YOUR_WS_PASSWORD\" \\\n...\n```\n## Roles and permissions\nTo use the Transfers API, you need an additional role for your API credential. Transfers must also be enabled for the source balance account. Your Adyen contact will set up the roles and permissions for you.\n## Versioning\nThe Transfers API supports [versioning](https://docs.adyen.com/development-resources/versioning) using a version suffix in the endpoint URL. This suffix has the following format: \"vXX\", where XX is the version number.\n\nFor example:\n```\nhttps://balanceplatform-api-test.adyen.com/btl/v2/transfers\n```\n## Going live\nWhen going live, your Adyen contact will provide your API credential for the live environment. You can then use the username and password to send requests to `https://balanceplatform-api-live.adyen.com/btl/v2`.\n\n",
-      "x-timestamp" : "2023-02-01T15:28:04Z",
+      "x-timestamp" : "2023-02-09T22:20:55Z",
       "termsOfService" : "https://www.adyen.com/legal/terms-and-conditions",
       "contact" : {
          "name" : "Adyen Developer Experience team",
@@ -59,6 +59,15 @@
                      "type" : "string"
                   }
                },
+               {
+                  "description" : "Unique identifier of the [payment instrument](https://docs.adyen.com/api-explorer/balanceplatform/latest/get/paymentInstruments/_id_).",
+                  "name" : "paymentInstrumentId",
+                  "in" : "query",
+                  "required" : false,
+                  "schema" : {
+                     "type" : "string"
+                  }
+               },
                {
                   "description" : "Unique identifier of the [account holder](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/get/accountHolders/{id}__queryParam_id).",
                   "name" : "accountHolderId",
@@ -441,8 +450,9 @@
             "properties" : {
                "priority" : {
                   "x-addedInVersion" : "1",
-                  "description" : "The priority for the bank transfer. This sets the speed at which the transfer is sent and the fees that you have to pay. If you don't provide this in the request, Adyen sets the optimal priority.\n\nPossible values:\n\n* **regular**: For normal, low-value transactions.\n\n* **fast**: Faster way to transfer funds but has higher fees. Recommended for high-priority, low-value transactions.\n\n* **wire**: Fastest way to transfer funds but has the highest fees. Recommended for high-priority, high-value transactions.\n\n* **instant**: Instant way to transfer funds in [SEPA countries](https://www.ecb.europa.eu/paym/integration/retail/sepa/html/index.en.html).",
+                  "description" : "The priority for the bank transfer. This sets the speed at which the transfer is sent and the fees that you have to pay. If you don't provide this in the request, Adyen sets the optimal priority.\n\nPossible values:\n\n* **regular**: For normal, low-value transactions.\n\n* **fast**: Faster way to transfer funds but has higher fees. Recommended for high-priority, low-value transactions.\n\n* **wire**: Fastest way to transfer funds but has the highest fees. Recommended for high-priority, high-value transactions.\n\n* **instant**: Instant way to transfer funds in [SEPA countries](https://www.ecb.europa.eu/paym/integration/retail/sepa/html/index.en.html)\n\n.* **crossBorder**: High value transfer to receipt in a different country. ",
                   "enum" : [
+                     "crossBorder",
                      "directDebit",
                      "fast",
                      "instant",

json/TransferService-v3.json

@@ -10,7 +10,7 @@
       "x-publicVersion" : true,
       "title" : "Transfers API",
       "description" : "The Transfers API provides endpoints that you can use to get information about all your transactions, move funds within your balance platform or send funds from your balance platform to a [transfer instrument](https://docs.adyen.com/api-explorer/#/legalentity/latest/post/transferInstruments).\n\n## Authentication\nYour Adyen contact will provide your API credential and an API key. To connect to the API, add an `X-API-Key` header with the API key as the value, for example:\n\n ```\ncurl\n-H \"Content-Type: application/json\" \\\n-H \"X-API-Key: YOUR_API_KEY\" \\\n...\n```\n\nAlternatively, you can use the username and password to connect to the API using basic authentication. For example:\n\n```\ncurl\n-H \"Content-Type: application/json\" \\\n-U \"ws@BalancePlatform.YOUR_BALANCE_PLATFORM\":\"YOUR_WS_PASSWORD\" \\\n...\n```\n## Roles and permissions\nTo use the Transfers API, you need an additional role for your API credential. Transfers must also be enabled for the source balance account. Your Adyen contact will set up the roles and permissions for you.\n## Versioning\nThe Transfers API supports [versioning](https://docs.adyen.com/development-resources/versioning) using a version suffix in the endpoint URL. This suffix has the following format: \"vXX\", where XX is the version number.\n\nFor example:\n```\nhttps://balanceplatform-api-test.adyen.com/btl/v3/transfers\n```\n## Going live\nWhen going live, your Adyen contact will provide your API credential for the live environment. You can then use the username and password to send requests to `https://balanceplatform-api-live.adyen.com/btl/v3`.\n\n",
-      "x-timestamp" : "2023-02-01T15:28:04Z",
+      "x-timestamp" : "2023-02-09T22:20:55Z",
       "termsOfService" : "https://www.adyen.com/legal/terms-and-conditions",
       "contact" : {
          "name" : "Adyen Developer Experience team",
@@ -59,6 +59,15 @@
                      "type" : "string"
                   }
                },
+               {
+                  "description" : "Unique identifier of the [payment instrument](https://docs.adyen.com/api-explorer/balanceplatform/latest/get/paymentInstruments/_id_).",
+                  "name" : "paymentInstrumentId",
+                  "in" : "query",
+                  "required" : false,
+                  "schema" : {
+                     "type" : "string"
+                  }
+               },
                {
                   "description" : "Unique identifier of the [account holder](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/get/accountHolders/{id}__queryParam_id).",
                   "name" : "accountHolderId",
@@ -1309,8 +1318,9 @@
                },
                "priority" : {
                   "x-addedInVersion" : "3",
-                  "description" : "The priority for the bank transfer. This sets the speed at which the transfer is sent and the fees that you have to pay. Required for transfers with `category` **bank**.\n\nPossible values:\n\n* **regular**: For normal, low-value transactions.\n\n* **fast**: Faster way to transfer funds but has higher fees. Recommended for high-priority, low-value transactions.\n\n* **wire**: Fastest way to transfer funds but has the highest fees. Recommended for high-priority, high-value transactions.\n\n* **instant**: Instant way to transfer funds in [SEPA countries](https://www.ecb.europa.eu/paym/integration/retail/sepa/html/index.en.html).",
+                  "description" : "The priority for the bank transfer. This sets the speed at which the transfer is sent and the fees that you have to pay. Required for transfers with `category` **bank**.\n\nPossible values:\n\n* **regular**: For normal, low-value transactions.\n\n* **fast**: Faster way to transfer funds but has higher fees. Recommended for high-priority, low-value transactions.\n\n* **wire**: Fastest way to transfer funds but has the highest fees. Recommended for high-priority, high-value transactions.\n\n* **instant**: Instant way to transfer funds in [SEPA countries](https://www.ecb.europa.eu/paym/integration/retail/sepa/html/index.en.html)\n\n.* **crossBorder**: High value transfer to receipt in a different country. ",
                   "enum" : [
+                     "crossBorder",
                      "directDebit",
                      "fast",
                      "instant",
@@ -1468,8 +1478,9 @@
                },
                "priority" : {
                   "x-addedInVersion" : "3",
-                  "description" : "The priority for the bank transfer. This sets the speed at which the transfer is sent and the fees that you have to pay. Required for transfers with `category` **bank**.\n\nPossible values:\n\n* **regular**: For normal, low-value transactions.\n\n* **fast**: Faster way to transfer funds but has higher fees. Recommended for high-priority, low-value transactions.\n\n* **wire**: Fastest way to transfer funds but has the highest fees. Recommended for high-priority, high-value transactions.\n\n* **instant**: Instant way to transfer funds in [SEPA countries](https://www.ecb.europa.eu/paym/integration/retail/sepa/html/index.en.html).",
+                  "description" : "The priority for the bank transfer. This sets the speed at which the transfer is sent and the fees that you have to pay. Required for transfers with `category` **bank**.\n\nPossible values:\n\n* **regular**: For normal, low-value transactions.\n\n* **fast**: Faster way to transfer funds but has higher fees. Recommended for high-priority, low-value transactions.\n\n* **wire**: Fastest way to transfer funds but has the highest fees. Recommended for high-priority, high-value transactions.\n\n* **instant**: Instant way to transfer funds in [SEPA countries](https://www.ecb.europa.eu/paym/integration/retail/sepa/html/index.en.html)\n\n.* **crossBorder**: High value transfer to receipt in a different country. ",
                   "enum" : [
+                     "crossBorder",
                      "directDebit",
                      "fast",
                      "instant",

yaml/BalancePlatformAccountingNotification-v3.yaml

@@ -10,7 +10,7 @@ info:
     You can use these webhooks to build your implementation. For example, you can
     use this information to update balances in your own dashboards or to keep track
     of incoming funds.'
-  x-timestamp: '2023-02-01T15:28:04Z'
+  x-timestamp: '2023-02-10T11:25:40Z'
   termsOfService: https://www.adyen.com/legal/terms-and-conditions
   contact:
     name: Adyen Developer Experience team
@@ -648,11 +648,22 @@ components:
           type: string
         transactionRule:
           description: Contains information about the transaction rule.
-          $ref: '#/components/schemas/ResourceReference'
+          $ref: '#/components/schemas/TransactionRuleReference'
         transactionRuleSource:
           description: Contains the type and ID of the resource to which the transaction
             rule is linked.
           $ref: '#/components/schemas/TransactionRuleSource'
+    TransactionRuleReference:
+      properties:
+        description:
+          description: The description of the resource.
+          type: string
+        id:
+          description: The unique identifier of the resource.
+          type: string
+        reference:
+          description: The reference for the resource.
+          type: string
     TransactionRuleSource:
       properties:
         id:
@@ -797,7 +808,7 @@ components:
         transactionId:
           x-addedInVersion: '3'
           description: The id of the transaction that is related to this accounting
-            event. Only sent for events of type accounting where the balance changes
+            event. Only sent for events of type **accounting** where the balance changes.
           type: string
         type:
           x-addedInVersion: '3'
@@ -835,6 +846,11 @@ components:
             the transfer.
           $ref: '#/components/schemas/ResourceReference'
         balanceAccountId:
+          x-addedInVersion: '3'
+          deprecated: true
+          x-deprecatedInVersion: '3'
+          x-deprecatedMessage: Use the [id](https://docs.adyen.com/api-explorer/accounting-webhooks/latest/post/balancePlatform.transfer.created#request-data-balanceAccount-id)
+            in the `balanceAccount` object instead.
           description: The unique identifier of the source [balance account](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/post/balanceAccounts__resParam_id).
           type: string
         balances:
@@ -945,8 +961,12 @@ components:
             for high-priority, high-value transactions.
 
 
-            * **instant**: Instant way to transfer funds in [SEPA countries](https://www.ecb.europa.eu/paym/integration/retail/sepa/html/index.en.html).'
+            * **instant**: Instant way to transfer funds in [SEPA countries](https://www.ecb.europa.eu/paym/integration/retail/sepa/html/index.en.html)
+
+
+            .* **crossBorder**: High value transfer to receipt in a different country. '
           enum:
+          - crossBorder
           - directDebit
           - fast
           - instant
@@ -1094,8 +1114,11 @@ components:
           $ref: '#/components/schemas/TransferNotificationTransferTracking'
         transactionId:
           x-addedInVersion: '3'
+          deprecated: true
+          x-deprecatedInVersion: '3'
+          x-deprecatedMessage: Use the [transactionId](https://docs.adyen.com/api-explorer/accounting-webhooks/latest/post/balancePlatform.transfer.created#request-data-events-transactionId)
+            in the `events` array instead.
           description: The ID of the transaction that is created based on the transfer.
-            Deprecated; use the transactionId in the events instead.
           type: string
         transactionRulesResult:
           x-addedInVersion: '3'

yaml/BalancePlatformPaymentNotification-v1.yaml

@@ -15,7 +15,7 @@ info:
     You can use these webhooks to build your implementation. For example, you can
     use this information to update balances in your own dashboards or to keep track
     of incoming funds.'
-  x-timestamp: '2023-02-03T12:25:07Z'
+  x-timestamp: '2023-02-10T11:25:38Z'
   termsOfService: https://www.adyen.com/legal/terms-and-conditions
   contact:
     name: Adyen Developer Experience team
@@ -905,7 +905,7 @@ components:
           type: string
         transactionRule:
           description: Contains information about the transaction rule.
-          $ref: '#/components/schemas/ResourceReference'
+          $ref: '#/components/schemas/TransactionRuleReference'
         transactionRuleSource:
           description: Contains the type and ID of the resource to which the transaction
             rule is linked.
@@ -1039,6 +1039,17 @@ components:
           type: string
       required:
       - counterparty
+    TransactionRuleReference:
+      properties:
+        description:
+          description: The description of the resource.
+          type: string
+        id:
+          description: The unique identifier of the resource.
+          type: string
+        reference:
+          description: The reference for the resource.
+          type: string
     TransactionRuleSource:
       properties:
         id:

yaml/TransferService-v1.yaml

@@ -23,7 +23,7 @@ info:
     ```\n## Going live\nWhen going live, your Adyen contact will provide your API\
     \ credential for the live environment. You can then use the username and password\
     \ to send requests to `https://balanceplatform-api-live.adyen.com/btl/v1`.\n\n"
-  x-timestamp: '2023-02-01T15:28:04Z'
+  x-timestamp: '2023-02-09T22:20:55Z'
   termsOfService: https://www.adyen.com/legal/terms-and-conditions
   contact:
     name: Adyen Developer Experience team
@@ -63,6 +63,12 @@ paths:
         required: false
         schema:
           type: string
+      - description: Unique identifier of the [payment instrument](https://docs.adyen.com/api-explorer/balanceplatform/latest/get/paymentInstruments/_id_).
+        name: paymentInstrumentId
+        in: query
+        required: false
+        schema:
+          type: string
       - description: Unique identifier of the [account holder](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/get/accountHolders/{id}__queryParam_id).
         name: accountHolderId
         in: query

yaml/TransferService-v2.yaml

@@ -23,7 +23,7 @@ info:
     ```\n## Going live\nWhen going live, your Adyen contact will provide your API\
     \ credential for the live environment. You can then use the username and password\
     \ to send requests to `https://balanceplatform-api-live.adyen.com/btl/v2`.\n\n"
-  x-timestamp: '2023-02-01T15:28:04Z'
+  x-timestamp: '2023-02-09T22:20:55Z'
   termsOfService: https://www.adyen.com/legal/terms-and-conditions
   contact:
     name: Adyen Developer Experience team
@@ -63,6 +63,12 @@ paths:
         required: false
         schema:
           type: string
+      - description: Unique identifier of the [payment instrument](https://docs.adyen.com/api-explorer/balanceplatform/latest/get/paymentInstruments/_id_).
+        name: paymentInstrumentId
+        in: query
+        required: false
+        schema:
+          type: string
       - description: Unique identifier of the [account holder](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/get/accountHolders/{id}__queryParam_id).
         name: accountHolderId
         in: query
@@ -350,8 +356,12 @@ components:
             for high-priority, high-value transactions.
 
 
-            * **instant**: Instant way to transfer funds in [SEPA countries](https://www.ecb.europa.eu/paym/integration/retail/sepa/html/index.en.html).'
+            * **instant**: Instant way to transfer funds in [SEPA countries](https://www.ecb.europa.eu/paym/integration/retail/sepa/html/index.en.html)
+
+
+            .* **crossBorder**: High value transfer to receipt in a different country. '
           enum:
+          - crossBorder
           - directDebit
           - fast
           - instant

yaml/TransferService-v3.yaml

@@ -23,7 +23,7 @@ info:
     ```\n## Going live\nWhen going live, your Adyen contact will provide your API\
     \ credential for the live environment. You can then use the username and password\
     \ to send requests to `https://balanceplatform-api-live.adyen.com/btl/v3`.\n\n"
-  x-timestamp: '2023-02-01T15:28:04Z'
+  x-timestamp: '2023-02-09T22:20:55Z'
   termsOfService: https://www.adyen.com/legal/terms-and-conditions
   contact:
     name: Adyen Developer Experience team
@@ -63,6 +63,12 @@ paths:
         required: false
         schema:
           type: string
+      - description: Unique identifier of the [payment instrument](https://docs.adyen.com/api-explorer/balanceplatform/latest/get/paymentInstruments/_id_).
+        name: paymentInstrumentId
+        in: query
+        required: false
+        schema:
+          type: string
       - description: Unique identifier of the [account holder](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/get/accountHolders/{id}__queryParam_id).
         name: accountHolderId
         in: query
@@ -1049,8 +1055,12 @@ components:
             for high-priority, high-value transactions.
 
 
-            * **instant**: Instant way to transfer funds in [SEPA countries](https://www.ecb.europa.eu/paym/integration/retail/sepa/html/index.en.html).'
+            * **instant**: Instant way to transfer funds in [SEPA countries](https://www.ecb.europa.eu/paym/integration/retail/sepa/html/index.en.html)
+
+
+            .* **crossBorder**: High value transfer to receipt in a different country. '
           enum:
+          - crossBorder
           - directDebit
           - fast
           - instant
@@ -1225,8 +1235,12 @@ components:
             for high-priority, high-value transactions.
 
 
-            * **instant**: Instant way to transfer funds in [SEPA countries](https://www.ecb.europa.eu/paym/integration/retail/sepa/html/index.en.html).'
+            * **instant**: Instant way to transfer funds in [SEPA countries](https://www.ecb.europa.eu/paym/integration/retail/sepa/html/index.en.html)
+
+
+            .* **crossBorder**: High value transfer to receipt in a different country. '
           enum:
+          - crossBorder
           - directDebit
           - fast
           - instant