feat(api_models): add api_models for external 3ds authentication flow

[sai-harsha-vardhan]

Type of Change

• Bugfix
• New feature
• Enhancement
• Refactoring
• Dependency updates
• Documentation
• CI/CD

Description

add api_models for external 3ds authentication flow

Hyperswitch currently uses the "Processor driven approach" for 3DS and is now looking to move towards "Third Party 3DS provider approach" - Using a specialized 3DS provider for checking card enrollment and 3DS authentication
Eg: Cardinal, Netcetra

The 3DS authentication can be done once and the authentication response that we get can be sent to any processor to authorize the payment.

API contract changes
Business profile API

"authentication_details": {
      "authentication_connectors": ["threedsecureio"],
      "three_ds_requestor_url": "https://google.com"
  }

Payments API
Request
"request_external_three_ds_authentication": true / false

Response

"next_action": {
        "type": "three_ds_invoke",
        "three_ds_data": {
            "three_ds_authentication_url": "http://localhost:8080/payments/pay_CmrJbRTEDIgKbdlEriy7/3ds/authentication",
            "three_ds_authorize_url": "http://localhost:8080/payments/pay_CmrJbRTEDIgKbdlEriy7/postman_merchant_GHAction_b6352424-0155-4a1f-a639-75b59d679f74/authorize/checkout",
            "three_ds_method_details": {
                "three_ds_method_key": "threeDSMethodData",
                "three_ds_method_data_submission": true,
                "three_ds_method_data": "eyJ0aHJlZURTU2VydmVyVHJhbnNJRCI6ImFiN2RmYzkxLTdjYWYtNDkwZi1iY2E5LWQ2ZWJiODE5MGQyZiJ9",
                "three_ds_method_url": "https://acs35.sandbox.3dsecure.io/3dsmethod"
            }
        }
    }

"external_authentication_details": {
       "authentication_flow": "challenge",
        "electronic_commerce_indicator": "05",
        "status": "success",
        "ds_transaction_id": "2.1.0",
        "version": "dda51c42-3843-4e7c-a44a-23557e29f586"
    }

Authentication API
Request

{
    "device_channel": "BRW",
    "sdk_information": {
        "sdk_app_id": "92deb809-a452-47af-ac3b-301978a9e9e0",
        "sdk_enc_data": "eyJraW…",
        "sdk_ephem_pub_key": {
            "kty": "EC",
            "x": "P5zWKpoAZoUlrtUoe6Xzvia3zgCX1mSmpGj5XlV9R0w",
            "y": "ov2s2HF_HVwf2vzZMPOLjGwFASSmEGxeSUEuyMcrhLI",
            "crv": "P-256"
        },
        "sdk_trans_id": "4fa7696e-ca08-42cc-806f-1081287a1b9b",
        "sdk_reference_number": "3DS_LOA_SDK_JTPL_020200_00788",
        "sdk_max_timeout": "05"
    }
}

Response

{
    "trans_status": "C",
    "acs_url": "https://acs35.sandbox.3dsecure.io/browser/challenge/manual",
    "challenge_request": "eyJ0aHJlZ..",
    "acs_reference_number": "3dsecureio-standin-acs",
    "acs_trans_id": "71770ded-1daf-4d3b-b390-c79e7f37fe51",
    "three_dsserver_trans_id": "dda51c42-3843-4e7c-a44a-23557e29f586",
    "acs_signed_content": null
}

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?

Compiler guided and Sanity testing to make sure it's backward compatible

This PR cannot be tested until core changes are done.

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

[SanchithHegde]

Other than that, looks good to me!