AccountHoldersService.cs

/*
* Configuration API
*
*
* The version of the OpenAPI document: 2
*
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
* https://openapi-generator.tech
* Do not edit the class manually.
*/

using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Threading;
using System.Threading.Tasks;
using Adyen.Model;
using Adyen.Model.BalancePlatform;

namespace Adyen.Service.BalancePlatform
{
    /// <summary>
    /// AccountHoldersService Interface
    /// </summary>
    public interface IAccountHoldersService
    {
        /// <summary>
        /// Create an account holder
        /// </summary>
        /// <param name="accountHolderInfo"><see cref="AccountHolderInfo"/> - </param>
        /// <param name="requestOptions"><see cref="RequestOptions"/> - Additional request options.</param>
        /// <returns><see cref="AccountHolder"/>.</returns>
        Model.BalancePlatform.AccountHolder CreateAccountHolder(AccountHolderInfo accountHolderInfo = default, RequestOptions requestOptions = default);
        
        /// <summary>
        /// Create an account holder
        /// </summary>
        /// <param name="accountHolderInfo"><see cref="AccountHolderInfo"/> - </param>
        /// <param name="requestOptions"><see cref="RequestOptions"/> - Additional request options.</param>
        /// <param name="cancellationToken"> A CancellationToken enables cooperative cancellation between threads, thread pool work items, or Task objects.</param>
        /// <returns>Task of <see cref="AccountHolder"/>.</returns>
        Task<Model.BalancePlatform.AccountHolder> CreateAccountHolderAsync(AccountHolderInfo accountHolderInfo = default, RequestOptions requestOptions = default, CancellationToken cancellationToken = default);
        
        /// <summary>
        /// Get an account holder
        /// </summary>
        /// <param name="id"><see cref="string"/> - The unique identifier of the account holder.</param>
        /// <param name="requestOptions"><see cref="RequestOptions"/> - Additional request options.</param>
        /// <returns><see cref="AccountHolder"/>.</returns>
        Model.BalancePlatform.AccountHolder GetAccountHolder(string id, RequestOptions requestOptions = default);
        
        /// <summary>
        /// Get an account holder
        /// </summary>
        /// <param name="id"><see cref="string"/> - The unique identifier of the account holder.</param>
        /// <param name="requestOptions"><see cref="RequestOptions"/> - Additional request options.</param>
        /// <param name="cancellationToken"> A CancellationToken enables cooperative cancellation between threads, thread pool work items, or Task objects.</param>
        /// <returns>Task of <see cref="AccountHolder"/>.</returns>
        Task<Model.BalancePlatform.AccountHolder> GetAccountHolderAsync(string id, RequestOptions requestOptions = default, CancellationToken cancellationToken = default);
        
        /// <summary>
        /// Get all balance accounts of an account holder
        /// </summary>
        /// <param name="id"><see cref="string"/> - The unique identifier of the account holder.</param>
        /// <param name="offset"><see cref="int?"/> - The number of items that you want to skip.</param>
        /// <param name="limit"><see cref="int?"/> - The number of items returned per page, maximum 100 items. By default, the response returns 10 items per page.</param>
        /// <param name="requestOptions"><see cref="RequestOptions"/> - Additional request options.</param>
        /// <returns><see cref="PaginatedBalanceAccountsResponse"/>.</returns>
        Model.BalancePlatform.PaginatedBalanceAccountsResponse GetAllBalanceAccountsOfAccountHolder(string id, int? offset = default, int? limit = default, RequestOptions requestOptions = default);
        
        /// <summary>
        /// Get all balance accounts of an account holder
        /// </summary>
        /// <param name="id"><see cref="string"/> - The unique identifier of the account holder.</param>
        /// <param name="offset"><see cref="int?"/> - The number of items that you want to skip.</param>
        /// <param name="limit"><see cref="int?"/> - The number of items returned per page, maximum 100 items. By default, the response returns 10 items per page.</param>
        /// <param name="requestOptions"><see cref="RequestOptions"/> - Additional request options.</param>
        /// <param name="cancellationToken"> A CancellationToken enables cooperative cancellation between threads, thread pool work items, or Task objects.</param>
        /// <returns>Task of <see cref="PaginatedBalanceAccountsResponse"/>.</returns>
        Task<Model.BalancePlatform.PaginatedBalanceAccountsResponse> GetAllBalanceAccountsOfAccountHolderAsync(string id, int? offset = default, int? limit = default, RequestOptions requestOptions = default, CancellationToken cancellationToken = default);
        
        /// <summary>
        /// Get a tax form
        /// </summary>
        /// <param name="id"><see cref="string"/> - The unique identifier of the account holder.</param>
        /// <param name="formType"><see cref="string"/> - The type of tax form you want to retrieve. Accepted values are **US1099k** and **US1099nec**</param>
        /// <param name="year"><see cref="int"/> - The tax year in YYYY format for the tax form you want to retrieve</param>
        /// <param name="requestOptions"><see cref="RequestOptions"/> - Additional request options.</param>
        /// <returns><see cref="GetTaxFormResponse"/>.</returns>
        Model.BalancePlatform.GetTaxFormResponse GetTaxForm(string id, string formType, int year, RequestOptions requestOptions = default);
        
        /// <summary>
        /// Get a tax form
        /// </summary>
        /// <param name="id"><see cref="string"/> - The unique identifier of the account holder.</param>
        /// <param name="formType"><see cref="string"/> - The type of tax form you want to retrieve. Accepted values are **US1099k** and **US1099nec**</param>
        /// <param name="year"><see cref="int"/> - The tax year in YYYY format for the tax form you want to retrieve</param>
        /// <param name="requestOptions"><see cref="RequestOptions"/> - Additional request options.</param>
        /// <param name="cancellationToken"> A CancellationToken enables cooperative cancellation between threads, thread pool work items, or Task objects.</param>
        /// <returns>Task of <see cref="GetTaxFormResponse"/>.</returns>
        Task<Model.BalancePlatform.GetTaxFormResponse> GetTaxFormAsync(string id, string formType, int year, RequestOptions requestOptions = default, CancellationToken cancellationToken = default);
        
        /// <summary>
        /// Update an account holder
        /// </summary>
        /// <param name="id"><see cref="string"/> - The unique identifier of the account holder.</param>
        /// <param name="accountHolderUpdateRequest"><see cref="AccountHolderUpdateRequest"/> - </param>
        /// <param name="requestOptions"><see cref="RequestOptions"/> - Additional request options.</param>
        /// <returns><see cref="AccountHolder"/>.</returns>
        Model.BalancePlatform.AccountHolder UpdateAccountHolder(string id, AccountHolderUpdateRequest accountHolderUpdateRequest = default, RequestOptions requestOptions = default);
        
        /// <summary>
        /// Update an account holder
        /// </summary>
        /// <param name="id"><see cref="string"/> - The unique identifier of the account holder.</param>
        /// <param name="accountHolderUpdateRequest"><see cref="AccountHolderUpdateRequest"/> - </param>
        /// <param name="requestOptions"><see cref="RequestOptions"/> - Additional request options.</param>
        /// <param name="cancellationToken"> A CancellationToken enables cooperative cancellation between threads, thread pool work items, or Task objects.</param>
        /// <returns>Task of <see cref="AccountHolder"/>.</returns>
        Task<Model.BalancePlatform.AccountHolder> UpdateAccountHolderAsync(string id, AccountHolderUpdateRequest accountHolderUpdateRequest = default, RequestOptions requestOptions = default, CancellationToken cancellationToken = default);
        
    }
    
    /// <summary>
    /// Represents a collection of functions to interact with the AccountHoldersService API endpoints
    /// </summary>
    public class AccountHoldersService : AbstractService, IAccountHoldersService
    {
        private readonly string _baseUrl;
        
        public AccountHoldersService(Client client) : base(client)
        {
            _baseUrl = CreateBaseUrl("https://balanceplatform-api-test.adyen.com/bcl/v2");
        }
        
        public Model.BalancePlatform.AccountHolder CreateAccountHolder(AccountHolderInfo accountHolderInfo = default, RequestOptions requestOptions = default)
        {
            return CreateAccountHolderAsync(accountHolderInfo, requestOptions).ConfigureAwait(false).GetAwaiter().GetResult();
        }

        public async Task<Model.BalancePlatform.AccountHolder> CreateAccountHolderAsync(AccountHolderInfo accountHolderInfo = default, RequestOptions requestOptions = default, CancellationToken cancellationToken = default)
        {
            var endpoint = _baseUrl + "/accountHolders";
            var resource = new ServiceResource(this, endpoint);
            return await resource.RequestAsync<Model.BalancePlatform.AccountHolder>(accountHolderInfo.ToJson(), requestOptions, new HttpMethod("POST"), cancellationToken).ConfigureAwait(false);
        }
        
        public Model.BalancePlatform.AccountHolder GetAccountHolder(string id, RequestOptions requestOptions = default)
        {
            return GetAccountHolderAsync(id, requestOptions).ConfigureAwait(false).GetAwaiter().GetResult();
        }

        public async Task<Model.BalancePlatform.AccountHolder> GetAccountHolderAsync(string id, RequestOptions requestOptions = default, CancellationToken cancellationToken = default)
        {
            var endpoint = _baseUrl + $"/accountHolders/{id}";
            var resource = new ServiceResource(this, endpoint);
            return await resource.RequestAsync<Model.BalancePlatform.AccountHolder>(null, requestOptions, new HttpMethod("GET"), cancellationToken).ConfigureAwait(false);
        }
        
        public Model.BalancePlatform.PaginatedBalanceAccountsResponse GetAllBalanceAccountsOfAccountHolder(string id, int? offset = default, int? limit = default, RequestOptions requestOptions = default)
        {
            return GetAllBalanceAccountsOfAccountHolderAsync(id, offset, limit, requestOptions).ConfigureAwait(false).GetAwaiter().GetResult();
        }

        public async Task<Model.BalancePlatform.PaginatedBalanceAccountsResponse> GetAllBalanceAccountsOfAccountHolderAsync(string id, int? offset = default, int? limit = default, RequestOptions requestOptions = default, CancellationToken cancellationToken = default)
        {
            // Build the query string
            var queryParams = new Dictionary<string, string>();
            if (offset != null) queryParams.Add("offset", offset.ToString());
            if (limit != null) queryParams.Add("limit", limit.ToString());
            var endpoint = _baseUrl + $"/accountHolders/{id}/balanceAccounts" + ToQueryString(queryParams);
            var resource = new ServiceResource(this, endpoint);
            return await resource.RequestAsync<Model.BalancePlatform.PaginatedBalanceAccountsResponse>(null, requestOptions, new HttpMethod("GET"), cancellationToken).ConfigureAwait(false);
        }
        
        public Model.BalancePlatform.GetTaxFormResponse GetTaxForm(string id, string formType, int year, RequestOptions requestOptions = default)
        {
            return GetTaxFormAsync(id, formType, year, requestOptions).ConfigureAwait(false).GetAwaiter().GetResult();
        }

        public async Task<Model.BalancePlatform.GetTaxFormResponse> GetTaxFormAsync(string id, string formType, int year, RequestOptions requestOptions = default, CancellationToken cancellationToken = default)
        {
            // Build the query string
            var queryParams = new Dictionary<string, string>();
            queryParams.Add("formType", formType);
            queryParams.Add("year", year.ToString());
            var endpoint = _baseUrl + $"/accountHolders/{id}/taxForms" + ToQueryString(queryParams);
            var resource = new ServiceResource(this, endpoint);
            return await resource.RequestAsync<Model.BalancePlatform.GetTaxFormResponse>(null, requestOptions, new HttpMethod("GET"), cancellationToken).ConfigureAwait(false);
        }
        
        public Model.BalancePlatform.AccountHolder UpdateAccountHolder(string id, AccountHolderUpdateRequest accountHolderUpdateRequest = default, RequestOptions requestOptions = default)
        {
            return UpdateAccountHolderAsync(id, accountHolderUpdateRequest, requestOptions).ConfigureAwait(false).GetAwaiter().GetResult();
        }

        public async Task<Model.BalancePlatform.AccountHolder> UpdateAccountHolderAsync(string id, AccountHolderUpdateRequest accountHolderUpdateRequest = default, RequestOptions requestOptions = default, CancellationToken cancellationToken = default)
        {
            var endpoint = _baseUrl + $"/accountHolders/{id}";
            var resource = new ServiceResource(this, endpoint);
            return await resource.RequestAsync<Model.BalancePlatform.AccountHolder>(accountHolderUpdateRequest.ToJson(), requestOptions, new HttpMethod("PATCH"), cancellationToken).ConfigureAwait(false);
        }
    }
}