Added get child merchants to merchant api client

Author: arifm

src/NoFrixion.MoneyMoov/ApiClients/MerchantClient.cs

@@ -56,6 +56,12 @@ public interface IMerchantClient
     Task<RestApiResponse<Merchant>> GetMerchantAsync(string userAccessToken, Guid merchantID);
 
     Task<RestApiResponse<Merchant>> UpdateMerchantAsync(string userAccessToken, Guid merchantID, MerchantUpdate merchantUpdate);
+
+    Task<RestApiResponse<MerchantPageResponse>> GetChildMerchantsAsync(string userAccessToken, Guid parentMerchantID,
+        int pageNumber = 1,
+        int pageSize = 20,
+        string? search = null,
+        string? sort = null);
 }
 
 public class MerchantClient : IMerchantClient
@@ -365,4 +371,36 @@ public Task<RestApiResponse<Merchant>> UpdateMerchantAsync(string userAccessToke
             _ => Task.FromResult(new RestApiResponse<Merchant>(HttpStatusCode.PreconditionFailed, new Uri(url), prob))
         };
     }
+
+    /// <summary>
+    /// Calls the MoneyMoov Merchant get child merchants endpoint to get a paged list of child merchants.
+    /// </summary>
+    /// <param name="userAccessToken">A user-scoped JWT access token.</param>
+    /// <param name="parentMerchantID">The unique identifier of the parent merchant.</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>> GetChildMerchantsAsync(string userAccessToken, Guid parentMerchantID,
+        int pageNumber = 1,
+        int pageSize = 20,
+        string? search = null,
+        string? sort = null)
+    {
+        var url = MoneyMoovUrlBuilder.MerchantsApi.ChildMerchantsUrl(_apiClient.GetBaseUri().ToString(),
+            parentMerchantID,
+            pageNumber,
+            pageSize,
+            search,
+            sort);
+
+        var prob = _apiClient.CheckAccessToken(userAccessToken, nameof(GetMerchantTokenAsync));
+
+        return prob switch
+        {
+            var p when p.IsEmpty => _apiClient.GetAsync<MerchantPageResponse>(url, userAccessToken),
+            _ => Task.FromResult(new RestApiResponse<MerchantPageResponse>(HttpStatusCode.PreconditionFailed, new Uri(url), prob))
+        };
+    }
 }

src/NoFrixion.MoneyMoov/MoneyMoovUrlBuilder.cs

@@ -18,7 +18,7 @@ namespace NoFrixion.MoneyMoov;
 public enum MoneyMoovResources
 {
     accounts,
-    
+
     banksettings,
 
     batch,
@@ -54,7 +54,7 @@ public enum MoneyMoovResources
     userroles,
 
     webhooks,
-    
+
     roles,
 
     users,
@@ -80,13 +80,13 @@ public static string AccountsUrl(string moneyMoovBaseUrl)
 
         public static string AccountPayoutsUrl(string moneyMoovBaseUrl, Guid accountID)
             => $"{moneyMoovBaseUrl}/{MoneyMoovResources.accounts}/{accountID}/{MoneyMoovResources.payouts}";
-        
+
         public static string StatementsUrl(string moneyMoovBaseUrl)
             => $"{moneyMoovBaseUrl}/{MoneyMoovResources.accounts}/{MoneyMoovResources.statements}";
 
         public static string StatementsUrlWithAccountPlaceholder(string moneyMoovBaseUrl)
             => $"{moneyMoovBaseUrl}/{MoneyMoovResources.accounts}/##account##/{MoneyMoovResources.statements}";
-        
+
         public static string StatementsUrl(string moneyMoovBaseUrl, Guid accountID, Guid statementID)
             => $"{moneyMoovBaseUrl}/{MoneyMoovResources.accounts}/{accountID}/{MoneyMoovResources.statements}/{statementID}";
     }
@@ -114,20 +114,20 @@ public static string MerchantAccountsUrl(string moneyMoovBaseUrl, Guid merchantI
         public static string MerchantBankSettings(string moneyMoovBaseUrl, Guid merchantID,
             CurrencyTypeEnum? currency = null)
         {
-            return currency.HasValue 
-                ? $"{moneyMoovBaseUrl}/{MoneyMoovResources.merchants}/{merchantID}/{MoneyMoovResources.banksettings}?currency={currency}" 
+            return currency.HasValue
+                ? $"{moneyMoovBaseUrl}/{MoneyMoovResources.merchants}/{merchantID}/{MoneyMoovResources.banksettings}?currency={currency}"
                 : $"{moneyMoovBaseUrl}/{MoneyMoovResources.merchants}/{merchantID}/{MoneyMoovResources.banksettings}";
         }
-        
+
         public static string MerchantTokensUrl(string moneyMoovBaseUrl, Guid merchantID)
             => $"{moneyMoovBaseUrl}/{MoneyMoovResources.merchants}/{merchantID}/{MoneyMoovResources.tokens}";
 
         public static string MerchantUserInvitesUrl(string moneyMoovBaseUrl, Guid merchantID)
            => $"{moneyMoovBaseUrl}/{MoneyMoovResources.merchants}/{merchantID}/{MoneyMoovResources.userinvites}";
-        
+
         public static string MerchantWebHooksUrl(string moneyMoovBaseUrl, Guid merchantID)
             => $"{moneyMoovBaseUrl}/{MoneyMoovResources.merchants}/{merchantID}/{MoneyMoovResources.webhooks}";
-        
+
         public static string MerchantRolesUrl(string moneyMoovBaseUrl, Guid merchantID)
             => $"{moneyMoovBaseUrl}/{MoneyMoovResources.merchants}/{merchantID}/{MoneyMoovResources.roles}";
 
@@ -136,15 +136,23 @@ public static string MerchantRoleUrl(string moneyMoovBaseUrl, Guid merchantID, G
 
         public static string MerchantRoleUsersUrl(string moneyMoovBaseUrl, Guid merchantID, Guid roleID)
             => $"{moneyMoovBaseUrl}/{MoneyMoovResources.merchants}/{merchantID}/{MoneyMoovResources.roles}/{roleID}/{MoneyMoovResources.users}";
-        
+
         public static string MerchantRoleUsersUrl(string moneyMoovBaseUrl, Guid merchantID, Guid roleID, Guid userID)
             => $"{moneyMoovBaseUrl}/{MoneyMoovResources.merchants}/{merchantID}/{MoneyMoovResources.roles}/{roleID}/{MoneyMoovResources.users}/{userID}";
 
         public static string MerchantRolesUserUrl(string moneyMoovBaseUrl, Guid merchantID, Guid userID)
             => $"{moneyMoovBaseUrl}/{MoneyMoovResources.merchants}/{merchantID}/{MoneyMoovResources.users}/{userID}/{MoneyMoovResources.roles}";
-        
+
         public static string MerchantRolesBatchCreateUrl(string moneyMoovBaseUrl, Guid merchantID)
             => $"{moneyMoovBaseUrl}/{MoneyMoovResources.merchants}/{merchantID}/{MoneyMoovResources.roles}/batchcreate";
+
+        public static string ChildMerchantsUrl(string moneyMoovBaseUrl, Guid parentMerchantID,
+            int? pageNumber,
+            int? pageSize,
+            string? search,
+            string? sort)
+            => $"{moneyMoovBaseUrl}/{MoneyMoovResources.merchants}/{parentMerchantID}/childmerchants" +
+               $"?pageNumber={pageNumber}&pageSize={pageSize}&search={search}&sort={sort}";
     }
 
     /// <summary>
@@ -202,7 +210,7 @@ public static string PaymentRequestUrl(string moneyMoovBaseUrl, Guid paymentRequ
 
         public static string GetByOrderIDUrl(string moneyMoovBaseUrl, string orderID)
             => $"{moneyMoovBaseUrl}/{MoneyMoovResources.paymentrequests}/getbyorderid/{orderID}";
-        
+
         public static string BatchPaymentRequestsUrl(string moneyMoovBaseUrl)
             => $"{moneyMoovBaseUrl}/{MoneyMoovResources.paymentrequests}/batchcreate";
     }
@@ -238,7 +246,7 @@ public static string SubmitBatchPayoutUrl(string moneyMoovBaseUrl, Guid payoutID
 
         public static string CancelScheduledPayoutUrl(string moneyMoovBaseUrl, Guid payoutID)
             => $"{moneyMoovBaseUrl}/{MoneyMoovResources.payouts}/cancel/{payoutID}";
-        
+
         public static string RejectPayoutUrl(string moneyMoovBaseUrl, Guid payoutID)
             => $"{moneyMoovBaseUrl}/{MoneyMoovResources.payouts}/reject/{payoutID}";
 
@@ -327,7 +335,7 @@ public static string AuthoriseUserInviteUrl(string moneyMoovBaseUrl, Guid userIn
 
         public static string UserInviteDetailsUrl(string moneyMoovBaseUrl, Guid userInviteID)
             => $"{moneyMoovBaseUrl}/{MoneyMoovResources.userinvites}/{userInviteID}/details";
-        
+
         public static string BatchUserInvitesUrl(string moneyMoovBaseUrl)
             => $"{moneyMoovBaseUrl}/{MoneyMoovResources.userinvites}/batchcreate";
     }
@@ -357,7 +365,7 @@ public static string BeneficiaryUrl(string moneyMoovBaseUrl)
 
         public static string AuthoriseBeneficiaryUrl(string moneyMoovBaseUrl, Guid beneficiaryID)
             => $"{moneyMoovBaseUrl}/{MoneyMoovResources.beneficiaries}/authorise/{beneficiaryID}";
-        
+
         public static string BatchBeneficiariesUrl(string moneyMoovBaseUrl)
             => $"{moneyMoovBaseUrl}/{MoneyMoovResources.beneficiaries}/batchcreate";
     }
@@ -429,5 +437,5 @@ public static string BeneficiaryGroupsGetAllApiUrl(string moneyMoovBaseUrl, Guid
     public static string BusinessHubUrl(string moneyMoovBaseUrl)
     {
         return $"{moneyMoovBaseUrl}/signalr/business";
-    } 
+    }
 }