Prices

A price belongs to one product. It contains the amount and currency used for that offer, and it may include a recurring billing configuration for subscription products.

Price data

Every price has an ID, a product ID, details, and a creation time. details contains:

• amount: A non-negative number.
• currency: A lowercase ISO 4217 alphabetic code, such as usd, jmd, or eur.

This is different from a payment intent, which uses an ISO 4217 numeric currencyCode, such as 840 for USD and 388 for JMD.

One-time and recurring prices

A price without recurring represents a one-time amount. A recurring price includes:

Example:

curl -X POST "https://api.paynowpro.com/api/v1/products/PRODUCT_ID/prices" \
  -H "api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "tenantAlias": "YOUR_TENANT_ALIAS",
    "prices": [{
      "details": { "amount": 25, "currency": "usd" },
      "recurring": { "frequency": "Monthly" }
    }]
  }'

Manage prices

The public API lets you create prices for a product, list its prices, retrieve a single price, update its amount and currency details, and delete it. The product must exist before you create or retrieve a price.

Use a different price whenever the amount, currency, or billing schedule differs. Preserve the returned price ID; a subscription-intent request identifies the recurring offer by priceId.

Continue to Subscriptions for recurring billing, or use the Prices API reference for complete endpoint schemas.