Skip to main content
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"

Documentation Index

Fetch the complete documentation index at: https://docs.khaime.com/llms.txt

Use this file to discover all available pages before exploring further.

​
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.
FieldTypeDescription
original_base_priceintegerProduct’s base price before any adjustment
discrimination_amountintegerAmount added (or subtracted) by the rule
discrimination_percentagenumberDecimal percentage applied (e.g., 0.15 for +15%)
adjusted_base_priceintegerPrice after discrimination, before currency conversion
country_triggeredstringISO-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"