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 |
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
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
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
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:
becomes
What was the color of your first car?
becomes
V2hhdCB3YXMgdGhlIGNvbG9yIG9mIHlvdXIgZmlyc3QgY2FyPw
3DS Answer Formatting:
All uppercased, SHA256 hashed, URL Safe Base64 Answer:
becomes
Blue
becomes
MjRhODY2ZjQ5NDBmMWIwMDA4M2E3MWJhNGRmNzMyM2JhYzE0ODZmMjhkYzgxZDUwMGJiYzRiYjAyYzZlMGUxNg