Skip to content
Gaurav TiwariDocs

Payment Method and Currency Links

Updated November 19, 2026

You want buyers from India to pay with Dodo Payments in INR, or a reseller to pay only by PayPal. Telling them which option to pick at checkout loses some of them. Payment method and currency links set it for them: ?paymethod= limits checkout to the methods you name, and ?paycurrency= fixes the currency.

Switch Them On

  • ?paymethod= is part of Extra Enhancements. Switch on Extra Enhancements on the Stackless Dashboard, open its Settings and check that Set the payment method from a link, under Payment method links, is ticked. It is by default.
  • ?paycurrency= belongs to Multi-Currency Checkout and works whenever that module is on. The currency has to be one of the enabled currencies under Stackless → Settings → Multi-Currency Checkout.

The Payment method links section lists the payment method keys your store has, so you can copy the exact values.

Payment Method Values

Use the payment method’s key, not the name buyers see at checkout:

Payment methodKey
Stripe (Stackless)gtfc_stripe
Stripe Managed Payments (Stackless)gtfc_stripe_managed
PayPal (Stackless)gtfc_paypal
Paddle (Stackless)gtfc_paddle
Polar (Stackless)polar
Dodo Payments (Stackless)dodo
FluentCart’s own Stripe and PayPalstripe, paypal
A gateway copyIts family key with _copy and its number, such as polar_copy2
  • Keys aren’t case-sensitive, and a hyphen counts as an underscore, so gtfc-stripe works too.
  • Name up to 10 methods, separated by commas: ?paymethod=gtfc_stripe,gtfc_paypal.
  • ?paymethod=any (or all) clears an earlier choice.

For ?paycurrency=, use a three-letter currency code such as EUR or INR. The cart is priced in that currency and the currency switcher is hidden. If the buyer tries to switch anyway, they see “This checkout is set to pay in EUR, so the currency cannot be changed.”

How Long the Choice Lasts

  • The link can point at any page of your store, not only checkout. The choice is remembered for a day until the visitor has something in the cart, then it stays with that cart.
  • Every checkout of that cart follows it: the checkout page, Modal Checkout and On-page Checkout.
  • A later link replaces the choice.

When a Value Doesn’t Work

  • A payment method key your store doesn’t have changes nothing. Checkout shows its usual methods.
  • A method that can’t take the order, because it’s switched off or not routed for the cart’s currency in Multi-Currency Checkout, is skipped. If none of the named methods can take the order, checkout shows every method rather than none.
  • If an order comes in with a method the link hid, for example from an old checkout tab, it’s refused with “This checkout link pays with a set payment method. Choose one of the payment methods shown.”
  • A currency that isn’t enabled, or isn’t a three-letter code, is ignored.
  • If a product in the cart can’t be priced in that currency, the link doesn’t lock the cart, and the currency stays as it was.

All three parameters work in one link, in any order. ?coupon= needs Coupon links in Extra Enhancements, which are also on by default:

https://your-store.com/checkout/?paycurrency=EUR&paymethod=paypal&coupon=WELCOME10

Add them to a buy link too. The buy link builds its fresh cart, and checkout opens with your payment method and currency. The extra parameters don’t affect the link’s signature:

https://your-store.com/?gtfc-buy=12:2,15&paymethod=gtfc_stripe&paycurrency=USD

Examples

  • Pay by UPI in India: /checkout/?paymethod=dodo&paycurrency=INR
  • Only PayPal (Stackless), from a pricing page: /pricing/?paymethod=gtfc_paypal
  • Card or PayPal, in USD: /checkout/?paymethod=gtfc_stripe,gtfc_paypal&paycurrency=USD
  • Show every method again: /checkout/?paymethod=any

To limit one button instead of a whole visit, Modal Checkout‘s pay-via- classes do the same per button.

Share

Was this helpful?

Still stuck? Open a support ticket