Billhighway Cloud API

<back to all web services

CreditCardPaymentRefund

The following routes are available for this service:
POST/api/CreditCard/Payment/RefundPerforms a credit card payment refund against Performs a credit card payment refund.
import Foundation
import ServiceStack

public class CreditCardPaymentRefund : CreditCardPaymentRefund
{
    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 CreditCardPaymentRefundResult : CreditCardCloudServiceResponse
{
    public var transactionRecordID:Int?
    public var failureType:PaymentFailureType?
    public var isOverpayment:Bool?
    public var paymentNotFound:Bool?

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

    private enum CodingKeys : String, CodingKey {
        case transactionRecordID
        case failureType
        case isOverpayment
        case paymentNotFound
    }

    required public init(from decoder: Decoder) throws {
        try super.init(from: decoder)
        let container = try decoder.container(keyedBy: CodingKeys.self)
        transactionRecordID = try container.decodeIfPresent(Int.self, forKey: .transactionRecordID)
        failureType = try container.decodeIfPresent(PaymentFailureType.self, forKey: .failureType)
        isOverpayment = try container.decodeIfPresent(Bool.self, forKey: .isOverpayment)
        paymentNotFound = try container.decodeIfPresent(Bool.self, forKey: .paymentNotFound)
    }

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

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(){}
}

public enum PaymentFailureType : Int, Codable
{
    case None = 0
    case Gateway = 1
    case PaymentTransaction = 2
    case KeyProcurment = 3
    case CardVerification = 4
}


Swift CreditCardPaymentRefund DTOs

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

HTTP + XML

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

POST /api/CreditCard/Payment/Refund HTTP/1.1 
Host: devapi.billhighway.com 
Accept: application/xml
Content-Type: application/xml
Content-Length: length

<CreditCardPaymentRefund xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="https://www.billhighway.com/api">
  <Header xmlns="http://schemas.datacontract.org/2004/07/BH.CloudAPI.Common.DTO">
    <CampaignId>0</CampaignId>
    <ClientId>0</ClientId>
    <CreatedBy>0</CreatedBy>
    <GroupId>0</GroupId>
    <IpAddress>String</IpAddress>
    <Location>String</Location>
    <LoggedInUserId>0</LoggedInUserId>
    <Machine>String</Machine>
    <ReCaptchaScore>0</ReCaptchaScore>
    <Referrer>String</Referrer>
    <Task>String</Task>
  </Header>
  <RefundInfo xmlns="http://schemas.datacontract.org/2004/07/BH.CloudAPI.Common.DTO">
    <Amount>0</Amount>
    <CurrencyCode>String</CurrencyCode>
    <GatewayTransactionId>String</GatewayTransactionId>
    <MemberPaymentId>0</MemberPaymentId>
    <Memo>String</Memo>
    <ReasonId>0</ReasonId>
    <Type>None</Type>
    <UserId>0</UserId>
  </RefundInfo>
</CreditCardPaymentRefund>
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<CreditCardPaymentRefundResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/BH.CloudAPI.Common.DTO">
  <ConfirmationNumber>String</ConfirmationNumber>
  <ErrorCode>String</ErrorCode>
  <GatewayId>0</GatewayId>
  <IsDuplicate>false</IsDuplicate>
  <IsSuccessful>false</IsSuccessful>
  <Message>String</Message>
  <NetworkTransactionId>String</NetworkTransactionId>
  <FailureType>None</FailureType>
  <IsOverpayment>false</IsOverpayment>
  <PaymentNotFound>false</PaymentNotFound>
  <TransactionRecordID>0</TransactionRecordID>
</CreditCardPaymentRefundResult>