/* Options:
Date: 2026-11-08 12:02:33
SwiftVersion: 5.0
Version: 5.140
Tip: To override a DTO option, remove "//" prefix before updating
BaseUrl: https://devapi.billhighway.com

//BaseClass: 
//AddModelExtensions: True
//AddServiceStackTypes: True
IncludeTypes: DonationAchRequest.*
//ExcludeTypes: 
//ExcludeGenericBaseTypes: False
//AddResponseStatus: False
//AddImplicitVersion: 
//AddDescriptionAsComments: True
//InitializeCollections: True
//TreatTypesAsStrings: 
//DefaultImports: Foundation,ServiceStack
*/

import Foundation
import ServiceStack

// @Route("/donations/ach", "POST")
public class DonationAchRequest : DonationRequestBase, IReturn, IDonationRequestWithDonorInfo
{
    public typealias Return = DonationAchResponse

    /**
    * Not required if MemberInfo is present on request
    */
    // @ApiMember(Description="Not required if MemberInfo is present on request")
    public var donorInfo:DonationDonorInfo?

    /**
    * Not required if DonorInfo is present on request
    */
    // @ApiMember(Description="Not required if DonorInfo is present on request")
    public var memberInfo:DonationMemberInfo?

    /**
    * Use GET /campaigns to retreive valid list of campaignIDs
    */
    // @ApiMember(Description="Use GET /campaigns to retreive valid list of campaignIDs")
    public var campaignId:Int?

    /**
    * RoutingNumber and AccountNumber are not required if AchRef is provided
    */
    // @ApiMember(Description="RoutingNumber and AccountNumber are not required if AchRef is provided")
    public var achRef:String?

    /**
    * Required if AchRef is not provided
    */
    // @ApiMember(Description="Required if AchRef is not provided")
    public var routingNumber:String?

    /**
    * Required if AchRef is not provided
    */
    // @ApiMember(Description="Required if AchRef is not provided")
    public var accountNumber:String?

    required public init(){ super.init() }

    private enum CodingKeys : String, CodingKey {
        case donorInfo
        case memberInfo
        case campaignId
        case achRef
        case routingNumber
        case accountNumber
    }

    required public init(from decoder: Decoder) throws {
        try super.init(from: decoder)
        let container = try decoder.container(keyedBy: CodingKeys.self)
        donorInfo = try container.decodeIfPresent(DonationDonorInfo.self, forKey: .donorInfo)
        memberInfo = try container.decodeIfPresent(DonationMemberInfo.self, forKey: .memberInfo)
        campaignId = try container.decodeIfPresent(Int.self, forKey: .campaignId)
        achRef = try container.decodeIfPresent(String.self, forKey: .achRef)
        routingNumber = try container.decodeIfPresent(String.self, forKey: .routingNumber)
        accountNumber = try container.decodeIfPresent(String.self, forKey: .accountNumber)
    }

    public override func encode(to encoder: Encoder) throws {
        try super.encode(to: encoder)
        var container = encoder.container(keyedBy: CodingKeys.self)
        if donorInfo != nil { try container.encode(donorInfo, forKey: .donorInfo) }
        if memberInfo != nil { try container.encode(memberInfo, forKey: .memberInfo) }
        if campaignId != nil { try container.encode(campaignId, forKey: .campaignId) }
        if achRef != nil { try container.encode(achRef, forKey: .achRef) }
        if routingNumber != nil { try container.encode(routingNumber, forKey: .routingNumber) }
        if accountNumber != nil { try container.encode(accountNumber, forKey: .accountNumber) }
    }
}

public class DonationAchResponse : IHaveErrorField, Codable
{
    /**
    * Legacy ErrorCode
    */
    // @ApiMember(Description="Legacy ErrorCode", ExcludeInSchema=true)
    // @Ignore()
    public var errorCode:Int?

    public var errorMessage:String?
    public var isError:Bool?
    /**
    * Donation Transaction ID
    */
    // @ApiMember(Description="Donation Transaction ID")
    public var transactionId:String?

    required public init(){}
}

public class DonationDonorInfo : Codable
{
    /**
    * Name of donor. Maximum 100 characters. Format must be Firstname {space} Lastname.
    */
    // @ApiMember(Description="Name of donor. Maximum 100 characters. Format must be Firstname {space} Lastname.", IsRequired=true, Name="FullName")
    public var fullName:String?

    /**
    * Billing address. Maximum 100 characters.
    */
    // @ApiMember(Description="Billing address. Maximum 100 characters.", IsRequired=true, Name="Address")
    public var address:String?

    /**
    * Billing city. Maximum 100 characters.
    */
    // @ApiMember(Description="Billing city. Maximum 100 characters.", IsRequired=true, Name="City")
    public var city:String?

    /**
    * Billing state. Two characters, must match valid US state code.
    */
    // @ApiMember(Description="Billing state. Two characters, must match valid US state code.", IsRequired=true, Name="State")
    public var state:String?

    /**
    * Credit Card billing address postal code. Maximum 10 characters.
    */
    // @ApiMember(Description="Credit Card billing address postal code. Maximum 10 characters.", IsRequired=true, Name="PostalCode")
    public var postalCode:String?

    /**
    * Email address of donor. Maximum 100 characters. If provided, must be valid email format.
    */
    // @ApiMember(Description="Email address of donor. Maximum 100 characters. If provided, must be valid email format.", Name="EmailAddress")
    public var emailAddress:String?

    /**
    * Preferred phone number. Maximum 12 characters.
    */
    // @ApiMember(Description="Preferred phone number. Maximum 12 characters.", Name="Phone")
    public var phone:String?

    required public init(){}
}

public class DonationMemberInfo : Codable
{
    // @ApiMember(IsRequired=true)
    public var bhUserId:Int?

    required public init(){}
}

public class DonationRecurringInfo : Codable
{
    /**
    * How often donation is collected automatically
    */
    // @ApiMember(Description="How often donation is collected automatically", IsRequired=true, Name="Frequency")
    public var frequency:String?

    /**
    * Number of recurring donation cycles.
    */
    // @ApiMember(Description="Number of recurring donation cycles.", IsRequired=true, Name="NumberOfOccurrences")
    public var numberOfOccurrences:Int?

    /**
    * Allows the submitter to set a future date for the donation
    */
    // @ApiMember(Description="Allows the submitter to set a future date for the donation", Name="FutureDonationDate")
    public var futureDonationDate:Date?

    required public init(){}
}

public class JsonObject : List<String:String>
{
    required public init(){ super.init() }

    required public init(from decoder: Decoder) throws {
        try super.init(from: decoder)
    }

    public override func encode(to encoder: Encoder) throws {
        try super.encode(to: encoder)
    }
}

public class DonationRequestBase : Codable
{
    /**
    * Client value for Group. String must already be configured in Billhighway system.
    */
    // @ApiMember(Description="Client value for Group. String must already be configured in Billhighway system.", IsRequired=true, Name="GroupID")
    public var groupId:String?

    /**
    * Amount of the payment. Must be an amount less than $10,000,000.00.
    */
    // @ApiMember(Description="Amount of the payment. Must be an amount less than $10,000,000.00.", IsRequired=true, Name="Amount")
    public var amount:Double?

    /**
    * The currency the payment is being made in. Three digit currency code (see ISO 4217) for a valid currency supported by Billhighway.  Defaults to USD
    */
    // @ApiMember(Description="The currency the payment is being made in. Three digit currency code (see ISO 4217) for a valid currency supported by Billhighway.  Defaults to USD", ExcludeInSchema=true, Name="CurrencyCode")
    public var currencyCode:String?

    /**
    * Notes about the donation. Maximum 70 characters.
    */
    // @ApiMember(Description="Notes about the donation. Maximum 70 characters.", Name="Memo")
    public var memo:String?

    // @ApiMember()
    public var donationRecurringInfo:DonationRecurringInfo?

    /**
    * Custom fields
    */
    // @ApiMember(Description="Custom fields", Name="MetaData")
    public var metaData:JsonObject?

    required public init(){}
}

public protocol IDonationRequestWithDonorInfo
{
    var donorInfo:DonationDonorInfo? { get set }
    var memberInfo:DonationMemberInfo? { get set }
    var groupId:String? { get set }

}

public protocol IHaveErrorField
{
    var isError:Bool? { get set }

}

public protocol IHaveErrorField
{
    var isError:Bool? { get set }

}