[ING-238] feat(wallets): document grants_target_top_up on recurring transaction rules

src/schemas/WalletCreateInput.yaml

@@ -159,6 +159,12 @@ properties:
               pattern: "^[0-9]+.?[0-9]*$"
               description: The number of free granted credits used for recurring top-up.
               example: "10.0"
+            grants_target_top_up:
+              type:
+                - boolean
+                - "null"
+              description: "Applies only to `target` rules. When `true`, the recurring top-up grants free credits to reach the target ongoing balance instead of creating a paid top-up (and bypasses the paid top-up minimum). When `false`, the gap is filled with a paid top-up. `null` for `fixed` rules. Defaults to `false` for target rules when omitted."
+              example: false
             method:
               type: string
               enum:

src/schemas/WalletRecurringTransactionRule.yaml

@@ -4,6 +4,7 @@ required:
   - created_at
   - expiration_at
   - granted_credits
+  - grants_target_top_up
   - ignore_paid_top_up_limits
   - interval
   - invoice_requires_successful_payment
@@ -69,6 +70,12 @@ properties:
     pattern: "^[0-9]+.?[0-9]*$"
     description: The number of free granted credits. Required only if there is no paid credits.
     example: "10.0"
+  grants_target_top_up:
+    type:
+      - boolean
+      - "null"
+    description: "Applies only to `target` rules. When `true`, the recurring top-up grants free credits to reach the target ongoing balance instead of creating a paid top-up (and bypasses the paid top-up minimum). When `false`, the gap is filled with a paid top-up. `null` for `fixed` rules. Defaults to `false` for target rules when omitted."
+    example: false
   started_at:
     type:
       - string

src/schemas/WalletUpdateInput.yaml

@@ -93,6 +93,12 @@ properties:
               pattern: "^[0-9]+.?[0-9]*$"
               description: The number of free granted credits. Required only if there is no paid credits.
               example: "10.0"
+            grants_target_top_up:
+              type:
+                - boolean
+                - "null"
+              description: "Applies only to `target` rules. When `true`, the recurring top-up grants free credits to reach the target ongoing balance instead of creating a paid top-up (and bypasses the paid top-up minimum). When `false`, the gap is filled with a paid top-up. `null` for `fixed` rules. Defaults to `false` for target rules when omitted."
+              example: false
             started_at:
               type:
                 - string