Billhighway Cloud API

AchDonation

The following routes are available for this service:
POST	/v1.2/payments/ach

import 'package:servicestack/servicestack.dart';

class ResultCode
{
    static const ResultCode Success = const ResultCode._(0);
    static const ResultCode Duplicate = const ResultCode._(-7);
    static const ResultCode NotAvailable = const ResultCode._(-6);
    static const ResultCode NotFound = const ResultCode._(-5);
    static const ResultCode GeneralError = const ResultCode._(-4);
    static const ResultCode UnexpectedError = const ResultCode._(-3);
    static const ResultCode CreditCardDeclined = const ResultCode._(-2);
    static const ResultCode DataValidationFailure = const ResultCode._(-1);

    final int _value;
    const ResultCode._(this._value);
    int get value => _value;
    static List<ResultCode> get values => const [Success,Duplicate,NotAvailable,NotFound,GeneralError,UnexpectedError,CreditCardDeclined,DataValidationFailure];
}

// @DataContract(Namespace="www.billhighway.com/api")
class LegacyApiResponse implements IHaveErrorField, IConvertible
{
    // @DataMember
    double? amount;

    // @DataMember
    String? confirmationNumber;

    // @DataMember
    String? responseCode;

    // @DataMember
    String? responseDescription;

    // @DataMember
    ResultCode? resultCode;

    LegacyApiResponse({this.amount,this.confirmationNumber,this.responseCode,this.responseDescription,this.resultCode});
    LegacyApiResponse.fromJson(Map<String, dynamic> json) { fromMap(json); }

    fromMap(Map<String, dynamic> json) {
        amount = JsonConverters.toDouble(json['amount']);
        confirmationNumber = json['confirmationNumber'];
        responseCode = json['responseCode'];
        responseDescription = json['responseDescription'];
        resultCode = JsonConverters.fromJson(json['resultCode'],'ResultCode',context!);
        return this;
    }

    Map<String, dynamic> toJson() => {
        'amount': amount,
        'confirmationNumber': confirmationNumber,
        'responseCode': responseCode,
        'responseDescription': responseDescription,
        'resultCode': JsonConverters.toJson(resultCode,'ResultCode',context!)
    };

    getTypeName() => "LegacyApiResponse";
    TypeContext? context = _ctx;
}

class AchDonation extends AchDonation implements ICanBeRecurring, IReturnLegacyException, IConvertible
{
    AchDonation();
    AchDonation.fromJson(Map<String, dynamic> json) : super.fromJson(json);
    fromMap(Map<String, dynamic> json) {
        super.fromMap(json);
        return this;
    }

    Map<String, dynamic> toJson() => super.toJson();
    getTypeName() => "AchDonation";
    TypeContext? context = _ctx;
}

TypeContext _ctx = TypeContext(library: 'devapi.billhighway.com', types: <String, TypeInfo> {
    'ResultCode': TypeInfo(TypeOf.Enum, enumValues:ResultCode.values),
    'LegacyApiResponse': TypeInfo(TypeOf.Class, create:() => LegacyApiResponse()),
    'AchDonation': TypeInfo(TypeOf.Class, create:() => AchDonation()),
});

Dart AchDonation 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 /v1.2/payments/ach HTTP/1.1 
Host: devapi.billhighway.com 
Accept: application/xml
Content-Type: application/xml
Content-Length: length

<AchDonation xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="https://www.billhighway.com/api">
  <AccountNumber xmlns="http://schemas.datacontract.org/2004/07/BH.CloudAPI.Common.DTO">String</AccountNumber>
  <Amount xmlns="http://schemas.datacontract.org/2004/07/BH.CloudAPI.Common.DTO">0</Amount>
  <CheckNumber xmlns="http://schemas.datacontract.org/2004/07/BH.CloudAPI.Common.DTO">String</CheckNumber>
  <ClientId xmlns="http://schemas.datacontract.org/2004/07/BH.CloudAPI.Common.DTO">0</ClientId>
  <EmailAddress xmlns="http://schemas.datacontract.org/2004/07/BH.CloudAPI.Common.DTO">String</EmailAddress>
  <GroupId xmlns="http://schemas.datacontract.org/2004/07/BH.CloudAPI.Common.DTO">0</GroupId>
  <Memo xmlns="http://schemas.datacontract.org/2004/07/BH.CloudAPI.Common.DTO">String</Memo>
  <NumberOfOccurences xmlns="http://schemas.datacontract.org/2004/07/BH.CloudAPI.Common.DTO">String</NumberOfOccurences>
  <Occurs xmlns="http://schemas.datacontract.org/2004/07/BH.CloudAPI.Common.DTO">String</Occurs>
  <PayerName xmlns="http://schemas.datacontract.org/2004/07/BH.CloudAPI.Common.DTO">String</PayerName>
  <RoutingNumber xmlns="http://schemas.datacontract.org/2004/07/BH.CloudAPI.Common.DTO">String</RoutingNumber>
</AchDonation>

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<LegacyApiResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="www.billhighway.com/api">
  <amount>0</amount>
  <confirmationNumber>String</confirmationNumber>
  <responseCode>String</responseCode>
  <responseDescription>String</responseDescription>
  <resultCode>Success</resultCode>
</LegacyApiResponse>