OCC Integration Options | Cashfree Payments

Select the integration workflow for your platform to set up Cashfree One Click Checkout (OCC).

Shopify: Add One Click Checkout to your Shopify store with OTP sign-in, pre-filled address details, UPI and card payments, cash on delivery (COD), and abandoned cart recovery..
Custom website: Enable One Click Checkout on your existing Cashfree integration by extending the Create Order API and retrieving order details after payment.
Mobile app: Extend One Click Checkout to your Shopify mobile app using the native Cashfree extension in Appmaker.

Ensure the One Click Checkout product is activated. To activate it, Log in to the Merchant Dashboard and go to Payment Gateway > PG Products > One Click Checkout.

Shopify
Custom website
Mobile app

Complete setup in the following phases:

Phase	Description
Onboarding	Send your Shopify collaborator request code to the Cashfree team. You will receive an app installation link within 48 hours.
Installation	Install the Cashfree OCC app using the link, then connect it to your Merchant Dashboard.
Theme configuration	Add a Cashfree snippet to your `theme.liquid` file to activate the checkout experience.

Before launching, configure shipping rules, COD settings, discounts, and branding in the Merchant Dashboard.Follow these steps to onboard and activate One Click Checkout (OCC) on your Shopify store.

Prerequisites

Before proceeding with the installation, complete the following steps:

Complete the Cashfree support form or contact your account manager.
Create and share the collaborator request code. Use these steps:
1. Log in to your Shopify store using your admin credentials.
2. Navigate to Settings > Users and permissions.
3. Scroll down to the Collaborators section and copy the collaborator request code.
4. Share your Shopify store URL.
Within 48 hours, you receive an app installation link, dashboard details, and setup instructions from Cashfree at your registered email address.

Installation

To install the OCC app on Shopify:

Open the installation link, then Log in to Shopify to complete the installation.
Shopify redirects you to the Merchant Dashboard to finalise the installation.
To confirm the installation, check the installed apps in Shopify. The app should be listed as cashfree-occ-<brand>.
You can now access your One Click Checkout dashboard.

Configure theme

Follow these steps to configure checkout on Shopify:

Log in to Shopify using your credentials.
Navigate to Sales channels > Online Store > Themes.
Select the ellipsis (⋮) next to the live theme, then select Duplicate to create a copy.
Select the ellipsis (⋮) next to the duplicated theme, then select Edit code.
Search for and open the theme.liquid file.
Add the following code before the </head> tag:
```
{% render 'cashfree' %}
```
Select the ellipsis (⋮) next to the duplicated theme, then select Preview. Review and confirm the checkout.
Select Publish to set the updated theme as live.

To verify your configuration before launch, complete the Go Live Checklist.If you have questions about the Shopify integration, submit a request through the Cashfree support form.

Complete setup in the following phases:

Phase	Description
Create order	Add `products.one_click_checkout` and `cart_details` so the checkout session includes OCC features and cart line items.
Order details	After payment, call the Get Order Extended API for customer context, addresses, and applied offers.

You must have an existing Cashfree web or app checkout integration before enabling OCC. If you haven’t set one up, see Cashfree Checkout Integration Overview.

Before launching, validate Create Order payloads and extended order handling in Sandbox, then replicate the same configuration in Production.Follow these steps to add OCC fields to order creation and to retrieve extended order data after payment:

Add OCC parameters to the Create Order API request Include the following two additional objects in the Create Order API request:

products.one_click_checkout: Enables OCC and specifies which features to allow, such as address collection and authentication.
cart_details: Provides cart item information to populate the checkout summary.

Request sample

curl --location 'https://sandbox.cashfree.com/pg/orders' \
--header 'X-Client-Id: {{clientId}}' \
--header 'X-Client-Secret: {{clientSecret}}' \
--header 'x-api-version: 2025-01-01' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data '{
    "order_amount": 1,
    "order_currency": "INR",
    "customer_details": {
        "customer_id": "USER123",
        "customer_name": "Joe Smith",
        "customer_email": "joe.s@cashfree.com",
        "customer_phone": "+919999999999"
    },
    "order_meta": {
        "return_url": "https://yourwebsite.com/payment/return?order_id={order_id}"
    },
    "products": {
        "one_click_checkout": {
            "enabled": true,
            "conditions": [
               {
                   "action": "ALLOW",
                   "values": [
                       "checkoutCollectAddress",
                       "checkoutAuthenticate"
                   ],
                   "key": "features"
               }
           ]
        }
    },
    "cart_details": {
        "cart_items": [
            {
                "item_id": "cart_id_1",
                "item_name": "T Shirt",
                "item_description": "Test Description",
                "item_details_url": "https://example.com/product/t-shirt",
                "item_image_url": "https://example.com/product/t-shirt.jpg",
                "item_original_unit_price": 1,
                "item_discounted_unit_price": 1,
                "item_quantity": 1,
                "item_currency": "INR"
            }
        ]
    }
}'

In the example above, note the following key parameters:

products.one_click_checkout.enabled: Set to true to enable OCC.
conditions.values: Specify the features to allow, such as checkoutCollectAddress and checkoutAuthenticate.
cart_details.cart_items: Specify the product information to display in the checkout summary.

Retrieve extended order details Use the Get Order Extended API endpoint after payment to fetch OCC-specific data. The response includes:
- Customer details: Information about the logged-in user.
- Shipping and billing addresses: Recipient details collected during checkout.
- Applied offers: Discounts applied at the time of payment.
The customer_details object identifies the logged-in user who placed the order. The shipping_address object identifies the delivery recipient. These values may differ if the customer enters a different delivery address during checkout.

Complete setup in the following phases:

Phase	Description
Onboarding	Send your collaborator request code to the Cashfree team. You will receive an app installation link within 48 hours.
Installation	Install the Cashfree OCC app using the link, then connect it to your Merchant Dashboard.
Configuration	Set Environment to Production, save changes, and create a new app build so customers receive the updated checkout behaviour.

Before launching, confirm the Shopify OCC app is connected in the Merchant Dashboard and verify checkout in a staging build where possible.Follow these steps to install the extension, configure the Production environment, and create a new build:

In the Appmaker Dashboard, go to Extensions.
Search for and select Cashfree One Click Checkout.
Select Install and activate in the top-right corner.
Open the Settings tab and set Environment to Production.
Select Save Changes.
Create a new app build for the changes to take effect.

To track in-app purchase analytics, set up Firebase and install the Firebase Extension in Appmaker. See the Firebase Extension documentation for setup steps.

For more information, see the Appmaker documentation.

​Prerequisites

​Installation

​Configure theme

Prerequisites

Installation

Configure theme