feat(connector): [NMI] External 3DS flow for Cards #4385

Sakilmostak · 2024-04-17T10:42:55Z

Type of Change

Description

External 3DS is done through ThreeDSecure.io for Card payment in NMI

Additional Changes

This PR modifies the API contract
This PR modifies the database schema
This PR modifies application configuration/environment variables

Motivation and Context

How did you test it?

Tested through Postman:

Create a MCA(NMI):

curl --location 'http://localhost:8080/account/{{merchant_id}}/connectors' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'api-key: {{admin_api_key}}' \
--data '{
    "connector_type": "payment_processor",
    "connector_name": "nmi",
    "connector_account_details": {
        "auth_type": "BodyKey",
        "api_key": "{{api_key}}",
        "key1": "{{key1}}"
    },
    "test_mode": false,
    "disabled": false,
    "payment_methods_enabled": [
        {
            "payment_method": "card",
            "payment_method_types": [
                {
                    "payment_method_type": "credit",
                    "card_networks": [
                        "Visa",
                        "Mastercard"
                    ],
                    "minimum_amount": 1,
                    "maximum_amount": 68607706,
                    "recurring_enabled": true,
                    "installment_payment_enabled": true
                },
                {
                    "payment_method_type": "debit",
                    "card_networks": [
                        "Visa",
                        "Mastercard"
                    ],
                    "minimum_amount": 1,
                    "maximum_amount": 68607706,
                    "recurring_enabled": true,
                    "installment_payment_enabled": true
                }
            ]
        },
        {
            "payment_method": "voucher",
            "payment_method_types": [
                {
                    "payment_method_type": "boleto",
                    
                    "minimum_amount": 1,
                    "maximum_amount": 68607706,
                    "recurring_enabled": true,
                    "installment_payment_enabled": true
                }
            ]
        },
        {
            "payment_method": "pay_later",
            "payment_method_types": [
                {
                    "payment_method_type": "klarna",
                    "payment_experience": "redirect_to_url",
                    "minimum_amount": 1,
                    "maximum_amount": 68607706,
                    "recurring_enabled": true,
                    "installment_payment_enabled": true
                },
                {
                    "payment_method_type": "affirm",
                    "payment_experience": "redirect_to_url",
                    "minimum_amount": 1,
                    "maximum_amount": 68607706,
                    "recurring_enabled": true,
                    "installment_payment_enabled": true
                },
                {
                    "payment_method_type": "afterpay_clearpay",
                    "payment_experience": "redirect_to_url",
                    "minimum_amount": 1,
                    "maximum_amount": 68607706,
                    "recurring_enabled": true,
                    "installment_payment_enabled": true
                }
            ]
        }
    ],
    "metadata": {
        "city": "NY",
        "unit": "245",
        "acquirer_bin": "{{acquirer_bin}}",
        "acquirer_merchant_id": "{{acquirer_merchant_id}}"
    },
    "connector_webhook_details": {
        "merchant_secret": "{{merchant_secret}}"
    },
    "business_country": "US",
    "business_label": "default"
}'

Create External ThreeDS MCA:

curl --location 'http://localhost:8080/account/{{merchant_id}}/connectors' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'api-key: {{admin_api_key}}' \
--data '{
  "connector_type": "authentication_processor",
  "connector_name": "threedsecureio",
  "connector_account_details": {
        "auth_type": "HeaderKey",
        "api_key":"{{api_key}}"
    },
  "test_mode": true,
  "disabled": false,
  "metadata": {
        "mcc": "5411",
        "merchant_country_code": "840",
        "merchant_name": "Dummy Merchant"
  }
}'

Update Business Profile:

curl --location 'http://localhost:8080/account/{{merchant_id}}/business_profile/{{profile_id}}' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'api-key: {{admin_api_key}}' \
--data '{
    "authentication_connector_details": {
        "authentication_connectors": ["threedsecureio"],
        "three_ds_requestor_url": "https://google.com"
    }
}'

Create a External 3DS request:

{
    "amount": 254,
    "currency": "USD",
    "confirm": true,
    "amount_to_capture": 254,
    "capture_method": "automatic",
    "capture_on": "2022-09-10T10:11:12Z",
    "customer_id": "StripeCustomer",
    "email": "[email protected]",
    "name": "John Doe",
    "phone": "999999999",
    "request_external_three_ds_authentication": true,
    "phone_country_code": "+65",
    "description": "Its my first payment request",
    "authentication_type": "three_ds",
    "return_url": "https://google.com",
    "setup_future_usage": "on_session",
    "browser_info": {
        "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/70.0.3538.110 Safari/537.36",
        "accept_header": "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8",
        "language": "nl-NL",
        "color_depth": 24,
        "screen_height": 723,
        "screen_width": 1536,
        "time_zone": 0,
        "java_enabled": true,
        "java_script_enabled": true,
        "ip_address": "127.0.0.1"
    },
    "shipping": {
        "address": {
            "line1": "1467",
            "line2": "Harrison Street",
            "line3": "Harrison Street",
            "city": "San Fransico",
            "state": "California",
            "zip": "94122",
            "country": "US",
            "first_name": "John",
            "last_name": "Doe"
        }
    },
    "routing": {
        "type": "single",
        "data": "nmi"
    },
    "statement_descriptor_name": "joseph",
    "statement_descriptor_suffix": "JS",
    "metadata": {
        "udf1": "value1",
        "new_customer": "true",
        "login_date": "2019-09-10T10:11:12Z"
    },
    "payment_method": "card",
    "payment_method_type": "credit",
    "payment_method_data": {
        "card": {
            "card_number": "4000000000002503",
            "card_exp_month": "08",
            "card_exp_year": "25",
            "card_holder_name": "joseph Doe",
            "card_cvc": "999"
        }
    },
    "billing": {
        "address": {
            "line1": "1467",
            "line2": "Harrison Street",
            "line3": "Harrison Street",
            "city": "San Fransico",
            "state": "California",
            "zip": "94122",
            "country": "US",
            "first_name": "John",
            "last_name": "Doe"
        }
    }
}

Collect the three_ds_method_data from the response:
Simulate Device Data Collection:
Fill the threeDSMethodData field with collected three_ds_method_data

curl --location 'https://acs40.sandbox.3dsecure.io/3dsmethod' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'api-key: {{api_key}}' \
--data-urlencode 'threeDSMethodData={{threeDSMethodData}}'

Create a Challenge request:

curl --location 'http://localhost:8080/payments/{{payment_id}}/3ds/authentication' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'api-key: {{api_key}}' \
--data '{
    "client_secret": "{{client_secret}}",
    "device_channel": "BRW",
    "threeds_method_comp_ind": "Y"
}'

Authorize the Payment:

curl --location --request POST 'http://localhost:8080/payments/{{payment_id}}/{{merchant_id}}/authorize/checkout' \
--header 'api-key: {{api_key}}'

Do a Payment Sync:

curl --location 'http://localhost:8080/payments/{{payment_id}}?force_sync=true' \
--header 'Accept: application/json' \
--header 'api-key: {{api_key}}'

Status should be succeeded

Checklist

I formatted the code cargo +nightly fmt --all
I addressed lints thrown by cargo clippy
I reviewed the submitted code
I added unit tests for my changes where possible
I added a CHANGELOG entry if applicable

sai-harsha-vardhan · 2024-04-17T13:28:53Z

crates/router/src/connector/nmi/transformers.rs

+            email: item.email.clone(),
+            cavv: Some(auth_data.cavv.clone()),
+            eci: auth_data.eci.clone(),
+            xid: None,


Please populate xid with threeds_server_transaction_id and three_ds_version with message_version here

sai-harsha-vardhan · 2024-04-18T09:22:49Z

crates/router/src/connector/nmi/transformers.rs

+            xid: Some(auth_data.threeds_server_transaction_id.clone()),
+            cardholder_auth: None,
+            three_ds_version: Some(auth_data.message_version.clone()),
+            directory_server_id: None,


please create an issue for missing values here

…press-for-more-control * 'main' of github.com:juspay/hyperswitch: feat(payments): add amount and connector id filter in list (#4354) feat(connector): [NMI] External 3DS flow for Cards (#4385) test(cypress): Update ConnectorAuth Details (#4386) chore(version): 2024.04.18.0 fix(router): make payment_instrument optional (#4389) fix(config): remove `merchant_business_country` from the connector configs as enums can not be handled in this toml file (#4383) feat(payment_link): Add support for saved payment method option for payment link (#4373)

Sakilmostak added 6 commits April 8, 2024 12:02

feature: detached 3ds flow for nmi

92e178d

refactor: add condition to enter auth flow on detached 3ds

f11be92

refactor: add condition to skip pre processing flow

410f0fb

feat: add configs

eb3b28e

Merge branch 'main' into nmi_detached_3ds

e623d4b

refactor: add new flow type for redirection

6f89256

Sakilmostak added A-connector-integration Area: Connector integration C-feature Category: Feature request or enhancement labels Apr 17, 2024

Sakilmostak self-assigned this Apr 17, 2024

Sakilmostak requested review from a team as code owners April 17, 2024 10:42

sai-harsha-vardhan reviewed Apr 17, 2024

View reviewed changes

refactor: resolve comments

015d7aa

sai-harsha-vardhan approved these changes Apr 18, 2024

View reviewed changes

srujanchikke approved these changes Apr 18, 2024

View reviewed changes

likhinbopanna added this pull request to the merge queue Apr 18, 2024

Merged via the queue into main with commit 4feda8f Apr 18, 2024

likhinbopanna deleted the nmi_detached_3ds branch April 18, 2024 11:45

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat(connector): [NMI] External 3DS flow for Cards #4385

feat(connector): [NMI] External 3DS flow for Cards #4385

Uh oh!

Sakilmostak commented Apr 17, 2024 •

edited

Loading

Uh oh!

sai-harsha-vardhan Apr 17, 2024

Uh oh!

sai-harsha-vardhan Apr 18, 2024

Uh oh!

Uh oh!

feat(connector): [NMI] External 3DS flow for Cards #4385

feat(connector): [NMI] External 3DS flow for Cards #4385

Uh oh!

Conversation

Sakilmostak commented Apr 17, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Type of Change

Description

Additional Changes

Motivation and Context

How did you test it?

Checklist

Uh oh!

sai-harsha-vardhan Apr 17, 2024

Choose a reason for hiding this comment

Uh oh!

sai-harsha-vardhan Apr 18, 2024

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Sakilmostak commented Apr 17, 2024 •

edited

Loading