G
All docs
Payments
Updated 2026-04-28
4 min read

PAYable setup

Connect PAYable with your merchant key and merchant token.

PAYable accepts Visa, Mastercard, AMEX and local Sri Lankan bank cards. Setup is mostly clicking around in the PAYable dashboard and copying two values into Gannako.

What you'll need

  • A registered PAYable merchant account.
  • Your business documents.
  • Your storefront domain (more on this in Step 2).

Step 1 — Sign up

  1. Visit payable.lk and apply for a merchant account.
  2. Submit your business documents. PAYable usually approves within 2-5 working days.

Step 2 — Generate your API token (with the right domain)

PAYable ties your token to a specific domain. The domain you use depends on what your customers see in their browser.

  • If you have not set up a custom domain yet, use your full Gannako address — for example your-store.gannako.com. (Find it on the home page of your Gannako admin.)
  • If you have set up a custom domain in Settings → Domain, use the custom domain — for example shop.yourbrand.com or yourbrand.com.
  1. Sign in to your PAYable Merchant Dashboard.
  2. Open Settings → API Integration.
  3. Click Generate API Token and fill in the form:
    • Category: select Domain.
    • Brand Name: your store name.
    • Domain Name: the domain from the rules above. No https://, no trailing slash.
  4. Click Generate.
  5. Copy the Merchant Key.
  6. Copy the Merchant Token.

Step 3 — No webhook to configure

PAYable does not need you to register a webhook URL. Gannako sends the notify URL with every payment request automatically. You can skip this step entirely.

Step 4 — Add credentials in Gannako

  1. Open Settings → Payments → PAYable → API Credentials in your Gannako admin.
  2. Paste the Merchant Key into the Merchant Key field.
  3. Paste the Merchant Token into the Merchant Token field.
  4. Click Save.
  5. Toggle PAYable Enabled on the main payments page.

Step 5 — Test, then go live

  1. With Test Mode on, place a small test order. PAYable's docs list sandbox card numbers.
  2. Confirm the order appears as Paid in your Gannako admin.
  3. Switch Test Mode off and run a real order. Refund it from the PAYable dashboard if you want — Gannako will sync the status.

Cards supported

  • Visa
  • Mastercard
  • American Express
  • Diners Club
  • Discover
All docs