Skip to main content

​
Overview

Checkout Session provides a unified hosted checkout experience. Where the merchant business model, settlement configuration, payment channel, and target currency all support it, Checkout can display or process prices in that currency. Subscriptions generally require a fixed price configured per currency in advance. The actual supported range follows the merchant contract and channel configuration. Offering local currency support provides several advantages:
  • Higher conversion rates: Customers prefer to pay in familiar currencies
  • Access to local payment methods: Many local payment methods only support their native currency
  • Market-specific pricing: Implement competitive pricing strategies for different markets
  • Cost reduction: Avoid foreign exchange fees that some payment providers charge customers

​
Customer Experience

When customers access your checkout page from a location with a currency different from your defined price currencies, they’ll see both their local currency and your default currency. Currency options are determined based on the customer’s public IP address location. If the customer’s local currency matches one of your defined price currencies, only that currency will be shown. For one-time payments, set localPriceOnly to true when creating the checkout session to prioritize local currency price options. Clink resolves the customer’s local currencies from the checkout access IP. If no local price option can be shown, Clink falls back to the original pricing currency when it is available. This setting does not apply to subscription checkout sessions. currency_conversion

​
Pre-defined Local Currency Prices

Merchants can configure products with multiple local currencies to meet various business needs. Clink allows you to set multiple currencies for a single price. To configure this, visit the Multi-currency Pricing section on the product page.
multi_currency_price_example
After configuration, simply use a single Price ID to create checkout sessions. Customers will automatically see your pre-defined price in their local currency, with no additional conversion needed.
Subscription: To support local currencies in recurring payments, you must configure them in advance through price settings. Adaptive pricing is not available.
Settlement Currency: For payments made in a pre-defined local currency different from your settlement currency, Clink automatically handles conversion during settlement.
If a customer’s local currency isn’t included in your configuration, adaptive pricing will be used instead.

​
Adaptive Pricing

As mentioned in the Customer Experience section, customers will see their local currency alongside your default price currency. For multi-currency price, only the primary currency will be shown.
Settlement Currency: With adaptive pricing, orders settle in your primary price currency. Clink manages all customer-side currency conversions during payment processing.

​
Restrictions

Adaptive Pricing is not available for:
  • Subscription payments: Due to exchange rate fluctuations and the need for customer agreement on renewal amounts
  • Sessions where the customer’s currency is already covered by pre-defined price currencies

​
API One-time Payments

When creating a one-time payment by API, use paymentCurrency for the currency you want to charge the customer in. If paymentCurrency is omitted, the payment uses the original pricing currency. For direct amount payments, currency is still required as the original pricing currency. For price-based payments, Clink uses the currency from the price. Clink first uses a configured fixed multi-currency price when available. If no fixed price exists, Clink automatically converts the amount from the original pricing currency to the requested payment currency. The selected payment method must support the requested paymentCurrency. For CASHAPP, GCASH, TNG, WECHAT, KAKAO, ALIPAY, QRIS, and PROMPTPAY, you can omit paymentInstrumentId; Clink automatically creates the payment instrument and returns its ID in the response. Other payment methods still require an existing paymentInstrumentId.
Specify payment currency

​
Supported Currencies

Clink supports these major currencies: