> ## Documentation Index
> Fetch the complete documentation index at: https://razorpay-881012b3.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Paytm Instant (beta)

> Add Paytm Instant (beta) as a payment provider on Optimizer.

<div style={{display:"flex",flexWrap:"wrap",alignItems:"center",gap:"0.35rem 0.9rem",border:"1px solid rgba(128,128,128,0.28)",borderRadius:"0.5rem",padding:"0.45rem 0.75rem",margin:"0 0 1.25rem",fontSize:"0.875rem"}}>
  <span style={{fontWeight:600}}>Available in</span>
  <span>🇮🇳 India</span>
</div>

Go live with your Paytm Payment Gateway account instantly using the **Instant** integration mode. This is a beta release and supports limited [payment methods](/docs/payments/optimizer/paytm-instant#supported-payment-methods). Follow the steps below to onboard Paytm Instant (beta) as a payment provider.

<AccordionGroup>
  <Accordion title="Prerequisites">
    * You need to have an active Paytm account with the necessary payment methods activated.
    * [Write to the Paytm Support Team](#email-format-for-paytm-instant-beta) to enable refunds via API for your Paytm account.
    * Generate API keys on the [Paytm Dashboard](https://dashboard.paytm.com/login/).
      1. Log in to the Paytm Dashboard.
      2. Navigate to **Developers Settings** → **API Keys** and generate live API keys.
          <img src="https://razorpay.com/docs/build/browser/assets/images/optimizer-paytm-test-api-keys.jpg" alt="Paytm test API keys" width="800" />
  </Accordion>
</AccordionGroup>

## Add Paytm as a Payment Provider

<AccordionGroup>
  <Accordion title="To add Paytm (instant) as a payment provider:">
    1. Log in to your Dashboard.
    2. Go to the **PAYMENT PRODUCTS** section and click **Optimizer**.
    3. In the top-right section, click **Add Provider**.
    4. Select **PayTm** in the list of gateways available and click **Next**.
           <img src="https://razorpay.com/docs/build/browser/assets/images/optimizer-paytm-add.jpg" class="click-zoom" alt="Add Paytm" width="700" />
    5. Select **Instant (beta)** and click **Next**.
           <img src="https://razorpay.com/docs/build/browser/assets/images/optimizer-paytm-select-instant.jpg" alt="Select Paytm Insant (beta)" width="800" />
    6. Enter the provider name and description and click **Next**.
           <img src="https://razorpay.com/docs/build/browser/assets/images/optimizer-paytm-add-provider.jpg" class="click-zoom" alt="Add Paytm provider details" width="700" />
    7. Enter your **INDUSTRY\_TYPE\_ID**, **KEY**, **MID** (merchant id) and **WEBSITE** details.
    8. Select the payment methods you want to enable for Paytm and click **Submit**.
           <img src="https://razorpay.com/docs/build/browser/assets/images/optimizer-paytm-final-new.jpg" class="click-zoom" alt="Add Paytm final details" width="700" />

    You have successfully added **Paytm Instant (beta)** as a payment provider on Optimizer.
  </Accordion>
</AccordionGroup>

## Supported Payment Methods

| Payment Methods | Availability |
| --------------- | ------------ |
| Netbanking      | Live         |
| Cards           | Live         |
| UPI             | Live         |
| Wallet          | Live         |
| EMI             | Coming Soon  |
| Settlements     | Live         |
| Refunds         | Live         |

<Info>
  **Handy Tips**

  If you want to offer all payment methods and support refunds from the Dashboard, please use the [S2S integration mode](/docs/payments/optimizer/paytm-s2s).
</Info>

## Email Format for Paytm Instant (beta)

Follow the email format given below to get Refund API enabled on your Paytm PG account:

To: `pg.support@paytmpayments.com`, `devsupport@paytmpayments.com` <br />

Subject: Enabling Refunds API on MID `Paytm MID` <br />

Dear Team,

Please enable refunds via API for our Paytm PG account with MID `Paytm MID`

Regards, <br />

## Send Receipt/Order ID to External Gateway

You might be generating a unique Order id or Receipt for every order which can be passed to Paytm via [Orders API](/docs/api/orders#orders-api).

To make your order id visible on the Paytm Dashboard:

1. In Razorpay's Orders API, use the `receipt` parameter to send your unique Order id or Receipt.
2. Razorpay passes this value to Paytm in the `extendInfo.udf1` parameter.
3. Write to your Paytm Relationship Manager to show the parameter `extendInfo.udf1` in the Dashboard and reports as per your use case.

## Best Practices

Before routing any traffic to a new gateway via Optimizer, the following best practices are recommended:

<AccordionGroup>
  <Accordion title="Live and Test Mode Rules">
    All rules configured on live or test mode on the Razorpay Dashboard will reflect on live mode. However, credentials added on test mode will not be automatically replicated in live mode.
  </Accordion>

  <Accordion title="Sanity Test at Razorpay">
    You can reach out to Razorpay for basic sanity testing of the integration. Razorpay will try a test payment of small value and ensure that the credentials are correct.
  </Accordion>

  <Accordion title="Perform Self Sanity Test">
    We recommend configuring a rule on live mode to route payments lesser than a set value (for example, ₹2) to the Paytm gateway. This helps to test on production whether small value payments are being routed to Paytm and working successfully, thus avoiding any direct impact on production traffic.

    To configure a rule in live mode:

    1. Log in to your Dashboard.
    2. In the left navigation, click **Optimizer**.
    3. Click **+Add Rule** and enter the **Rule name** and **Description**.
    4. Click **Next** and enter the following rule:
       * In **Parameter** field, select **Amount (In Rupees)**.
       * In **Select Connection** field, select **Less Than**.
       * In **Enter Amount** field, enter the value 2 and click **Next**.

    <img src="https://razorpay.com/docs/build/browser/assets/images/add-rule.jpg" class="click-zoom" alt="Add Rule" width="600" />

    5. Enter the value 100 in the **Route field**, select **Paytm** in the **payment via** field, and click **Next**.
           <img src="https://razorpay.com/docs/build/browser/assets/images/optimizer-paytm-rule-add.jpg" class="click-zoom" alt="Paytm target Provider" width="600" />
    6. Click **Publish Rule**.
           <img src="https://razorpay.com/docs/build/browser/assets/images/optimizer-paytm-publish-rule.jpg" class="click-zoom" alt="Paytm Publish Rule" width="600" />
  </Accordion>
</AccordionGroup>

## Go Live

After the integration is tested and successful, you can go live on Paytm.