diff --git a/json/BalanceControlService-v1.json b/json/BalanceControlService-v1.json
index 02deaec..7a6bef8 100644
--- a/json/BalanceControlService-v1.json
+++ b/json/BalanceControlService-v1.json
@@ -29,6 +29,8 @@
             ],
             "summary" : "Start a balance transfer",
             "description" : "Starts a balance transfer request between merchant accounts. The following conditions must be met before you can successfully transfer balances:\n\n* The source and destination merchant accounts must be under the same company account and legal entity.\n\n* The source merchant account must have sufficient funds.\n\n* The source and destination merchant accounts must have at least one common processing currency.\n\nWhen sending multiple API requests with the same source and destination merchant accounts, send the requests sequentially and *not* in parallel. Some requests may not be processed if the requests are sent in parallel.\n",
+            "deprecated" : true,
+            "x-deprecatedInVersion" : "1",
             "operationId" : "post-balanceTransfer",
             "x-sortIndex" : 0,
             "x-methodName" : "balanceTransfer",
@@ -82,13 +84,13 @@
             "additionalProperties" : false,
             "properties" : {
                "currency" : {
-                  "description" : "The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes).",
+                  "description" : "The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes#currency-codes).",
                   "maxLength" : 3,
                   "minLength" : 3,
                   "type" : "string"
                },
                "value" : {
-                  "description" : "The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes).",
+                  "description" : "The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes#minor-units).",
                   "format" : "int64",
                   "type" : "integer"
                }
diff --git a/yaml/BalanceControlService-v1.yaml b/yaml/BalanceControlService-v1.yaml
index 3a08e6d..77669c6 100644
--- a/yaml/BalanceControlService-v1.yaml
+++ b/yaml/BalanceControlService-v1.yaml
@@ -82,6 +82,8 @@ paths:
         may not be processed if the requests are sent in parallel.
 
         '
+      deprecated: true
+      x-deprecatedInVersion: '1'
       operationId: post-balanceTransfer
       x-sortIndex: 0
       x-methodName: balanceTransfer
@@ -112,12 +114,12 @@ components:
       additionalProperties: false
       properties:
         currency:
-          description: The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes).
+          description: The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes#currency-codes).
           maxLength: 3
           minLength: 3
           type: string
         value:
-          description: The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes).
+          description: The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes#minor-units).
           format: int64
           type: integer
       required: