🇮🇳India

Check the list of Payment Methods available on India

Payment Methods

Icon	payment_method	Name	Flow	Payment Type	Iframe supported
	UI	UPI	REDIRECT	BANK_DEPOSIT	No
	UIS	UPI Seamless	REDIRECT ONE_SHOT	BANK_DEPOSIT	Yes
	ICSH	iCash One	ONE_SHOT	VOUCHER WALLET	Yes

Use the Payment Methods Endpoint to retrieve the Payment Methods' types, logos and more details.

Fields required for the OneShot Experience

Field	Required?
Country	Yes
Amount	Yes
Payer[]	Yes
payment_method	Yes

Payer object requirements

Payment Method Name	document	email	first_name	last_name	phone
All	Yes	Yes	Yes	Yes	No

Other fields not in these lists are optional.

UPI

Request

{
    "invoice_id" : "{{invoiceId}}",
    "amount": "500",
    "country": "IN",
    "currency": "INR",
    "payment_method": "UI",
    "payer": {
        "document": "1233131313",
        "document_type": "ID",
        "first_name": "Rojit",
        "last_name": "Test",
        "phone": "91 2234567890",
        "email": "[email protected]"
    },
 
    "description": "test description",
    "client_ip": "123.123.123.123",
    "back_url": "https://www.lime-pay.com/deposit_cancelled",
    "success_url": "https://www.lime-pay.com/deposit_completed",
    "error_url": "https://www.lime-pay.com/deposit_error",
    "notification_url": "https://www.lime-pay.com/limepay/notify",
    "logo": "https://www.lime-pay.com/limepay.png",
    "test": false,
    "mobile": false,
    "language": "en"
}

Response

{
    "checkout_type": "ONE_SHOT",
    "redirect_url": "https://payment-stg.lime-pay.com/v1/checkout/eyJhbGciOiJIUzM4NCJ9.eyJqdGkiOiI1Njk4Mjg2NSIsImlhdCI6MTcxNDAwNDExMSwiZXhwIjoxNzE1MzAwMTExLCJsYW5ndWFnZSI6InB0In0.m_veUauWLd5oFp9vcVd6q7Sa-ou6__12U5LkqF5XdDm1r0-tonU83KmUJ15FTrcf/IN/UI/4731/10881",
    "iframe": true,
    "deposit_id": 301245385,
    "user_id": "11",
    "merchant_invoice_id": "postmanTest701370365",
    "payment_info": {
        "type": "VOUCHER",
        "payment_method": "UI",
        "payment_method_name": "UPI",
        "amount": 1000.00,
        "currency": "INR",
        "expiration_date": "2024-05-01 22:55:08",
        "created_at": "2024-04-25 00:15:08",
        "metadata": {}
    }
}

UPI Seamless

This method requires the field listed below to generate deposit successfully

The UPI Seamless payment method is only available using the OneShot integration as all fields must be sent.

Field	Required?
Country	Yes
Amount	Yes
Payer[]	Yes
payment_method	Yes
reported_info[].bank_account_number	Yes, see example below "bank_account_number"= VPA (UPI ID)

VPA is the technical term used for the identifier of the UPI Accounts, for UX and user-facing views, use “UPI ID” instead

VPA Regex: ^[a-zA-Z0-9._\-]{2,50}@[a-zA-Z]{2,50}$

Payer object requirements For UPI Seamless

Payment Method Name	document	email	first_name	last_name	phone
All	Yes	Yes	Yes	Yes	Yes

Request

{
    "invoice_id" : "{{invoiceId}}",
    "amount": "500",
    "country": "IN",
    "currency": "INR",
    "payer": {
        "document": "1233131313",
        "document_type": "ID",
        "first_name": "John",
        "last_name": "Doe",
        "phone": "91 2234567890",
        "email": "[email protected]"
    },
    "payment_method": "UIS",
    "reported_info": {
        "bank_account_number": "test@paymt"
    },
    "description": "test description",
    "client_ip": "123.123.123.123",
    "back_url": "https://www.lime-pay.com/deposit_cancelled",
    "success_url": "https://www.lime-pay.com/deposit_completed",
    "error_url": "https://www.lime-pay.com/deposit_error",
    "notification_url": "https://www.lime-pay.com/limepay/notify",
    "logo": "https://www.lime-pay.com/limepay.png",
    "test": true,
    "mobile": false,
    "language": "en"
}

Response

{
    "checkout_type": "ONE_SHOT",
    "redirect_url": "https://payment.lime-pay.com/v1/checkout/eyJhbGciOiJIUzM4NCJ9.eyJqdGkiOiI4MzMyMzY5NzAiLCJpYXQiOjE3MTM5NTc1OTUsImV4cCI6MTcxNTI1MzU5NSwibGFuZ3VhZ2UiOiJwdCJ9.7URAL4pNP8ARSoBiBJJe0dknC6US2LXra6Q6ginDtH1AZLnsCfOQsPQA-133rtFP/IN/UIS/8261/4",
    "iframe": true,
    "deposit_id": 991814322,
    "merchant_invoice_id": "postmanTest934792442",
    "payment_info": {
        "type": "VOUCHER",
        "payment_method": "UIS",
        "payment_method_name": "UPI Seamless",
        "amount": 500.00,
        "currency": "INR",
        "expiration_date": "2024-04-25 11:19:51",
        "created_at": "2024-04-24 11:19:51",
        "metadata": {
            "qr_code": "data:image/png;base64,encodedimage",
            "provider_link": "upi://pay?pa=paymentdata"
        }
    }

For Customizeable UPI Seamless checkout, Kindly ensure that both the qr_code and provider_link is displayed on the checkout. The provider_link is the intent button that allows end-users make payment right from any of their mobile app. The provider_link is a deep link, therefore, make sure to open it outside of any containers/mobile apps.

UPI Seamless checkout.

iCash One

ICash supports both wallet (balance-based) and voucher (prepaid code) modes in India.

Required Fields

Field	Type	Required
country	string	Yes
amount	number	Yes
payment_method	string	Yes
payer[email]	string	Yes
payer[phone]	string	Yes

Request Example

{
  "country": "IN",
  "amount": 1000,
  "currency": "INR",
  "payment_method": "ICSH",
  "invoice_id": "INV-001",
  "payer": {
    "email": "[email protected]",
    "phone": "919876543210"
  }
}

Response Example

{
  "checkout_type": "ONE_SHOT",
  "redirect_url": "https://payment.checkoutogate.com/v1/checkout/...",
  "iframe": true,
  "deposit_id": 1597517845,
  "invoice_id": "INV-001",
  "payment_info": {
    "type": "VOUCHER",
    "payment_method": "ICSH",
    "payment_method_name": "ICash",
    "amount": 1000,
    "currency": "INR",
    "expiration_date": "2026-06-18 21:36:50",
    "created_at": "2026-06-18 09:36:50",
    "metadata": {
      "qr_code": "data:image/png;base64,...",
      "provider_link": "https://payments.lime-pay.com/deposit/..."
    }
  }
}

Both the qr_code and provider_link should be displayed on the checkout. The provider_link opens the iCash app or web flow to complete the payment.

---

Discover the Payment Flows Behind Our Top Methods! 🚀

UPI Seamless Flow