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 Symptom | Root Cause | Technical Impact | Corrective Action |
| ‘Payment Failed / Gateway Authentication Error’ | Test/Sandbox API keys left active in live store | Gateway rejects real customer cards/UPI | Replace Test Keys with Live API Keys in Settings > Payment |
| Payment debited from customer, but no order in admin | Webhook URL or Webhook Secret misconfigured | Shopiators server never receives payment confirmation | Configure active Webhook URL in Razorpay/Cashfree portal |
| UPI Apps (GPay / PhonePe) fail on mobile | Gateway account not approved for UPI intent flow | Mobile app switch fails to launch UPI app | Verify UPI activation status inside payment gateway dashboard |
| Gateway shows ‘Account Suspended / On Hold’ | Pending business KYC documents or tax filing | Gateway blocks all incoming payment processing | Submit 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]

