---
title: "UPI iOS Drop-in"
description: "Add UPI to your Drop-in integration."
url: "https://docs.adyen.com/payment-methods/upi/ios-drop-in"
source_url: "https://docs.adyen.com/payment-methods/upi/ios-drop-in.md"
canonical: "https://docs.adyen.com/payment-methods/upi/ios-drop-in"
last_modified: "2026-06-01T15:33:15+02:00"
language: "en"
---

# UPI iOS Drop-in

Add UPI to your Drop-in integration.

[View source](/payment-methods/upi/ios-drop-in.md)

You can add UPI to your existing integration. The following instructions show only what you must add to your integration specifically for UPI.

If an instruction on this page corresponds with a step in the main integration guide, it includes a link to that corresponding step of the main integration guide.

What you must add to your integration depends on the [server-side flow](/online-payments/build-your-integration) that your integration uses:

## Sessions flow Drop-in

### Drop-In-Before-You-Begin

## Requirements

| Requirement          | Description                                                                                                                                                                                                                                                                       |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Integration type** | Make sure that you have an existing Sessions flow [Drop-in integration](/online-payments/build-your-integration/sessions-flow?platform=iOS\&integration=Drop-in). Required version of [Checkout API](https://docs.adyen.com/api-explorer/Checkout/latest/overview): v68 or later. |
| **Setup steps**      | Before you begin, [add UPI in your Customer Area](/payment-methods/add-payment-methods).                                                                                                                                                                                          |

### Drop-In-Add-Parameters-Sessions-Request

## Add additional parameters to your /sessions request

You do not need to add any parameters when you [create a payment session](/online-payments/build-your-integration/sessions-flow?platform=iOS\&integration=Drop-in#create-a-payment-session).

### Drop-In-Add-Configuration

## Add additional configuration for UPI

You do not need to add any configuration parameters for UPI.

### Drop-In-Test-And-Go-Live

## Test and go live

Depending on your account setup, you may have access to the UPI simulator which you can use to test your UPI integration. Contact your Account Manager or our [Support Team](https://ca-test.adyen.com/ca/ca/contactUs/support.shtml?form=other) if you have questions about the simulator.

You can also use your personal account on a UPI app to test your integration by making live payments with a low value.

## Advanced flow Drop-in

### Drop-In-Requirements

## Requirements

| Requirement          | Description                                                                                                                                                                                                                   |   |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | - |
| **Integration type** | Make sure that you have an existing Advanced flow [iOS Drop-in integration](/online-payments/build-your-integration/advanced-flow?platform=iOS\&integration=Drop-in).                                                         |   |
| **Action handling**  | Make sure that your existing integration is set up to [handle the additional action](/online-payments/build-your-integration/advanced-flow/?platform=iOS\&integration=Drop-in#handle-the-redirect). `action.type`: **await**. |   |
| **Setup steps**      | Before you begin, [add UPI in your Customer Area](/payment-methods/add-payment-methods).                                                                                                                                      |   |

### Drop-In-Add-Configuration

## Add additional configuration for UPI

You do not need to add any configuration parameters for UPI.

### Drop-In-Add-Parameters-Payments-Request

## Add additional parameters to your /payments request

When you [make a payment](/online-payments/build-your-integration/advanced-flow/?platform=iOS\&integration=Drop-in#make-a-payment), add the following parameters:

| Parameter                                                                                                                             | Required                                                                                    | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |   |
| [paymentMethod.appId](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments#request-paymentMethod-UpiIntentDetails-appId) | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Required when the payment option is UPI Intent (`paymentMethod.type`: **upi\_intent**). The identifier of the Third Party Application Provider (TPAP) that the shopper uses to make the UPI payment. Possible values: - **gpay**: Google Pay - **phonepe**: PhonePe - **bhim**: BHIM (Bharat Interface for Money) - **paytm**: Paytm - **amazonpay**: Amazon Pay - **cred**: Cred - **wapay**: WhatsApp Pay - **jupiter**: Jupiter - **navi**: navi - **supermoney**: Super.money - **mobikwik**: MobiKwik - **freecharge**: Freecharge |

**Example request for UPI intent**

```bash
curl https://checkout-test.adyen.com/v72/payments \
-H "x-API-key: ADYEN_API_KEY" \
-H "content-type: application/json" \
-d '{
    "amount": {
        "currency": "INR",
        "value": 15100
    },
    "countryCode": "IN",
    "merchantAccount": "ADYEN_MERCHANT_ACCOUNT",
    "reference": "YOUR_ORDER_NUMBER",
    "paymentMethod": {
        "type": "upi_intent",
        "appId": "gpay"
    },
    "returnUrl": "https://your-company.example.com/checkout?shopperOrder=12xy.."
}'
```

### Drop-In-Test-And-Go-Live

## Test and go live

Depending on your account setup, you may have access to the UPI simulator which you can use to test your UPI integration. Contact your Account Manager or our [Support Team](https://ca-test.adyen.com/ca/ca/contactUs/support.shtml?form=other) if you have questions about the simulator.

You can also use your personal account on a UPI app to test your integration by making live payments with a low value.
