From 594475331fba7de48b26369547a603f44d2d86f6 Mon Sep 17 00:00:00 2001
From: "b.boterman@htm.nl" <b.boterman@htm.nl>
Date: Fri, 13 Feb 2026 14:47:12 +0100
Subject: [PATCH] OVPAY-2442 - Added touchpointId query param.

---
 src/openapi/products/vouchers-se.yaml | 20 +++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

diff --git a/src/openapi/products/vouchers-se.yaml b/src/openapi/products/vouchers-se.yaml
index 895eb20..a01c3f9 100644
--- a/src/openapi/products/vouchers-se.yaml
+++ b/src/openapi/products/vouchers-se.yaml
@@ -16,6 +16,15 @@ paths:
         Essentially, this means that only products that have active sellingPeriods for touch points within the same 
         retailer as the calling touch point are returned.
       parameters:
+        - name: touchpointId
+          in: query
+          required: false
+          description: |
+            Filter the voucher definitions on a specific touch point id. This means that only voucher definitions with active selling periods for the specified touch point are returned.
+            This query parameter is only intended for administrative purposes, since the touch point associated with the access token used in the request is used to determine which voucher definitions are returned. This query parameter can be used to retrieve voucher definitions for other touch points within the same retailer, for example to retrieve voucher definitions for a specific sales touch point that is different from the calling touch point.
+          schema:
+            type: integer
+            example: 1001
         - name: productId
           in: query
           required: false
@@ -194,6 +203,15 @@ paths:
         Retrieve all issued vouchers for a specific touch point. This means that only products that have active sellingPeriods for touch points within the same
         retailer as the calling touch point are returned.
       parameters:
+        - name: touchpointId
+          in: query
+          required: false
+          description: |
+            Filter the issued vouchers on a specific touch point id. This means that only issued vouchers for products with active selling periods for the specified touch point are returned.
+            This query parameter is only intended for administrative purposes, since the touch point associated with the access token used in the request is used to determine which issued vouchers are returned. This query parameter can be used to retrieve issued vouchers for other touch points within the same retailer, for example to retrieve issued vouchers for a specific sales touch point that is different from the calling touch point.
+          schema:
+            type: integer
+            example: 1001
         - name: issuedVoucherId
           in: query
           required: false
@@ -272,7 +290,7 @@ paths:
                                     {
                                       "productId": 126,
                                       "productName": "HTM-30001",
-                                      "productDescription": "Reis met 20% korting op je betaalpas bij HTM.",
+                                      "productDescription": "Regiovrij maand.",
                                       "_links":
                                         {
                                           "get_details":