---
title: "UPI QR & Intent String"
method: POST
path: "/icp/upi/intent"
---

# UPI QR & Intent String

`POST /icp/upi/intent`

The **UPI Intent API** enables merchants to generate UPI intent links & QR string using a valid `payment_token_id`.

## Headers

- `Access-Key` string, required

## Request body

- object
  - `amount` string, required — The amount of transaction
  - `contact_number` string, required — Mobile number of the customer. Please make sure you are passing actual customer mobile number. If you pass a hardcoded value, if the customer doesn't change the mobile number from layer the transaction will appear with hardcoded mobile number and name associated with it.
  - `email_id` string, required — Email Id of the customer
  - `currency` string, required — INR
  - `mtx` string, required — Reference id for the transaction. This should be unique for each transaction.
  - `udf` object — Merchant can pass extra parameters in the request which they require in the response. Key-value pair that can be used to store additional information about the entity.<ul><li>Each pair cannot exceed 256 characters.</li><li>Maximum 5 key-value pairs.</li></ul>Example: `"key_1": "DD”`
    - `key_1` string
    - `key_2` string

## Response `200`

200

- object
  - `status` string
  - `message` string
  - `data` object
    - `transaction_id` string
    - `amount` string
    - `currency` string
    - `merchant_id` string
    - `upi_intent_links` object
      - `collect_pay` object
        - `instrument_id` integer
        - `amount` string
      - `intent` object
        - `instrument_id` integer
        - `qr_string` string
        - `intent_apps` object[]
          - `label` string
          - `intent` string
          - `qr_string` string
      - `qr` object
        - `instrument_id` integer
        - `qr_string` string

## Other responses

- `403` — 403
- `422` — 422

---

[API](https://skmtc.net/zwitch/apis/2.md) · [All operations](https://skmtc.net/zwitch/apis/2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zwitch/2/versions/4586157daf87/schema)
