---
title: "UPI Mandate"
method: POST
path: "/payment/upimandate"
---

# UPI Mandate

`POST /payment/upimandate`

## Request body

- object
  - `upiId` string, required — The customer’s UPI ID from which the mandate amount will be debited.
  - `mandate_amount` integer, required — The fixed amount that will be debited from the customer’s UPI account on each cycle.
  - `order_amount` string, required — The transaction amount to be charged for the current order or execution under the mandate.
  - `start_date` string, required — The date from which the UPI mandate becomes active and eligible for debit.
  - `end_date` string, required — The date on which the UPI mandate automatically expires.
  - `frequency` 'AS' | 'MT' | 'WK' | 'QT' | 'HY' | 'YR', required — Defines how often the mandate amount will be debited.(Mandate Frequency can be : WK=Weekly MT=Monthly QT=Quarterly HY=half yearly YR= yearly)
  - `debitRule` 'ON' | 'BEFORE' | 'AFTER', required — Specifies the rule for when the debit should occur relative to the scheduled date.
  - `debitDay` string, required — The day on which the debit will be attempted based on the selected mandate frequency. For WEEKLY, the value should be between 1 (Monday) and 7 (Sunday). For MONTHLY, QUARTERLY, HALF-YEARLY, and YEARLY, the value should be between 1 and 30/31 depending on the month. For AS (As Presented) frequency, this field is not mandatory as there is no fixed debit day.
  - `note` string — Note displayed to the user in the UPI app (PSP) during mandate approval. Maximum length is 50 characters.
  - `remark` string — Remark or reference entered by the payer for personal identification of the mandate. Maximum length is 50 characters.
  - `customer_name` string — Full name of the customer for whom the UPI mandate is being created.
  - `customer_email` string — Email address of the customer used for mandate-related communication and reference.
  - `customer_mobile` number, float — Mobile number of the customer registered with the UPI account for mandate notifications and verification.
  - `autoExecute` string — Indicates whether the mandate should be automatically executed once it becomes active, without manual intervention.

## Response `200`

200

- object
  - `status` integer
  - `message` string
  - `data` object
    - `transaction_id` string
    - `BankRRN` string

## Other responses

- `400` — 400
- `401` — 401
- `403` — 403
- `500` — 500
- `501` — 501
- `502` — 502
- `503` — 503

---

[API](https://skmtc.dev/ledgers/apis/authentication.md) · [All operations](https://skmtc.dev/ledgers/apis/authentication/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ledgers/authentication/revisions/605f28ef08ef/schema)