Documentation

CashLine

CashLine

  2. Home
  4. CashLine
  6. CashLine eCheck
  8. Enroll Into CashLine

Enroll Into CashLine

Enrollment Fields and Conditional Values

US Only – *Canadian Addresses not permitted

POST  https://cce.cashline.certegy.com/v1/customer
Field ParameterValueRequired or OptionalField Values or Constraints
trxID123456REQUIRED4 / 20 Alphanumeric, a-z, A-Z, 0-9 - (dash) (Must be Unique for 2 years)
membershipID 6$1#2@3.4_5-AA-bbOPTIONAL1 / 30 Alphanumeric and dash (a-z, A-Z, 0-9, - (dash) $#@._ )
operatorIDxxx123OPTIONAL2 / 30 Alphanumeric and dash (a-z, A-Z, 0-9, - (dash) $#@._ )
terminalIDTerminal321OPTIONAL2 / 30 Alphanumeric and dash (a-z, A-Z, 0-9, - (dash) $#@._ )
terminalGrpIDgrp321OPTIONAL2 / 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.
firstNamefirstnameREQUIREDFirst name.
Allowable characters:
a to z (lowercase alphabet)
A to Z (uppercase alphabet)
0 to 9 (numeric digits)
hyphen (-)
dot (.)
comma (,)
space character ( )
tab character
Minimum Characters: 2
Maximum Characters: 25
lastNamelastnameREQUIREDFirst name.
Allowable characters:
a to z (lowercase alphabet)
A to Z (uppercase alphabet)
0 to 9 (numeric digits)
hyphen (-)
dot (.)
comma (,)
space character ( )
tab character
Minimum Characters: 2
Maximum Characters: 25
dobyyyy-mm-ddREQUIREDDATE (YYYY-MM-DD)
ssn999999999OPTIONAL9 digits/Numeric only. No dashes or spaces.
phoneNumber2345678901REQUIRED10 digits/Numeric only. No dashes or spaces. Cannot begin with a 0 or a 1.
emailAddressiam@home.comOPTIONAL50 All Allowed. (All emails must be unique and cannot be shared with another consumer)
address112355 Rose BlvdREQUIREDStreet number and street name.
Allowable characters:
a to z (lowercase alphabet)
A to Z (uppercase alphabet)
0 to 9 (numeric digits)
single quotation mark ( ' )
ampersand ( & )
hyphen ( - )
dot ( . )
comma ( , )
hash symbol (#)
forward slash ( / )
parenthesis ( () )
space character ( )
tab character
Minimum Characters: 2
Maximum Characters: 50
address2suite 3OPTIONALAdditional addressing components.
Allowable characters:
a to z (lowercase alphabet)
A to Z (uppercase alphabet)
0 to 9 (numeric digits)
single quotation mark ( ' )
ampersand ( & )
hyphen ( - )
dot ( . )
comma ( , )
hash symbol (#)
forward slash ( / )
parenthesis ( () )
space character ( )
tab character
Minimum Characters: 2
Maximum Characters: 50
citySt PeteREQUIREDCity.
Allowable characters:
a to z (lowercase alphabet)
A to Z (uppercase alphabet)
0 to 9 (numeric digits)
single quotation mark ( ' )
hyphen ( - )
dot ( . )
comma ( , )
space character ( )
tab character
Minimum Characters: 2
Maximum Characters: 30
stateFLREQUIRED2 / 2 Alpha only
zip12345REQUIRED5 or 9 Numeric only
accountNicknameWells FargoREQUIRED1/30 Alphanumeric and spl chars except \ and "
micrDataREQUIRED 1 / 75 Alphanumeric and spaces only. lower Case letters See TOAD
idCodeFLREQUIRED2 / 2 See State Code List
idValue123458 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. 
{
  "trxID": "123456",
  "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": "2345678901",
  "emailAddress": "iam@home.com",
  "address": {
    "address1": "12355 Rose Blvd",
    "address2": "suite 3",
    "city": "St Pete",
    "state": "FL",
    "zip": "12345"
  },
  "account": {
    "accountNickname": "Wells Fargo",
    "micrData": "t123456789t o1234o 123"
  },
  "id": {
    "idCode": "FL",
    "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 ParameterValueField Values or Constraints
trxRefID56044900000144 / 36 Alphanumeric, a-z, A-Z, 0-9 - (dash)
trxID1234564 / 20 Alphanumeric, a-z, A-Z, 0-9 - (dash) (Must be Unique for 2 years)
consumerToken1b597b33-a0e7-11ea-9630-ef55d2cd0f41Max 60 Alphanumeric and dash
termsAcceptedIndY=yes1 Byte Y=Yes Consumer must accept the Terms and Conditions
activeIndY=Yes or N=No1 Byte Y=Yes or N=No
firstNamefirstnameFirst name.
Allowable characters:
a to z (lowercase alphabet)
A to Z (uppercase alphabet)
0 to 9 (numeric digits)
hyphen (-)
dot (.)
comma (,)
space character ( )
tab character
Minimum Characters: 2
Maximum Characters: 25
lastNamelastnameLast name.
Allowable characters:
a to z (lowercase alphabet)
A to Z (uppercase alphabet)
0 to 9 (numeric digits)
hyphen (-)
dot (.)
comma (,)
space character ( )
tab character
Minimum Characters: 2
Maximum Characters: 25
address112355 Rose BlvdStreet number and street name.
Allowable characters:
a to z (lowercase alphabet)
A to Z (uppercase alphabet)
0 to 9 (numeric digits)
single quotation mark ( ' )
ampersand ( & )
hyphen ( - )
dot ( . )
comma ( , )
hash symbol (#)
forward slash ( / )
parenthesis ( () )
space character ( )
tab character
Minimum Characters: 2
Maximum Characters: 50
address2suite 3Additional addressing components.
Allowable characters:
a to z (lowercase alphabet)
A to Z (uppercase alphabet)
0 to 9 (numeric digits)
single quotation mark ( ' )
ampersand ( & )
hyphen ( - )
dot ( . )
comma ( , )
hash symbol (#)
forward slash ( / )
parenthesis ( () )
space character ( )
tab character
Minimum Characters: 2
Maximum Characters: 50
citySt PeteCity.
Allowable characters:
a to z (lowercase alphabet)
A to Z (uppercase alphabet)
0 to 9 (numeric digits)
single quotation mark ( ' )
hyphen ( - )
dot ( . )
comma ( , )
space character ( )
tab character
Minimum Characters: 2
Maximum Characters: 30
stateFL2 / 2 Alpha only
zip123455 or 9 Numeric only
cashLineLimit150No Min/(Max) 9999999.99 Numeric only - No commas. If the decimal point is omitted, the amount is considered to be in whole dollars.
cashLineAvailable150No Min/(Max) 9999999.99 Numeric only - No commas. If the decimal point is omitted, the amount is considered to be in whole dollars.
idCodeFL2 / 2 See State Code List
idToken1b8211d5-a0e7-11ea-9630-73b018443428Max 60 Alphanumeric and dash
idPrimaryIndY1 byte
accountNicknameWells FargoMax 30 Alphanumeric and spl chars except \ and "
accountToken1b68bd74-a0e7-11ea-9630-9750481e0769Max 60 Alphanumeric and dash
accountLast412344 / 4 All numeric
accountLastUsedfalse(boolean) true/false (lowercase only)
SSNPresentfalse(boolean) true/false (lowercase only)
phoneMasked78904 digits Numeric only
emailAddressiam@home.com50 All Allowed. (All emails must be unique and cannot be shared with another consumer) 
{
  "trxRefID": "5604490000014",
  "trxID": "123456",
  "consumerToken": "1b597b33-a0e7-11ea-9630-ef55d2cd0f41",
  "termsAcceptedInd": "Y",
  "activeInd": "Y",
  "name": {
    "firstName": "Johnny",
    "lastName": "Rocket"
  },
  "address": {
    "address1": "12355 Rose Blvd",
    "address2": "suite 3",
    "city": "St Pete",
    "state": "FL",
    "zip": "12345"
  },
  "limit": {
    "cashLineLimit": "150",
    "cashLineAvailable": "150"
  },
  "ids": [
    {
      "idCode": "FL",
      "idToken": "1b8211d5-a0e7-11ea-9630-73b018443428",
      "idPrimaryInd": "Y"
    }
  ],
  "accounts": [
    {
      "accountNickname": "Wells Fargo",
      "accountToken": "1b68bd74-a0e7-11ea-9630-9750481e0769",
      "accountLast4": "1234",
      "accountLastUsed": "false"
    }
  ],
  "SSNPresent": "false",
  "phoneMasked": "7890",
  "emailAddress": "iam@home.com"
}

Response Decline/Error for Enrollment – HTTPS 500

Field ParameterValueField Values or Constraints
trxRefID56044900000144 / 36 Alphanumeric, a-z, A-Z, 0-9 - (dash)
trxID1234564 / 20 Alphanumeric, a-z, A-Z, 0-9 - (dash) (Must be Unique for 2 years)
errorPath /customerMax 200 Alpha only a-z, A-Z
errorMessage
Declined (Customer Already Enrolled)Max 200 Alpha only a-z, A-Z
errorDetails
Our records indicate this Driver's License or Social Security Number is already enrolled in CashLine or the account is inactive. Validate the consumer's information is correct and try again. Please call Customer Care at 833-293-3131.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": [{
		"trxRefID": "5604490000014",
		"trxID": "123456",
		"errorPath": "/customer",
		"errorMessage": "Declined (Customer Already Enrolled)",
		"errorDetails": "Our records indicate this Driver's License or Social Security Number is already enrolled in CashLine or the account is inactive. Validate the consumer's information is correct and try again. Please call Customer Care at 833-293-3131.",
		"errorType": "declined",
		"errorDate": "06-25-2020 03:18:19",
		"responseCode": "0399",
		"adverseAction": "false",
		"stationNum": "1065025600"
	}]
}

Response Decline/Error for Enrollment – HTTPS 400

Validation Error

Field ParameterValueField Values or Constraints
errorPath/customerMax 200 Alpha only a-z, A-Z
errorMessage
Declined (invalid phone number)Max 200 Alpha only a-z, A-Z
errorTypeedit_errorMax 200 Alpha only a-z, A-Z
errorDate11-05-2024 10:27:37DATE/TIME
adverseActionfalse(boolean) true/false (lowercase only) 
{
	"errors": [{
    "errorPath": "/customer",
    "errorMessages": [
        "[phoneNumber][1134324455][invalid phone number]"
    ],
    "errorType": "edit_error",
    "errorDate": "11-05-2024 10:27:37",
    "adverseAction": false
}]
}

Field Error

Field ParameterValueField Values or Constraints
trxRefID56044900000144 / 36 Alphanumeric, a-z, A-Z, 0-9 - (dash)
trxID1234564 / 20 Alphanumeric, a-z, A-Z, 0-9 - (dash) (Must be Unique for 2 years)
errorPath/customerMax 200 Alpha only a-z, A-Z
errorMessage
Errors in Inquiry Message to CertegyMax 200 Alpha only a-z, A-Z
errorDetails
Certain required information or data elements were missing from the request. Reattempt the transaction.Max 260 Alpha only a-z, A-Z
errorTypeEdit ErrorMax 200 Alpha only a-z, A-Z
errorDate11-05-2024 10:29:16DATE/TIME
responseCode0313Min/Max 4 bytes 0-9
adverseActionfalse(boolean) true/false (lowercase only)
stationNum1028618009Min/Max 10 bytes - 10 digits Numeric only 
{
	"errors": [{
     "trxRefID": "5604490000014",
     "trxID": "123456",
     "errorPath": "/customer",
     "errorMessage": "Errors in Inquiry Message to Certegy",
     "errorDetails": "Certain required information or data elements were missing from the request. Reattempt the transaction.",
     "errorType": "Edit Error",
     "errorDate": "11-05-2024 10:29:16",
     "responseCode": "0313",
      "adverseAction": false,
     "stationNum": "1028618009"
        }]

}

Back to Top

Was this article helpful to you? Yes 1 No 1

How can we help?