Payment Gateways

Who can use this?

• Gallabox users with Integrations access.
• Roles: Owners and Admins

Payment gateway integrations let you collect payments directly within WhatsApp conversations — send a payment link without redirecting customers to a separate storefront.

Plan Availability

Gateway	Plan Required	Market
Razorpay	Basic, Essential, Advanced	India
Stripe	Basic, Essential, Advanced	Global
Cashfree	Basic, Essential, Advanced	India
PhonePe	Basic, Essential, Advanced	India

Razorpay

What Razorpay integration does

Connects your Razorpay account to Gallabox — generate payment links from inside bot flows.

Note: Razorpay is available on Basic, Essential, and Advanced plans. Best for Indian businesses.

Supported Razorpay actions

• Create payment link — generate a shareable payment link with custom amount and validity

Note: Refunds are processed in the Razorpay Dashboard — they’re not available as a bot flow action. You can still notify customers automatically when a refund is processed by using Razorpay’s refund webhook event with a workflow.

How to connect Razorpay

1. Go to Integrations → Razorpay
2. Click Connect — you’ll be redirected to Razorpay to sign in and authorize Gallabox (OAuth — you log into Razorpay directly, Gallabox never sees your password)
3. Once authorized, the connection appears in your Integrations list

Note: Razorpay has two environments — test (for testing) and live (for real payments). Make sure you connect the correct one for your use case.

Reconnecting Razorpay

The Razorpay authorization token expires periodically — this is Razorpay’s security design, not an error. When it expires:

• Payment link actions in bot flows start failing, and you may receive an email titled “[ACTION REQUIRED] Reconnect your Razorpay Connection”
• To check: go to Integrations → Razorpay — an expired connection shows a reconnect prompt
• To fix: click Reconnect and complete the Razorpay sign-in again — your bot flows resume working immediately; no flow changes are needed

Razorpay use cases

Send a payment link via WhatsApp:

Ask Amount → "Enter the amount to pay (in ₹)"
  → Store in {{payment_amount}}

Razorpay: Create payment link
  Amount: {{payment_amount}}
  Purpose: "Order payment"
  Validity: 24 hours
  Customer contact: {{contact.phone}}
  → Store payment_link in {{razorpay_link}}

Send Text: "Here's your payment link — valid for 24 hours: {{razorpay_link}}"

Confirm the payment once the customer pays:

The Create payment link connector doesn’t wait for the customer to pay. It creates the link, and the flow moves straight on. To confirm the payment, set up the Razorpay Payment Captured workflow. When Razorpay reports the payment, Gallabox sends the template you chose to the customer. Add a button payload to the template if you want a bot to start when the customer taps it.

Bot flow: Razorpay: Create payment link → Send Text: "Complete your payment: {{razorpay_link}}"

Customer pays via the link
  → Payment Captured workflow sends a template: "Payment received! Your order is confirmed."

See Workflows for Razorpay.

Stripe

What Stripe integration does

Connects your Stripe account to Gallabox — creates payment links from your Stripe products and prices, so customers can pay via a secure Stripe checkout page. Advanced plan only.

Note: Stripe is available on Advanced plan only and supports global payment methods including cards, bank transfers, and wallets.

Supported Stripe actions

• Create payment link — generate a Stripe payment link for a selected product and price
• Select product — choose from your active Stripe products when configuring the action
• Select price — choose from the active prices of the selected product

Note: Refunds, subscriptions, and customer management are handled in the Stripe Dashboard — they’re not available as bot flow actions.

How to connect Stripe

1. Go to Integrations → Stripe
2. Enter your Stripe Secret API Key (from Stripe Dashboard → Developers → API Keys)
3. Click Connect — the connection appears in your Integrations list

Note: Stripe has test mode and live mode. When testing, use a Stripe test API key — switch to your live key before going public.

Stripe use cases

Send a Stripe payment link:

Ask Product → "What would you like to buy?"
  → Store in {{product_name}}

Stripe: Create payment link
  Product: {{product_name}} (selected from your Stripe products)
  Price: selected Stripe price
  Quantity: 1
  → Store payment link URL in {{stripe_checkout_link}}

Send Text: "Complete your purchase: {{stripe_checkout_link}}"

PhonePe

What PhonePe integration does

Connects your PhonePe merchant account to Gallabox — generates PhonePe payment links from inside bot flows, so customers can pay via UPI and the PhonePe app.

Supported PhonePe actions

• Create payment link — generate a PhonePe payment link for a given amount

How to connect PhonePe

1. Go to Integrations → PhonePe
2. Enter your PhonePe Merchant ID, Salt Key, and Salt Index (from your PhonePe Business dashboard)
3. Click Connect

PhonePe use cases

Ask Amount → "Enter the amount to pay (in ₹)"
  → Store in {{payment_amount}}

PhonePe: Create payment link
  Amount: {{payment_amount}}
  → Store link in {{phonepe_link}}

Send Text: "Pay securely via PhonePe: {{phonepe_link}}"

Cashfree

What Cashfree integration does

Connects your Cashfree account to Gallabox — sends automatic WhatsApp notifications to customers when payments are captured or fail. Unlike Razorpay and Stripe, Cashfree is a workflow integration: it doesn’t create payment links from bot flows; it reacts to payment events from Cashfree via webhook.

Available workflows

• Payment Success — template sent automatically when a payment is captured
• Payment Failed — template sent automatically when a payment fails

For each workflow, pick a message template, map the variables, and optionally add a button payload to trigger a bot in response.

How to connect Cashfree

1. Go to Integrations → Cashfree, click Connect, name the integration, and click Submit — Gallabox generates a Webhook URL
2. In Cashfree: Developers → Webhooks → Add Webhook Endpoint, paste the Gallabox webhook URL and choose the webhook version
3. Click Test to verify the endpoint, then select all events and click Add Webhook
4. Back in Gallabox, choose the WhatsApp channel and click Update Configurations

Note: If the test returns “Merchant Key is not present”, generate an API key in Cashfree first (Developers → API Keys → Generate API Key).

Cashfree use cases

Customer pays via Cashfree checkout
  → Payment Success workflow fires
  → Template: "Payment of ₹{{amount}} received! Your order {{order_id}} is confirmed."

Payment fails
  → Payment Failed workflow fires
  → Template: "Your payment didn't go through. Tap below to retry." (button triggers retry bot)

To disable a workflow, toggle off the switch beside it.

Comparing Razorpay vs Stripe

Feature	Razorpay	Stripe
Availability	Basic+	Advanced only
Market	India	Global
Payment methods	UPI, cards, wallets, net banking	Cards, bank transfer, wallets, buy-now-pay-later
WhatsApp Pay	✓	—
Multi-currency	INR only via Gallabox	✓
Dashboard	Razorpay	Stripe Dashboard
Authentication	OAuth (expiring token)	Secret API Key

FAQs

Can customers pay directly in WhatsApp without leaving the chat?

On WhatsApp, customers can tap a payment button (WhatsApp Pay) if they have WhatsApp Payments set up with a linked bank account. For Razorpay and Stripe, customers are redirected to a secure payment page (via a link) — they complete payment in their browser or payment app, then return to the conversation. A payment link doesn’t pause the bot, so the flow doesn’t continue when the customer pays. Use the gateway’s payment workflows to confirm link payments.

Can a bot wait until the customer has paid?

Only for WhatsApp Pay. The Ask WhatsApp Payment node sends a payment request and pauses the bot. When WhatsApp reports the result, the bot continues on the success branch or the failure branch. It needs WhatsApp Pay connected.

Payment links from Razorpay, Stripe, and PhonePe don’t pause the bot. Razorpay, Stripe, and Cashfree have workflows that send a template when the payment comes through. PhonePe doesn’t have payment workflows.

• Workflows for Razorpay
• Stripe Workflows
• Workflows for Cashfree

What happens if a payment fails?

It depends on how the customer was asked to pay.

• WhatsApp Pay (Ask WhatsApp Payment node): the bot continues on the failure branch. Use it to tell the customer and offer another try.
• Payment link: the bot isn’t notified. With Razorpay, Stripe, or Cashfree, set up the gateway’s Payment Failed workflow to send the customer a template automatically. Add a button payload to the template if you want a retry bot to start when they tap it.

Ask WhatsApp Payment
  → on success: Send Text: "Payment received! Your order is confirmed."
  → on failure: Send Text: "Your payment didn't go through. Please try again or use a different payment method."

If the customer doesn’t pay at all, the bot waits until its wait time runs out and then drops off. See Bot wait time and drop-off.