one-time-payment

Razorpay One-Time Payments

Two flows for one-time payments: Order flow (Razorpay JS SDK popup) and Invoice flow (hosted page). Both require server-side HMAC verification.

One-Time Payments vs Subscriptions: Completely Different Checkout

This is a common source of confusion. One-time payments and subscriptions use entirely different APIs and checkout experiences:

Do NOT mix these up. You cannot use short_url for one-time orders, and you cannot use the JS SDK popup for subscriptions (it technically works but breaks on mobile/popup blockers).

Flow 1: Order + JS SDK (Recommended for UX)

Create Order (Server)

// app/api/billing/create-order/route.ts
export async function POST(request: Request) {
  const user = await getAuthenticatedUser(request);
  const { productKey, amountPaise } = await request.json();

  try {
    const order = await razorpay.orders.create({
      amount: amountPaise,       // Amount in paise (e.g., 11682 for Rs 116.82)
      currency: "INR",
      receipt: `${productKey}_${user.id}_${Date.now()}`,
      notes: {
        userId: user.id,
        productKey,
      },
    });

    return Response.json({
      orderId: order.id,
      amount: order.amount,
      currency: order.currency,
      keyId: process.env.NEXT_PUBLIC_RAZORPAY_KEY_ID,
    });
  } catch (error) {
    console.error("Failed to create order:", error);
    return Response.json({ error: "Something went wrong" }, { status: 500 });
  }
}