Get Product Pricing

# Auto-detect currency and country
curl "https://api.khaime.com/api/v1/partner/product/3046/pricing" \
  -H "X-API-Key: pk_sandbox_your_key"

# Explicit currency (country derived from NGN → NG automatically)
curl "https://api.khaime.com/api/v1/partner/product/3046/pricing?currency=NGN" \
  -H "X-API-Key: pk_sandbox_your_key"

# Explicit currency + country override (for ambiguous currencies like USD)
curl "https://api.khaime.com/api/v1/partner/product/3046/pricing?currency=USD&customer_country=NG" \
  -H "X-API-Key: pk_sandbox_your_key"

GET

product

{product_id}

pricing

# Auto-detect currency and country
curl "https://api.khaime.com/api/v1/partner/product/3046/pricing" \
  -H "X-API-Key: pk_sandbox_your_key"

# Explicit currency (country derived from NGN → NG automatically)
curl "https://api.khaime.com/api/v1/partner/product/3046/pricing?currency=NGN" \
  -H "X-API-Key: pk_sandbox_your_key"

# Explicit currency + country override (for ambiguous currencies like USD)
curl "https://api.khaime.com/api/v1/partner/product/3046/pricing?currency=USD&customer_country=NG" \
  -H "X-API-Key: pk_sandbox_your_key"

Intro

Returns a Khaime catalog product’s price converted to the customer’s detected or specified currency, including fee breakdown, available payment methods, and any active regional price adjustment.

The path is singular — /product/{product_id}/pricing, not /products/{product_id}/pricing.

Context

This is the product-based counterpart to Calculate Pricing, which does the same conversion for an arbitrary amount without a catalog product. Use this endpoint to render a localized price on a product page; use Calculate Pricing when you already know the amount (e.g. cart total) and just need conversion. The local.amount this returns is exactly what you’d pass as amount on Create Payment Intent for this product.

Hows

Path parameters

integer

required

The Khaime product ID.

Query parameters

string

Override auto-detected currency. 3-letter ISO code (e.g., NGN).

string

Override auto-detected customer country. 2-letter ISO code (e.g., NG). When omitted, the country is derived from the payment currency (e.g., NGN → NG), with IP geolocation as a fallback. Only needed for ambiguous currencies like USD.

Response

{
  "success": true,
  "data": {
    "product": {
      "id": 3046,
      "name": "Premium Course",
      "type": "digital"
    },
    "pricing": {
      "base": {
        "amount": 10000,
        "currency": "USD",
        "formatted": "$100.00"
      },
      "local": {
        "amount": 16675000,
        "currency": "NGN",
        "formatted": "₦166,750.00"
      },
      "conversion": {
        "rate": 1450.1,
        "source": "wise_api",
        "applied": true
      }
    },
    "price_discrimination": {
      "original_base_price": 10000,
      "discrimination_amount": 1500,
      "discrimination_percentage": 0.15,
      "adjusted_base_price": 11500,
      "country_triggered": "NG"
    },
    "amount": {
      "product_price": {
        "amount": 16675000,
        "currency": "NGN",
        "formatted": "₦166,750.00"
      },
      "total": {
        "amount": 17742500,
        "currency": "NGN",
        "formatted": "₦177,425.00"
      }
    },
    "customer": {
      "location": {
        "country": "Nigeria",
        "country_code": "NG",
        "detected_from": "ip_address"
      },
      "currency": {
        "code": "NGN",
        "detected": false,
        "override": true
      }
    },
    "payment": {
      "methods": ["card", "bank_transfer", "ussd"],
      "currency": "NGN"
    }
  }
}

Price discrimination (regional pricing)

If the merchant has configured a regional pricing rule for the customer’s country, the price_discrimination field is included in the response. The adjustment is applied to the base price before currency conversion, so pricing.local already reflects the discriminated amount. When no rule is active for the customer’s country, price_discrimination is null.

Field	Type	Description
`original_base_price`	integer	Product’s base price before any adjustment
`discrimination_amount`	integer	Amount added (or subtracted) by the rule
`discrimination_percentage`	number	Decimal percentage applied (e.g., `0.15` for +15%)
`adjusted_base_price`	integer	Price after discrimination, before currency conversion
`country_triggered`	string	ISO-2 country code that matched the rule

Error codes

Status	Cause
`404`	`PRODUCT_NOT_FOUND` — no published product with this ID matches your API key’s live/sandbox environment.

# Auto-detect currency and country
curl "https://api.khaime.com/api/v1/partner/product/3046/pricing" \
  -H "X-API-Key: pk_sandbox_your_key"

# Explicit currency (country derived from NGN → NG automatically)
curl "https://api.khaime.com/api/v1/partner/product/3046/pricing?currency=NGN" \
  -H "X-API-Key: pk_sandbox_your_key"

# Explicit currency + country override (for ambiguous currencies like USD)
curl "https://api.khaime.com/api/v1/partner/product/3046/pricing?currency=USD&customer_country=NG" \
  -H "X-API-Key: pk_sandbox_your_key"

Whys

Pricing is resolved per-product (rather than requiring you to fetch the catalog price and call Calculate Pricing yourself) because product pricing can carry a regional discrimination rule the generic conversion endpoint has no way to know about — this endpoint applies that adjustment before conversion so the returned local.amount is ready to charge as-is.

Why nots

The path is /product/{id}/pricing, singular — it is easy to guess wrong from List Products’ plural /products and get a 404.
This does not create a charge or reserve the price — it’s a read-only quote. Rates can drift between this call and an actual Create Payment Intent request; the intent endpoint uses the product’s live catalog price at charge time, not a value you pass back in from here.
Fee details are not returned here — this endpoint reports price and available payment methods, not a fee_details breakdown. Use Create Charge’s preview mode for that.

API Reference

Account

Products & Pricing

Payments

Integration Guides

Commerce API

Subscriptions

Marketplace

Intro

Context

Hows

Path parameters

Query parameters

Response

Price discrimination (regional pricing)

Error codes

Whys

Why nots

​Intro

​Context

​Hows

​Path parameters

​Query parameters

​Response

​Price discrimination (regional pricing)

​Error codes

​Whys

​Why nots

Intro

Context

Hows

Path parameters

Query parameters

Response

Price discrimination (regional pricing)

Error codes

Whys

Why nots