Quick Start Guide

Sale Transaction (ACH) 2018-01-15T18:05:31+00:00

Sale Transaction (ACH)

Running an ACH sale transaction is almost identical to running a credit card sale transaction.   You will need to specify the transaction type and provide the ACH bank account and routing number. Below is an example of an ACH sale transaction request.

The fields below are a subset of the all fields that can be used with a sale transaction. Please review our full reference site for additional information about sale transactions.

Building Your Request

Parameter Description Values Example Value
Payment Details
accountType Specifies the payment method to be used with this transaction Values C
accountNumber If accountType (above) is set to R this field contains the credit card number
If accountType is set to C or S this field contains the checking or savings account number.
String 98765214
accountAccessory If accountType(above) is set to R this field contains the credit card expiration date. Month and year are represented by 4 digits. Example August 2017 = 0817.
If accountType is set to C or S this field contains the routing number.
String 123456789
https://secure.ziftpay.com/gates/xurl?&requestType=sale&userName=api-user-1234&password=mypass1234
&merchantAccountCode=21234&amount=500&accountType=C&accountNumber=  98765214
&accountAccessory=123456789&holderName=Lionel+Cosgrove&transactionIndustryType=RE
&street=123+My+Street&city=My+City&state=UT&zipCode=87653&transactionCode=000000001

Transaction Response

When you have submitted a transaction to the Zift Gateway you will get a response back indicating the status of the transaction.   Below is a list parameters sent back as part of the API response.

responseType=sale
approvalCode=018930
providerAvsResponseCode=Y
accountNumberMasked=9***********5214
avsResponseCode=4E
responseCode=A01
avsResultCode=4E
entryModeType=MX
cscResponseCode=
balance=
referenceNumber=9198951
cycleCode=2366331
entryMediumType=MC
holderVerificationModeType=
holderName=Lionel Cosgrove
amount=50
extendedAccountType=VD
warningCode=00
accountType=C
transactionCode=000000001
transactionDate=20160818
token=VD20000000000000053648
merchantAccountCode=21234
feeAmount=
providerReferenceNumber=26
originalAmount=50
accountAccessory=0817
providerCscResponseCode=
responseMessage=Approved+%28Success%29
currencyCode=USD
processorCode=018930
terminalMessage=
processorResponse=