Billhighway Cloud API

<back to all web services

CreditCardVerify

The following routes are available for this service:
POST/api/v2/PaymentMethods/CC/VerificationPerforms 0 dollar verify of a credit card.Validates the credit card type, expiration date and performs credit card address verification against the credit card networks.
import Foundation
import ServiceStack

public class CreditCardVerify : CreditCardVerify
{
    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 CreditCardVerifyResult : CreditCardCloudServiceResponse
{
    public var cardRef:String?

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

    private enum CodingKeys : String, CodingKey {
        case cardRef
    }

    required public init(from decoder: Decoder) throws {
        try super.init(from: decoder)
        let container = try decoder.container(keyedBy: CodingKeys.self)
        cardRef = try container.decodeIfPresent(String.self, forKey: .cardRef)
    }

    public override func encode(to encoder: Encoder) throws {
        try super.encode(to: encoder)
        var container = encoder.container(keyedBy: CodingKeys.self)
        if cardRef != nil { try container.encode(cardRef, forKey: .cardRef) }
    }
}

public class CreditCardCloudServiceResponse : IHaveErrorField, Codable
{
    public var isDuplicate:Bool?
    public var isSuccessful:Bool?
    public var errorCode:String?
    public var message:String?
    public var gatewayId:Int?
    public var confirmationNumber:String?
    public var networkTransactionId:String?
    public var isError:Bool?

    required public init(){}
}


Swift CreditCardVerify DTOs

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /api/v2/PaymentMethods/CC/Verification HTTP/1.1 
Host: devapi.billhighway.com 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	UserId: 0,
	GroupId: 0,
	Location: String,
	CurrencyCode: String,
	NameOnCard: String,
	Address1: String,
	Address2: String,
	City: String,
	State: String,
	PostalCode: String,
	Country: String,
	CardType: 0,
	CardNumber: String,
	ExpMonth: 0,
	ExpYear: 0,
	CVV: String,
	Amount: 0,
	ChapAndUser: String,
	Description: String,
	PayLinkID: 0,
	EnsureValidZipAndCvc: False,
	ReCaptchaScore: 0
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	CardRef: String,
	IsDuplicate: False,
	IsSuccessful: False,
	ErrorCode: String,
	Message: String,
	GatewayId: 0,
	ConfirmationNumber: String,
	NetworkTransactionId: String,
	IsError: True
}