Merge pull request #664 from nofrixion/feature/MOOV-4884-add-child-merchant

Added ParentMerchant to Merchant model

Author: donalnofrixion

src/NoFrixion.MoneyMoov/ApiClients/MerchantClient.cs

@@ -66,6 +66,14 @@ Task<RestApiResponse<MerchantPageResponse>> GetChildMerchantsAsync(string userAc
     Task<RestApiResponse<RoleUser>> GetRoleUserAssignmentAsync(string userAccessToken, Guid roleUserID);
 
     Task<RestApiResponse> AuthoriseRoleUserAssignmentAsync(string strongUserAccessToken, Guid roleUserID);
+    
+    Task<RestApiResponse<MerchantPageResponse>> GetMerchantsAsync(string userAccessToken,
+        int pageNumber = 1,
+        int pageSize = 20,
+        string? search = null,
+        string? sort = null);
+
+    Task<RestApiResponse> SetParentMerchantAsync(string userAccessToken, Guid merchantId, Guid parentMerchantId);
 }
 
 public class MerchantClient : IMerchantClient
@@ -447,4 +455,57 @@ public Task<RestApiResponse> AuthoriseRoleUserAssignmentAsync(string strongUserA
             _ => Task.FromResult(new RestApiResponse(HttpStatusCode.PreconditionFailed, new Uri(url), prob))
         };
     }
+
+    /// <summary>
+    /// Calls the MoneyMoov merchant endpoint to get a paged list of merchants.
+    /// </summary>
+    /// <param name="userAccessToken">A user scoped JWT access token.</param>
+    /// <param name="pageNumber">The page number of the result set to retrieve.</param>
+    /// <param name="pageSize">The number of records to return per page.</param>
+    /// <param name="search">A search filter to apply to the child merchant list. Typically searches against merchant name or ID.</param>
+    /// <param name="sort">The sort expression for the result set, e.g., "Name asc".</param>
+    /// <returns>A paged response containing a list of child merchants if successful.</returns>
+    public Task<RestApiResponse<MerchantPageResponse>> GetMerchantsAsync(string userAccessToken, 
+        int pageNumber = 1, 
+        int pageSize = Int32.MaxValue, 
+        string? search = null,
+        string? sort = null)
+    {
+        var url = MoneyMoovUrlBuilder.MerchantsApi.MerchantsPagedUrl(_apiClient.GetBaseUri().ToString(), 
+            pageNumber,
+            pageSize,
+            search,
+            sort);
+        
+        var prob = _apiClient.CheckAccessToken(userAccessToken, nameof(GetMerchantsAsync));
+        
+        return prob switch
+        {
+            var p when p.IsEmpty => _apiClient.GetAsync<MerchantPageResponse>(url, userAccessToken),
+            _ => Task.FromResult(new RestApiResponse<MerchantPageResponse>(HttpStatusCode.PreconditionFailed, new Uri(url), prob))
+        };
+    }
+
+    /// <summary>
+    /// Sets the parent merchant for a merchant.
+    /// This will make the merchant a child merchant of the specified parent merchant.
+    /// </summary>
+    /// <param name="userAccessToken">A user scoped JWT access token.</param>
+    /// <param name="merchantId">The id of the merchant to set the parent for. </param>
+    /// <param name="parentMerchantId">The parent merchant id</param>
+    /// <returns></returns>
+    public Task<RestApiResponse> SetParentMerchantAsync(string userAccessToken, Guid merchantId, Guid parentMerchantId)
+    {
+        var url = MoneyMoovUrlBuilder.MerchantsApi.SetParentMerchantUrl(_apiClient.GetBaseUri().ToString(), 
+            merchantId,
+            parentMerchantId);
+        
+        var prob = _apiClient.CheckAccessToken(userAccessToken, nameof(GetMerchantsAsync));
+        
+        return prob switch
+        {
+            var p when p.IsEmpty => _apiClient.PutAsync(url, userAccessToken),
+            _ => Task.FromResult(new RestApiResponse(HttpStatusCode.PreconditionFailed, new Uri(url), prob))
+        };
+    }
 }

src/NoFrixion.MoneyMoov/Models/Merchant/Merchant.cs

@@ -179,6 +179,11 @@ public class Merchant
     /// </summary>
     public List<CurrencyTypeEnum> AccountCurrencies { get; set; } = [];
 
+    /// <summary>
+    /// If the merchant is a child merchant, this property contains information about the parent merchant.
+    /// </summary>
+    public ParentMerchant? ParentMerchant { get; set; }
+    
     /// <summary>
     /// Gets the most appropriate display name for the merchant which
     /// means use the trading name if set and if not, default to the business name.

src/NoFrixion.MoneyMoov/Models/Merchant/ParentMerchant.cs

@@ -0,0 +1,23 @@
+// -----------------------------------------------------------------------------
+//  Filename: ParentMerchant.cs
+// 
+//  Description: Model to represent a Parent Merchant in MoneyMoov.:
+// 
+//  Author(s):
+//  Donal O'Connor ([email protected])
+// 
+//  History:
+//  09 10 2025  Donal O'Connor   Created, Harcourt St, Dublin, Ireland.
+// 
+//  License:
+//  Proprietary NoFrixion.
+// -----------------------------------------------------------------------------
+
+namespace NoFrixion.MoneyMoov.Models;
+
+public class ParentMerchant
+{
+    public Guid ID { get; set; }
+    
+    public string? Name { get; set; }
+}

src/NoFrixion.MoneyMoov/MoneyMoovUrlBuilder.cs

@@ -158,6 +158,17 @@ public static string ChildMerchantsUrl(string moneyMoovBaseUrl, Guid parentMerch
 
         public static string MerchantRoleUserAssignmentsUrl(string moneyMoovBaseUrl, Guid roleUserID)
             => $"{moneyMoovBaseUrl}/{MoneyMoovResources.merchants}/{MoneyMoovResources.roleusers}/{roleUserID}";
+        
+        public static string MerchantsPagedUrl(string moneyMoovBaseUrl,
+            int? pageNumber,
+            int? pageSize,
+            string? search,
+            string? sort)
+            => $"{moneyMoovBaseUrl}/{MoneyMoovResources.merchants}/paged" +
+               $"?pageNumber={pageNumber}&pageSize={pageSize}&search={search}&sort={sort}";
+        
+        public static string SetParentMerchantUrl(string moneyMoovBaseUrl, Guid merchantID, Guid parentMerchantID)
+            => $"{moneyMoovBaseUrl}/{MoneyMoovResources.merchants}/{merchantID}/parent/{parentMerchantID}";
     }
 
     /// <summary>