Wie man Razorpay im CRM integriert

Business User können Zahlungen über Razorpay, einen in Indien weit verbreiteten Payment Provider, abwickeln. Die Integration ist als Marketplace App im App Marketplace innerhalb eines Sub-Accounts verfügbar und auch über „Search for More“ in Payments → Integrations auffindbar.

Die Integration ermöglicht:

• Einmalzahlungen

• Custom Amount Payments

• Wiederkehrende Zahlungen (Subscriptions)

• Nutzung über Order Forms, Invoices, Payment Links, Forms und Contacts

• Subscription Management (Kündigung, Card Updates, Refunds)

  

Voraussetzungen

Sub-Account User müssen:

• die App aus dem Marketplace installieren

• sich mit API Keys authentifizieren

• notwendige Berechtigungen freigeben

  

Schritt-für-Schritt Setup

1. Razorpay App installieren

Gehe in den App Marketplace und installiere die Razorpay App.

2. API Keys eintragen (Authentifizierung)

• Öffne dein Razorpay Dashboard
  → Accounts & Settings → API Keys

• Kopiere:

  • Key ID

  • Key Secret

• Füge diese in der Auth-Seite der Integration ein

  

3. Webhooks konfigurieren

Im Razorpay Dashboard:

Accounts & Settings → Webhooks

Füge folgende URL hinzu:

https://backend.leadconnectorhq.com/razorpay/webhook

Aktiviere alle payment-related events, damit Sync und Status-Updates korrekt funktionieren.

4. Domain whitelisten (sehr wichtig)

In deinem CRM:

• Gehe zu
  Settings → Business Profile → Branded Domain

• Domain hinzufügen und speichern

In Razorpay:

• Gehe zu
  Accounts & Settings → Business Website Details → Add Additional Website/App Details

• Trage exakt dieselbe Domain ein

Warum das wichtig ist

Razorpay erlaubt Payments nur von verifizierten/whitelisted Domains.

Wenn die Domain fehlt, kann dieser Fehler auftreten:

Payment attempted … from web domain link.fastpaydirect.com has failed

Wichtige Hinweise zur Funktionsweise

• Die Integration verhält sich wie Stripe/NMI/Authorize.net im CRM

• Unterstützt:

  • Automationen nach Zahlung

  • Refunds

  • Payment Received / Order Submitted Trigger

  • Coupons & Discounts

Einschränkungen

• ❌ SaaS Mode wird nur eingeschränkt unterstützt

• ❌ Wallet recharges werden nicht unterstützt

• ❌ Keine Off-Session Charges (Saved Cards für spätere automatische Abbuchung)

Grund:

Razorpay unterstützt über diese Integration keine Off-Session Card Charges.
Nur fixe Subscription-Zyklen sind möglich.

FAQ (wichtig)

Fehler: Domain nicht registriert

Wenn du eine Mail von Razorpay bekommst wie:

payment attempted on merchant ID from domain link.fastpaydirect.com has failed

Dann bedeutet das:

• Deine echte Domain ist nicht in Razorpay whitelisted

• GHL Default Domain (link.fastpaydirect.com) ist nicht gültig für dein Merchant Account

Lösung:
→ Eigene Branded Domain in GHL setzen
→ Diese Domain in Razorpay hinzufügen