feat(connector): [STRIPE] Add Incremental Authorization Flow #8569

Anurag-05-prog · 2025-07-07T14:33:36Z

Type of Change

Closes this issue

Description

Added Incremental Authorization Flow in Stripe.

Additional Changes

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

Motivation and Context

8633

How did you test it?

Postman Tests

Payments - Create

Request:

curl --location 'http://localhost:8080/payments' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'api-key: dev_GO27IMaWkZPcdQp7NA8uYvMJowN0WzpbyqEGtW7L3fxAtXZzCzy60mIZTzOjGon1' \
--data-raw '
{
    "amount": 1000,
    "currency": "USD",
    "confirm": true,
    "capture_method": "manual",
    "capture_on": "2022-09-10T10:11:12Z",
    "amount_to_capture": 1000,
    "customer_id": "StripeCustomer",
    "email": "[email protected]",
    "name": "John Doe",
    "phone": "999999999",
    "phone_country_code": "+65",
    "description": "Its my first payment request",
    "authentication_type": "no_three_ds",
    "return_url": "https://duck.com",
    "billing": {
        "address": {
            "first_name": "John",
            "last_name": "Doe",
            "line1": "1467",
            "line2": "Harrison Street",
            "line3": "Harrison Street",
            "city": "San Fransico",
            "state": "California",
            "zip": "94122",
            "country": "AT"
        }
    },
    "payment_method": "card",
    "payment_method_type": "credit",
    "payment_method_data": {
        "card": {
            
            "card_number": "4242424242424242",
            "card_exp_month": "12",
            "card_exp_year": "2026",
            "card_holder_name": "joseph Doe",
            "card_cvc": "123"
        }
    },
    "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"
        }
    },
    "statement_descriptor_name": "joseph",
    "statement_descriptor_suffix": "JS",
    "metadata": {
        "udf1": "value1",
        "new_customer": "true",
        "login_date": "2019-09-10T10:11:12Z"
    },
    "request_incremental_authorization": true
}'

Response:

{
    "payment_id": "pay_jQwvRdxooT7YhHSEvann",
    "merchant_id": "merchant_1751975048",
    "status": "requires_capture",
    "amount": 1000,
    "net_amount": 1000,
    "shipping_cost": null,
    "amount_capturable": 1000,
    "amount_received": 0,
    "connector": "stripe",
    "client_secret": "pay_jQwvRdxooT7YhHSEvann_secret_tjC9HRIfeD3ku1ILRS8Y",
    "created": "2025-07-08T11:44:25.513Z",
    "currency": "USD",
    "customer_id": "StripeCustomer",
    "customer": {
        "id": "StripeCustomer",
        "name": "John Doe",
        "email": "[email protected]",
        "phone": "999999999",
        "phone_country_code": "+65"
    },
    "description": "Its my first payment request",
    "refunds": null,
    "disputes": null,
    "mandate_id": null,
    "mandate_data": null,
    "setup_future_usage": null,
    "off_session": null,
    "capture_on": null,
    "capture_method": "manual",
    "payment_method": "card",
    "payment_method_data": {
        "card": {
            "last4": "4242",
            "card_type": null,
            "card_network": null,
            "card_issuer": null,
            "card_issuing_country": null,
            "card_isin": "424242",
            "card_extended_bin": null,
            "card_exp_month": "12",
            "card_exp_year": "2026",
            "card_holder_name": "joseph Doe",
            "payment_checks": {
                "cvc_check": "pass",
                "address_line1_check": "pass",
                "address_postal_code_check": "pass"
            },
            "authentication_data": null
        },
        "billing": null
    },
    "payment_token": null,
    "shipping": {
        "address": {
            "city": "San Fransico",
            "country": "US",
            "line1": "1467",
            "line2": "Harrison Street",
            "line3": "Harrison Street",
            "zip": "94122",
            "state": "California",
            "first_name": "John",
            "last_name": "Doe"
        },
        "phone": null,
        "email": null
    },
    "billing": {
        "address": {
            "city": "San Fransico",
            "country": "AT",
            "line1": "1467",
            "line2": "Harrison Street",
            "line3": "Harrison Street",
            "zip": "94122",
            "state": "California",
            "first_name": "John",
            "last_name": "Doe"
        },
        "phone": null,
        "email": null
    },
    "order_details": null,
    "email": "[email protected]",
    "name": "John Doe",
    "phone": "999999999",
    "return_url": "https://duck.com/",
    "authentication_type": "no_three_ds",
    "statement_descriptor_name": "joseph",
    "statement_descriptor_suffix": "JS",
    "next_action": null,
    "cancellation_reason": null,
    "error_code": null,
    "error_message": null,
    "unified_code": null,
    "unified_message": null,
    "payment_experience": null,
    "payment_method_type": "credit",
    "connector_label": null,
    "business_country": null,
    "business_label": "default",
    "business_sub_label": null,
    "allowed_payment_method_types": null,
    "ephemeral_key": {
        "customer_id": "StripeCustomer",
        "created_at": 1751975065,
        "expires": 1751978665,
        "secret": "epk_4ce25909189e412389f732e1cd91ce49"
    },
    "manual_retry_allowed": false,
    "connector_transaction_id": "pi_3RiZwnE9cSvqiivY0jq3K45T",
    "frm_message": null,
    "metadata": {
        "udf1": "value1",
        "login_date": "2019-09-10T10:11:12Z",
        "new_customer": "true"
    },
    "connector_metadata": null,
    "feature_metadata": null,
    "reference_id": "pi_3RiZwnE9cSvqiivY0jq3K45T",
    "payment_link": null,
    "profile_id": "pro_fql6hf5I69zMoOLyp0gP",
    "surcharge_details": null,
    "attempt_count": 1,
    "merchant_decision": null,
    "merchant_connector_id": "mca_qTfdo4iBwxJFmMDXJwLD",
    "incremental_authorization_allowed": true,
    "authorization_count": null,
    "incremental_authorizations": null,
    "external_authentication_details": null,
    "external_3ds_authentication_attempted": false,
    "expires_on": "2025-07-08T11:59:25.513Z",
    "fingerprint": null,
    "browser_info": {
        "language": "nl-NL",
        "time_zone": 0,
        "ip_address": "127.0.0.1",
        "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",
        "color_depth": 24,
        "java_enabled": true,
        "screen_width": 1536,
        "accept_header": "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8",
        "screen_height": 723,
        "java_script_enabled": true
    },
    "payment_method_id": null,
    "payment_method_status": null,
    "updated": "2025-07-08T11:44:30.290Z",
    "split_payments": null,
    "frm_metadata": null,
    "extended_authorization_applied": null,
    "capture_before": null,
    "merchant_order_reference_id": null,
    "order_tax_amount": null,
    "connector_mandate_id": null,
    "card_discovery": "manual",
    "force_3ds_challenge": false,
    "force_3ds_challenge_trigger": false,
    "issuer_error_code": null,
    "issuer_error_message": null,
    "is_iframe_redirection_enabled": null,
    "whole_connector_response": null
}

Incremental Authorization

Request:

curl --location 'http://localhost:8080/payments/pay_jQwvRdxooT7YhHSEvann/incremental_authorization' \
--header 'Content-Type: application/json' \
--header 'api-key: dev_GO27IMaWkZPcdQp7NA8uYvMJowN0WzpbyqEGtW7L3fxAtXZzCzy60mIZTzOjGon1' \
--data '{
  "amount": 6540,
  "reason": "customer bought new products"
}'

Response:

{
    "payment_id": "pay_jQwvRdxooT7YhHSEvann",
    "merchant_id": "merchant_1751975048",
    "status": "requires_capture",
    "amount": 6540,
    "net_amount": 6540,
    "shipping_cost": null,
    "amount_capturable": 6540,
    "amount_received": 0,
    "connector": "stripe",
    "client_secret": "pay_jQwvRdxooT7YhHSEvann_secret_tjC9HRIfeD3ku1ILRS8Y",
    "created": "2025-07-08T11:44:25.513Z",
    "currency": "USD",
    "customer_id": null,
    "customer": {
        "id": null,
        "name": "John Doe",
        "email": "[email protected]",
        "phone": "999999999",
        "phone_country_code": "+65"
    },
    "description": "Its my first payment request",
    "refunds": null,
    "disputes": null,
    "mandate_id": null,
    "mandate_data": null,
    "setup_future_usage": null,
    "off_session": null,
    "capture_on": null,
    "capture_method": "manual",
    "payment_method": "card",
    "payment_method_data": {
        "card": {
            "last4": "4242",
            "card_type": null,
            "card_network": null,
            "card_issuer": null,
            "card_issuing_country": null,
            "card_isin": "424242",
            "card_extended_bin": null,
            "card_exp_month": "12",
            "card_exp_year": "2026",
            "card_holder_name": "joseph Doe",
            "payment_checks": {
                "cvc_check": "pass",
                "address_line1_check": "pass",
                "address_postal_code_check": "pass"
            },
            "authentication_data": null
        },
        "billing": null
    },
    "payment_token": null,
    "shipping": null,
    "billing": null,
    "order_details": null,
    "email": null,
    "name": null,
    "phone": null,
    "return_url": "https://duck.com/",
    "authentication_type": "no_three_ds",
    "statement_descriptor_name": "joseph",
    "statement_descriptor_suffix": "JS",
    "next_action": null,
    "cancellation_reason": null,
    "error_code": null,
    "error_message": null,
    "unified_code": null,
    "unified_message": null,
    "payment_experience": null,
    "payment_method_type": "credit",
    "connector_label": null,
    "business_country": null,
    "business_label": "default",
    "business_sub_label": null,
    "allowed_payment_method_types": null,
    "ephemeral_key": null,
    "manual_retry_allowed": false,
    "connector_transaction_id": "pi_3RiZwnE9cSvqiivY0jq3K45T",
    "frm_message": null,
    "metadata": {
        "udf1": "value1",
        "login_date": "2019-09-10T10:11:12Z",
        "new_customer": "true"
    },
    "connector_metadata": null,
    "feature_metadata": null,
    "reference_id": "pi_3RiZwnE9cSvqiivY0jq3K45T",
    "payment_link": null,
    "profile_id": "pro_fql6hf5I69zMoOLyp0gP",
    "surcharge_details": null,
    "attempt_count": 1,
    "merchant_decision": null,
    "merchant_connector_id": "mca_qTfdo4iBwxJFmMDXJwLD",
    "incremental_authorization_allowed": true,
    "authorization_count": 1,
    "incremental_authorizations": [
        {
            "authorization_id": "auth_qIHwnbG3etLwlil1piKr_1",
            "amount": 6540,
            "status": "success",
            "error_code": null,
            "error_message": null,
            "previously_authorized_amount": 1000
        }
    ],
    "external_authentication_details": null,
    "external_3ds_authentication_attempted": false,
    "expires_on": "2025-07-08T11:59:25.513Z",
    "fingerprint": null,
    "browser_info": {
        "language": "nl-NL",
        "time_zone": 0,
        "ip_address": "127.0.0.1",
        "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",
        "color_depth": 24,
        "java_enabled": true,
        "screen_width": 1536,
        "accept_header": "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8",
        "screen_height": 723,
        "java_script_enabled": true
    },
    "payment_method_id": null,
    "payment_method_status": null,
    "updated": "2025-07-08T11:44:36.093Z",
    "split_payments": null,
    "frm_metadata": null,
    "extended_authorization_applied": null,
    "capture_before": null,
    "merchant_order_reference_id": null,
    "order_tax_amount": null,
    "connector_mandate_id": null,
    "card_discovery": "manual",
    "force_3ds_challenge": false,
    "force_3ds_challenge_trigger": false,
    "issuer_error_code": null,
    "issuer_error_message": null,
    "is_iframe_redirection_enabled": null,
    "whole_connector_response": null
}

Cypress test screenshot:

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

semanticdiff-com · 2025-07-07T14:33:39Z

Review changes with

Changed Files

File	Status
api-reference/v2/openapi_spec_v2.json	67% smaller
crates/hyperswitch_connectors/src/default_implementations.rs	30% smaller
crates/hyperswitch_connectors/src/connectors/stripe/transformers.rs	16% smaller
crates/hyperswitch_connectors/src/connectors/stripe.rs	15% smaller
crates/router/src/core/payments/transformers.rs	1% smaller
.github/workflows/cypress-tests-runner.yml	0% smaller
crates/common_enums/src/enums.rs	0% smaller
cypress-tests/cypress/e2e/configs/Payment/Stripe.js	0% smaller
cypress-tests/cypress/e2e/configs/Payment/Utils.js	0% smaller

…ch into stripe-incremental-auth

jarnura · 2025-08-11T10:40:01Z

cypress-tests/cypress/e2e/configs/Payment/Stripe.js

        },
      },
    },
+    // IncrementalAuth: { // commenting out due to credentials issue


@sundarigopal can you verify this

We’ve verified that he’s currently unable to handle three different credentials for separate flows. He’s taking this up as a separate PR, as it requires some framework-level changes. At present, we can only handle two credentials. We’ll follow up on this.

add stripe incremental auth

7c2e3ae

Anurag-05-prog self-assigned this Jul 7, 2025

Anurag-05-prog requested a review from a team as a code owner July 7, 2025 14:33

Anurag-05-prog linked an issue Jul 7, 2025 that may be closed by this pull request

[FEATURE] Add incremental authorization for Paypal, AuthorizeDotNet, Stripe #8516

Closed

2 tasks

Anurag Singh and others added 3 commits July 8, 2025 17:13

fix clippy errors

135aefc

chore: run formatter

ce3fa05

remove unnecessary code

1a5f108

deepanshu-iiitu previously approved these changes Jul 8, 2025

View reviewed changes

add cypress test for incremental auth flow

b47f6d4

Anurag-05-prog dismissed deepanshu-iiitu’s stale review via b47f6d4 July 8, 2025 13:12

Anurag-05-prog requested a review from a team as a code owner July 8, 2025 13:12

deepanshu-iiitu previously approved these changes Jul 8, 2025

View reviewed changes

fix cypress

22f8163

Anurag-05-prog dismissed deepanshu-iiitu’s stale review via 22f8163 July 8, 2025 17:49

Anurag Singh and others added 5 commits July 9, 2025 00:26

revert cypress

2bb806d

Merge branch 'main' into stripe-incremental-auth

c205370

Merge branch 'main' into stripe-incremental-auth

52f125f

fix clippy error

20cac9d

Merge branch 'stripe-incremental-auth' of github.com:juspay/hyperswit…

917632f

…ch into stripe-incremental-auth

Anurag-05-prog removed a link to an issue Jul 14, 2025

[FEATURE] Add incremental authorization for Paypal, AuthorizeDotNet, Stripe #8516

Closed

2 tasks

Anurag-05-prog linked an issue Jul 14, 2025 that may be closed by this pull request

[FEATURE] Add Incremental Authorization Flow for Stripe #8633

Closed

2 tasks

Anurag-05-prog requested review from a team as code owners July 22, 2025 12:30

add stripe incremental auth

a415888

Anurag-05-prog force-pushed the stripe-incremental-auth branch from 2681d9a to a415888 Compare July 22, 2025 12:35

hyperswitch-bot bot added 2 commits July 22, 2025 12:36

chore: run formatter

865abf5

docs(openapi): re-generate OpenAPI specification

316d533

hyperswitch-bot bot added the M-api-contract-changes Metadata: This PR involves API contract changes label Jul 22, 2025

Anurag-05-prog dismissed stale reviews from ShankarSinghC and deepanshu-iiitu via c958611 July 31, 2025 13:26

update credential of stripe

68821f5

Anurag-05-prog requested a review from a team as a code owner August 1, 2025 07:46

Anurag Singh and others added 13 commits August 1, 2025 14:07

fix connector creds

4980236

Merge remote-tracking branch 'origin/main' into stripe-incremental-auth

585c6cf

update s3_source_file_name

2e87d0c

fix cypress

40950a9

comment out incremental auth code

bcd4bf4

fix cypress

82a5c0f

fix cypress

1c070df

fix cypress

82cebfa

fix cypress

ad85212

chore(cypress): run formatter and address lints

7bf52a8

update credentials

9bc5c55

Merge branch 'stripe-incremental-auth' of github.com:juspay/hyperswit…

5ab5e64

…ch into stripe-incremental-auth

update utils.js

58f09a1

pixincreate approved these changes Aug 7, 2025

View reviewed changes

deepanshu-iiitu approved these changes Aug 8, 2025

View reviewed changes

likhinbopanna approved these changes Aug 8, 2025

View reviewed changes

jarnura reviewed Aug 11, 2025

View reviewed changes

sai-harsha-vardhan approved these changes Aug 11, 2025

View reviewed changes

Gnanasundari24 approved these changes Aug 11, 2025

View reviewed changes

dgeee13 approved these changes Aug 11, 2025

View reviewed changes

jarnura approved these changes Aug 11, 2025

View reviewed changes

ShankarSinghC approved these changes Aug 12, 2025

View reviewed changes

likhinbopanna added this pull request to the merge queue Aug 12, 2025

Merged via the queue into main with commit e36bb99 Aug 12, 2025
17 of 22 checks passed

likhinbopanna deleted the stripe-incremental-auth branch August 12, 2025 07:11

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat(connector): [STRIPE] Add Incremental Authorization Flow #8569

feat(connector): [STRIPE] Add Incremental Authorization Flow #8569

Uh oh!

Anurag-05-prog commented Jul 7, 2025 •

edited

Loading

Uh oh!

semanticdiff-com bot commented Jul 7, 2025 •

edited

Loading

Uh oh!

jarnura Aug 11, 2025

Uh oh!

Gnanasundari24 Aug 11, 2025

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

10 participants

feat(connector): [STRIPE] Add Incremental Authorization Flow #8569

feat(connector): [STRIPE] Add Incremental Authorization Flow #8569

Uh oh!

Conversation

Anurag-05-prog commented Jul 7, 2025 • 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!

semanticdiff-com bot commented Jul 7, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

jarnura Aug 11, 2025

Choose a reason for hiding this comment

Uh oh!

Gnanasundari24 Aug 11, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

10 participants

Anurag-05-prog commented Jul 7, 2025 •

edited

Loading

semanticdiff-com bot commented Jul 7, 2025 •

edited

Loading