Accept payments with SkyPay

Getting started

SkyPay lets you take eSewa, Khalti, and bank payments through one integration. Here's the short version: grab your API key, send customers to checkout, verify the payment, deliver the order. That's it.

Get your API key

You'll pass this key on every checkout link and verify request.

1. 1 Log in to the merchant dashboard at app.skypay.dev
2. 2 Open Developers → API Keys (or Profile → API Key)
3. 3 Create or rotate a key and copy it once
4. 4 Use the key in the Key header for verification; generate checkout links from the dashboard (signed ck token)

Connect providers

Turn on the payment methods your customers actually use.

1. 1 Open your Merchant Dashboard
2. 2 Go to Providers
3. 3 Add and configure eSewa, Khalti, or Other
4. 4 Save — you’re ready to accept payments

Integration modes

Pick how you want to accept payments. You can switch anytime from the dashboard.

Add checkout to your site

Redirect customers to SkyPay with a link or form. On return, verify the payment.

1. Your app generates a unique code (order ID).
2. Generate a checkout link from the dashboard (includes a signed ck token).
3. SkyPay handles the payment at app.skypay.dev/checkout.
4. Customer returns to your success or failure URL.
5. Verify server-side, then fulfill the order.

Parameters

Checkout link

<a href="https://app.skypay.dev/checkout?ck=YOUR_CHECKOUT_TOKEN&amount=100&code=ORDER123&success_url=https://yourapp.com/success&failure_url=https://yourapp.com/failure">
  Pay with SkyPay
</a>

Great for quick redirects, email/SMS links, or low-code flows.

Verify payments

Always verify after redirect and before fulfillment. A success screen doesn't mean the money landed.

const res = await fetch(
  'https://app.skypay.dev/api/v1/checkout/payments-verify/ORDER123',
  { headers: { Key: 'YOUR_API_KEY' } }
);
const { data } = await res.json();

if (data?.status === 'complete') {
  // Fulfill the order
}

Status values

Use cases

The same integration fits a lot of business models: