feat(connector): Implement Razorpay UPI Collect by swangi-kumari · Pull Request #8009 · juspay/hyperswitch

swangi-kumari · 2025-05-13T05:56:28Z

Type of Change

Description

Integrate Razorpay's API directly
Payment Method - UPI Collect
Added a new flow create order
Added connector_request_reference_id in payment_attempt

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?

Using v2 API

Create Organisation
Create Merchant Account
Create Business Profile
Create API KEY
Create Razorpay Connector

curl --location 'http://localhost:8080/v2/connector-accounts' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'x-merchant-id: cloth_seller_LfNJ6bMzJarkrh2kCGbu' \
--header 'x-profile-id: pro_Y7riw0Lyz8GF7ZV778Pj' \
--header 'Authorization: admin-api-key=test_admin' \
--data '{
    "connector_type": "payment_processor",
    "connector_name": "razorpay",
     "connector_account_details": {
        "auth_type": "BodyKey",
        "api_key": "_",
        "key1": "_"
    },

    
    "disabled": false,
    "payment_methods_enabled": [
        {
            "payment_method_type": "upi",
            "payment_method_subtypes": [
                {
                    "payment_method_subtype": "upi_collect",
                    "payment_experience": "redirect_to_url",
                    "card_networks": null,
                    "accepted_currencies": {
                        "type" : "enable_only",
                        "list": ["INR"]
                    },
                    "accepted_countries": {
                        "type" : "enable_only",
                        "list": ["IN"]
                    },
                    "minimum_amount": 1,
                    "maximum_amount": 68607706,
                    "recurring_enabled": true,
                    "installment_payment_enabled": true
                }
            ]
        }
    ],
    "metadata": {
        "city": "NY",
        "unit": "245"
    },
    "profile_id": "pro_Y7riw0Lyz8GF7ZV778Pj" 
}'

Create UPI collect Payment

curl --location 'http://localhost:8080/v2/payments' \
--header 'api-key: _' \
--header 'Content-Type: application/json' \
--header 'x-profile-id: pro_Y7riw0Lyz8GF7ZV778Pj' \
--header 'Authorization: api-key=_' \
--data-raw '{
    "amount_details": {
        "order_amount": 100,
        "currency": "INR"
    },
    "capture_method":"automatic",
    "description": "Its my first payment request",
    "authentication_type": "no_three_ds",
    "return_url": "https://google.com",
    "payment_method_data": {
        "upi": {
            "upi_collect": {
                "vpa_id": "success@razorpay"
            }
        },
        "billing": {
            "address": {
                "line1": "1467",
                "line2": "Harrison Street",
                "line3": "Harrison Street",
                "city": "San Fransico",
                "state": "California",
                "zip": "94122",
                "country": "IN",
                "first_name": "Swangi",
                "last_name": "Kumari"
            },
            "phone": {
                "number": "8056594427",
                "country_code": "+91"
            },
            "email": "swangi.kumari@juspay.in"
        }
    },
    "payment_method_subtype": "upi_collect",
    "payment_method_type": "upi"
}'

Response

    "id": "12345_pay_0197345f8a97773399963e3616993a6d",
    "status": "requires_customer_action",
    "amount": {
        "order_amount": 100,
        "currency": "INR",
        "shipping_cost": null,
        "order_tax_amount": null,
        "external_tax_calculation": "skip",
        "surcharge_calculation": "skip",
        "surcharge_amount": null,
        "tax_on_surcharge": null,
        "net_amount": 100,
        "amount_to_capture": null,
        "amount_capturable": 0,
        "amount_captured": null
    },
    "customer_id": null,
    "connector": "razorpay",
    "created": "2025-06-03T05:59:26.106Z",
    "payment_method_data": {
        "billing": {
            "address": {
                "city": "San Fransico",
                "country": "IN",
                "line1": "1467",
                "line2": "Harrison Street",
                "line3": "Harrison Street",
                "zip": "94122",
                "state": "California",
                "first_name": "Swangi",
                "last_name": "Kumari"
            },
            "phone": {
                "number": "8056594427",
                "country_code": "+91"
            },
            "email": "swangi.kumari@juspay.in"
        }
    },
    "payment_method_type": "upi",
    "payment_method_subtype": "upi_collect",
    "connector_transaction_id": "pay_QccH6k6FydAlRu",
    "connector_reference_id": null,
    "merchant_connector_id": "mca_KPn3O1yDpcEjAQuGkKyY",
    "browser_info": null,
    "error": null,
    "shipping": null,
    "billing": null,
    "attempts": null,
    "connector_token_details": null,
    "payment_method_id": null,
    "next_action": {
        "type": "wait_screen_information",
        "display_from_timestamp": 1748930369789539000,
        "display_to_timestamp": 1748930669789539000,
        "poll_config": {
            "delay_in_secs": 5,
            "frequency": 5
        }
    },
    "return_url": "https://google.com/",
    "authentication_type": "no_three_ds",
    "authentication_type_applied": "no_three_ds",
    "is_iframe_redirection_enabled": null
}

Psync

curl --location 'http://localhost:8080/v2/payments/12345_pay_0197345f8a97773399963e3616993a6d?force_sync=true' \
--header 'x-profile-id: pro_Y7riw0Lyz8GF7ZV778Pj' \
--header 'Authorization: api-key=_' \
--data ''

Response

{
    "id": "12345_pay_019734579f437140a230d7387ea89411",
    "status": "succeeded",
    "amount": {
        "order_amount": 100,
        "currency": "INR",
        "shipping_cost": null,
        "order_tax_amount": null,
        "external_tax_calculation": "skip",
        "surcharge_calculation": "skip",
        "surcharge_amount": null,
        "tax_on_surcharge": null,
        "net_amount": 100,
        "amount_to_capture": null,
        "amount_capturable": 0,
        "amount_captured": 100
    },
    "customer_id": "12345_cus_0197345793f67342a629d92ff75da55f",
    "connector": "razorpay",
    "created": "2025-06-03T05:50:47.108Z",
    "payment_method_data": {
        "billing": {
            "address": {
                "city": "San Fransico",
                "country": "IN",
                "line1": "1467",
                "line2": "Harrison Street",
                "line3": "Harrison Street",
                "zip": "94122",
                "state": "California",
                "first_name": "Swangi",
                "last_name": "Kumari"
            },
            "phone": {
                "number": "8056594427",
                "country_code": "+91"
            },
            "email": "swangi.kumari@juspay.in"
        }
    },
    "payment_method_type": "upi",
    "payment_method_subtype": "upi_collect",
    "connector_transaction_id": "pay_Qcc7y4GnfJNdkS",
    "connector_reference_id": null,
    "merchant_connector_id": "mca_KPn3O1yDpcEjAQuGkKyY",
    "browser_info": null,
    "error": null,
    "shipping": null,
    "billing": null,
    "attempts": null,
    "connector_token_details": null,
    "payment_method_id": null,
    "next_action": null,
    "return_url": "https://google.com/",
    "authentication_type": "no_three_ds",
    "authentication_type_applied": null,
    "is_iframe_redirection_enabled": null
}

Create a Refund

curl --location 'http://localhost:8080/v2/refunds' \
--header 'x-profile-id: pro_Y7riw0Lyz8GF7ZV778Pj' \
--header 'Authorization: api-key=_' \
--header 'Content-Type: application/json' \
--header 'api-key: _' \
--data '{
  "payment_id": "12345_pay_0197346a13577d61a3a4e95699d565c1",
  "merchant_reference_id": "customer_1748931028",
  "amount": 100,
  "reason": "Customer returned product",
  "refund_type": "instant",
  "metadata": {
    "udf1": "value1",
    "new_customer": "true",
    "login_date": "2019-09-10T10:11:12Z"
  }
}'

Response

{
    "id": "12345_ref_0197346a6f2f7093a446ec2609b2d58e",
    "payment_id": "12345_pay_0197346a13577d61a3a4e95699d565c1",
    "merchant_reference_id": "customer_1748931028",
    "amount": 100,
    "currency": "INR",
    "status": "pending",
    "reason": "Customer returned product",
    "metadata": {
        "udf1": "value1",
        "new_customer": "true",
        "login_date": "2019-09-10T10:11:12Z"
    },
    "error_details": {
        "code": "",
        "message": ""
    },
    "created_at": "2025-06-03T06:11:20.007Z",
    "updated_at": "2025-06-03T06:11:22.283Z",
    "connector": "razorpay",
    "profile_id": "pro_Y7riw0Lyz8GF7ZV778Pj",
    "merchant_connector_id": "mca_KPn3O1yDpcEjAQuGkKyY",
    "connector_refund_reference_id": null
}

Refund Sync

curl --location 'http://localhost:8080/v2/refunds/12345_ref_0197346a6f2f7093a446ec2609b2d58e' \
--header 'Authorization: api-key=_' \
--header 'X-Profile-Id: pro_Y7riw0Lyz8GF7ZV778Pj' \
--header 'api-key: _'

Response

{
    "id": "12345_ref_0197346a6f2f7093a446ec2609b2d58e",
    "payment_id": "12345_pay_0197346a13577d61a3a4e95699d565c1",
    "merchant_reference_id": "customer_1748931028",
    "amount": 100,
    "currency": "INR",
    "status": "succeeded",
    "reason": "Customer returned product",
    "metadata": {
        "udf1": "value1",
        "new_customer": "true",
        "login_date": "2019-09-10T10:11:12Z"
    },
    "error_details": {
        "code": "",
        "message": ""
    },
    "created_at": "2025-06-03T06:11:20.007Z",
    "updated_at": "2025-06-03T06:13:40.875Z",
    "connector": "razorpay",
    "profile_id": "pro_Y7riw0Lyz8GF7ZV778Pj",
    "merchant_connector_id": "mca_KPn3O1yDpcEjAQuGkKyY",
    "connector_refund_reference_id": null
}

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-05-13T05:56:31Z

Review changes with

Changed Files

File	Status
crates/router/src/types/api/payments.rs	85% smaller
crates/hyperswitch_interfaces/src/types.rs	83% smaller
crates/hyperswitch_connectors/src/types.rs	80% smaller
crates/hyperswitch_domain_models/src/types.rs	79% smaller
crates/hyperswitch_connectors/src/default_implementations_v2.rs	77% smaller
crates/payment_methods/src/configs/payment_connector_required_fields.rs	73% smaller
crates/hyperswitch_interfaces/src/api/payments.rs	70% smaller
crates/hyperswitch_interfaces/src/api/payments_v2.rs	58% smaller
crates/hyperswitch_connectors/src/connectors/adyen/transformers.rs	56% smaller
crates/openapi/src/openapi.rs	41% smaller
crates/openapi/src/openapi_v2.rs	41% smaller
crates/router/src/types.rs	30% smaller
crates/hyperswitch_connectors/src/connectors/razorpay.rs	22% smaller
crates/router/src/core/payments/transformers.rs	18% smaller
crates/hyperswitch_connectors/src/connectors/razorpay/transformers.rs	7% smaller
crates/hyperswitch_connectors/src/default_implementations.rs	4% smaller
crates/router/src/core/payments/operations/payment_confirm_intent.rs	1% smaller
api-reference-v2/openapi_spec.json	0% smaller
api-reference/openapi_spec.json	0% smaller
config/config.example.toml	Unsupported file format
config/deployments/integration_test.toml	Unsupported file format
config/deployments/production.toml	Unsupported file format
config/deployments/sandbox.toml	Unsupported file format
config/development.toml	Unsupported file format
config/docker_compose.toml	Unsupported file format
config/payment_required_fields_v2.toml	Unsupported file format
crates/api_models/src/payments.rs	0% smaller
crates/common_enums/src/connector_enums.rs	0% smaller
crates/diesel_models/src/payment_attempt.rs	0% smaller
crates/diesel_models/src/schema_v2.rs	0% smaller
crates/hyperswitch_connectors/src/utils.rs	0% smaller
crates/hyperswitch_domain_models/src/payments/payment_attempt.rs	0% smaller
crates/hyperswitch_domain_models/src/router_data.rs	0% smaller
crates/hyperswitch_domain_models/src/router_flow_types/payments.rs	0% smaller
crates/hyperswitch_domain_models/src/router_request_types.rs	0% smaller
crates/hyperswitch_domain_models/src/router_response_types.rs	0% smaller
crates/hyperswitch_interfaces/src/api.rs	0% smaller
crates/hyperswitch_interfaces/src/connector_integration_interface.rs	Unsupported file format
crates/router/src/compatibility/stripe/payment_intents/types.rs	0% smaller
crates/router/src/compatibility/stripe/setup_intents/types.rs	0% smaller
crates/router/src/core/payments.rs	0% smaller
crates/router/src/core/payments/flows.rs	0% smaller
crates/router/src/core/payments/flows/authorize_flow.rs	0% smaller
crates/router/src/core/payments/operations/payment_response.rs	0% smaller
crates/router/src/core/payments/operations/proxy_payments_intent.rs	0% smaller
crates/router/src/types/api/verify_connector.rs	0% smaller
crates/router/tests/connectors/utils.rs	0% smaller
loadtest/config/development.toml	Unsupported file format
v2_migrations/2025-05-30-103514_add_connector_request_reference_id_in_payment_attempt/down.sql	Unsupported file format
v2_migrations/2025-05-30-103514_add_connector_request_reference_id_in_payment_attempt/up.sql	Unsupported file format

crates/hyperswitch_connectors/src/utils.rs

crates/hyperswitch_connectors/src/connectors/razorpay/transformers.rs

config/deployments/production.toml

crates/hyperswitch_connectors/src/utils.rs

crates/router/src/core/payments/flows/authorize_flow.rs

crates/router/src/core/payments/flows.rs

crates/hyperswitch_connectors/src/connectors/razorpay/transformers.rs

crates/api_models/src/payments.rs

crates/common_enums/src/connector_enums.rs

crates/router/src/core/payments/transformers.rs

v2_migrations/2025-05-30-103514_add_connector_request_reference_id_in_payment_attempt/up.sql

crates/router/src/core/payments/flows/authorize_flow.rs

crates/router/src/core/payments.rs

crates/router/src/core/payments/flows/authorize_flow.rs

crates/api_models/src/payments.rs

crates/hyperswitch_connectors/src/connectors/razorpay.rs

crates/hyperswitch_connectors/src/connectors/razorpay/transformers.rs

crates/payment_methods/src/configs/payment_connector_required_fields.rs

deepanshu-iiitu

Connector changes look good.

Co-authored-by: Aishwariyaa Anand <aishwariyaa.anand@Aishwariyaa-Anand-C3PGW02T6Y.local> Co-authored-by: Aishwariyaa Anand <124241367+Aishwariyaa-Anand@users.noreply.github.com> Co-authored-by: hyperswitch-bot[bot] <148525504+hyperswitch-bot[bot]@users.noreply.github.com>

feat: razorpay-upi

8da90c0

swangi-kumari self-assigned this May 13, 2025

swangi-kumari added the A-connector-integration Area: Connector integration label May 13, 2025

feat: comment webhook code

f1117fe

swangi-kumari marked this pull request as ready for review May 13, 2025 13:25

swangi-kumari requested review from a team as code owners May 13, 2025 13:25

swangi-kumari added 3 commits May 13, 2025 19:32

refactor: fix

49c1723

refactor: remove println

a9b8785

refactor: remove unnecessary comments

3fb7c21

deepanshu-iiitu requested changes May 14, 2025

View reviewed changes

swangi-kumari changed the title ~~feat(connector): Implement Razorpay UPI Intent~~ feat(connector): Implement Razorpay UPI Collect May 14, 2025

refactor: required fields

60a9a1b

swangi-kumari requested a review from a team as a code owner May 14, 2025 17:26

feat: add CreateOrder flow

9ba5f8f

Aishwariyaa-Anand requested a review from a team as a code owner May 20, 2025 14:02

swangi-kumari assigned Aishwariyaa-Anand May 21, 2025

Aishwariyaa-Anand and others added 3 commits May 21, 2025 18:15

Merge branch 'main' into razorpay-upi

198838c

chore: run formatter

798d122

feat: add CreateOrder for v1

caa1035

sai-harsha-vardhan reviewed May 22, 2025

View reviewed changes

Aishwariyaa Anand and others added 5 commits May 23, 2025 18:37

reslove comments

d936c01

chore: run formatter

42be684

Merge branch 'main' into razorpay-upi

2f51bb7

fix ci checks

8108551

refactor: add wait screen and display connector error

8f80130

Aishwariyaa-Anand requested a review from a team as a code owner May 28, 2025 09:16

docs(openapi): re-generate OpenAPI specification

271622d

hyperswitch-bot bot added the M-database-changes Metadata: This PR involves database schema changes label Jun 2, 2025

refactor: get_billing_email

6543d87

sai-harsha-vardhan reviewed Jun 3, 2025

View reviewed changes

Aishwariyaa Anand and others added 4 commits June 3, 2025 17:27

apply suggestions

cf66933

chore: run formatter

179f446

fix: openapi changes

1ebef5b

generate openapi

049d344

sai-harsha-vardhan reviewed Jun 4, 2025

View reviewed changes

crates/router/src/core/payments/flows/authorize_flow.rs Outdated Show resolved Hide resolved

add connector error resp

e85677f

sai-harsha-vardhan reviewed Jun 4, 2025

View reviewed changes

crates/router/src/core/payments/flows/authorize_flow.rs Outdated Show resolved Hide resolved

crates/router/src/core/payments/flows/authorize_flow.rs Show resolved Hide resolved

Aishwariyaa-Anand and others added 2 commits June 5, 2025 12:09

Merge branch 'main' into razorpay-upi

2393bd0

add connector unexpected error

05bb06a

sai-harsha-vardhan reviewed Jun 6, 2025

View reviewed changes

crates/router/src/core/payments/flows/authorize_flow.rs Outdated Show resolved Hide resolved

crates/router/src/core/payments/flows/authorize_flow.rs Outdated Show resolved Hide resolved

refactor: connector response error

8dd7313

SanchithHegde reviewed Jun 9, 2025

View reviewed changes

sai-harsha-vardhan previously approved these changes Jun 9, 2025

View reviewed changes

apply suggestions

b96073a

Aishwariyaa-Anand dismissed sai-harsha-vardhan’s stale review via b96073a June 9, 2025 14:12

hyperswitch-bot bot and others added 2 commits June 9, 2025 14:17

docs(openapi): re-generate OpenAPI specification

83dc2bf

remove comment

63a2767

SanchithHegde approved these changes Jun 9, 2025

View reviewed changes

tsdk02 approved these changes Jun 9, 2025

View reviewed changes

Sakilmostak approved these changes Jun 10, 2025

View reviewed changes

sai-harsha-vardhan approved these changes Jun 10, 2025

View reviewed changes

deepanshu-iiitu approved these changes Jun 10, 2025

View reviewed changes

likhinbopanna added this pull request to the merge queue Jun 11, 2025

Merged via the queue into main with commit ee7bce0 Jun 11, 2025
23 of 28 checks passed

likhinbopanna deleted the razorpay-upi branch June 11, 2025 14:05

Conversation

swangi-kumari commented May 13, 2025 • edited by Aishwariyaa-Anand 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 May 13, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

deepanshu-iiitu left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

8 participants

swangi-kumari commented May 13, 2025 •

edited by Aishwariyaa-Anand

Loading

semanticdiff-com bot commented May 13, 2025 •

edited

Loading