> ## Documentation Index
> Fetch the complete documentation index at: https://razorpay-60c89f9a-mintlify-audit-missing-sections-1778528421.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom Checkout Parameters

> Given below are the checkout parameters that you must pass in the `razorpay.js` file.

## Default Parameters

`key` *mandatory*
: `string` API Key ID generated from **Dashboard** → **Account & Settings** → [API Keys](/payments/dashboard/account-settings/api-keys#generate-api-keys).

`amount` *mandatory*
: `integer` The amount to be paid by the customer in currency subunits. For example, if the amount is 100, enter `10000`. In the case of three decimal currencies, such as KWD, BHD and OMR, to accept a payment of 295.991, pass the value as 295990. And in the case of zero decimal currencies such as JPY, to accept a payment of 295, pass the value as 295.

<Warning>
  **Watch Out!**

  As per payment guidelines, you should pass the last decimal number as 0 for three decimal currency payments. For example, if you want to charge a customer 99.991 KD for a transaction, you should pass the value for the amount parameter as `99990` and not `99991`.

  `currency` *mandatory*
  : `string` The currency in which the payment should be made by the customer. For example, `INR`. See the list of [supported currencies](/payments/international-payments#supported-currencies).

  <Info>
    **Handy Tips**
  </Info>

  Razorpay has added support for zero decimal currencies, such as JPY, and three decimal currencies, such as KWD, BHD, and OMR, allowing businesses to accept international payments in these currencies. Know more about [Currency Conversion](/payments/international-payments/currency-conversion) (May 2024).

  `description` *optional*
  : `string` Description of the product shown in the Checkout form. It must start with an alphanumeric character.

  `image` *optional*
  : `string` Link to an image (usually your business logo) shown in the Checkout form. Can also be a **base64** string, if loading the image from a network is not desirable.

  `order_id` *mandatory*
  : `string` Order ID generated via the [Orders API](/api/orders).

  `notes` *optional*
  : `object` Set of key-value pairs that can be used to store additional information about the payment. It can hold a maximum of 15 key-value pairs, each 256 characters long (maximum).

  `method` *mandatory*
  : `string` The payment method used by the customer on Checkout.
  Possible values:

  * `card` (default)
  * `upi` (default)
  * `netbanking` (default)
  * `wallet` (default)
  * `emi` (default)
  * `cardless_emi` (requires [approval](https://razorpay.com/support/#request))
  * `paylater` (requires [approval](https://razorpay.com/support/#request))
  * `emandate` (requires [approval](https://razorpay.com/support/#request))

  `card` *mandatory if method=card/emi*
  : `object` The details of the card that should be entered while making the payment.

  `number`
  : `integer` Unformatted card number.

  `name`
  : `string` The name of the cardholder.

  `expiry_month`
  : `integer` Expiry month for card in MM format.

  `expiry_year`
  : `integer` Expiry year for card in YY format.

  `cvv`
  : `integer` CVV printed on the back of the card.

  <Info>
    **Handy Tips**
  </Info>

  * CVV is not required by default for tokenised cards across all networks.
  * CVV is optional for tokenised card payments. Do not pass dummy CVV values.
  * To implement this change, skip passing the `cvv` parameter entirely, or pass a `null` or empty value in the CVV field.
  * We recommend removing the CVV field from your checkout UI/UX for tokenised cards.
  * If CVV is still collected for tokenised cards and the customer enters a CVV, pass the entered CVV value to Razorpay.

    `emi_duration`
    : `integer` Defines the number of months in the EMI plan.

  `bank_account` *mandatory if method=emandate*
  : The details of the bank account that should be passed in the request. These details include bank account number, IFSC code and the name of the customer associated with the bank account.

  `account_number`
  : `string` Bank account number used to initiate the payment.

  `ifsc`
  : `string` IFSC of the bank used to initiate the payment.

  `name`
  : `string` Name associated with the bank account used to initiate the payment.

  `bank` *mandatory if method=netbanking*
  : `string` Bank code. List of available banks enabled for your account can be fetched via [**methods**](/payments/payment-gateway/web-integration/custom/payment-methods#fetch-supported-methods).

  `wallet` *mandatory if method=wallet*
  : `string` Wallet code for the wallet used for the payment. Possible values:

  * `payzapp` (default)
  * `olamoney` (requires [approval](https://razorpay.com/support/#request))
  * `phonepe` (requires [approval](https://razorpay.com/support/#request))
  * `airtelmoney` (requires [approval](https://razorpay.com/support/#request))
  * `mobikwik` (requires [approval](https://razorpay.com/support/#request))
  * `jiomoney` (requires [approval](https://razorpay.com/support/#request))
  * `amazonpay` (requires [approval](https://razorpay.com/support/#request))
  * `paypal` (requires [approval](https://razorpay.com/support/#request))
  * `phonepeswitch` (requires [approval](https://razorpay.com/support/#request))

  `provider` *mandatory if method=cardless\_emi/paylater*
  : `string`  Name of the cardless EMI provider partnered with Razorpay.

  Available options for Cardless EMI (requires [approval](https://razorpay.com/support/#request)):

  * `hdfc`
  * `icic`
  * `idfb`
  * `kkbk`
  * `zestmoney`
  * `earlysalary`
  * `walnut369`

  Available options for Pay Later:

  * `lazypay`
  * `paypal`

  `vpa` *mandatory if method=upi*
  : `string`  UPI ID used for making the payment on the UPI app.
</Warning>

<Warning>
  **Deprecation Notice**

  UPI Collect is deprecated effective 28 February 2026. This tab is applicable only for exempted businesses. If you are not covered by the exemptions, refer to the [migration documentation](/announcements/upi-collect-migration/custom-integration) to switch to UPI Intent.

  `callback_url` *optional*
  : `string` The URL to which the customer must be redirected upon completion of payment. The URL must accept incoming `POST` requests. The callback URL will have `razorpay_payment_id`, `razorpay_order_id` and `razorpay_signature` as the request parameters for a successful payment.

  `redirect` *conditionally mandatory*
  : `boolean` Determines whether customer should be redirected to the URL mentioned in the
  `callback_url` parameter. This is mandatory if `callback_url` parameter is used. Possible values:

  * `true`: Customer will be redirected to the `callback_url`.
  * `false`: Customer will not be redirected to the `callback_url`
</Warning>

## Offers Parameters

Pass these parameters to send offer details to Google.

`additional_info`
: `object` Offer details.

`displayItems` *mandatory*
: `array` Used to display the shopping cart information. Possible values:

* `type`: For example, `SUBTOTAL`.
* `price`: For example, `20.00`.

`offerInfo` *mandatory*
: `object` Used to share information regarding the offer.

`offers` *mandatory*
: `array` Detailed information about the offer.

`redemptionCode` *mandatory*
: `string` The discount code used by the customer. For example, `DISCOUNT10`.