Ship India-specific pricing
without trusting the browser.

Create your first trusted INR quote

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

Request Early Access → organization starts PENDING → operator approves → create a project → generate a project-scoped TEST key → integrate the REST API or Node SDK. Random signups do not receive active API access immediately.

1. 1

   Install and configure

   Install with npm install @localprice/node. Store the key in your server environment—never in frontend JavaScript.

   .envCopy

   LOCALPRICE_API_KEY="lp_test_your_key_here"
   LOCALPRICE_BASE_URL="https://www.localpriceapi.online"

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": 40,
       "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: 40,
     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.

{
  "amount": 40,
  "currency": "USD",
  "targetMarket": "IN",
  "pricingMode": "fx"
}

{
  "amount": 40,
  "currency": "USD",
  "targetMarket": "IN",
  "pricingMode": "localized",
  "productType": "saas"
}

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.quoteId },
});

LocalPrice does not process the customer's payment and does not integrate into or control the payment provider. The boundary is: source price → LocalPrice quote → verified INR amount → your backend → your Stripe, Razorpay, PayPal, or other gateway.

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.

const stored = await localprice.quotes.retrieve(quote.id);

Supported values

Source currencies

Product types

Enum values are case-sensitive. The only V1 target market is IN, and target currency is always INR. LocalPrice obtains FX data from Frankfurter; clients configure no FX key and do not call Frankfurter directly.

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 operator can approve project-scoped TEST and LIVE key creation and API access.

Organization and project limits default to 10,000 successful creations and verifications per UTC calendar month. TEST and LIVE share both limits. Retrievals, failed validation/authentication, dashboard traffic, and idempotent replays do not consume quota. A new UTC calendar-month counter is used automatically; unused quota does not roll over.

Check remaining quota and reset date in Usage & Analytics. Exhaustion returns HTTP 429 QUOTA_EXCEEDED. The separate default short-term limit is 100 requests per 60 seconds per project and mode; it returns RATE_LIMIT_EXCEEDED with Retry-After.

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: 40,
  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 stored = await localprice.quotes.retrieve(quote.id);
const verified = await localprice.quotes.verify(stored.id);
console.log(verified.checkout.amount, verified.checkout.currency);

The production API base URL is https://www.localpriceapi.online. SDK errors expose name, message, code, status, requestId, and optional retryAfter.

Endpoint index