Documentation

CashLine

  1. Home
  2. Docs
  3. CashLine
  4. Kiosk eCheck
  5. Kiosk Authorization request for ACH

Kiosk Authorization request for ACH

The accountToken, idToken and consumerToken are provided in the successful response to the Get Customer Request, or in the response from a successful Enrollment Request. With the approved transaction HTTPS 200, Approval Receipt The consumer approval receipt should print or would be clearly displayed on the pin pad with Return Check fee, and would be signed by the consumer requesting the ACH debit.

eCheck Request

POST  https://cce.cashline.certegy.com/v1/kiosk/check/echeck

*requestAmount is equal to the (requestAmount + feeAmount – feeDiscount) that the casino would be providing to the player.

Field ParameterRequired or OptionalField Values or Constraints
merchantID 128756REQUIRED6 / 6 Numeric only, 0-9
trxID   1234567890REQUIRED4 / 20 Alphanumeric, a-z, A-Z, 0-9 - (dash)
integratorID   xYzAbC123REQUIRED4 / 30 Alphanumeric space and dash
operatorID  xxx123Optional2 / 30 Alphanumeric, a-z, A-Z, 0-9 $#@._ (-) Dash
terminalID  Terminal321Optional2 / 30 Alphanumeric, a-z, A-Z, 0-9 $#@._ (-) Dash
terminalGrpID  grp321Optional2 / 30 Alphanumeric, a-z, A-Z, 0-9 $#@._ (-) Dash
consumerToken
5399a4aa-8303-11ea-bf23-01b0eb9039be
REQUIREDMax 60 Alphanumeric and dash
accountToken
e4321e6d-333e-11ea-a53a-15092651fc59
REQUIREDMax 60 Alphanumeric and dash
idToken
e445cd7e-333e-11ea-a53a-77513333192d
REQUIREDMax 60 Alphanumeric and dash
requestAmount 1.00REQUIREDNo Min/(Max) 9999999.99 Numeric only - No commas. If the decimal point is omitted, the amount is considered to be in whole dollars.
*requestAmount is equal to the (requestAmount + feeAmount - feeDiscount). If the decimal point is omitted, the amount is considered to be in whole dollars.
feeAmount  2.00REQUIRED0 - 10.00 Numeric only
feeDiscount  1.00REQUIRED0 - 10.00 Numeric only

POST https://cce.cashline.certegy.com/v1/kiosk/check/echeck

{ 
"merchantID":"128756",
"trxID":"1234567890", 
"integratorID":"xYzAbC123", 
"operatorID":"xxx123", 
"terminalID":"Terminal321", 
"terminalGrpID":"grp321", 
"consumerToken":"5399a4aa-8303-11ea-bf23-01b0eb9039be", 
"accountToken":"e4321e6d-333e-11ea-a53a-15092651fc59", 
"idToken":"e445cd7e-333e-11ea-a53a-77513333192d", 
"requestAmount":"1.00", 
"feeAmount":"2.00", 
"feeDiscount":"1.00" 
}

Approval Response for eCheck

 The approval response is followed up with the Acknowledgement request. After the signature capture or signature receipt indicating approval for the debit and service charge fee if NSF, for the for eCheck.

*requestAmount is equal to the (requestAmount + feeAmount – feeDiscount)

Field ParameterRequired or OptionalField Values or Constraints
trxID  1234561096REQUIRED4 / 20 Alphanumeric, a-z, A-Z, 0-9 - (dash)
trxRefID  5604490000014REQUIREDMax 15 Numeric
achRefID  371867197REQUIREDMax 15 Numeric
approvalNum  178864REQUIRED0/8 Numeric only
aba  063210125REQUIRED9 Numeric only
accountLast4  3456REQUIRED4 Numeric only
checkType  PREQUIRED1 Alpha P=Personal
returnCheckFee 30.00REQUIREDDecimal (5,2)
netAmount  90.00REQUIREDNo Min/(Max) 9999999.99 Numeric only - No commas. If the decimal point is omitted, the amount is considered to be in whole dollars.
{ 
"trxID":"1234561096", 
"trxRefID":"5604490000014", 
"achRefID":"371867197", 
"approvalNum":"178864", 
"aba":"063210125", 
"accountLast4":"3456", 
"checkType":"P", 
"returnCheckFee":"30.00", 
"netAmount":"90.00"
} 

Decline or Error Response for eCheck – HTTP 400 and HTTP 500

Field ParameterField Values or Constraints
errors {object
errorPath /check/echeckMax 200 Alpha only a-z, A-Z
errorMessage Declined (Over CashLine Limit)Max 200 Alpha only a-z, A-Z
errorDetails
Certegy could not approve the transaction. The dollar amount the consumer requested exceeds what is available in their CashLine limit
Max 260 Alpha only a-z, A-Z
errorType declinedMax 20 Alpha only a-z, A-Z
errorDate   06-25-2020 03:18:19DATE/TIME
trxID 90001114 / 20 Alphanumeric a-z, A-Z, 0-9 - (dash)
trxRefID 5804490000095Max 15 Numeric only
responseCode 0326Min/Max 4 bytes 0-9
adverseAction false(boolean) true/false (lowercase only)
stationNum 106502560010 / 10 Numeric only
customerCare 833-293-313112 / 12 Numeric and Dash
{ 
"errors":[  
 {    
   "errorPath":"/check/echeck",    
   "errorMessage":"Declined (Over CashLine Limit",    
   "errorDetails":"Certegy could not approve the transaction. The dollar amount the consumer requested exceeds what is available in their CashLine limit",    
   "errorType":"declined",    
   "errorDate":"06-25-2020 03:18:19",    
   "trxID":"9000111",    
   "trxRefID":"5804490000095",    
   "responseCode":"0326",    
   "adverseAction":"false",    
   "stationNum":"1065025600",    
   "customerCare":"833-293-3131"   
  }  
 ]
}

Back to Top

How can we help?