admin

Razorpay Admin Operations

Run these commands directly to query and manage your Razorpay account. All commands use the Razorpay REST API with basic auth.

Before running: Ensure RAZORPAY_KEY_ID and RAZORPAY_KEY_SECRET are set in your environment or .env.local. If not, ask the user for their key ID and secret.

# Load env vars if using .env.local
export RAZORPAY_KEY_ID=$(grep RAZORPAY_KEY_ID .env.local | head -1 | cut -d'=' -f2)
export RAZORPAY_KEY_SECRET=$(grep RAZORPAY_KEY_SECRET .env.local | head -1 | cut -d'=' -f2)

Authentication

All API calls use HTTP Basic Auth: -u $RAZORPAY_KEY_ID:$RAZORPAY_KEY_SECRET

Test keys (rzp_test_) only access test data. Live keys (rzp_live_) only access live data.

---

Payments

Fetch a specific payment

curl -s -u $RAZORPAY_KEY_ID:$RAZORPAY_KEY_SECRET \
  https://api.razorpay.com/v1/payments/pay_xxxxx | jq .

Key fields: id, amount (paise), status (created|authorized|captured|refunded|failed), method, email, subscription_id, order_id, created_at

List recent payments

# Last 10 payments
curl -s -u $RAZORPAY_KEY_ID:$RAZORPAY_KEY_SECRET \
  "https://api.razorpay.com/v1/payments?count=10" | jq '.items[] | {id, amount, status, method, email, created_at}'

List payments by subscription

curl -s -u $RAZORPAY_KEY_ID:$RAZORPAY_KEY_SECRET \
  "https://api.razorpay.com/v1/subscriptions/sub_xxxxx/payments" | jq '.items[] | {id, amount, status, method, created_at}'

Filter payments by status

# Failed payments only
curl -s -u $RAZORPAY_KEY_ID:$RAZORPAY_KEY_SECRET \
  "https://api.razorpay.com/v1/payments?count=20" | jq '.items[] | select(.status == "failed") | {id, amount, error_code, error_description}'

---

Subscriptions

Fetch a specific subscription

curl -s -u $RAZORPAY_KEY_ID:$RAZORPAY_KEY_SECRET \
  https://api.razorpay.com/v1/subscriptions/sub_xxxxx | jq .

Key fields: id, plan_id, status (created|authenticated|active|halted|cancelled|completed|paused), current_start, current_end, total_count, paid_count, remaining_count, short_url, notes