Kraya-AI Docs
Integrations

Razorpay Leads

Turn completed Razorpay payments into Kraya leads — self-serve setup, pipeline/stage routing, automatic deduplication by phone and email.

Razorpay Leads Integration

  • Where in Kraya
    • Page: https://kraya-ai.com/dashboard/razorpay-leads-integration
  • What it does
    • Creates a lead in Kraya every time someone completes a payment on your Razorpay account.
    • Self-serve — you set it up in Kraya in a few clicks and paste a couple of values into your Razorpay dashboard.

Overview

Razorpay is a popular payments platform in India. When a buyer pays you on Razorpay, Razorpay can tell Kraya automatically, and Kraya creates or updates a lead with that buyer's name, email, and phone — routed to the pipeline and stage you choose.

This is a one-way integration — payment information flows from Razorpay into Kraya. Kraya does not push anything back to Razorpay.


What you can do

  • Have completed Razorpay payments appear as leads in Kraya without manual entry
  • Route Razorpay leads into a specific pipeline and stage of your choice
  • See each buyer's name, email, and phone on the new lead, plus the payment amount for context
  • Rely on automatic deduplication — repeat purchases by the same buyer refresh the existing lead instead of creating duplicates
  • Pause the integration at any time without deleting it

How it works

  1. In Kraya, you open the Razorpay Leads Integration page and click Generate to create your own webhook address and a private key.
  2. In your Razorpay dashboard, you paste those two values into Razorpay's Webhooks section and tell Razorpay to notify Kraya whenever a payment is completed.
  3. Each time a buyer pays you on Razorpay, Razorpay sends the payment details to Kraya.
  4. Kraya creates a new lead (or updates an existing one matched by phone or email), routes it to your chosen pipeline and stage, and tags the lead source as Razorpay.

Payment events other than completed payments (refunds, failed attempts, settlements) don't create leads.


Setup

  1. Generate your webhook address and key in Kraya
  • Open Dashboard → Razorpay Leads Integration (/dashboard/razorpay-leads-integration).
  • Click Generate. Kraya shows you a webhook URL and a private key. Copy both.
  • Tip: the key is shown only once. Copy it now — Kraya doesn't display it again. You can always regenerate later if you lose it.
  1. Pick the destination pipeline and stage
  • Still on the integration page, choose where new Razorpay leads should land — Pipeline and Stage.
  • Leave it as-is to fall back to your Leads pipeline at the New Lead stage.
  • Existing leads (matched by phone or email) stay where they are on repeat purchases — only their details are refreshed.
  1. Configure the webhook in Razorpay
  • In your Razorpay dashboard, open Account & Settings → Webhooks.
  • Click Add New Webhook.
  • Webhook URL — paste the URL you copied from Kraya.
  • Secret — paste the private key you copied from Kraya. It must match exactly.
  • Active events — pick the payment completed event (called order.paid in Razorpay's list).
  • Save.
  1. Test it
  • Run a small test payment through your Razorpay checkout, or use Razorpay's "Send Test Webhook" feature on the Webhooks page.
  • Search for the buyer in Kraya by phone or email — the lead should appear within a few seconds.

What gets saved

From RazorpayWhere it lands in Kraya
Buyer emailLead Email
Buyer phoneLead Phone (normalized to your default country code)
Buyer nameLead Name
Payment amount + currencySaved on the lead for reference
Payment descriptionSaved on the lead as a context note
SourceSet to Razorpay so you can filter and report on it
Pipeline + StagePer your integration settings (or Leads / New Lead by default)

How dedup works

For every completed payment from Razorpay:

  1. Phone match — if a lead in your organization already has the same phone number, that lead is updated (no new lead).
  2. Email match — if there's no phone match but the buyer's email matches an existing lead, that lead is updated.
  3. New lead — otherwise, a new lead is created in your chosen pipeline and stage.

So repeat buyers always show up as one lead with the latest details, not a separate lead per order.


Settings and configuration

  • Webhook URL — a unique address per organization. Razorpay must call this exact URL.
  • Private key (secret) — used to confirm that incoming requests really came from your Razorpay account. Treat it like a password — don't share it.
  • Pipeline and Stage — where new Razorpay leads land. Change anytime from the integration page; existing leads aren't moved.
  • Active toggle — on by default. Turn off to temporarily stop Kraya from creating leads from Razorpay, without removing the webhook on Razorpay's side.

Day-to-day usage

  • Leads from Razorpay appear in your chosen pipeline within a few seconds of the payment completing.
  • They behave like any other lead — you can attach Auto Followups, Smart Triggers, AI Qualification, and any other automation.
  • The integration page shows your webhook URL at any time (the key is hidden after first generation).
  • Use Regenerate Key if you suspect the key has been exposed. Important: the old key stops working immediately, so paste the new one into Razorpay's webhook settings right after, or new payments won't reach Kraya.

Edge cases to expect

  • Refunds, failed payments, settlement events — these don't create leads. Only a completed payment does.
  • Missing email or phone — Kraya creates the lead with whatever Razorpay sends. If both are missing, the lead can't be created.
  • Test mode — Razorpay test-mode payments behave the same as real ones. Keep test and live separate, or expect test buyers to show up as leads.
  • Same buyer, multiple orders — Kraya updates the same lead each time, so you have one lead per buyer, not one per order. Use Razorpay's own dashboard for the full order history.
  • Free-plan Kraya organisations — on Kraya's free pack, inbound lead-import sources may not actually create leads. Check with your Kraya POC if you're unsure.

Troubleshooting

"Completed payments in Razorpay but no lead in Kraya"

  • Cause: the wrong URL or key was pasted into Razorpay, or the wrong event was selected.
  • Fix:
    1. Open the Razorpay Webhooks page and inspect recent deliveries. If they show failures, the URL or key is wrong.
    2. Regenerate the key in Kraya, paste it back into Razorpay, save.
    3. Confirm the payment completed event (order.paid) is in the active events list.

"Lead appeared but in the wrong pipeline"

  • Cause: the integration's default pipeline was set after the payment came in, or a Smart Trigger moved the lead.
  • Fix: open the integration page, set the correct Pipeline and Stage, save. Future leads will use the new defaults; existing leads stay where they are.

"Same lead's name keeps getting overwritten"

  • Cause: each new payment refreshes the lead with the latest values from Razorpay. If the same buyer pays from a different account or with a different name, the lead picks up the latest name.
  • Fix: this is expected for repeat buyers. If you need to preserve a specific value, edit the lead manually — but it will be overwritten again on the next payment.

Decision tree

  • Nothing appears after a completed payment → check Razorpay's webhook delivery log → fix URL/key if it shows failures → retry.
  • Lead created with the wrong pipeline → update the integration's default and save.
  • Lead created but missing email or phone → check the Razorpay order; some checkout flows don't capture both.

FAQs

  • Is this real-time? Yes. Most leads appear within seconds of the payment completing.

  • Does Kraya send anything back to Razorpay? No. The integration is one-way (Razorpay → Kraya).

  • Can I rotate the key? Yes. Click Regenerate Key on the integration page. The old key stops working immediately, so update Razorpay's webhook settings with the new key right after.

  • Can I subscribe to other Razorpay events? You can, but only payment completed (order.paid) actually creates leads in Kraya.

  • Can I pause it without removing the webhook? Yes — use the Active toggle on the integration page.

  • Can I run Razorpay leads through AI Qualification and Auto Followup sequences? Yes. Once the lead is in Kraya, it behaves like any other lead.

  • Will reconnecting create duplicate leads? No. Matching is by phone number (then email) within your organization.


Tips and best practices

  • Generate the key, paste it into Razorpay immediately, and avoid sharing it in chat or email.
  • Pick the destination Pipeline and Stage before you do your first test payment, so you don't have to manually move test leads.
  • Keep Razorpay test mode webhooks pointed at a separate Kraya organization (or accept that test payments will create leads in production).


Screenshots

On this page