> ## Documentation Index
> Fetch the complete documentation index at: https://www.cashfree.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# UPI App Priority Reordering

> Reorder UPI apps on the Cashfree checkout page to prioritise preferred apps such as GPay, PhonePe, or Paytm and improve UPI conversion for Indian shoppers.

UPI App Priority Reordering allows merchants to configure the order in which UPI apps are displayed on the checkout page. By controlling the display order, merchants can prioritise apps that align with business preferences or customer behaviour and drive higher conversion rates.

## Platform behaviour

The display and ordering of UPI apps vary by platform; SDK (Android or iOS) and mobile web each apply different rules.

### SDK (Android or iOS)

For mobile SDK integrations, UPI apps are displayed based on:

* **Merchant-defined priority order**
* **App installation status** on the customer's device

Only **installed apps** are displayed. Among them, **display order follows the configured priority** (e.g. Google Pay, then PhonePe, then Paytm).

### MWeb

For MWeb integrations, UPI apps are displayed based on:

* **Top 3 display:** The top 3 apps from the configured priority list are always displayed.
* **Universal access:** These apps are shown irrespective of whether they are installed on the device.
* **iOS MWeb:** The full list of PSPs is shown according to the configured priority order in **Pay via any**.

## Configuration methods

Merchants can configure UPI app priority using one of the following methods. If multiple configurations exist, precedence rules apply.

<CardGroup cols={2}>
  <Card title="Create Order API" icon="code" href="/api-reference/payments/latest/orders/create">
    Set priority per order via `order_meta`.
  </Card>

  <Card title="Merchant Dashboard" icon="sliders" href="/payments/checkout/bussiness-customisation#payment-apps-ordering">
    Configure the preferred top five UPI apps in one place.
  </Card>
</CardGroup>

### Create order API (highest precedence)

Set UPI app priority per order using the `order_meta` object in the [Create Order API](/api-reference/payments/latest/orders/create). The UPI app order can be customised per order.

### Create order API example

The following is an example of how to send UPI app priority in the Create Order API:

```json theme={"dark"}
{
  "order_meta": {
    "upi_app_priority": ["gpay", "phonepe", "paytm", "navi", "cred", "supermoney", "amazonpay", "bhim", "mobikwik", "airtel", "popclub", "kiwi"]
  }
}
```

### Merchant Dashboard

Configure the preferred top five UPI apps through the Cashfree Merchant Dashboard for a consistent experience across all transactions. See [payment apps ordering](/payments/checkout/bussiness-customisation#payment-apps-ordering) for configuration steps.

### Supported UPI apps

The following UPI apps can be included when configuring priority via the Dashboard or API:

* Google Pay
* PhonePe
* Navi
* BHIM
* Paytm
* CRED
* Amazon Pay
* MobiKwik
* Airtel Payments Bank
* Popclub
* Kiwi
* Supermoney

## Configuration precedence

If multiple configurations are present, the system applies them in the following order of priority:

<Steps>
  <Step title="Create Order API configuration">
    Highest precedence; overrides all other settings when present in the API call. See [Create Order API](/api-reference/payments/latest/orders/create).
  </Step>

  <Step title="Merchant Dashboard configuration">
    Used when no API-level configuration is sent for the order.
  </Step>

  <Step title="Cashfree default priority">
    Used when no custom configuration is set by the merchant.
  </Step>
</Steps>

<div class="hidden" data-table-of-contents="bottom">
  <p class="mt-4 font-medium flex items-center gap-2 related-docs-heading">
    <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" class="w-4 h-4">
      <path d="M3 4h7a2 2 0 0 1 2 2v13a2 2 0 0 0-2-2H3z" />

      <path d="M21 4h-7a2 2 0 0 0-2 2v13a2 2 0 0 1 2-2h7z" />
    </svg>

    <span>Related topics</span>
  </p>

  <ul>
    <li><a href="/api-reference/payments/latest/orders/create">Create Order API</a></li>
    <li><a href="/docs/payments/manage/payment-methods/upi">UPI Payment Methods</a></li>
    <li><a href="/payments/checkout/bussiness-customisation">Checkout Business Customisation</a></li>
  </ul>
</div>