Supported Currencies

Primary Currencies

Inkress currently supports the following currencies for payments and payouts:

Setting Payment Currency

When creating a payment link or order, specify the currency using the currency_code field:

const response = await admin.paymentLink.create({
  title: "Premium Subscription",
  total: 9900,  // Amount in cents (JMD 99.00)
  currency_code: "JMD",  // or "USD"
  description: "Monthly premium plan"
});

Amount Formatting Best Practices

// ✓ Good - using integers
const amount = 2550;  // $25.50

// ✗ Bad - using floats
const amount = 25.50;  // Can cause precision errors

function formatCurrency(cents: number, currency: string): string {
  const amount = cents / 100;
  
  const formatters = {
    JMD: new Intl.NumberFormat('en-JM', {
      style: 'currency',
      currency: 'JMD'
    }),
    USD: new Intl.NumberFormat('en-US', {
      style: 'currency',
      currency: 'USD'
    })
  };
  
  return formatters[currency].format(amount);
}

// Usage
formatCurrency(9900, 'JMD');  // "$99.00"
formatCurrency(2550, 'USD');  // "$25.50"

function parseCurrencyInput(input: string): number {
  // Remove currency symbols and commas
  const cleaned = input.replace(/[$,]/g, '');
  
  // Parse as float and convert to cents
  const dollars = parseFloat(cleaned);
  
  if (isNaN(dollars)) {
    throw new Error('Invalid amount');
  }
  
  return Math.round(dollars * 100);
}

// Usage
parseCurrencyInput("$99.99");    // 9999
parseCurrencyInput("1,250.50");  // 125050

Multi-Currency Payments

Merchants can accept payments in multiple currencies, but each payment link must specify a single currency. Customers see prices in that currency throughout the checkout flow.

// Create separate payment links for different currencies
const jmdLink = await admin.paymentLink.create({
  title: "Premium Plan",
  total: 9900,
  currency_code: "JMD"
});

const usdLink = await admin.paymentLink.create({
  title: "Premium Plan", 
  total: 6500,  // ~$65 USD equivalent
  currency_code: "USD"
});

// Show appropriate link based on customer location
function getPaymentLink(countryCode: string) {
  return countryCode === 'US' ? usdLink : jmdLink;
}

Exchange Rates

Inkress does not automatically convert between currencies. If you need to support multiple currencies, you must:

1. Fetch current exchange rates from a service (e.g., exchangerate-api.com)
2. Calculate equivalent amounts in each currency
3. Create separate payment links for each currency
4. Display appropriate links to customers based on their preference

async function getExchangeRate(from: string, to: string): Promise<number> {
  const response = await fetch(
    `https://api.exchangerate-api.com/v4/latest/${from}`
  );
  const data = await response.json();
  return data.rates[to];
}

async function createMultiCurrencyLinks(
  baseAmount: number, 
  baseCurrency: string
) {
  const links = [];
  
  // Create JMD link
  links.push(await admin.paymentLink.create({
    title: "Premium Plan",
    total: baseCurrency === 'JMD' ? baseAmount : 
      Math.round(baseAmount * await getExchangeRate(baseCurrency, 'JMD')),
    currency_code: "JMD"
  }));
  
  // Create USD link
  links.push(await admin.paymentLink.create({
    title: "Premium Plan",
    total: baseCurrency === 'USD' ? baseAmount : 
      Math.round(baseAmount * await getExchangeRate(baseCurrency, 'USD')),
    currency_code: "USD"
  }));
  
  return links;
}

Settlement & Payouts

Your merchant account has a primary settlement currency (usually JMD). Payments received in different currencies are handled as follows:

Payment:           $100.00 USD
Exchange Rate:     1 USD = 155 JMD
Gross:             JMD 15,500
Conversion Fee:    JMD   -155 (1%)
Transaction Fee:   JMD   -310 (2%)
────────────────────────────────
Net to Balance:    JMD 15,035

Fee Structure by Currency

Transaction fees vary slightly by currency and payment method:

Requesting Additional Currencies

We're actively expanding our currency support. If you need to accept payments in a currency not currently supported, please contact our sales team.