Merge pull request #660 from nofrixion/MOOV-4804-requester-vop

Added payee verification properties to payout

Author: sauravmaiti22

src/NoFrixion.MoneyMoov/Enums/PayeeVerificationStatusEnum.cs

@@ -0,0 +1,29 @@
+namespace NoFrixion.MoneyMoov.Enums;
+
+public enum PayeeVerificationStatusEnum
+{
+    /// <summary>
+    /// Indicates that no payee verification status is set.
+    /// </summary>
+    None = 0,
+    
+    /// <summary>
+    /// Indicates that payee verification is not required for this payee.
+    /// </summary>
+    NotRequired = 1,
+    
+    /// <summary>
+    /// Indicates that payee verification is pending and has not yet been completed.
+    /// </summary>
+    Pending = 2,
+    
+    /// <summary>
+    /// Indicates that payee verification has been successfully completed.
+    /// </summary>
+    Completed = 3,
+    
+    /// <summary>
+    /// Indicates that payee verification failed.
+    /// </summary>
+    Failed = 4
+}

src/NoFrixion.MoneyMoov/Models/PayeeVerification/PayeeVerificationResult.cs

@@ -0,0 +1,48 @@
+// -----------------------------------------------------------------------------
+//  Filename: PayeeVerificationResult.cs
+// 
+//  Description: The result of a payee verification attempt.
+// 
+//  Author(s):
+//  Saurav Maiti ([email protected])
+// 
+//  History:
+//  19 Sep 2025  Saurav Maiti   Created, Hamilton gardens, Dublin, Ireland.
+// 
+//  License:
+//  MIT.
+// -----------------------------------------------------------------------------
+
+using NoFrixion.MoneyMoov.Enums;
+
+namespace NoFrixion.MoneyMoov.Models.PayeeVerification;
+
+public class PayeeVerificationResult
+{
+    /// <summary>
+    /// The payee that was verified
+    /// </summary>
+    public required Counterparty Payee { get; init; }
+    
+    /// <summary>
+    /// An optional reference that was passed in with the verification request
+    /// </summary>
+    public string? Reference { get; init; }
+    
+    /// <summary>
+    /// The result of the payee verification
+    /// </summary>
+    public PayeeVerificationResultEnum Result { get; init; }
+    
+    /// <summary>
+    /// The verified account name of the payee, if available (in case of a close match)
+    /// </summary>
+    public string? PayeeVerifiedAccountName { get; init; }
+    
+    /// <summary>
+    /// The raw response from the supplier (e.g. Technoxander) as a JSON string, if available
+    /// </summary>
+    public string? SupplierRawResponse { get; set; }
+    
+    public string? SupplierStatus { get; set; }
+}

src/NoFrixion.MoneyMoov/Models/Payouts/Payout.cs

@@ -18,7 +18,7 @@
 using NoFrixion.MoneyMoov.Models.Approve;
 using System.ComponentModel.DataAnnotations;
 using NoFrixion.MoneyMoov.Extensions;
-using LanguageExt;
+using NoFrixion.MoneyMoov.Models.PayeeVerification;
 
 namespace NoFrixion.MoneyMoov.Models;
 
@@ -513,6 +513,16 @@ public Counterparty? DestinationAccount
     /// </summary>
     public DateTimeOffset? FxQuoteExpiresAt { get; set; }
 
+    /// <summary>
+    /// Current status of the payee verification check
+    /// </summary>
+    public PayeeVerificationStatusEnum PayeeVerificationStatus { get; set; }
+
+    /// <summary>
+    /// The payee verification result, if verification has been completed
+    /// </summary>
+    public PayeeVerificationResult? PayeeVerificationResult { get; set; }
+
     public NoFrixionProblem Validate()
     {
         var context = new ValidationContext(this, serviceProvider: null, items: null);
@@ -578,3 +588,5 @@ public string ToCsvRow()
         return this.ToCsvRowString();
     }
 }
+
+

src/NoFrixion.MoneyMoov/Models/Payouts/PayoutEvent.cs

@@ -63,4 +63,9 @@ public class PayoutEvent
     /// this contains the actual verified name returned by the payee verification supplier.
     /// </summary>
     public string? PayeeVerifiedAccountName { get; set; }
+    
+    /// <summary>
+    /// The payout ID the event is for.
+    /// </summary>
+    public Guid PayoutID { get; set; }
 }