Create a price

POST

/v1/catalog/prices

• Production (nep_live_ keys)
• Local development

A price binds an amount (in paisa) and a billing interval to a product. Subscriptions reference a price.

Authorizations

• ApiKeyAuth

Parameters

Header Parameters

Idempotency-Key

required

string

<= 255 characters

A client-generated unique key (UUID recommended). Required on all POST/PATCH/DELETE. Retrying with the same key returns the original response for 24 hours.

Request Body ^required

object

productId

required

string

prod_01ARZ3NDEKTSV4RRFFQ69G5FAX

amount_paisa

required

Recurring amount in paisa.

string

49900

currency

string

default: NPR

Allowed values: NPR

interval

required

string

Allowed values: day week month year

month

intervalCount

E.g. interval=month, intervalCount=3 → quarterly.

integer

default: 1

trialDays

Free trial length before the first charge.

integer

metadata

Up to 50 key/value string pairs you can attach to an object. Trile ignores them; they’re returned on every read.

object

key

additional properties

string

{
  "internal_user_id": "42"
}

Responses

201

A price object.

object

id

string

price_01ARZ3NDEKTSV4RRFFQ69G5FAY

productId

string

amount

All amounts are integer paisa (1 NPR = 100 paisa) serialized as a string to avoid float errors.

object

amount_paisa

required

Integer paisa as a base-10 string. 49900 = NPR 499.00.

string

49900

currency

required

string

Allowed values: NPR

NPR

interval

string

Allowed values: day week month year

intervalCount

integer

active

boolean

404

Error.

object

success

boolean

error

object

code

string

insufficient_funds

message

string

Wallet balance is below the first cycle amount.

meta

object

requestId

string

req_aBcDeFgHiJkL

422

Request validation failed.

object

success

boolean

error

object

code

string

insufficient_funds

message

string

Wallet balance is below the first cycle amount.

meta

object

requestId

string

req_aBcDeFgHiJkL