Back to Help Home
Integrations & API

Payment gateway setup (Razorpay/Stripe)

5 minutes read time Difficulty: intermediate

Payment gateway setup

Accept payments directly in WhatsApp conversations by sending payment links.

Supported gateways

GatewayRegionsCurrencies
RazorpayIndiaINR
StripeGlobalUSD, EUR, GBP, + 135 more

Setting up Razorpay

Prerequisites

  • A Razorpay account (razorpay.com)
  • API Key ID and Key Secret from Razorpay Dashboard

Configuration

  1. Go to Settings → Integrations (or contact admin)
  2. Find Razorpay section
  3. Enter:
    • Key ID — From Razorpay Dashboard → Settings → API Keys
    • Key Secret — The secret key (shown once when generated)
  4. Save

Testing

  • Use Razorpay's Test Mode keys first
  • Send a test payment link to yourself
  • Verify the payment flow works end-to-end
  • Switch to Live Mode keys for production

Setting up Stripe

Prerequisites

  • A Stripe account (stripe.com)
  • Publishable Key and Secret Key

Configuration

  1. Go to Settings → Integrations
  2. Find Stripe section
  3. Enter:
    • Publishable Keypk_live_... or pk_test_...
    • Secret Keysk_live_... or sk_test_...
  4. Save
  1. Open a conversation
  2. Click the 💳 Payment button in the header
  3. Fill in:
    • Amount — Payment amount
    • Currency — INR, USD, etc.
    • Description — What the payment is for (e.g., "Order #123")
  4. Click "Create & Send"

The customer receives a clickable payment link in WhatsApp. When they pay:

  • You receive a notification
  • The payment status updates in the conversation
  • A receipt is generated

Payment status tracking

StatusMeaning
CreatedLink sent, awaiting payment
PaidCustomer completed payment ✅
FailedPayment attempt failed
ExpiredLink expired (configurable timeout)

Tips

  1. Include order details — Clear descriptions reduce payment disputes
  2. Set expiry — Payment links should expire after 24-48 hours
  3. Follow up — If not paid within a few hours, send a reminder
  4. Test first — Always test with test mode keys before going live
  5. Keep records — Payment IDs are logged for reconciliation

Security

  • API keys are encrypted at rest in AIsoule
  • Payment processing happens directly between customer and gateway
  • AIsoule never stores card numbers or sensitive payment data
  • All payment links use HTTPS

Was this guide helpful?

Your feedback helps us make these guides better for everyone.