3.27 3DS Enrollment Control – Function THREEDS

3DS Enrollment Control – Function THREEDS

Function THREEDS is used to control the enrollment of a cardholder for 3DS enabled programs. This function allows for a card to be enrolled and unenrolled with our 3DS provider.

The language list (separated by commas) supports either the entire language name such as ENGLISH, FRENCH, SPANISH and GERMAN; or the first letter such as E, F, S and G.

Inputs	Description	Required	Data Type
FunctionID	THREEDS	Y
P1	PAN or ALT ID	Y	(16,19) numeric
P2	Action. E to Enroll a card. U to Unenroll a card.	Y	(1) alpha – E or U
Language	Acceptable inputs: en_US de_DE es_ES fr_FR it_IT nb_NO sv_SE ENGLISH GERMAN SPANISH FRENCH ITALIAN NORWEGIAN SWEDISH	Y	varchar
MOBILE	Country codes should follow the format of 001 or +1, no leading 0’s when using symbolic form.	N	alpha
EMAIL		N
SQ SA	3DS Security question: SQ – Security Question SA – Security Answer `*Please see 3DS note on formatting below`	N	varchar
Outputs	Description
P1	Error Code	Y
P2	Error Text	Y

Example: 3DS Enroll/Unenroll Card Request

https://api.m2fin.com:8443/AuthENGINAPI/AuthENGINAPI?CID=5&CUSR=myuseraccount&CPWD=passwor
dassignedtome&FUNC=THREEDS&MSGID=00001704406600030&P1=PAN or ALT
ID&P2=E&P3=ENGLISH,GERMAN

https://api.m2fin.com:8443/AuthENGINAPI/AuthENGINAPI?CID=5&CUSR=myuseraccount&CPWD=passwor
dassignedtome&FUNC=THREEDS&MSGID=00001704406600030&P1=PAN or ALT ID&P2=U&P3=E,F

Example: 3DS Enrollment Tries Response

P1=0000&P2=Card Enrolled
P1=0000&P2=Card Un-Enrolled
P1=0000&P2=Card Already Enrolled
P1=0000&P2=Card Not Enrolled

3DS Question Formatting:

URL Safe Base64 Encoded Question:
What was the color of your first car?
becomes
V2hhdCB3YXMgdGhlIGNvbG9yIG9mIHlvdXIgZmlyc3QgY2FyPw

3DS Answer Formatting:

All uppercased, SHA256 hashed, URL Safe Base64 Answer:
Blue
becomes
MjRhODY2ZjQ5NDBmMWIwMDA4M2E3MWJhNGRmNzMyM2JhYzE0ODZmMjhkYzgxZDUwMGJiYzRiYjAyYzZlMGUxNg

London

Prague

Ireland