Skip the manual navigation

Add payment methods: manual payments and online gateways

Turn on cash/bank payment options and connect the online payment gateways your customers can pay with, from Settings > Payments.

6 min read · Updated October 2, 2026 · Screenshots use demonstration accounts

On this page
  1. 1. Open Payments settings
  2. 2. Turn on manual payment methods
  3. 3. Add an online payment provider
  4. 4. Enter the provider's API keys
  5. 5. Point Stripe's webhook, if using Stripe
  6. 6. Choose how payments are captured
  7. 7. Set gift card expiration
  8. 8. Save
  9. Completion checklist
  10. Troubleshooting
Before you start

While your store is in development mode, the Payments page shows a development-mode banner and every order placed at checkout is tagged "test". Configured gateways still run with whatever keys you enter, so use each provider's sandbox or test keys until you have completed Go-live (the banner links to the Go-live checklist).

On a phone? Open the admin menu to find the same section. Screenshots below show the desktop view; tap “Open full size” for a closer look.
STEP 1

Open Payments settings

Go to Settings > Payments in your admin.

STEP 2

Turn on manual payment methods

Under Manual payment methods, tick any of: Cash on delivery (COD), Pay at the store (pickup orders) — only selectable once a location offers Local pickup under Settings > Shipping and delivery — and Bank transfer, which reveals a Payment instructions text box (bank name, account number, reference) shown to customers on their order confirmation.

  • Cash on delivery (COD)
  • Pay at the store (pickup orders) — needs Local pickup turned on first
  • Bank transfer — add payment instructions for customers
STEP 3

Add an online payment provider

Under Online payment providers, choose a provider from the Add a payment provider dropdown and click Add. The list is: Stripe (international cards), PayPal, PayHere, Onepay, WebXPay, PAYable and Marx IPG (card, wallet and bank gateways for Sri Lanka), plus the buy-now-pay-later options Mintpay and KOKO (3 interest-free instalments, LKR only). Each provider appears as its own card once added. At checkout, a gateway is only offered when it can accept the order's currency.

STEP 4

Enter the provider's API keys

On each provider's card, tick its enable box (Enable card payments (Stripe), Enable PayPal, or Enable {provider} for the others). PayPal and the Sri Lankan gateways also have an Environment choice: Live (real payments) or Sandbox (testing). Stripe has no Environment switch; the keys you paste decide it (test keys or live keys). Then paste the keys the provider issued you, for example Stripe's Publishable key and Secret key, or PayPal's Client ID and Secret. Once a secret is saved it only shows as a masked placeholder. Leave the field blank to keep the key that's already stored.

STEP 5

Point Stripe's webhook, if using Stripe

If you use Stripe, you can also paste its Webhook signing secret (optional) and point your Stripe webhook endpoint at /api/store/payments/webhook on your store's domain. This lets payment status updates reach your store reliably.

STEP 6

Choose how payments are captured

Under Payment capture method you can pick Automatically at checkout, Automatically when the entire order is fulfilled, or Manually. This now controls Stripe card payments: with either of the fulfilment-based options, a card is only authorized (held, not charged) at checkout, and you capture or void it from the order page — see "Capture payments later" for the full flow. PayPal and the local payment gateways (PayHere, Onepay, WebXPay, PAYable, Mintpay, KOKO, Marx) can't hold an authorization, so they always capture at checkout whatever you choose here. Pre-order deposits and gift-card-only orders also always capture at checkout. Cash on delivery, bank transfer and pay at the store are collected manually.

STEP 7

Set gift card expiration

Under Gift card expiration, choose Gift cards never expire or Gift cards expire. If they expire, enter Days after issue (a whole number from 1 to 3,650; anything else shows 'Enter a number of days between 1 and 3,650'). This applies only to new gift cards issued without an explicit expiration date. Check your local laws — some regions don't allow gift cards to expire.

STEP 8

Save

Click Save at the bottom of the Payments page. Bank installment plans (Easy payment plans) are edited on their own page and aren't affected by this Save button.

CHECK YOUR WORK

You’re ready when…

  • Turn on the manual methods (COD, pay at store, bank transfer) you want to offer
  • Add each online gateway you have an account with from the provider dropdown
  • Tick each gateway's enable box and enter its keys (sandbox or test keys while in development mode)
  • Decide whether gift cards expire, and after how many days
  • Complete Go-live before taking real payments

IF SOMETHING DOESN’T LOOK RIGHT

Troubleshooting

I enabled a gateway but it isn't showing at checkout.

Check that the gateway's enable box is ticked and that you clicked Save. Its required keys must be saved too, not just typed in. Also check the order's currency: some gateways only accept certain currencies (for example Mintpay and KOKO are LKR only), and a gateway that can't take the shopper's currency is hidden at checkout.

"Pay at the store" is greyed out and I can't turn it on.

This option only becomes available once a location offers Local pickup. Turn on Local pickup under Settings > Shipping and delivery first, then return to Settings > Payments.

What's the difference between Mintpay/KOKO and the Easy payment plans page?

Mintpay and KOKO are buy-now-pay-later gateways you connect here with their own merchant credentials. Easy payment plans (linked from this page) is a separate feature for listing bank card-installment schemes — each bank's tenors and handling fees — that shoppers pick from at checkout; see the bank-installments-and-bnpl article.

Can I re-enter a secret key to confirm it's correct?

No — once saved, secret keys only ever show a masked placeholder (e.g. the last 4 characters) for security. Enter a new value only if you need to replace the key; leaving the field blank keeps the existing one.

I chose "Manually" or "when fulfilled" as the capture method, but a payment was still captured straight away.

That's expected for PayPal, the Sri Lankan gateways, Marx, a pre-order deposit or a gift-card-only order — none of those can hold an authorization, so they always capture at checkout regardless of this setting. Stripe card payments do follow it: check the order's payment status shows Authorized, not Paid, right after checkout.

In this section: Payment providers

Still need help?

Tell us your store address and what you’re trying to do. Leave out passwords and payment details.

Contact support