# Auto-detect currency and country
curl "https://api.khaime.com/api/v1/partner/products/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/products/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/products/3046/pricing?currency=USD&customer_country=NG" \
  -H "X-API-Key: pk_sandbox_your_key"

GET

products

{product_id}

pricing

# Auto-detect currency and country
curl "https://api.khaime.com/api/v1/partner/products/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/products/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/products/3046/pricing?currency=USD&customer_country=NG" \
  -H "X-API-Key: pk_sandbox_your_key"

Get Product Pricing

Returns the product’s price converted to the customer’s detected or specified currency, including fee breakdown, available payment methods, and any active price discrimination adjustment for the customer’s country.

Path Parameters

product_id

integer

required

The Khaime product ID.

Query Parameters

currency

string

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

customer_country

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

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

# Auto-detect currency and country
curl "https://api.khaime.com/api/v1/partner/products/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/products/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/products/3046/pricing?currency=USD&customer_country=NG" \
  -H "X-API-Key: pk_sandbox_your_key"

List Products Calculate Pricing

API Reference

Account

Products & Pricing

Payments

Subscriptions

Marketplace

B2B Commerce

Get Product Pricing

Get Product Pricing

Path Parameters

Query Parameters

Response

Price Discrimination

​Get Product Pricing

​Path Parameters

​Query Parameters

​Response

​Price Discrimination

Get Product Pricing

Path Parameters

Query Parameters

Response

Price Discrimination