feat(authentication): added authentication sync api #8596
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
…y/hyperswitch into 9455-add-authentication-create-api
…thentication-create-api
…y/hyperswitch into 9948-flatten-existing-core-authentication-function-to-remove-out-of-payments-context
…le-from-acquirer_config' of github.com:juspay/hyperswitch into 9944-add-eligibility-pre_authentication-api
…com:juspay/hyperswitch into 9945-add-authentication----authenticate-api
…com:juspay/hyperswitch into 9945-add-authentication----authenticate-api
|
Review changes with Changed Files
|
Base automatically changed from
9945-add-authentication----authenticate-api
to
main
July 25, 2025 09:47
hyperswitch-bot
bot
added
M-database-changes
sahkal
changed the title
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Type of Change
Description
The main feature is the addition of a new authentication synchronization API that allows syncing authentication data between systems.
API Contract Changes
Files Modified
Core Authentication Logic
crates/router/src/core/unified_authentication_service.rs- Main authentication service logiccrates/router/src/core/authentication/utils.rs- Authentication utilitiescrates/router/src/services/authentication.rs- Authentication servicesAPI Models & Routes
crates/api_models/src/authentication.rs- Authentication API modelscrates/router/src/routes/authentication.rs- Authentication route handlerscrates/router/src/routes/app.rs- App routing configurationcrates/router/src/routes/lock_utils.rs- Lock utilities for routesDomain Models
crates/hyperswitch_domain_models/src/authentication.rs- Authentication domain modelscrates/hyperswitch_domain_models/src/router_request_types/unified_authentication_service.rs- Request types for unified auth serviceConnector Integration
crates/hyperswitch_connectors/src/connectors/unified_authentication_service.rs- Unified auth service connectorcrates/hyperswitch_connectors/src/connectors/unified_authentication_service/transformers.rs- Data transformerscrates/hyperswitch_connectors/src/connectors/netcetera/transformers.rs- Netcetera connector transformersConfiguration & Documentation
config/development.toml- Development configuration updatesapi-reference/v1/openapi_spec_v1.json- Updated OpenAPI v1 specificationapi-reference/v2/openapi_spec_v2.json- Updated OpenAPI v2 specificationTechnical Implementation Details
Integration Points
How did you test it?
Try the flow with both Friction and Frictionless card
Setup Netcetera in MCA :
Setup Profile acquirer Config
Update Business Profile
Do Authentication Create :
Do Authentication Eligibility
RESPONSE
{ "authentication_id": "authn_U4Z7xqe7HHIScfDU50xW", "next_api_action": { "url": "http://localhost:8080/authentication/authn_U4Z7xqe7HHIScfDU50xW/authenticate", "http_method": "POST" }, "status": "pending", "eligibility_response_params": { "ThreeDsData": { "threeds_server_transaction_id": "ed790486-dda7-4972-83ab-5d0afbaa8885", "maximum_supported_3ds_version": "2.3.1", "connector_authentication_id": "ed790486-dda7-4972-83ab-5d0afbaa8885", "three_ds_method_data": "eyJ0aHJlZURTTWV0aG9kTm90aWZpY2F0aW9uVVJMIjoiaHR0cHM6Ly9leGFtcGxlLmNvbS8zZHMtbWV0aG9kLW5vdGlmaWNhdGlvbi11cmwiLCJ0aHJlZURTU2VydmVyVHJhbnNJRCI6ImVkNzkwNDg2LWRkYTctNDk3Mi04M2FiLTVkMGFmYmFhODg4NSJ9", "three_ds_method_url": "https://ndm-prev.3dss-non-prod.cloud.netcetera.com/acs/3ds-method", "message_version": "2.3.1", "directory_server_id": "A000000003" } }, "connector_metadata": null, "profile_id": "pro_To47L194jVTevrWXRxR3", "error_message": null, "error_code": null, "authentication_connector": "netcetera", "billing": { "address": { "city": "San Fransico", "country": "US", "line1": "1467", "line2": "Harrison Street", "line3": "Harrison Street", "zip": "94122", "state": "CA", "first_name": "PiX", "last_name": null }, "phone": { "number": "123456789", "country_code": "12" }, "email": null }, "shipping": { "address": { "city": "San Fransico", "country": "US", "line1": "1467", "line2": "Harrison Street", "line3": "Harrison Street", "zip": "94122", "state": "California", "first_name": "PiX", "last_name": null }, "phone": { "number": "123456789", "country_code": "12" }, "email": null }, "browser_information": { "color_depth": 24, "java_enabled": true, "java_script_enabled": true, "language": "nl-NL", "screen_height": 723, "screen_width": 1536, "time_zone": 0, "ip_address": "115.99.183.2", "accept_header": "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8", "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", "os_type": null, "os_version": null, "device_model": null }, "email": "[email protected]" }Authentication API
Response
Sync
Response
{ "authentication_id": "authn_xfnVvnZIWfGMaHrwEBGJ", "merchant_id": "sahkal11", "status": "success", "client_secret": "authn_xfnVvnZIWfGMaHrwEBGJ_secret_b1iIylqBuPVUBw1EYibA", "amount": 10, "currency": "USD", "authentication_connector": "netcetera", "force_3ds_challenge": false, "return_url": null, "created_at": "2025-07-26T11:30:13.974Z", "profile_id": "pro_BEX6ZBeTBuJq3TxXrjwz", "psd2_sca_exemption_type": null, "acquirer_details": { "bin": "400000", "merchant_id": "00002000000", "country_code": "004" }, "threeds_server_transaction_id": "23be8c88-8dee-4279-94c0-7c7a7148ad74", "maximum_supported_3ds_version": "2.3.1", "connector_authentication_id": "23be8c88-8dee-4279-94c0-7c7a7148ad74", "three_ds_method_data": "eyJ0aHJlZURTTWV0aG9kTm90aWZpY2F0aW9uVVJMIjoiaHR0cHM6Ly9leGFtcGxlLmNvbS8zZHMtbWV0aG9kLW5vdGlmaWNhdGlvbi11cmwiLCJ0aHJlZURTU2VydmVyVHJhbnNJRCI6IjIzYmU4Yzg4LThkZWUtNDI3OS05NGMwLTdjN2E3MTQ4YWQ3NCJ9", "three_ds_method_url": "https://ndm-prev.3dss-non-prod.cloud.netcetera.com/acs/3ds-method", "message_version": "2.3.1", "connector_metadata": null, "directory_server_id": "A000000003", "billing": { "address": { "city": "San Fransico", "country": "US", "line1": "1467", "line2": "Harrison Street", "line3": "Harrison Street", "zip": "94122", "state": "CA", "first_name": "PiX", "last_name": null }, "phone": { "number": "123456789", "country_code": "12" }, "email": null }, "shipping": { "address": { "city": "San Fransico", "country": "US", "line1": "1467", "line2": "Harrison Street", "line3": "Harrison Street", "zip": "94122", "state": "California", "first_name": "PiX", "last_name": null }, "phone": { "number": "123456789", "country_code": "12" }, "email": null }, "browser_information": { "color_depth": 24, "java_enabled": true, "java_script_enabled": true, "language": "nl-NL", "screen_height": 723, "screen_width": 1536, "time_zone": 0, "ip_address": "115.99.183.2", "accept_header": "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8", "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", "os_type": null, "os_version": null, "device_model": null }, "email": "[email protected]", "trans_status": "Y", "acs_url": null, "challenge_request": null, "acs_reference_number": null, "acs_trans_id": null, "three_dsserver_trans_id": "23be8c88-8dee-4279-94c0-7c7a7148ad74", "acs_signed_content": null, "three_ds_requestor_url": "https://google.com", "three_ds_requestor_app_url": null, "authentication_value": "MTIzNDU2Nzg5MDA5ODc2NTQzMjE=", "error_message": null, "error_code": null, "profile_acquirer_id": "pro_acq_ebY2fZAOqqjMAikwIMqH" }Checklist
cargo +nightly fmt --allcargo clippy