# Vihaya Events API: your front end, our backend

> Vihaya Events is an event ticketing API for India that works as the backend for your own website. It handles Razorpay payments, QR tickets, ticket emails, gate check-in and organiser payouts. You build the front end in any framework or AI builder. API access is free; paid tickets carry a 1.75–4.5% fee.

Last updated: 2026-10-04

## Who it is for

Developers, vibe coders and agencies building their own branded event website in Lovable, v0, Bolt, Replit, Cursor, Windsurf, Claude Code, GitHub Copilot, Next.js, Webflow, WordPress, Framer, Wix, Squarespace or any framework, who do not want to build payments, tickets, check-in and payouts.

## What Vihaya Events handles

- Payments: UPI, cards, net banking and wallets through Razorpay Checkout. No payment gateway account needed.
- Tickets: every confirmed booking gets a QR ticket and a ticket email.
- Check-in: organisers scan tickets at the gate from a phone.
- Webhooks: signed registration.confirmed on every booking.
- Test mode: test keys (vihaya_test_sk_) never touch real money.
- Payouts: organisers withdraw by UPI; it lands in about two working days.
- Official SDKs: JavaScript / TypeScript (`npm install vihaya-sdk`), Python (`pip install vihaya-events`), PHP (`composer require vihaya/events`), Ruby (`gem install vihaya-events`), Go (`go get github.com/Vishnu252005/vihaya-sdk-go@v0.1.1`), Java / Kotlin (`implementation("com.github.Vishnu252005:vihaya-sdk-java:v0.1.1")`), Flutter / Dart (`flutter pub add vihaya_sdk_flutter`).

## Three steps

1. Create a free test key at https://events.vihaya.app/profile/developer/keys.
2. List events: `GET https://events.vihaya.app/api/v1/events` with an `x-api-key` header.
3. Book: `POST https://events.vihaya.app/api/v1/events/{id}/register` with name, email and phone. A free event is confirmed. A paid event returns `orderId` and `key`; open Razorpay Checkout with them, then POST register again with `registrationId`, `orderId` and `paymentId`.

## Guides

- [Sell event tickets from a Lovable app](https://events.vihaya.app/developers/lovable) — Add real ticket sales, QR tickets and payouts to a site you built with Lovable, using the Vihaya Events API as the backend. No payment gateway account and no ticketing code.
- [Add event ticketing to a Next.js site](https://events.vihaya.app/developers/nextjs) — A complete Next.js ticketing flow with the Vihaya Events API: list events, take payment with Razorpay Checkout, issue QR tickets. About 60 lines, no payment gateway account.
- [Sell event tickets on your website without your own payment gateway](https://events.vihaya.app/developers/sell-tickets-without-payment-gateway) — Take UPI and card payments for event tickets on your own website without opening a Razorpay or Stripe account. Vihaya Events collects the payment and pays the organiser out by UPI.
- [An event ticketing API for India](https://events.vihaya.app/developers/ticketing-api-india) — The Vihaya Events API is a REST API for selling event tickets in India: UPI and card payments, QR tickets, gate check-in, webhooks and payouts. Seven official SDKs and a test mode.
- [Sell event tickets from a v0 app](https://events.vihaya.app/developers/v0) — Add real ticket sales, QR tickets and payouts to a Next.js app made with v0 by Vercel, using the Vihaya Events API as the backend. No payment gateway account.
- [Sell event tickets from a Bolt.new app](https://events.vihaya.app/developers/bolt) — Add real ticket sales, QR tickets and payouts to an app built with Bolt.new, using the Vihaya Events API as the backend. No payment gateway account.
- [Sell event tickets from a Replit app](https://events.vihaya.app/developers/replit) — Use Replit Agent to build an event ticketing site with the Vihaya Events API as the backend: payments, QR tickets, check-in and payouts. No payment gateway account.
- [Build an event ticketing site with Cursor](https://events.vihaya.app/developers/cursor) — Use Cursor to build your own branded event site with Vihaya Events as the backend for payments, QR tickets, check-in and payouts. Includes the prompt and the MCP setup.
- [Build an event ticketing site with Windsurf](https://events.vihaya.app/developers/windsurf) — Use Windsurf to build your own branded event site with Vihaya Events as the backend for payments, QR tickets, check-in and payouts. Includes the prompt and the MCP setup.
- [Build an event ticketing site with Claude Code](https://events.vihaya.app/developers/claude-code) — Use Claude Code to build your own branded event site with Vihaya Events as the backend for payments, QR tickets, check-in and payouts. Includes the prompt and the MCP setup.
- [Build an event ticketing site with GitHub Copilot](https://events.vihaya.app/developers/github-copilot) — Use GitHub Copilot to build your own branded event site with Vihaya Events as the backend for payments, QR tickets, check-in and payouts. Includes the prompt and the MCP setup.
- [Sell event tickets on a Webflow site](https://events.vihaya.app/developers/webflow) — Add a real booking form with UPI and card payments and QR tickets to a Webflow site, using the Vihaya Events API. Paste one code embed; no payment gateway account.
- [Sell event tickets on a WordPress site](https://events.vihaya.app/developers/wordpress) — Add a booking form with UPI and card payments and QR tickets to WordPress, using the Vihaya Events API. No plugin to install and no payment gateway account.
- [Sell event tickets on a Framer, Wix, Squarespace or Carrd site](https://events.vihaya.app/developers/website-builders) — The quickest way to sell event tickets from any website builder: a button to your Vihaya Events page, which takes UPI and card payments and emails QR tickets. No code needed.

## Frequently asked questions

### What is the Vihaya Events API?

The Vihaya Events API is a REST API that works as the backend for your own event website. It handles events, bookings, Razorpay payments, QR tickets, ticket emails, gate check-in and organiser payouts, so you only build the front end.

### Do I need my own Razorpay or payment gateway account?

No. Buyers pay through Vihaya’s Razorpay account. The organiser withdraws from the Vihaya dashboard and the money lands by UPI in about two working days. You never open, verify or integrate a payment gateway of your own.

### How much does the Vihaya Events API cost?

API access is free and there is no monthly plan. Free events cost nothing. Paid tickets carry a 1.75–4.5% platform fee, minimum ₹3 and maximum ₹75 per ticket, plus Razorpay’s 3% gateway charge.

### Can I keep my own brand and domain?

Yes. You design and host the front end on your own domain, in any framework. Vihaya Events runs behind it. The ticket email can come from Vihaya, or from your own server using the registration.confirmed webhook.

### Does it work with Lovable, v0, Bolt, Replit, Cursor and Claude Code?

Yes. Any app builder or coding assistant whose code can make HTTP requests can use the Vihaya Events API. Point it at the API reference and the OpenAPI spec, and use a checkout key if the code runs in the browser.

### Is it safe to call the API from the browser?

Use a checkout key in the browser. A Vihaya checkout key can list events, book tickets and read seat counts, but never the attendee list. It can be locked to your domain. Keep full keys on a server.

### Which programming languages have an official SDK?

Vihaya Events has official SDKs for JavaScript / TypeScript, Python, PHP, Ruby, Go, Java / Kotlin, Flutter / Dart. The SDKs cover listing events, booking and verifying payment. Every other endpoint is plain REST with an x-api-key header.

### Can I test without real money?

Yes. A Vihaya test key only works on test events. No payment gateway is called, no email is sent, no fee is charged and nothing is public. Swap in a live key when you launch.

### How many API calls does a booking take?

A free booking is one call to POST /events/{id}/register and is confirmed immediately. A paid booking is two calls: one returns a Razorpay order, and the second confirms it with the payment id after Checkout.

### What happens if the buyer closes the tab after paying?

Vihaya Events still confirms the booking. Razorpay notifies Vihaya’s webhook when the order is paid, and Vihaya confirms the registration and emails the ticket even if the buyer’s browser never comes back.

### How do attendees check in at the event?

Every confirmed booking gets a ticket whose QR code is the registration id. Organisers scan it at the entrance from any phone using the Vihaya dashboard. Team bookings get one ticket per member.

### Does the Vihaya Events API have webhooks?

Yes. Vihaya sends a signed registration.confirmed webhook when a booking is confirmed and its ticket issued. It is the only webhook event today. Set the URL and secret in the dashboard or through the API.

### How do organisers get paid?

Organisers request a withdrawal from the Vihaya dashboard to their UPI ID. Transfers land in about two working days, and the minimum withdrawal is ₹100. Payments do not settle directly into the developer’s own gateway account.

### Can I manage events from Claude or another AI assistant?

Yes. Vihaya Events has an MCP server, so Claude can create, publish and track events and read sales by chatting. It uses the same API key and permissions as the REST API. The setup guide is at events.vihaya.app/connect.

### How do I get started?

Sign up at events.vihaya.app, verify your email, and open Developer, then API keys. Create a free test key and follow the three steps on this page. Switch to a live key when you are ready to sell.


---

Canonical URL: https://events.vihaya.app/developers
Last updated: 2026-10-04
API reference: https://events.vihaya.app/docs
OpenAPI spec: https://events.vihaya.app/api/v1/openapi.json
Brief AI index: https://events.vihaya.app/llms.txt
Full AI index: https://events.vihaya.app/llms-full.txt
