Ship India-specific pricing
without trusting the browser.

Create your first trusted INR quote

Start with a TEST key. It uses isolated sandbox data and cannot consume LIVE allowance.

1. 1

   Set your key

   Store it in your server environment—never in frontend JavaScript.

   .envCopy

   LOCALPRICE_API_KEY="lp_test_your_key_here"

2. 2

   Create a quote

   Use a unique idempotency key for each logical pricing operation.

   cURLNode.js

   POST /v1/prices/quoteCopy

   curl -X POST "$LOCALPRICE_BASE_URL/v1/prices/quote" \
     -H "Authorization: Bearer $LOCALPRICE_API_KEY" \
     -H "Content-Type: application/json" \
     -H "Idempotency-Key: product-pro-annual-v1" \
     -d '{
       "amount": 49,
       "currency": "USD",
       "targetMarket": "IN",
       "productType": "saas",
       "pricingMode": "localized"
     }'

   quote.tsCopy

   import { LocalPrice } from '@localprice/node';
   
   const localprice = new LocalPrice({
     apiKey: process.env.LOCALPRICE_API_KEY!,
   });
   
   const quote = await localprice.quotes.create({
     amount: 49,
     currency: 'USD',
     targetMarket: 'IN',
     productType: 'saas',
     pricingMode: 'localized',
   }, { idempotencyKey: 'product-pro-annual-v1' });

3. 3

   Use the response

   Display localizedAmount to the customer and save quoteId for checkout verification. Money is returned as decimal strings to prevent floating-point loss.

   201 CreatedCopy

   {
     "data": {
       "quoteId": "quote_kN0cRjTQY0wJ8A6wE5b5FDzQ",
       "status": "ACTIVE",
       "mode": "TEST",
       "pricingMode": "localized",
       "sourceAmount": "49.0000",
       "sourceCurrency": "USD",
       "localizedAmount": "1499.00",
       "localizedCurrency": "INR",
       "targetMarket": "IN",
       "productType": "saas",
       "pricingModelVersion": "v1",
       "expiresAt": "2026-09-01T12:00:00.000Z"
     }
   }

Authentication and environments

Send the API key as a Bearer token on every pricing endpoint.

Authorization: Bearer lp_test_your_key_here

1. Create a quote

Choose localized for an India-optimized recommendation or fx for direct market-rate conversion. Omitting the mode preserves the localized default. Both create the same secure, project-scoped quote.

Request body

Headers

2. Display the localized price

Return only display-safe quote data to the frontend. Keep the source input and LocalPrice key server-side.

3. Verify before charging

From your backend, verify the quote immediately before creating a payment-provider session. Use the returned checkout.amount and checkout.currency exactly.

const verified = await localprice.quotes.verify(quoteId);

const checkoutSession = await payments.checkout.create({
  currency: verified.checkout.currency, // "INR"
  amount: verified.checkout.amount,     // 1499
  metadata: { localpriceQuoteId: verified.id },
});

Retrieve a quote

Retrieve the stored quote for display refreshes or server-side inspection. Quotes remain isolated by project and mode; a quote created with a TEST key is invisible to LIVE keys.

Supported values

Source currencies

Product types

Enum values are case-sensitive. The only V1 target market is IN, and localized currency is always INR.

Pricing modes and seller constraints

localized applies FX, affordability, category, constraints, price-point rounding, and a recommendation range. fx applies only source amount × current FX rate and normal two-decimal INR rounding. Optional constraints keep a localized recommendation inside your commercial boundaries. Precedence is evaluated per field: request value > project default > LocalPrice default.

{
  "maximumRegionalDiscountPercent": 70,
  "minimumRevenueRetentionPercent": 30,
  "minimumLocalizedPriceINR": 1299,
  "maximumLocalizedPriceINR": 2999,
  "sellerCostAmount": 8,
  "sellerCostCurrency": "USD",
  "minimumGrossMarginPercent": 40
}

Quote states

Always check the verification response at checkout time. Do not infer validity from a timestamp cached in the client.

Stable errors you can act on

Branch on error.code and HTTP status—not the human-readable message. Every error includes a request ID for support and tracing.

{
  "requestId": "req_01J…",
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Request validation failed",
    "details": {}
  }
}

Retry safely and trace everything

Access and monthly quota

Early access is currently available to selected early users while we are validating the pricing engine.

New organizations start PENDING. Only a LocalPrice administrator can approve key creation and API access. No subscription payment is required.

Organization and project limits default to 10,000 successful creations and verifications per UTC calendar month. TEST and LIVE share these limits. Retrievals, failed requests, dashboard traffic, and idempotent replays do not consume quota.

Check remaining quota and reset date in Usage & Analytics. Exhaustion returns HTTP 429 QUOTA_EXCEEDED; this is separate from the short-term Redis rate limit.

Production checklist

• Use a LIVE key only in the production server environment.
• Create one idempotency key per cart or pricing operation.
• Send only quoteId through the browser.
• Verify on your backend immediately before checkout creation.
• Use verified.checkout.amount and .currency without recalculation.
• Handle expired and invalidated quotes by creating a fresh quote.
• Implement bounded retry with jitter for 429, network failures, and temporary 5xx errors.
• Record X-Request-Id and configure quota alerts.
• Use GET /health for liveness and GET /ready for dependency readiness.

Node.js SDK

The TypeScript-first client supports apiKey, baseUrl, timeout, requestId, and conservative maxRetries. Quote creation is retried only when you provide an idempotency key; retrieval and verification are safe to retry.

import { LocalPrice, generateIdempotencyKey } from '@localprice/node';

const localprice = new LocalPrice({
  apiKey: process.env.LOCALPRICE_API_KEY!,
  timeout: 5_000,
  maxRetries: 2,
});

const quote = await localprice.quotes.create({
  amount: 49,
  currency: 'USD',
  targetMarket: 'IN',
  productType: 'saas',
  pricingMode: 'localized',
}, {
  idempotencyKey: generateIdempotencyKey('pricing-page'),
});

// Send quote.id and display-safe fields to the browser.
// Later, on your checkout route:
const verified = await localprice.quotes.verify(quote.id);
console.log(verified.checkout.amount, verified.checkout.currency);

Endpoint index