Get Multiple Transactions – Certegy Developer

Get Consumer’s Transactions – Required Fields and Parameters

CashLine API has the ability to search for consumer’s transactions by one or a combination set of these fields (idCode, idValue and dob) or by (SSN and dob). Get requests are a URL generated request with the proper data elements included.

US Only – *Canadian Addresses not permitted

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

REQUIRED

Field Parameter	Value	Field Values or Constraints
merchantID	123456	6 / 6 All Numeric, 0-9 (no special characters or alpha allowed)
trxID	123456	4 / 20 Alphanumeric, a-z, A-Z, 0-9 - (dash)
integratorID	xYzAbC123	4 / 30 Alphanumeric, space and dash

OPTIONAL

Field Parameter	Value	Field Values or Constraints
operatorID	xxx123	2 / 30 Alphanumeric, Spaces and dash (a-z, A-Z, 0-9 $#@._ )
terminalID	Terminal321	2 / 30 Alphanumeric, Spaces and dash (a-z, A-Z, 0-9 $#@._ )
ssn	999999999	999999999
dob	yyyy-mm-dd	DATE (YYYY-MM-DD)
idCode	FL	2 characters alpha, A-Z US only
idValue	123458	Alphanumeric 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. 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.
attributes	all or all_plus_transactions	Only two possible attributes; 1. all or 2. all_plus_transactions

URL using idCode, idValue and DOB: Search by: idCode and idValue and dob

https://cce.cashline.certegy.com/v1/customer?{merchantID}{trxID}{integratorID}{idCode}{idValue}{dob}

URL when using SSN & DOB: Search by: ssn and dob

https://cce.cashline.certegy.com/v1/customer?{merchantID}{trxID}{integratorID}{ssn}{dob}

Get Consumer’s Transactions Response

Field Parameter	Value	Field Values or Constraints
consumerToken	99da5722-83f9-11ea-b9c5-f9a750265efe	36 / 36 Alphanumeric and dash
transactions		Object = May respond with multiple transaction history
trxDate	06-25-2020 03:18:19	4 / 20 Alphanumeric a-z, A-Z, 0-9 - (dash)
trxAmt	1.00	No Min/(Max) 9999999.99 Numeric and deximal - No commas
trxID	1234567890	4 / 20 Alphanumeric, a-z, A-Z, 0-9 - (dash)
trxRefID	5604490000014	Max 15 Numeric
checkStatus	APPROVE	Max 20 Alpha a-z, A-Z
merchantID	123456	6 / 6 All Numeric, 0-9 (no special characters or alpha allowed)
integratorID	xYzAbC123	4 / 30 Alphanumeric, space and dash
operatorID	xxx123	2 / 30 Alphanumeric, Spaces and dash (a-z, A-Z, 0-9 $#@._ )
terminalID	Terminal321	2 / 30 Alphanumeric, Spaces and dash (a-z, A-Z, 0-9 $#@._ )
terminalGrpID	grp321	2 / 30 Alphanumeric, a-z, A-Z, 0-9 $#@._ (-) Dash


{
	"consumerToken": "99da5722-83f9-11ea-b9c5-f9a750265efe",	
	"transactions": [{
			"trcDate": "06-30-2020 18:49:53",
			"trxAmt": "3002",
			"trxID": "81368985",
			"trxRefID": "5605730000009",
			"checkStatus": "APPROVE",
			"merchantID": "123456",
			"integratorID": "xYzAbC123",
			"operatorID": "xxx123",
			"terminalID": "terminal321",
			"terminalGrpID": "grp321"
		},
		{
			"trcDate": "06-22-2020 11:49:53",
			"trxAmt": "3002",
			"trxID": "81368985",
			"trxRefID": "5605730000009",
			"checkStatus": "APPROVE",
			"merchantID": "123456",
			"integratorID": "xYzAbC123",
			"operatorID": "xxx123",
			"terminalID": "terminal321",
			"terminalGrpID": "grp321"
		}
	],	
}

Get Consumer Response Decline/Error – HTTPS 400 and HTTPS 500

If the customer is not enrolled in CashLine you will receive a “Customer is not Enrolled” response.

Field Parameter	Value	Field Values or Constraints
errorPath	/customer	Max 200 Alpha only a-z, A-Z
errorMessage	Invalid or inactive setup	Max 200 Alpha only a-z, A-Z
errorDetails	The client's account information does not exist or has been deactivated in Certegy's system. Reattempt the transaction. If the issue persists, contact Certegy Client Relations at 833-293-3131	Max 260 Alpha only a-z, A-Z
errorType	system_error	Max 20 Alpha only a-z, A-Z
errorDate	06-25-2020 03:18:19	DATE/TIME
trxRefID	5604490000014	Max 15 Numeric
trxID	100235245	4 / 20 Alphanumeric, a-z, A-Z, 0-9 - (dash)
responseCode	0314	See 4 digit response codes page for gaming
adverseAction	false	(boolean) true/false (lowercase only)
stationNum	1070000000	10 Max Numeric only


{
	"errors": [{
		"errorPath": "/customer",
		"errorMessage": "Customer is not Enrolled",
		"errorDetails": "The client's account information does not exist or has been deactivated in Certegy's system. Reattempt the transaction. If the issue persists, contact Certegy Client Relations at xxx-xxx-xxxx",
		"errorType": "system_error",
		"errorDate": "06-25-2020 03:18:19",
		"trxRefID": "5604490000014",
		"trxID": "123456", 
		"responseCode": "0390",
		"adverseAction": "false",
		"stationNum": "1070000000"
 }]
}

Get Consumer Response Agreement Required, the consumer must accept the Terms and Conditions before continuing – HTTPS 400 and HTTPS 500

This is the response if the Terms and Conditions have not been accepted by the consumer

Field Parameter	Value	Field Values or Constraints
errorPath	/customer/customer	Max 200 Alpha only a-z, A-Z
errorMessage	Agreement Required	Max 200 Alpha only a-z, A-Z
errorDetails	Enrollment cannot proceed with our agreeing to the Terms and Conditions.	Max 260 Alpha only a-z, A-Z
errorType	decline	Max 20 Alpha only a-z, A-Z
errorDate	06-25-2020 03:18:19	DATE/TIME
trxRefID	5604490000014	Max 15 Numeric
trxID	100235245	4 / 20 Alphanumeric, a-z, A-Z, 0-9 - (dash)
responseCode	0389	See 4 digit response codes page for gaming
adverseAction	false	(boolean) true/false (lowercase only)
stationNum	1070000000	10 Max Numeric only


{
	"errors": [{
		"errorPath": "/customer",
		"errorMessage": "Agreement Required",
		"errorDetails": "Enrollment cannot proceed withour agreeing to the Terms and Conditions.",
		"errorType": "decline",
		"errorDate": "06-25-2020 03:18:19",
		"trxRefID": "5604490000014",
		"trxID": "123456", 
		"responseCode": "0390",
		"consumerToken": "e8f37d52-d296-11ea-adb9-1b536cf4193f",
		"adverseAction": "false",
		"stationNum": "1070000000"
 }]
}

CashLine