Documentation

CashLine

  1. Home
  2. CashLine
  3. Private: Kiosk eCheck
  4. 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 ParameterValueRequired or OptionalField Values or Constraints
trxID  123456REQUIRED4 / 20 Alphanumeric, a-z, A-Z, 0-9 - (dash) (Must be Unique for 2 years)
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-01b0eb9039beREQUIREDMax 60 Alphanumeric and dash
accountToken
e4321e6d-333e-11ea-a53a-15092651fc59REQUIREDMax 60 Alphanumeric and dash
kioskTransactionIndicatorYOPTIONAL1 Alpha - ( This is optional)
If Y= Kiosk
If N or Blank = Cage
settlementPeriod0REQUIRED0-4 numeric only
0 = Cashline Immediate Settlement
1 = 7 Day Delayed Settlement
2 = 14 Day Delayed Settlement
3 = 21 Day Delayed Settlment
4 = 28 Day Delay Settlement
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.00OPTIONAL0 - 10.00 Numeric only
feeDiscount  1.00OPTIONAL0 - 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",
	"settlementPeriod": 0,
	"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 ParameterValueField Values or Constraints
trxID 1234564 / 20 Alphanumeric, a-z, A-Z, 0-9 - (dash) (Must be Unique for 2 years)
trxRefID56044900000144 / 36 Alphanumeric, a-z, A-Z, 0-9 - (dash)
approvalNum  1788640/8 Numeric only
aba 0632101259 Numeric only
accountLast4  20584 Numeric only
checkType  P1 Alpha P=Personal
returnCheckFee 30.00Decimal (5,2)
netAmount  90.00No Min/(Max) 9999999.99 Numeric only - No commas. If the decimal point is omitted, the amount is considered to be in whole dollars.
settlementDateNext Dayalpha-numeric Next Day / 2024-04-08
cashLineLimit  350.00No Min/(Max) 9999999.99 Numeric only - No commas. If the decimal point is omitted, the amount is considered to be in whole dollars.
cashLineAvailable  330.00Decimal (5,2)
refillDate  2022-08-29 05:13:34Timestamp
refillAmount  100.00No Min/(Max) 9999999.99 Numeric only - No commas. If the decimal point is omitted, the amount is considered to be in whole dollars.
limitResetTimeframe  6Numeric

{
	"trxID": "1234561096",
	"trxRefID": "5604490000014",
	"approvalNum": "178864",
	"aba": "063210125",
	"accountLast4": "3456",
	"checkType": "P",
	"returnCheckFee": "30.00",
	"netAmount": "90.00",
	"settlementDate": "Next Day",
	"cashLineLimit":"350.00",
	"cashLineAvailable":"330.00",
	"refillDate":"2022-08-29 05:13:34",
	"refillAmount":"10",
	"limitResetTimeframe":"6"
}

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

Field ParameterValueField Values or Constraints
errorPath /kiosk/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 limitMax 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": "/kiosk/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

Was this article helpful to you? Yes No

How can we help?