Set merchant rates

post

https://partner.payu.in/api/v1/partners/merchant_rates

Create or update TDR/TSF pricing for a merchant referred by your partner account.

Supports batch upsert of up to 300 pricing entries per request. Each entry is processed independently — a failure on one entry does not roll back others.

Response shape depends on outcome:

HTTP 200 + status: success → all entries processed successfully.
HTTP 200 + status: partial_success → some entries succeeded, some failed. Always inspect results[].
HTTP 422 + status: error (with results) → all entries failed.
HTTP 422 + status: error (with message, no results) → service-level failure (bad MID, not linked, batch > 300).
HTTP 400 / 401 / 403 / 404 → request rejected before entry processing.

For all payment merchanism & instrument mapping, please see mechanism to instrument mapping guide.

Body Params

reseller_uuid

uuid

required

Your partner UUID. Must belong to a platform partner.

mid

string

required

Merchant product-account identifier. Must be referred by your partner.

pricing

array of objects

required

length between 1 and 300

Array of 1–300 rate entries. Must be a JSON array (not an object or string).
Entries are processed in order; index 0 is first.

pricing*

payment_mechanism

string

required

Short code matching OnePayuPaymentMode.title. Case-sensitive.

Common values: UPI, CC, DC.
Exact codes depend on PayU environment configuration.

instrument

string

required

OnePayuPaymentOption.identifier. Must belong to the given payment_mechanism.

Examples by mechanism:

UPI → UPI
CC → CC, RUPAYCC, AMEX
DC → DC, VISA, RUPAYDC

tdr_percentage

number

required

≥ 0

TDR percentage. Required. Must be ≥ 0.

tdr_flat

number

≥ 0

Flat TDR charge in currency units. Optional; if sent, must be ≥ 0.

tsf_percentage

number

≥ 0

TSF percentage. Optional.

If value > 0, only allowed when payment_mechanism is UPI or instrument starts with RUPAY (e.g. RUPAYCC).
Sending 0 or omitting is always valid on any instrument.

tsf_flat

number

≥ 0

Flat TSF charge. Optional.

Same instrument restrictions as tsf_percentage when value > 0.

card_type

string

enum

Required when payment_mechanism is CC or DC. Case-insensitive.

Input	Stored as
`Domestic`, `domestic`, `unknown`, `not_present`	`default`
`International`, `international`	`international`
`Corporate`, `corporate`	`corporate`
`Prepaid`, `prepaid`	`prepaid`

Unrecognized values default to default.

Allowed:

amount_slab

object

Optional transaction amount range for this pricing entry.

Provided?	Storage
Omitted	Rates apply on `PlanDetail` (flat rate for that instrument)
Present	Rates apply only for transactions in that range via `GmvBucket`

Different slabs for the same instrument create separate buckets. A second call with the same slab bounds updates the existing bucket.

Responses

Shape	`processed` / `failed` / `results` present?	When
`{ "status": "error", "message": "..." }`	No	Service-level failure — MID not found, not linked, batch > 300, server misconfiguration
`{ "status": "error", "processed": 0, "failed": N, "results": [...] }`	Yes	All pricing entries failed
`{ "error": "..." }`	No	Unhandled exception

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Request processed. Check status field: success — all entries succeeded (failed = 0). partial_success — some entries failed. Inspect results[] and retry failed indices. Do not rely on HTTP status alone. HTTP 200 can contain failed rows when status is partial_success.

400Missing or invalid required top-level fields. Returned before auth or entry processing.

401Missing, invalid, or expired Bearer token.

403One of: Partner is not a platform partner (is_platform_partner = false). Token lacks refer_merchant scope. Token user is not the partner owner. Returns the same JSON body as 401 — distinguish by HTTP status code.

404reseller_uuid not found or omitted/null in the request body. Note: A missing reseller_uuid returns 404, not 400.

EXAMPLE QUESTIONS