feat(payment-link): alternate text for manual captures

[mrudulvajpayee4935]

Type of Change

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

Description

Payment links will have Add Payment Method as button text in case merchant send is_setup_mandate_flow as true in payment_link_config, Authorize Payment in case of manual capture payments and Pay Now in automatic captures.
is_setup_mandate_flow field is only used to alter the text in payment button our core flow of setup mandate remains the same i.e setup mandate flow is used only if amount is zero other authorize flow is used in payments core.
Priority given according to below:

1. Payment button text added while business profile creation.
2. is_setup_mandate_flow passed in payment_link_config
3. Zero amount setup mandate flow.
4. Manual captures payment.
5. Automatic captures.

Additional Changes

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

Motivation and Context

Payment links created with capture_method: manual - where the intention is to authorize the customer for some non zero amount, and capture the authorized amount at some later point in time. In such scenarios, the text Pay Now is incorrect as the user is not actually paying in that moment.

How did you test it?

Curls involved to test the flows:

Automatic captures:

curl --location 'http://localhost:8080/payments' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'api-key: dev_qTm0pV0gtb4DRMB1eKS5h3EgUvdNvvSADkPjZMXyUY5rvEkvPUMdJBjMq0Y8M7MV' \
--data-raw '{
    "currency": "EUR",
    "amount": 10,
    "authentication_type": "three_ds",
    "description": "Joseph First Crypto",
    "email": "[email protected]",
    "setup_future_usage": "off_session",
    "connector_metadata": {
        "noon": {
            "order_category": "applepay"
        }
    },
    "payment_link": true,
    "return_url": "http://127.0.0.1:5500/src/pl_iframe.html",
    "payment_link_config": {
        "theme": "#14356f",
        "logo": "https://logosandtypes.com/wp-content/uploads/2020/08/zurich.svg",
        "seller_name": "Zurich Inc.",
        "setup_mandate": true
    },
    "metadata": {
        "udf1": "value1",
        "new_customer": "true",
        "login_date": "2019-09-10T10:11:12Z"
    },
    "customer_acceptance": null,
    "customer_id": "cus_CL6UOh3X35RCzaGNN24t"
}'

Manual Captures:

curl --location 'http://localhost:8080/payments' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'api-key: dev_qTm0pV0gtb4DRMB1eKS5h3EgUvdNvvSADkPjZMXyUY5rvEkvPUMdJBjMq0Y8M7MV' \
--data-raw '{
    "currency": "EUR",
    "amount": 10,
    "authentication_type": "three_ds",
    "description": "Joseph First Crypto",
    "email": "[email protected]",
    "setup_future_usage": "off_session",
    "connector_metadata": {
        "noon": {
            "order_category": "applepay"
        }
    },
    "payment_link": true,
    "return_url": "http://127.0.0.1:5500/src/pl_iframe.html",
    "payment_link_config": {
        "theme": "#14356f",
        "logo": "https://logosandtypes.com/wp-content/uploads/2020/08/zurich.svg",
        "seller_name": "Zurich Inc."
    },
    "metadata": {
        "udf1": "value1",
        "new_customer": "true",
        "login_date": "2019-09-10T10:11:12Z"
    },
    "customer_acceptance": null,
    "capture_method": "manual",
    "customer_id": "cus_CL6UOh3X35RCzaGNN24t"
}'

setup_mandate_flow

curl --location 'http://localhost:8080/payments' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'api-key: dev_qTm0pV0gtb4DRMB1eKS5h3EgUvdNvvSADkPjZMXyUY5rvEkvPUMdJBjMq0Y8M7MV' \
--data-raw '{
    "currency": "EUR",
    "amount": 10,
    "authentication_type": "three_ds",
    "description": "Joseph First Crypto",
    "email": "[email protected]",
    "setup_future_usage": "off_session",
    "connector_metadata": {
        "noon": {
            "order_category": "applepay"
        }
    },
    "payment_link": true,
    "return_url": "http://127.0.0.1:5500/src/pl_iframe.html",
    "payment_link_config": {
        "theme": "#14356f",
        "logo": "https://logosandtypes.com/wp-content/uploads/2020/08/zurich.svg",
        "seller_name": "Zurich Inc.",
        "is_setup_mandate_flow": true
    },
    "metadata": {
        "udf1": "value1",
        "new_customer": "true",
        "login_date": "2019-09-10T10:11:12Z"
    },
    "customer_acceptance": null,
    "capture_method": "manual",
    "customer_id": "cus_CL6UOh3X35RCzaGNN24t"
}'

setup_mandate_flow with zero amount

curl --location 'http://localhost:8080/payments' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'api-key: dev_iwLbXyltixlkkaaEPH4Sa5HtJtXlDKZ9wOdiGGZV3RTDhgl24aD9lbghKEn9fz88' \
--data-raw '{
    "currency": "EUR",
    "amount": 0,
    "setup_future_usage": "off_session",
    "authentication_type": "three_ds",
    "description": "Joseph First Crypto",
    "email": "[email protected]",
    "connector_metadata": {
        "noon": {
            "order_category": "applepay"
        }
    },
    "payment_link": true,
    "return_url": "http://127.0.0.1:5500/src/pl_iframe.html",
    "payment_link_config": {
        "theme": "#14356f",
        "logo": "https://logosandtypes.com/wp-content/uploads/2020/08/zurich.svg",
        "seller_name": "Zurich Inc."
    },
    "metadata": {
        "udf1": "value1",
        "new_customer": "true",
        "login_date": "2019-09-10T10:11:12Z"
    },
    "customer_acceptance": null,
    "customer_id": "cus_CL6UOh3X35RCzaGNN24t"
}'

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]

Review changes with  

Changed Files

File	Status
crates/router/src/core/payment_link.rs	57% smaller
crates/router/src/core/payment_link/payment_link_initiate/payment_link.js	9% smaller
api-reference-v2/openapi_spec.json	0% smaller
api-reference/openapi_spec.json	0% smaller
crates/api_models/src/admin.rs	0% smaller
crates/api_models/src/payments.rs	0% smaller
crates/diesel_models/src/business_profile.rs	0% smaller
crates/diesel_models/src/payment_intent.rs	0% smaller
crates/hyperswitch_domain_models/src/lib.rs	0% smaller
crates/router/src/core/payment_link/locale.js	0% smaller
crates/router/src/core/payments/transformers.rs	0% smaller
crates/router/src/types/transformers.rs	0% smaller

[kashif-m]

Ideally we should compute in rust code and send the computed value to JS bro,

Let's refactor in the subsequent PR

[Junjun13910]

How to do it Adrian

…

On Fri, Apr 25, 2025 at 6:17 AM likhinbopanna ***@***.***> wrote: Merged #7574 <#7574> into main. — Reply to this email directly, view it on GitHub <#7574 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/BJVKREALZJFCMMUZQOBEVYD23IRT7AVCNFSM6AAAAABZKU33I2VHI2DSMVQWIX3LMV45UABCJFZXG5LFIV3GK3TUJZXXI2LGNFRWC5DJN5XDWMJXGQYDKNRQGEZDGOI> . You are receiving this because you commented.Message ID: ***@***.***>