Add Network Token API endpoints and related models (#489)

Author: armando-rodriguez-cko

src/CheckoutSdk/CheckoutApi.cs

@@ -8,6 +8,7 @@
 using Checkout.Forward;
 using Checkout.Instruments;
 using Checkout.Metadata;
+using Checkout.NetworkTokens;
 using Checkout.Payments;
 using Checkout.Payments.Contexts;
 using Checkout.Payments.Hosted;
@@ -45,6 +46,7 @@ public class CheckoutApi : ICheckoutApi
         private readonly IPaymentContextsClient _paymentContextsClient;
         private readonly IPaymentSessionsClient _paymentSessionsClient;
         private readonly IForwardClient _forwardClient;
+        private readonly INetworkTokensClient _networkTokensClient;
 
         public CheckoutApi(CheckoutConfiguration configuration)
         {
@@ -75,6 +77,7 @@ public CheckoutApi(CheckoutConfiguration configuration)
             _paymentContextsClient = new PaymentContextsClient(baseApiClient, configuration);
             _paymentSessionsClient = new PaymentSessionsClient(baseApiClient, configuration);
             _forwardClient = new ForwardClient(baseApiClient, configuration);
+            _networkTokensClient = new NetworkTokensClient(baseApiClient, configuration);
         }
 
         private static ApiClient BaseApiClient(CheckoutConfiguration configuration)
@@ -212,5 +215,11 @@ public IForwardClient ForwardClient()
         {
             return _forwardClient;
         }
+
+        public INetworkTokensClient NetworkTokensClient()
+        {
+            return _networkTokensClient;
+        }
+        
     }
-}
+}

src/CheckoutSdk/Common/Resource.cs

@@ -23,6 +23,11 @@ public Link GetUploadLink()
             return GetLink("upload");
         }
 
+        public Link GetCryptogramLink()
+        {
+            return GetLink("cryptogram");
+        }
+        
         public bool HasLink(string relation)
         {
             return Links.ContainsKey(relation);

src/CheckoutSdk/Forward/ForwardClient.cs

@@ -1,11 +1,13 @@
 using Checkout.Forward.Requests;
 using Checkout.Forward.Responses;
-using System;
 using System.Threading;
 using System.Threading.Tasks;
 
 namespace Checkout.Forward
 {
+    /// <summary>
+    /// Forward
+    /// </summary>
     public class ForwardClient : AbstractClient, IForwardClient
     {
         private const string Forward = "forward";
@@ -15,6 +17,12 @@ public ForwardClient(IApiClient apiClient, CheckoutConfiguration configuration)
         {
         }
 
+        /// <summary>
+        /// Forward an API request
+        /// [BETA]
+        /// Forwards an API request to a third-party endpoint.
+        /// For example, you can forward payment credentials you've stored in our Vault to a third-party payment processor.
+        /// </summary>
         public Task<ForwardAnApiResponse> ForwardAnApiRequest(ForwardRequest forwardRequest,
             CancellationToken cancellationToken = default)
         {
@@ -27,6 +35,11 @@ public Task<ForwardAnApiResponse> ForwardAnApiRequest(ForwardRequest forwardRequ
             );
         }
 
+        /// <summary>
+        /// Get forward request
+        /// Retrieve the details of a successfully forwarded API request.
+        /// The details can be retrieved for up to 14 days after the request was initiated.
+        /// </summary>
         public Task<GetForwardResponse> GetForwardRequest(string forwardId,
             CancellationToken cancellationToken = default)
         {

src/CheckoutSdk/Forward/IForwardClient.cs

@@ -5,21 +5,24 @@
 
 namespace Checkout.Forward
 {
+    /// <summary>
+    /// Forward
+    /// </summary>
     public interface IForwardClient
     {
         /// <summary>
-        ///     Forward an API request<br />
-        ///     <b>Beta</b><br />
-        ///     Forwards an API request to a third-party endpoint.<br />
-        ///     For example, you can forward payment credentials you've stored in our Vault to a third-party payment processor.
+        /// Forward an API request
+        /// [BETA]
+        /// Forwards an API request to a third-party endpoint.
+        /// For example, you can forward payment credentials you've stored in our Vault to a third-party payment processor.
         /// </summary>
         Task<ForwardAnApiResponse> ForwardAnApiRequest(ForwardRequest forwardRequest,
             CancellationToken cancellationToken = default);
 
         /// <summary>
-        ///     Get forward request<br />
-        ///     Retrieve the details of a successfully forwarded API request.<br />
-        ///     The details can be retrieved for up to 14 days after the request was initiated.
+        /// Get forward request
+        /// Retrieve the details of a successfully forwarded API request.
+        /// The details can be retrieved for up to 14 days after the request was initiated.
         /// </summary>
         Task<GetForwardResponse> GetForwardRequest(string forwardId, CancellationToken cancellationToken = default);
     }

src/CheckoutSdk/ICheckoutApi.cs

@@ -8,6 +8,7 @@
 using Checkout.Forward;
 using Checkout.Instruments;
 using Checkout.Metadata;
+using Checkout.NetworkTokens;
 using Checkout.Payments;
 using Checkout.Payments.Contexts;
 using Checkout.Payments.Hosted;
@@ -65,5 +66,7 @@ public interface ICheckoutApi : ICheckoutApiClient
         IPaymentSessionsClient PaymentSessionsClient();
 
         IForwardClient ForwardClient();
+        
+        INetworkTokensClient NetworkTokensClient();
     }
-}
+}

src/CheckoutSdk/NetworkTokens/Common/Responses/Card.cs

@@ -0,0 +1,14 @@
+namespace Checkout.NetworkTokens.Common.Responses
+{
+    public class Card
+    {
+        /// <summary> The last four digits of the card number (Required, constraints: ^[0-9]{4}$) </summary>
+        public string Last4 { get; set; }
+
+        /// <summary> The card's expiration month (Required, constraints: [ 1 .. 12 ], ^[0-9]{1,2}$) </summary>
+        public string ExpiryMonth { get; set; }
+
+        /// <summary> The card's expiration year (Required, constraints: ^[0-9]{4}$) </summary>
+        public string ExpiryYear { get; set; }
+    }
+}

src/CheckoutSdk/NetworkTokens/Common/Responses/NetworkToken.cs

@@ -0,0 +1,45 @@
+namespace Checkout.NetworkTokens.Common.Responses
+{
+    public class NetworkToken
+    {
+        /// <summary> Unique token ID assigned by Checkout.com for each token (Required) </summary>
+        public string Id { get; set; }
+
+        /// <summary> Token status (Required) </summary>
+        public StateType State { get; set; }
+
+        /// <summary>
+        /// The network token number. This field is only returned when the network token status is one of the
+        /// following: active, suspended, inactive (Constraints: ^[0-9]+$)
+        /// </summary>
+        public string Number { get; set; }
+
+        /// <summary>
+        /// The network token's expiration month. This field is only returned when the network token status is
+        /// one of the following: active, suspended, inactive (Constraints: ^[0-9]{1,2}$)
+        /// </summary>
+        public string ExpiryMonth { get; set; }
+
+        /// <summary>
+        /// The network token's expiration year. This field is only returned when the network token status is
+        /// one of the following: active, suspended, inactive (Constraints: ^[0-9]{4}$)
+        /// </summary>
+        public string ExpiryYear { get; set; }
+
+        /// <summary> The type of token (Required) </summary>
+        public NetworkTokenType Type { get; set; }
+
+        /// <summary> When the network token was created (Required) </summary>
+        public string CreatedOn { get; set; }
+
+        /// <summary> When the network token was modified (Required) </summary>
+        public string ModifiedOn { get; set; }
+
+        /// <summary>
+        /// Unique Payment account reference value assigned to payment account. All affiliated payment tokens,
+        /// as well as the underlying PAN, have the same payment_account_reference (Optional)
+        /// </summary>
+        public string PaymentAccountReference { get; set; }
+
+    }
+}

src/CheckoutSdk/NetworkTokens/Common/Responses/NetworkTokenResponse.cs

@@ -0,0 +1,16 @@
+using Checkout.Common;
+
+namespace Checkout.NetworkTokens.Common.Responses
+{
+    public class NetworkTokenResponse : Resource
+    {
+        /// <summary> The card details (Required) </summary>
+        public Card Card { get; set; }
+
+        /// <summary> Network token details (Required) </summary>
+        public NetworkToken NetworkToken { get; set; }
+
+        /// <summary> Token requestor ID (Optional) </summary>
+        public string TokenRequestorId { get; set; }
+    }
+}

src/CheckoutSdk/NetworkTokens/Common/Responses/NetworkTokenType.cs

@@ -0,0 +1,12 @@
+using System.Runtime.Serialization;
+
+namespace Checkout.NetworkTokens.Common.Responses
+{
+    public enum NetworkTokenType
+    {
+        [EnumMember(Value = "vts")] Vts,
+
+        [EnumMember(Value = "mdes")] Mdes,
+
+    }
+}

src/CheckoutSdk/NetworkTokens/Common/Responses/StateType.cs

@@ -0,0 +1,22 @@
+using System.Runtime.Serialization;
+
+namespace Checkout.NetworkTokens.Common.Responses
+{
+    public enum StateType
+    {
+        [EnumMember(Value = "active")]
+        Active,
+        
+        [EnumMember(Value = "suspended")]
+        Suspended,
+        
+        [EnumMember(Value = "inactive")]
+        Inactive,
+        
+        [EnumMember(Value = "declined")]
+        Declined,
+        
+        [EnumMember(Value = "requested")]
+        Requested
+    }
+}