feat(authentication): added authentication sync api #8596
Merged
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
| @@ -45,10 +46,6 @@ pub struct AuthenticationCreateRequest { | |||
| #[schema(value_type = Option<String>, example = "https://example.com/redirect")] | |||
| pub return_url: Option<String>, | |||
|
|
|||
| /// Acquirer details information | |||
There was a problem hiding this comment.
We should have capability to override this per transaction level as well
| pub transaction_status: Option<common_enums::TransactionStatus>, | ||
|
|
||
| /// Access Server URL for challenge submission. | ||
| pub acs_url: Option<String>, |
There was a problem hiding this comment.
why are all the URLs represented as String?
There was a problem hiding this comment.
these are values retrieved from table, where it is stored as string, if we want all url to URL type then we would need to parse all the urls, is that required given that its just a state retrieve endpoint
| @@ -29,6 +29,7 @@ pub struct MerchantDetails { | |||
| pub three_ds_requestor_url: Option<String>, | |||
| pub three_ds_requestor_id: Option<String>, | |||
| pub three_ds_requestor_name: Option<String>, | |||
| pub notification_url: Option<String>, | |||
There was a problem hiding this comment.
this should be URL type right?
| @@ -904,6 +918,15 @@ pub async fn authentication_eligibility_core( | |||
| ) | |||
| .await?; | |||
|
|
|||
| let notification_url = match authentication_connector { | |||
| common_enums::AuthenticationConnectors::Juspaythreedsserver => Some(format!( | |||
There was a problem hiding this comment.
this logic should be same irrespective of connector right?
There was a problem hiding this comment.
incase of ctp, it might differ notification url can also be merchant url
| .authentication_connector_details | ||
| .and_then(|details| details.three_ds_requestor_app_url), | ||
| profile_acquirer_id, | ||
| eci: authentication.eci.clone(), |
There was a problem hiding this comment.
eci shouldn't be populated if it's client auth right?
There was a problem hiding this comment.
eci is not a maskable instrument we can send it to client right?
There was a problem hiding this comment.
No, better not to send ECI as well to the client
…hyperswitch into 9947-add-authentication-sync-api
ThisIsMani
previously approved these changes
Jul 29, 2025
…hyperswitch into 9947-add-authentication-sync-api
ShankarSinghC
approved these changes
Jul 30, 2025
sai-harsha-vardhan
approved these changes
Jul 30, 2025
apoorvdixit88
approved these changes
Jul 30, 2025
deepanshu-iiitu
approved these changes
Jul 30, 2025
pixincreate
added a commit
that referenced
this pull request
Jul 31, 2025
…dd-xof-cybersource * 'main' of github.com:juspay/hyperswitch: feat(authentication): added authentication sync api (#8596) feat(connector): [facilitapay] fix refunds, add webhook and void support (#8778) feat(connector): [payload] add recurring payments (#8597) chore(version): 2025.07.31.0 feat(connector): [Flexiti]Add support for flexiti connector (#8743) chore(router): events enhancement for kafka (#8780) ci(cypress): Making a mandate payment with large customer user agents (#8790)
pixincreate
added a commit
that referenced
this pull request
Aug 1, 2025
…rver * 'main' of github.com:juspay/hyperswitch: (25 commits) chore: `xof` currency to cybersource cards (#8799) chore(version): 2025.08.01.0 feat(core): Implement UCS based upi for paytm and phonepe (#8732) feat(connector): [katapult]add template code for katapult (#8783) feat(router): introduce `feature` and `feature_data` to gsm (#7771) feat(connector): [cybersource] add changes for field CybersourceConsumerAuthInformation (#8768) feat(authentication): added authentication sync api (#8596) feat(connector): [facilitapay] fix refunds, add webhook and void support (#8778) feat(connector): [payload] add recurring payments (#8597) chore(version): 2025.07.31.0 feat(connector): [Flexiti]Add support for flexiti connector (#8743) chore(router): events enhancement for kafka (#8780) ci(cypress): Making a mandate payment with large customer user agents (#8790) fix(openapi): update create_platform endpoint in api-reference docs (#8782) chore(version): 2025.07.30.0 fix(connector): [GLOBALPAY] Added Tokenization Flow for CITs (#8568) feat(routing): Add api-refs for new decision engine endpoints (#8709) fix: replace xtrim with xdel to support older redis version (#8515) fix(connector): [Worldpay] handle multiple ddc submission for CompleteAuthorize (#8741) feat(connector): [Adyen] receive incoming webhooks for pix expiry (#8720) ...
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