Shopiators LogoShopiators LogoDocs
Go to App
Documentation Home
START HERE20
AI COMMERCE20
BUSINESS GROWTH20
MERCHANT GUIDES206
  • ACCOUNT & SETTINGS15
  • CUSTOMERS18
  • DISCOUNTS & PROMOTIONS19
  • DOMAINS AND SEO17
  • GETTING STARTED20
  • MARKETING & GROWTH20
  • ORDERS19
  • PAYMENTS15
  • PRODUCTS And CATALOG20
  • SHIPPING & DELIVERY13
  • STORE SETUP5
  • STOREFRONT & DESIGN5
  • TROUBLESHOOTING20
MERCHANT WORKFLOWS20

© 2026 Shopiators Documentation. All rights reserved.

Visit Shopiators Application →
Docs/merchant guides/Payment Is Failing: What Should I Check?

Payment Is Failing: What Should I Check?

Executive Overview

Online payment gateway failures are the single most urgent technical emergency an ecommerce business can face. When a customer attempts to pay via UPI, credit card, or net banking and the transaction fails—or worse, money is debited from their bank account but no order appears in your dashboard—it causes severe customer distress and immediate lost revenue. Payment failures in Shopiators almost always result from three specific technical friction points: mismatched Sandbox/Live API credentials, incomplete payment gateway KYC verification, or missing webhook secrets.

1. Tactical Framework & Decision Matrix

The matrix below provides clear, actionable criteria for diagnosing and resolving this issue:

Payment Error SymptomRoot CauseTechnical ImpactCorrective Action
‘Payment Failed / Gateway Authentication Error’Test/Sandbox API keys left active in live storeGateway rejects real customer cards/UPIReplace Test Keys with Live API Keys in Settings > Payment
Payment debited from customer, but no order in adminWebhook URL or Webhook Secret misconfiguredShopiators server never receives payment confirmationConfigure active Webhook URL in Razorpay/Cashfree portal
UPI Apps (GPay / PhonePe) fail on mobileGateway account not approved for UPI intent flowMobile app switch fails to launch UPI appVerify UPI activation status inside payment gateway dashboard
Gateway shows ‘Account Suspended / On Hold’Pending business KYC documents or tax filingGateway blocks all incoming payment processingSubmit required corporate documents in gateway KYC portal

2. Step-by-Step Shopiators Implementation

Step 1: Verify Live API Key and Secret in Payment Settings

In the Shopiators Admin Panel, navigate to Settings > Payment. Click on your primary gateway (e.g., Razorpay or Cashfree). Ensure that Test Mode is toggled Off. Verify that the Key ID begins with `rzp_live_` (NOT `rzp_test_`).

Step 2: Check Webhook Endpoint and Secret Configuration

Log into your Razorpay or Payment Gateway dashboard. Navigate to Settings > Webhooks. Confirm that your Shopiators webhook endpoint URL is active and subscribed to the `order.paid` and `payment.captured` events. Ensure the Webhook Secret entered in Shopiators matches the gateway exactly.

Step 3: Conduct a Live ₹10 Transaction via UPI

Visit your storefront on a mobile smartphone, select a low-ticket item, and execute a live transaction using Google Pay or PhonePe. Confirm that the payment captures, the screen redirects to the Thank You page, and the order registers instantly under Sales > Orders.

3. Operational Pro-Tips & Common Pitfalls

💡 **Operational Pro-Tip:** If a customer states money was deducted from their account but no order generated, look up their Payment ID in your Razorpay dashboard. If the payment shows ‘Captured’, you can manually create their order in Sales > Orders.

⚠️ **Pre-Launch Warning:** Never share your Payment Gateway API Secret Key in public chat groups or support emails. Anyone with access to your Secret Key can initiate unauthorized programmatic refunds.

4. Related Documentation & Next Guides

•  [How to Configure Store Payments]

•  [COD Is Not Available at Checkout]

•  [My Customer Cannot Place an Order]

←PreviousHow to Configure NotificationsNext→How Much Should I Spend on Marketing?