feat(klarna): Klarna Kustom Checkout Integration #6590

Sweta-Kumari-Sharma · 2024-11-18T05:56:59Z

Type of Change

Description

Klarna Kustom Checkout (KCO) integration

Klarna provides two payment methods:

Klarna Payments (for US)
Klarna Kustom Checkout (for EU)

Any one of the methods can be used at a time and switching between Klarna Payments and Klarna Checkout is been done. Based on the PML got, there will be a switching between Klarna Payments and Klarna Checkout.
The redirect_to_url link from response is used to complete the payment.

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?

I tested it using postman by hitting the required endpoints. Curl to the postman setup:

Create a Klarna Checkout Payment request

curl --location 'http://localhost:8080/payments' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'api-key: dev_Tw5q9rLr9TN5s9Gi18mLefH1vOyljW523KJll46A8sBLBuAQ3JloMx3gRUJ09PLh' \
--data-raw '{
    "amount": 50000,
    "order_tax_amount":0,
    "currency": "EUR",
    "amount_to_capture": 50000,
    "confirm": true,
    "payment_experience":"redirect_to_url",
    "profile_id": null,
    "capture_method": "automatic",
    "capture_on": "2022-09-10T10:11:12Z",
    "authentication_type": "no_three_ds", 
    "setup_future_usage":"on_session", 
    "customer": {
        "id": "customer123",
        "name": "John Doe",
        "email": "[email protected]",
        "phone": "9999999999",
        "phone_country_code": "+1"
    },
    "customer_id": "customer123",
    "phone_country_code": "+1",
    "routing": { 
        "type": "single",
        "data": "stripe"
    },
    "description": "Its my first payment request",
    "return_url": "https://google.com",
    "payment_method": "pay_later",
    "payment_method_type": "klarna",
    "payment_method_data": { 
        "pay_later": {
            "klarna_checkout":{}
        }
    },
    "billing": {
        "address": {
            "line1": "1467",
            "line2": "Harrison Street",
            "line3": "Harrison Street",
            "city": "San Fransico",
            "state": "California",
            "zip": "94122",
            "country": "FR",
            "first_name": "joseph",
            "last_name": "Doe"
        },
        "phone": {
            "number": "8056594427",
            "country_code": "+91"
        },
        "email": "[email protected]"
    },
    "shipping": {
        "address": {
            "line1": "1467",
            "line2": "Harrison Street",
            "line3": "Harrison Street",
            "city": "San Fransico",
            "state": "California",
            "zip": "94122",
            "country": "FR",
            "first_name": "joseph",
            "last_name": "Doe"
        },
        "phone": {
            "number": "8056594427",
            "country_code": "+91"
        },
        "email": "[email protected]"
    },
    "statement_descriptor_name": "joseph",
    "statement_descriptor_suffix": "JS",
    "order_details": [
        {
            "product_name": "Red T-Shirt",
            "quantity": 5,
            "amount": 10000,
            "account_name": "transaction_processing",
            "total_tax_amount": 0,
            "tax_rate": 0,
            "total_amount": 50000
        }
    ],
    "metadata": {
        "udf1": "value1",
        "new_customer": "true",
        "login_date": "2019-09-10T10:11:12Z"
    },
    "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": "128.0.0.1"
    },
    "customer_acceptance": {
        "acceptance_type": "offline",
        "accepted_at": "1963-05-03T04:07:52.723Z",
        "online": {
            "ip_address": "125.0.0.1",
            "user_agent": "amet irure esse"
        }
    },
     "connector_metadata": {
        "noon": {
            "order_category": "pay"
        }
    },
    "payment_link": false,
    "payment_link_config": {
        "theme": "",
        "logo": "",
        "seller_name": "",
        "sdk_layout": "",
        "display_sdk_only": false,
        "enabled_saved_payment_method": false
    },
    "payment_type": "normal", 
    "request_incremental_authorization": false,
    "merchant_order_reference_id": "test_ord"
}
'

Response:

{
    "payment_id": "pay_gfmNMqnpLfQD5sOsHuXP",
    "merchant_id": "merchant_1733394558",
    "status": "requires_customer_action",
    "amount": 50000,
    "net_amount": 50000,
    "shipping_cost": null,
    "amount_capturable": 50000,
    "amount_received": null,
    "connector": "klarna",
    "client_secret": "pay_gfmNMqnpLfQD5sOsHuXP_secret_Dnao3W7pFjLnzUNUE7jC",
    "created": "2024-12-05T12:09:36.687Z",
    "currency": "EUR",
    "customer_id": "customer123",
    "customer": {
        "id": "customer123",
        "name": "John Doe",
        "email": "[email protected]",
        "phone": "9999999999",
        "phone_country_code": "+1"
    },
    "description": "Its my first payment request",
    "refunds": null,
    "disputes": null,
    "mandate_id": null,
    "mandate_data": null,
    "setup_future_usage": "on_session",
    "off_session": null,
    "capture_on": null,
    "capture_method": "automatic",
    "payment_method": "pay_later",
    "payment_method_data": {
        "pay_later": {
            "klarna_sdk": null
        },
        "billing": null
    },
    "payment_token": null,
    "shipping": {
        "address": {
            "city": "San Fransico",
            "country": "FR",
            "line1": "1467",
            "line2": "Harrison Street",
            "line3": "Harrison Street",
            "zip": "94122",
            "state": "California",
            "first_name": "joseph",
            "last_name": "Doe"
        },
        "phone": {
            "number": "8056594427",
            "country_code": "+91"
        },
        "email": "[email protected]"
    },
    "billing": {
        "address": {
            "city": "San Fransico",
            "country": "FR",
            "line1": "1467",
            "line2": "Harrison Street",
            "line3": "Harrison Street",
            "zip": "94122",
            "state": "California",
            "first_name": "joseph",
            "last_name": "Doe"
        },
        "phone": {
            "number": "8056594427",
            "country_code": "+91"
        },
        "email": "[email protected]"
    },
    "order_details": [
        {
            "brand": null,
            "amount": 10000,
            "category": null,
            "quantity": 5,
            "tax_rate": 0.0,
            "product_id": null,
            "product_name": "Red T-Shirt",
            "product_type": null,
            "sub_category": null,
            "product_img_link": null,
            "product_tax_code": null,
            "total_tax_amount": 0,
            "requires_shipping": null
        }
    ],
    "email": "[email protected]",
    "name": "John Doe",
    "phone": "9999999999",
    "return_url": "https://google.com/",
    "authentication_type": "no_three_ds",
    "statement_descriptor_name": "joseph",
    "statement_descriptor_suffix": "JS",
    "next_action": {
        "type": "redirect_to_url",
        "redirect_to_url": "http://localhost:8080/payments/redirect/pay_gfmNMqnpLfQD5sOsHuXP/merchant_1733394558/pay_gfmNMqnpLfQD5sOsHuXP_1"
    },
    "cancellation_reason": null,
    "error_code": null,
    "error_message": null,
    "unified_code": null,
    "unified_message": null,
    "payment_experience": "redirect_to_url",
    "payment_method_type": "klarna",
    "connector_label": null,
    "business_country": null,
    "business_label": "default",
    "business_sub_label": null,
    "allowed_payment_method_types": null,
    "ephemeral_key": {
        "customer_id": "customer123",
        "created_at": 1733400576,
        "expires": 1733404176,
        "secret": "epk_846ab68c297146268aa71093512e5d35"
    },
    "manual_retry_allowed": null,
    "connector_transaction_id": "b0e6da80-167a-4957-ab2b-01775a0d593a",
    "frm_message": null,
    "metadata": {
        "udf1": "value1",
        "login_date": "2019-09-10T10:11:12Z",
        "new_customer": "true"
    },
    "connector_metadata": {
        "apple_pay": null,
        "airwallex": null,
        "noon": {
            "order_category": "pay"
        }
    },
    "feature_metadata": null,
    "reference_id": "b0e6da80-167a-4957-ab2b-01775a0d593a",
    "payment_link": null,
    "profile_id": "pro_Tmi8WDBIW8sD9MTC9xNk",
    "surcharge_details": null,
    "attempt_count": 1,
    "merchant_decision": null,
    "merchant_connector_id": "mca_IkU9e5hbkZIeqUUK4GR9",
    "incremental_authorization_allowed": false,
    "authorization_count": null,
    "incremental_authorizations": null,
    "external_authentication_details": null,
    "external_3ds_authentication_attempted": false,
    "expires_on": "2024-12-05T12:24:36.686Z",
    "fingerprint": null,
    "browser_info": {
        "language": "nl-NL",
        "time_zone": 0,
        "ip_address": "128.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": "2024-12-05T12:09:38.846Z",
    "charges": null,
    "frm_metadata": null,
    "merchant_order_reference_id": "test_ord",
    "order_tax_amount": 0,
    "connector_mandate_id": null
}

After completing the payment on clicking the redirect_url, PSync response is as follows:

Retrieve the payment details:

curl --location 'http://localhost:8080/payments/pay_gfmNMqnpLfQD5sOsHuXP?force_sync=true&expand_captures=true&expand_attempts=true' \
--header 'Accept: application/json' \
--header 'api-key: dev_p0hGvu5HDFg1SujZzgk306N282a6Q1ZIjWu9GwtLETMxhx6MO8Yg8z4oru5AQc3D'

Response:

{
    "payment_id": "pay_gfmNMqnpLfQD5sOsHuXP",
    "merchant_id": "merchant_1733394558",
    "status": "succeeded",
    "amount": 50000,
    "net_amount": 50000,
    "shipping_cost": null,
    "amount_capturable": 0,
    "amount_received": 50000,
    "connector": "klarna",
    "client_secret": "pay_gfmNMqnpLfQD5sOsHuXP_secret_Dnao3W7pFjLnzUNUE7jC",
    "created": "2024-12-05T12:09:36.687Z",
    "currency": "EUR",
    "customer_id": "customer123",
    "customer": {
        "id": "customer123",
        "name": "John Doe",
        "email": "[email protected]",
        "phone": "9999999999",
        "phone_country_code": "+1"
    },
    "description": "Its my first payment request",
    "refunds": null,
    "disputes": null,
    "attempts": [
        {
            "attempt_id": "pay_gfmNMqnpLfQD5sOsHuXP_1",
            "status": "authentication_pending",
            "amount": 50000,
            "order_tax_amount": 0,
            "currency": "EUR",
            "connector": "klarna",
            "error_message": null,
            "payment_method": "pay_later",
            "connector_transaction_id": "b0e6da80-167a-4957-ab2b-01775a0d593a",
            "capture_method": "automatic",
            "authentication_type": "no_three_ds",
            "created_at": "2024-12-05T12:09:36.691Z",
            "modified_at": "2024-12-05T12:09:38.882Z",
            "cancellation_reason": null,
            "mandate_id": null,
            "error_code": null,
            "payment_token": null,
            "connector_metadata": null,
            "payment_experience": "redirect_to_url",
            "payment_method_type": "klarna",
            "reference_id": "b0e6da80-167a-4957-ab2b-01775a0d593a",
            "unified_code": null,
            "unified_message": null,
            "client_source": null,
            "client_version": null
        }
    ],
    "mandate_id": null,
    "mandate_data": null,
    "setup_future_usage": "on_session",
    "off_session": null,
    "capture_on": null,
    "capture_method": "automatic",
    "payment_method": "pay_later",
    "payment_method_data": {
        "pay_later": {
            "klarna_sdk": null
        },
        "billing": null
    },
    "payment_token": null,
    "shipping": {
        "address": {
            "city": "San Fransico",
            "country": "FR",
            "line1": "1467",
            "line2": "Harrison Street",
            "line3": "Harrison Street",
            "zip": "94122",
            "state": "California",
            "first_name": "joseph",
            "last_name": "Doe"
        },
        "phone": {
            "number": "8056594427",
            "country_code": "+91"
        },
        "email": "[email protected]"
    },
    "billing": {
        "address": {
            "city": "San Fransico",
            "country": "FR",
            "line1": "1467",
            "line2": "Harrison Street",
            "line3": "Harrison Street",
            "zip": "94122",
            "state": "California",
            "first_name": "joseph",
            "last_name": "Doe"
        },
        "phone": {
            "number": "8056594427",
            "country_code": "+91"
        },
        "email": "[email protected]"
    },
    "order_details": [
        {
            "brand": null,
            "amount": 10000,
            "category": null,
            "quantity": 5,
            "tax_rate": 0.0,
            "product_id": null,
            "product_name": "Red T-Shirt",
            "product_type": null,
            "sub_category": null,
            "product_img_link": null,
            "product_tax_code": null,
            "total_tax_amount": 0,
            "requires_shipping": null
        }
    ],
    "email": "[email protected]",
    "name": "John Doe",
    "phone": "9999999999",
    "return_url": "https://google.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": "redirect_to_url",
    "payment_method_type": "klarna",
    "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": "b0e6da80-167a-4957-ab2b-01775a0d593a",
    "frm_message": null,
    "metadata": {
        "udf1": "value1",
        "login_date": "2019-09-10T10:11:12Z",
        "new_customer": "true"
    },
    "connector_metadata": {
        "apple_pay": null,
        "airwallex": null,
        "noon": {
            "order_category": "pay"
        }
    },
    "feature_metadata": null,
    "reference_id": "b0e6da80-167a-4957-ab2b-01775a0d593a",
    "payment_link": null,
    "profile_id": "pro_Tmi8WDBIW8sD9MTC9xNk",
    "surcharge_details": null,
    "attempt_count": 1,
    "merchant_decision": null,
    "merchant_connector_id": "mca_IkU9e5hbkZIeqUUK4GR9",
    "incremental_authorization_allowed": false,
    "authorization_count": null,
    "incremental_authorizations": null,
    "external_authentication_details": null,
    "external_3ds_authentication_attempted": false,
    "expires_on": "2024-12-05T12:24:36.686Z",
    "fingerprint": null,
    "browser_info": {
        "language": "nl-NL",
        "time_zone": 0,
        "ip_address": "128.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": "pm_pKepLJMVDByRvyUodc68",
    "payment_method_status": "inactive",
    "updated": "2024-12-05T12:11:45.997Z",
    "charges": null,
    "frm_metadata": null,
    "merchant_order_reference_id": "test_ord",
    "order_tax_amount": 0,
    "connector_mandate_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 · 2024-11-18T05:57:02Z

Review changes with

Changed Files

File	Status
crates/router/src/connector/adyen/transformers.rs	67% smaller
crates/hyperswitch_connectors/src/connectors/multisafepay/transformers.rs	61% smaller
crates/router/src/connector/klarna/transformers.rs	41% smaller
crates/router/src/connector/nuvei/transformers.rs	32% smaller
crates/hyperswitch_connectors/src/connectors/square/transformers.rs	32% smaller
crates/hyperswitch_connectors/src/connectors/zen/transformers.rs	32% smaller
crates/openapi/src/openapi.rs	29% smaller
crates/openapi/src/openapi_v2.rs	29% smaller
crates/router/src/connector/paypal/transformers.rs	27% smaller
crates/router/src/connector/stripe/transformers.rs	27% smaller
crates/router/src/core/payments/operations/payment_confirm.rs	10% smaller
crates/api_models/src/payments.rs	6% smaller
crates/router/src/connector/klarna.rs	2% smaller
api-reference-v2/openapi_spec.json	1% smaller
api-reference/openapi_spec.json	0% smaller
crates/diesel_models/src/payment_attempt.rs	0% smaller
crates/diesel_models/src/types.rs	0% smaller
crates/hyperswitch_connectors/src/utils.rs	0% smaller
crates/hyperswitch_domain_models/src/lib.rs	0% smaller
crates/hyperswitch_domain_models/src/payment_method_data.rs	0% smaller
crates/hyperswitch_domain_models/src/payments/payment_attempt.rs	0% smaller
crates/hyperswitch_domain_models/src/router_request_types.rs	0% smaller
crates/router/src/connector/utils.rs	0% smaller
crates/router/src/core/payments/helpers.rs	0% smaller
crates/router/src/core/payments/operations/payment_create.rs	0% smaller
crates/router/src/core/payments/retry.rs	0% smaller
crates/router/src/core/payments/transformers.rs	0% smaller
crates/router/src/types.rs	0% smaller
crates/router/src/types/api/verify_connector.rs	0% smaller
crates/router/src/types/storage/payment_attempt.rs	0% smaller
crates/router/src/types/transformers.rs	0% smaller
crates/router/tests/connectors/payme.rs	0% smaller
crates/router/tests/connectors/utils.rs	0% smaller
crates/router/tests/connectors/zen.rs	0% smaller
crates/storage_impl/src/mock_db/payment_attempt.rs	0% smaller
crates/storage_impl/src/payments/payment_attempt.rs	0% smaller

crates/hyperswitch_domain_models/src/router_data.rs

crates/hyperswitch_domain_models/src/router_request_types.rs

crates/api_models/src/payments.rs

crates/router/src/connector/klarna/transformers.rs

crates/router/src/core/payments/operations/payment_create.rs

crates/router/src/core/payments/operations/payment_confirm.rs

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

crates/hyperswitch_domain_models/src/router_data.rs

crates/router_derive/src/lib.rs

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

crates/router/src/core/payments/operations/payment_confirm.rs

apoorvdixit88

Dashboard specific changes look fine.

crates/router/src/core/payments/operations/payment_confirm.rs

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

Narayanbhat166 · 2024-12-16T10:59:18Z

crates/hyperswitch_domain_models/src/payments/payment_attempt.rs

@@ -451,6 +451,7 @@ pub struct PaymentAttempt {
    pub status: storage_enums::AttemptStatus,
    pub net_amount: NetAmount,
    pub currency: Option<storage_enums::Currency>,
+    pub order_tax_amount: Option<MinorUnit>,


please remove this from here, we already have this in the net_amount field

Narayanbhat166 · 2024-12-16T11:06:15Z

crates/hyperswitch_domain_models/src/payments/payment_attempt.rs

@@ -791,6 +793,7 @@ pub enum PaymentAttemptUpdate {
    },
    ConfirmUpdate {
        net_amount: NetAmount,
+        order_tax_amount: Option<MinorUnit>,


we should not get this separately, use the one available in net_amount

Sweta-Kumari-Sharma added 2 commits November 15, 2024 13:35

checkout authorization

4cf5860

kco

69023a3

Sweta-Kumari-Sharma requested review from a team as code owners November 18, 2024 05:56

Sweta-Kumari-Sharma self-assigned this Nov 18, 2024

Merge remote-tracking branch 'origin/main' into klarnaCheckout

2e58ec7

Sweta-Kumari-Sharma linked an issue Nov 18, 2024 that may be closed by this pull request

[FEATURE]: [KLARNA] Klarna Kustom Checkout Integration #6521

Closed

2 tasks

swangi-kumari added A-connector-integration Area: Connector integration A-core Area: Core flows C-feature Category: Feature request or enhancement labels Nov 18, 2024

Sweta-Kumari-Sharma and others added 2 commits November 19, 2024 01:13

bugs fixed

f34bc90

Merge branch 'main' into klarnaCheckout

162991c

Sweta-Kumari-Sharma changed the title ~~Klarna checkout~~ [FEATURE]: [KLARNA] Klarna Kustom Checkout Integration #6590 Nov 18, 2024

Sweta-Kumari-Sharma changed the title ~~[FEATURE]: [KLARNA] Klarna Kustom Checkout Integration #6590~~ [FEATURE]: [KLARNA] Klarna Kustom Checkout Integration Nov 18, 2024

failing checks fixed

9d34f0d

hyperswitch-bot bot added the M-api-contract-changes Metadata: This PR involves API contract changes label Nov 18, 2024

Sweta-Kumari-Sharma changed the title ~~[FEATURE]: [KLARNA] Klarna Kustom Checkout Integration~~ feat(klarna): Klarna Kustom Checkout Integration Nov 18, 2024

Sweta-Kumari-Sharma requested review from swangi-kumari and deepanshu-iiitu November 18, 2024 20:32