Disassociated Persons (DAP) – Certegy Developer

Add or Delete information in the self reporting DisAssociated Persons Table

The Disassociated Persons list is for problem gamblers. This provides gamblers with a method to acknowledge that they have a problem with gambling and enable them to take personal responsibility by adding their name via this call out. This would inhibit the individual to ACH funds from their bank account via CashLine’s eCheck product. They can add or delete their personal information into the CashLine’s DAP gaming product. This call out can be added by the “block level” where at this time the levels are casino and property level. The consumer can be added and can use either their Identification.

Field Parameter	Value	Required or Optional	Field Values or Constraints
merchantID	123456	REQUIRED	6 / 6 All Numeric, 0-9
trxID	AA-bb-1234567890	REQUIRED	4 / 20 Alphanumeric, Spaces and dash (a-z A-Z 0-9)
integratorID	xYzAbC123	REQUIRED	4 / 30 Alphanumeric, space and dash
operatorID	xxx123	OPTIONAL	2 / 30 Alphanumeric, Spaces and dash (a-z A-Z 0-9 $#@._ )
terminalID	Terminal321	OPTIONAL	2 / 30 Alphanumeric, Spaces and dash (a-z A-Z 0-9 $#@._ )
terminalGrpID	grp321	OPTIONAL	2 / 30 Alphanumeric, Spaces and dash (a-z A-Z 0-9 $#@._ )
dob	yyyy-mm-dd	REQUIRED	DATE (YYYY-MM-DD)
ssn	999999999	OPTIONAL	999999999
blockLevel	Casino or Property	OPTIONAL	two options Casino or Property
firstName	firstname	REQUIRED	2 / 25 - 25 digits - Alphanumeric characters, "-", ".", ",", and spaces
lastName	lastname	REQUIRED	2 / 25 - 25 digits - Alphanumeric characters, "-", ".", ",", and spaces
idCode	FL	REQUIRED	2 / 2 See State Code List
idValue	123458	REQUIRED	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 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.

{
	"merchantID": "123456",
	"trxID": "1234567890",
	"integratorID": "xYzAbC123",
	"operatorID": "xxx123",
	"terminalID": "Terminal321",
	"terminalGrpID": "grp321",
	"dob": "yyyy-mm-dd",
	"ssn": "999999999",
	"blockLevel": "Casino or Property",
	"firstName": "Johnny",
	"lastName": "Rocket",
	"idCode": "GA",
	"idValue": "123458"
}

Successful Add to DAP

Field Parameter	Value	Field Values or Constraints
operatorID	12345678	2 / 30 Alphanumeric, Spaces and dash (a-z A-Z 0-9 $#@._ )
firstName	firstname	2 / 25- 25 digits - Alphanumeric characters, "-", ".", ",", and spaces only
lastName	lastname	2 / 25- 25 digits - Alphanumeric characters, "-", ".", ",", and spaces only
ssnLastFour	9999	4 digits if supplied returned
idCode	FL	2 / 2 See &nbsp: State Code List
idValueLastFour	3458	4 digits returned

{
	"operatorID": "xxx123",
	"firstName": "Johnny",
	"lastName": "Rocket",
	"ssn": "9999",
	"id": {
		"idState": "GA",
		"idValueLastFour": "3458"
	}
}

Unsuccessful add to DAP

Field Parameter	Value	Field Values or Constraints
errorPath	/dap	Max 200 Alpha only a-z, A-Z
errorMessage	The ID already exists on DAP	Max 200 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
adverseAction	False	(boolean) true/false (lowercase only)

{
	"errors": [{
		"errorPath": "/dap",
		"errorMessage": "The ID already exists on DAP",
		"errorType": "system_error",
		"errorDate": "06-25-2020 03:18:19",
		"adverseAction": "false"
	}]
}

Delete Consumer’s information for the DAP file

Field Parameter	Value	Required or Optional	Field Values or Constraints
merchantID	123456	REQUIRED	6 / 6 All Numeric, 0-9 (no special characters or alpha allowed)
integratorID	xYzAbC123	REQUIRED	4 / 30 Alphanumeric, space and dash
operatorID	xxx123	OPTIONAL	2 / 30 Alphanumeric, Spaces and dash (a-z A-Z 0-9 $#@._ )
terminalID	Terminal321	OPTIONAL	2 / 30 Alphanumeric, Spaces and dash (a-z A-Z 0-9 $#@._ )
dob	yyyy-mm-dd	REQUIRED	YYYY-MM-DD
ssn	999999999	OPTIONAL	999999999
firstName	firstname	REQUIRED	2 / 25 - 25 digits - Alphanumeric, "-", ".", ",", and spaces only
lastName	lastname	REQUIRED	2 / 25 - 25 digits - Alphanumeric, "-", ".", ",", and spaces only
idCode	FL	REQUIRED	2 / 2 See State Code List
idValue	123458	REQUIRED	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 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.

https://cce.cashline.certegy.com/v1/dap?merchantID=123456&integratorID=xYzAbC123&idCode=GA&idValue=7760123&dob=1962-11-10&lastName=Mannino&firstName=Andrew

Successful ID removal from DAP

If you get this, you can assume that you were added to DAP. Since there is really nothing here indicating a successful add.

Field Parameter	Value	Field Values or Constraints
idCode	FL	2 / 2 State Code
idValueLastFour	3458	4 digit returned

{
	"id": {
		"idState": "GA",
		"idValueLastFour": "3458"
	}
}

Unsuccessful Add to DAP

Field Parameter	Value	Field Values or Constraints
errorPath	/dap	Max 200 Alpha only a-z, A-Z
errorDetails	Errors in request Message to Certegy	Max 260 Alpha only a-z, A-Z
errorMessage	Invalid or Inactive Setup Client Account	Max 200 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
adverseAction	False	(boolean) true/false (lowercase only)


{
	"errors": [{
		"errorPath": "/dap",
		"errorMessage": "Invalid or Inactive Setup Client Account",
		"errorType": "system_error",
		"errorDate": "06-15-2020 03:18:19",
		"adverseAction": "false"
	}]
}