3DS - Init Authentication

POST

/dpm/security-gwproxy/v2/enrolments-initial

Initiate 3DS Authentication

3D Secure (3DS) is an authentication protocol designed to enhance the security of online transactions by verifying the identity of cardholders before a payment is processed. This endpoint initiates the enrolment flow for 3DS authentication, beginning the authentication process for a payment transaction.

Usage Scenarios:

Adding an extra layer of security to card payments and reducing fraud risk.

Complying with Strong Customer Authentication (SCA) requirements for transactions in the European Economic Area (EEA).

Notes:

The authentication flow is dynamically determined by factors such as card brand, issuing bank, and risk assessment.

Your integration must handle all possible authentication scenarios returned by the API.

For detailed information about 3DS authentication, including how it works, available scenarios, and implementation guidance, see the 3DS Authentication documentation.

请求参数

Body 参数application/json必填

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/dpm/security-gwproxy/v2/enrolments-initial' \
--header 'Content-Type: application/json' \
--data '{
    "currency": "string",
    "md": "NmQyZTQzODAtZDhhMy00Y2NiLTkxMzgtYzI4OTE4MjgxOGE0",
    "term_url": "string",
    "amount": 0,
    "payment_method": {
        "number_token": "string",
        "security_code": "string",
        "expiration_month": "string",
        "expiration_year": "string"
    },
    "description": "string",
    "operation": "string",
    "extra_fields": {
        "billing_address": {
            "street": "Av. Brasil",
            "number": "1000",
            "complement": "Sala 1",
            "district": "São Geraldo",
            "city": "Porto Alegre",
            "state": "RS",
            "country": "BR",
            "postal_code": "90230060",
            "reference": "Near the hospital"
        },
        "shipping_address": {
            "street": "Av. Brasil",
            "number": "1000",
            "complement": "Sala 1",
            "district": "São Geraldo",
            "city": "Porto Alegre",
            "state": "RS",
            "country": "BR",
            "postal_code": "90230060",
            "reference": "Near the hospital"
        }
    }
}'

返回响应

🟢200

application/json

Bodyapplication/json

示例

{
    "transaction_id": "string",
    "md": "NmQyZTQzODAtZDhhMy00Y2NiLTkxMzgtYzI4OTE4MjgxOGE0",
    "tx_id": 0,
    "xid": "VDdnR0kyU1g4ZXlxMkhWTlp0VnA=",
    "protocol": "3DS2.2.0",
    "status": "Authenticated",
    "operation": "CREDIT",
    "tds_method_content": "<html></html>",
    "redirect_html_template": "<html class=\"no-js\" lang=\"en\" xmlns=\"http://www.w3.org/1999/xhtml\">\n<head>\n<META http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">\n<meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">\n<meta charset=\"utf-8\">\n<title>3D Secure Processing</title>\n<link href=\"https://3ds2-mpi.test.modirum.com/mdpaympi/static/mpi.css\" rel=\"stylesheet\" type=\"text/css\">\n</head>\n<body>\n<div id=\"main\">\n<div id=\"content\">\n<div id=\"order\">\n<h2>3D Secure Processing</h2>\n<script src=\"https://3ds2-mpi.test.modirum.com/mdpaympi/static/red.js\" defer>/* needed for xsl to xhtml */</script>\n<div id=\"spinner\">\n<img src=\"https://3ds2-mpi.test.modirum.com/mdpaympi/static/preloader.gif\" alt=\"Please wait..\"></div>\n<img src=\"https://3ds2-mpi.test.modirum.com/mdpaympi/static/mc_idcheck_hrz_ltd_pos_103px.png\" alt=\"MasterCard ID Check\"><div id=\"formdiv\">\n<div>\n<form id=\"webform0\" name=\"red2ACSv1\" method=\"POST\" action=\"https://3ds-acs.test.modirum.com/mdpayacs/pareq\" accept_charset=\"UTF-8\">\n<input type=\"hidden\" name=\"PaReq\" value=\"eJxVUctuwjAQ/JWIe7GdBwK0WKJNpXIAUUop6s1ytiQiccB2Kvj72iEprU8zsw/vzsI214jpG8pGI4clGiMOGBTZbLDevE6ieMISNuCwnm/wzOEbtSlqxdmQDkMgPXV1WuZCWQ5Cnh8XKx63D0hHoUK9SDmjlAK5YVCiQp4+78IocmLLQNaNsvrK47Gr7Qk0uuS5tSczZaSspSjz2tiHL3HEoawrID4O5D7DuvHIuH6XIuO7NFMbery+s0P8uS8vy2P+sS1PdKfmMyA+AzJhkYc0ZCyk44DF0zCZshGQVgdR+UH4cr8K3N5u1k6Ak/9nfiPMB/4K4BzVqGS/TM8AL6daoctwBv5iyNBIHqVvAdsHWy2UEdI6a90MPgDkvtPTi3dZWu/nKB4lk2TMvNGt4rsXzrMwYbRt7wkQX0O6G5LuyA79O/4Pb++sPw==\"><input type=\"hidden\" name=\"MD\" value=\"eyJzZWxsZXJfaWQiOiIwNmYyNTZjOC0xYmJmLTQyYmYtOTNiNC1jZTIwNDFiZmI4N2EiLCJ0cmFuc2FjdGlvbl9pZCI6ImRjYjU4NzJlLWYxYjYtNDkyMi1hMGFlLWZiMGYyODg2MTM5YiIsImNvdW50cnkiOiJNWCIsInRlbmFudCI6InNhbnRhbmRlciJ9\"><input type=\"hidden\" name=\"TermUrl\" value=\"http://localhost:4000/api/modirum/token\"><input type=\"submit\" name=\"submitBtn\" value=\"Please click here to continue\">\n</form>\n</div>\n</div>\n<noscript>\n<div align=\"center\">\n<b>Javascript is turned off or not supported!</b>\n<br>\n</div>\n</noscript>\n</div>\n<div id=\"content-footer\"></div>\n</div>\n</div>\n</body>\n</html>\n",
    "acs_redirect_form": {
        "action_url": "https://test.getnet.com",
        "method": "POST",
        "creq": "ewogICAgImF",
        "threeDSSessionData": "NmQyZTQzODA"
    },
    "extra_fields": {
        "billing_address": {
            "street": "Av. Brasil",
            "number": "1000",
            "complement": "Sala 1",
            "district": "São Geraldo",
            "city": "Porto Alegre",
            "state": "RS",
            "country": "BR",
            "postal_code": "90230060",
            "reference": "Near the hospital"
        },
        "shipping_address": {
            "street": "Av. Brasil",
            "number": "1000",
            "complement": "Sala 1",
            "district": "São Geraldo",
            "city": "Porto Alegre",
            "state": "RS",
            "country": "BR",
            "postal_code": "90230060",
            "reference": "Near the hospital"
        }
    }
}

🟠400

🔴500

修改于 2026-04-01 08:05:47

Create PIX

3DS - Banking Login Authentication Payload