Documentation

CashLine

  1. Home
  2. Docs
  3. CashLine
  4. CashLine eCheck
  5. Enroll Into CashLine

Enroll Into CashLine

Enrollment cannot proceed without the consumer agreeing to the Terms and Conditions

Enrollment Fields and Conditional Values

POST  https://cce.cashline.certegy.com/v1/customer/

Field ParameterRequired or OptionalField Values or Constraints
merchantID  123456REQUIRED6 / 6 All Numeric, 0-9 (no special characters or alpha allowed)
trxID  AA-bb-1234567890REQUIREDThis is generated by the requestor and not repeatable for other post request. Minimum 4 and a maximum 20 characters - Alphanumeric and dash (a-z, A-Z, 0-9 - (dash))
integratorID  xYzAbC123REQUIRED4 / 30 Alphanumeric, space and dash
membershipID   6$1#2@3.4_5-AA-bbOPTIONAL1 / 30 Alphanumeric and dash (a-z, A-Z, 0-9, - (dash) $#@._ )
operatorID  xxx123OPTIONAL2 / 30 Alphanumeric and dash (a-z, A-Z, 0-9, - (dash) $#@._ )
terminalID  Terminal321OPTIONAL2 / 30 Alphanumeric and dash (a-z, A-Z, 0-9, - (dash) $#@._ )
terminalGrpID  grp321OPTIONAL2 / 30 Alphanumeric and dash (a-z, A-Z, 0-9, - (dash) $#@._ )
termsAcceptedInd  Y=yesREQUIRED1 byte Terms and Condition must provided to the consumer if the consumer does not agree or is not provided the Terms and Conditions Enrollment can not proceed.
name   {REQUIREDObject
firstName  firstnameREQUIRED2 / 25- 25 digits - Alphanumeric characters, "-", ".", ",", and spaces only
lastName  lastname  }REQUIRED2 / 25- 25 digits - Alphanumeric characters, "-", ".", ",", and spaces only
dob  yyyy-mm-ddREQUIREDDATE (YYYY-MM-DD)
ssn  999999999OPTIONAL999999999
phoneNumber  7275551212REQUIRED10 digits/Numeric only. No dashes or spaces.
emailAddress  iam@home.comOPTIONAL50 characters All Allowed
address {REQUIREDObject - US Only - *Canadian Addresses not permitted
address1 7512 Parkway RoadREQUIRED2 / 25 Alphanumeric characters, "-", ".", ",", "&"," " ' ", and spaces only
address2 suite 7512OPTIONAL2 / 14 Alphanumeric characters, "-", ".", ",", "&"," " ' ", and spaces only
city  New York CityREQUIRED30 Max 30 char's: Alphanumeric characters, "-", ".", ",", "&"," " ' ", and spaces only
state  FLREQUIRED2 characters alpha, A-Z US only allowed
zip   12345  }REQUIRED5 or 9 Numeric characters only
account {REQUIREDObject
accountNickname Wells Fargo Gaming 2212REQUIREDMax 30 Alpha only a-z, A-Z
micrData TOADREQUIREDTOAD 1 / 75 Alphanumeric and spaces only. lower Case letters
id   {REQUIREDObject
idCode  FLREQUIRED2 / 2 See State Code List
idValue  123458  }REQUIREDAlphanumeric and Asterisks (*) Only. Dashes or spaces, if entered, will be stripped out. Max Length - 24 Alphabetic characters. This variable-size field contains the Driver's License number for manual entry methods. Asterisks are acceptable characters. However, other special characters such as dashes and spaces appearing on the face of the license should not be manually entered or transmitted.

POST https://cce.cashline.certegy.com/v1/customer

{ 
 "merchantID":"123456",
 "trxID":"1234567890",
 "integratorID":"xYzAbC123",
 "membershipID":"61#2@34_5-AA-bb",
 "operatorID":"xxx123",
 "terminalID":"Terminal321",
 "terminalGrpID":"grp321",
 "termsAcceptedInd":"Y",
 "name": {
   "firstName":"Johnny",
   "lastName":"Rocket"
   },
 "dob":"yyyy-mm-dd",
 "ssn":"999999999",
 "phoneNumber":"1234567890",
 "emailAddress":"robert1@home.com",
 "address": { 
   "address1":"7512 Parkway Road", 
   "address2":"suite 7512 xxxxx",
   "city":"Marietta",
   "state":"GA",
   "zip":"30006"
   }, 
 "account": { 
   "accountNickname":"WellsFargo1",
   "micrData":"t123456789t o1234o 123"
   }, 
 "id": { 
   "idCode":"GA",
   "idValue":"123458"
   }
}

Successful Enrollment

The successful enrollment response provides the consumerToken, idToken and accountToken; these three values are required to be able to make an ACH (debit) authorization request to the consumer’s’ checking account that is enrolled in CashLine.

Field ParameterField Values or Constraints
trxRefID 56054800000024 / 20 Alphanumeric, a-z, A-Z, 0-9 - (dash)
consumerToken
1b597b33-a0e7-11ea-9630-ef55d2cd0f41
Max 60 Alphanumeric and dash
termsAcceptedInd Y=yes1 Byte Y=Yes Consumer must accept the Terms and Conditions
activeInd Y=Yes or N=No1 Byte Y=Yes or N=No
name {object
firstName Grace2 / 25 - Alphanumeric characters, "-", ".", ",", and spaces only
lastName Gonner  }2 / 25 - Alphanumeric characters, "-", ".", ",", and spaces only
address {object
address1 2093 Ridgecrest Drive2 / 25 Alphanumeric characters, "-", ".", ",", "&"," " ' ", and spaces only
address2 suite 32 / 25 Alphanumeric characters, "-", ".", ",", "&"," " ' ", and spaces only
city Dunedin2 / 14 Alphanumeric characters, "-", ".", ",", "&"," " ' ", and spaces only
state FL2 characters alpha, A-Z US only
zip 34698  }5 or 9 Numeric only
limit {object
cashLineLimit 150No Min/(Max) 9999999.99 Numeric only - No commas. If the decimal point is omitted, the amount is considered to be in whole dollars.
cashLineAvailable 150  }No Min/(Max) 9999999.99 Numeric only - No commas. If the decimal point is omitted, the amount is considered to be in whole dollars.
ids [object
idCode GA2 characters alpha, A-Z US only
idToken
1b8211d5-a0e7-11ea-9630-73b018443428
Max 60 Alphanumeric and dash
idPrimaryInd Y  }1 byte
accounts {object
accountNickname Wells Fargo Gaming 2212Max 30 Alpha only a-z, A-Z
accountToken
1b68bd74-a0e7-11ea-9630-9750481e0769
Max 60 Alphanumeric and dash
accountLast4 22124 / 4 All numeric
accountLastUsed false  }Y is the only response possible or enrollment would not be allowed
termsAcceptedInd YY=yes/td>
SSNPresent false(boolean) true/false (lowercase only)
phoneMasked 44224 digits Numeric only
emailAddress GG72@certegy.com50 All Characters Allowed
{ 
"trxRefID":"5605480000002",
"consumerToken":"1b597b33-a0e7-11ea-9630-ef55d2cd0f41",
"termsAcceptedInd":"Y",
"activeInd":"Y",
"name": {
  "firstName":"Grace",
  "lastName":"Gonner"
},
"address": {
  "address1":"2093 Ridgecrest Drive",
  "address2":"suite 3",
  "city":"Dunedin",
  "state":"FL",
  "zip":"34698"
},
"limit": {
  "cashLineLimit":"150",
  "cashLineAvailable":"150"
},
"ids":[
  {
  "idCode":"GA",
  "idToken":"1b8211d5-a0e7-11ea-9630-73b018443428",
  "idPrimaryInd":"Y"
  }
],
"accounts": [
  {
  "accountNickname":" Wells Fargo Gaming 2212",
  "accountToken":" 1b68bd74-a0e7-11ea-9630-9750481e0769",
  "accountLast4":" 1234", 
  "accountLastUsed":"false" 
  } 
],
"termsAcceptedInd":"Y", 
"SSNPresent":"false", 
"phoneMasked":"4422", 
"emailAddress":"GG72@certegy.com" 
} 

Response Decline/Error for Enrollment – HTTPS 400 and HTTPS 500

Field ParameterField Values or Constraints
errors [object
errorPath /customer/customerMax 200 Alpha only a-z, A-Z
trxRefID 56054800000024 / 20 Alphanumeric, a-z, A-Z, 0-9 - (dash)
errorMessage
Declined (Customer Already Enrolled)
Max 200 Alpha only a-z, A-Z
errorDetails
Certegy could not approve the enrollment. The consumer is already enrolled in the program.
Max 260 Alpha only a-z, A-Z
errorType declinedMax 200 Alpha only a-z, A-Z
errorDate   06-25-2020 03:18:19DATE/TIME
responseCode 0399Min/Max 4 bytes 0-9
adverseAction false(boolean) true/false (lowercase only)
stationNum 1065025600Min/Max 10 bytes - 10 digits Numeric only
{ 
"errors": [
 {
   "errorPath":"/customer/customer", 
   "trxRefID":"5605480000002",
   "errorMessage":"Declined (Customer Already Enrolled)", 
   "errorDetails":"Certegy could not approve the enrollment. The consumer is already enrolled in the program.", 
   "errorType":"declined", 
   "errorDate":"06-25-2020 03:18:19", 
   "responseCode":"0399", 
   "adverseAction":"false", 
   "stationNum":"1065025600" 
  }
 ]
}

Back to Top

How can we help?