Billhighway Cloud API

AchRefRequest

The following routes are available for this service:
POST	/payments/ach/ref	Create Ref for Ach Info	Creates a reference value for the ACH values passed in.
POST	/payments/ach/token	(Deprecated) Create Ref for Ach Info	(Deprecated) Creates a reference value for the ACH values passed in.

**AchRefRequest** Parameters:
Name	Parameter	Data Type	Required
ClientId	body	int	No
BankAccount	body	string	No
GroupId	body	string	Yes
RoutingNumber	body	string	Yes
AccountNumber	body	string	Yes

**AchRefRequestReply** Parameters:
Name	Parameter	Data Type	Required	Description
BankAccountToken	form	string	No	Same as AchReference, this field is deprecated
ErrorCode	form	int	No
ErrorMessage	form	string	No
IsError	form	bool	No
AchReference	form	string	No

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

<AchRefRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/BH.CloudAPI.Common4.DTO.SalesForce">
  <AccountNumber>String</AccountNumber>
  <BankAccount>String</BankAccount>
  <ClientId>0</ClientId>
  <GroupId>String</GroupId>
  <RoutingNumber>String</RoutingNumber>
</AchRefRequest>

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

<AchRefRequestReply xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/BH.CloudAPI.Common4.DTO.SalesForce">
  <AchReference>String</AchReference>
  <BankAccountToken>String</BankAccountToken>
  <ErrorCode>0</ErrorCode>
  <ErrorMessage>String</ErrorMessage>
  <IsError>false</IsError>
</AchRefRequestReply>