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

MintPay setup

Register on mintpay.lk, generate your API token, and wire MintPay into checkout.

MintPay lets your customers pay in 3 interest-free installments. You get the full amount up front; MintPay collects from the customer over time. Setup is short — about 10 minutes.

What you'll need

  • An approved MintPay merchant account.
  • Your business documents (for the application).

Step 1 — Apply with MintPay

  1. Visit mintpay.lk and apply for a merchant account.
  2. Submit your business details. Approval typically takes 3-7 working days.

Step 2 — Get your credentials

  1. Sign in to your MintPay merchant portal.
  2. Open Settings → API Access.
  3. Copy your Merchant ID.
  4. Click Generate API Token and copy the token. This is your secret — handle it like a password.

Step 3 — Return / callback URL

MintPay sends customers back to your store after they finish paying. Tell MintPay where to send them.

Return URL

https://gannako.com/api/webhooks/mintpay
  1. In your MintPay portal, find the field labelled Return URL or Callback URL.
  2. Paste the URL above and save.

Step 4 — Paste credentials into Gannako

  1. Open Settings → Payments → MintPay in your Gannako admin.
  2. Click the API Credentials tab.
  3. Paste your Merchant ID and API Token.
  4. Click Save.
  5. Enable MintPay on the main payments page.

Step 5 — Choose installment plans

  1. Go to the Installments tab.
  2. Tick the months MintPay supports for your account. Standard is 3 — leave only 3 ticked unless MintPay confirmed longer terms for you.
  3. Pick a default term.

Step 6 — Test and go live

  1. Leave Test Mode on. Sandbox URL is dev.mintpay.lk. Place a test order using MintPay's sandbox account.
  2. Confirm the order shows as Paid.
  3. Switch Test Mode off. Production URL is app.mintpay.lk. Run a real order to confirm.
All docs