WebXPay setup

WebXPay is a Sri Lankan card payment gateway. In Gannako, WebXPay is treated as a regular IPG — customers pay with their card on the WebXPay checkout page and you get the funds in your settlement bank account.

What you'll need

• A WebXPay merchant account.
• Your business registration certificate.
• Bank account details for settlements.

Step 1 — Apply for a WebXPay account

1. Visit webxpay.com and request a merchant account.
2. Their team will email you. Reply with your business documents and your storefront domain.
3. Approval usually takes 3-7 working days.

Step 2 — Get your keys

Once approved, WebXPay sends you two things by email:

• Public Key — used to encrypt payment data sent to WebXPay.
• Secret Key — used to verify that responses really came from WebXPay.

Both are long strings of random-looking characters. You don't need to understand them — just keep them safe.

Step 3 — Set up the webhook

Tell WebXPay where to send payment notifications.

Reply to your WebXPay onboarding email with this URL and ask them to register it as your Notify URL / IPN URL.

Step 4 — Paste credentials into Gannako

1. Open Settings → Payments → WebXPay in your Gannako admin.
2. Click the API Credentials tab.
3. Paste the Public Key and Secret Key.
4. Click Save.
5. Toggle WebXPay Enabled on the main payments page.

Step 5 — Test and go live

1. Leave Test Mode on. WebXPay's sandbox accepts any test card.
2. Place a test order. Confirm it shows as Paid in your admin.
3. Switch Test Mode off and place one real order to verify everything works.