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 pl_PL pt_PT ENGLISH GERMAN SPANISH FRENCH ITALIAN NORWEGIAN SWEDISH POLISH PORTUGUESE |
Y | varchar |
| MOBILE | Country codes should follow the format of 001 or +1, no leading 0’s when using symbolic form. | N | alpha |
| 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?CUSR=MyUserAccount&CPWD=MyPassword&MSGID=c9f1ce03-0582-4aa8-827f-bf7730bac848&FUNC=THREEDS&P1=123456******1111&P2=E&P3=en_US&MOBILE=0037128111111
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
V2hhdCB3YXMgdGhlIGNvbG9yIG9mIHlvdXIgZmlyc3QgY2FyPw3DS Answer Formatting:
All uppercased, SHA256 hashed, URL Safe Base64 Answer:
becomes
Bluebecomes
MjRhODY2ZjQ5NDBmMWIwMDA4M2E3MWJhNGRmNzMyM2JhYzE0ODZmMjhkYzgxZDUwMGJiYzRiYjAyYzZlMGUxNg