A Step-by-Step Guide to Integrating Payment Gateways with ERPNext

By WovLab Team | April 17, 2026 | 9 min read

Why Integrating a Payment Gateway with ERPNext is Crucial for Automation

In today's fast-paced digital economy, a successful erpnext payment gateway integration is no longer a luxury—it's the backbone of financial automation for any growing business. Manually tracking payments, reconciling bank statements, and updating invoices is a time-consuming process riddled with the potential for human error. By directly connecting a payment gateway to your ERPNext system, you create a seamless, automated workflow. When a customer pays an invoice online, the payment is instantly captured, a Payment Entry is automatically created and reconciled against the corresponding Sales Invoice, and your financial statements are updated in real-time. This eliminates hours of manual data entry, significantly reduces the accounts receivable cycle, and provides an accurate, up-to-the-minute view of your company's cash flow. Research shows that businesses automating their accounts receivable processes can reduce invoice processing costs by over 80% and get paid up to 30% faster. This level of efficiency is not just about saving time; it's about unlocking strategic capital and empowering your team to focus on growth rather than administrative tasks.

Expert Insight: True financial automation isn’t just about accepting payments online. It’s about creating a closed-loop system where the transaction, accounting, and reconciliation happen simultaneously without manual intervention, providing unparalleled data integrity.

This integration enhances the customer experience dramatically. Instead of cumbersome bank transfers, clients receive a professional invoice with a simple "Pay Now" button, allowing them to pay instantly using their preferred method—be it credit card, debit card, UPI, or net banking. This convenience builds trust and encourages prompt payments, directly impacting your bottom line. At WovLab, we've seen clients transform their financial operations by moving from manual reconciliation to a fully integrated system, freeing up valuable resources and gaining a critical competitive edge.

Choosing the Right Payment Gateway for Your Indian Business

Selecting the right payment gateway is a critical decision, especially for businesses operating in India's diverse and rapidly evolving digital payment landscape. The ideal choice depends on factors like transaction fees (TDR), settlement times, supported payment methods (especially UPI and RuPay), and the quality of its ERPNext connector. While international players like Stripe offer excellent developer APIs and global currency support, homegrown heroes like Razorpay and PayU often provide better native support for popular Indian payment methods and more competitive pricing for local transactions. It’s crucial to look beyond the headline TDR and consider the total cost of ownership, including setup fees, annual maintenance charges, and the ease of integration. A gateway that is difficult to integrate can lead to higher development costs, negating any potential savings on transaction fees.

To help you decide, we've compiled a comparison of leading gateways for the Indian market:

For most Indian businesses whose primary customer base is domestic, Razorpay is often the top contender due to its seamless UPI functionality, straightforward pricing, and a very stable, easy-to-configure ERPNext connector. However, if your business model involves significant international sales, Stripe's superior multi-currency handling and global presence might be more advantageous.

Step-by-Step: A Guide to erpnext payment gateway integration with Razorpay

Integrating a payment gateway like Razorpay or Stripe into ERPNext is a straightforward process thanks to the platform's built-in connectors. This guide will walk you through setting up Razorpay, as it's a popular choice for Indian businesses. The steps for Stripe are very similar.

1. Generate API Keys in Razorpay:
   • Log in to your Razorpay Dashboard.
   • Switch to Live Mode (or Test Mode for testing).
   • Navigate to Settings → API Keys.
   • Click Generate Live Key.
   • Securely copy the generated Key ID and Key Secret. You will not be able to see the Key Secret again, so store it safely.
2. Configure the Gateway in ERPNext:
   • In your ERPNext account, use the awesome bar to search for "Payment Gateway Account" and go to the list.
   • Click on the "+ Add Payment Gateway Account" button.
   • In the "Payment Gateway" field, select "Razorpay" from the dropdown menu.
3. Enter Your Credentials:
   • A new form will appear. Give this configuration a title, for example, "Razorpay Live Account".
   • Paste the Key ID and Key Secret you copied from the Razorpay dashboard into their respective fields.
   • Select the Company this gateway account will be associated with.
   • In the "Payment Account" table, specify the default receivable account (e.g., Debtors) and the currency (e.g., INR). This tells ERPNext which account to use for the transaction entries.
4. Enable and Save:
   • Ensure the "Is Default" checkbox is ticked if you want this to be your primary payment gateway.
   • Click Save.

That's it! Your Razorpay gateway is now linked. To activate it on your invoices, navigate to Print Settings, select the "Sales Invoice" doctype, and ensure your new Payment Gateway is enabled in the print format. Now, your invoices will include a payment link.

Customizing Payment Settings: Transaction Fees, Currencies, and Checkout Experience

A basic erpnext payment gateway integration is a great start, but true optimization comes from customizing the settings to match your business logic. ERPNext provides powerful tools to handle common scenarios like transaction fees and multi-currency operations without writing a single line of code. The key to this is the Payment Gateway Rule doctype.

Let's say your gateway charges a 2% transaction fee, and you want to pass this cost to the customer. Instead of manually adding it to each invoice, you can automate it:

1. Go to Payment Gateway Rule list and click "+ Add Payment Gateway Rule".
2. Set the Payment Gateway to "Razorpay".
3. In the "Payment Channel" field, you can specify a channel like "Credit Card" if the fee is specific to that method.
4. Set the Account to a specific expense account in your Chart of Accounts, like "Payment Gateway Fees". This ensures all charges are correctly logged for accounting purposes.
5. Set the Transaction Fee (%) to 2.
6. Save the rule.

Now, when a payment is made through Razorpay, ERPNext will automatically calculate the 2% fee and create a Journal Entry to book it as an expense, ensuring your P&L statement remains accurate. This simple automation prevents revenue leakage and saves hours of manual reconciliation.

Pro Tip: Use Payment Gateway Rules to direct different currencies to different gateways. For instance, you could create a rule to process all INR transactions through Razorpay and all USD transactions through Stripe to take advantage of the best TDR for each currency.

For further customization, ERPNext's checkout page can be modified. While this requires technical knowledge (HTML, Jinja templating), you can change the look and feel to match your brand, add trust badges, or display custom messages. This is done by editing the `www/checkout.html` file within your Frappe bench. For businesses seeking a highly branded and seamless checkout flow, this level of customization is invaluable. It transforms the generic payment page into a cohesive part of your brand's digital experience.

Testing Your Integration and Troubleshooting Common Errors

Before you go live and start accepting real payments, it is absolutely critical to thoroughly test your integration in a controlled environment. Both Razorpay and Stripe offer a "Test Mode" for this exact purpose. Using test API keys and their provided test card numbers, you can simulate transactions without any real money changing hands. This allows you to verify the entire workflow from end to end.

Here is a simple checklist for testing your erpnext payment gateway integration:

• Create a Test Configuration: Set up a new Payment Gateway Account in ERPNext using your gateway's test API keys.
• Generate a Test Invoice: Create a Sales Invoice for a dummy customer. Ensure the amount is low, e.g., ₹10.00.
• Initiate Payment: Open the invoice and click the "Pay Now" link. You should be redirected to the gateway's test checkout page.
• Complete Test Transaction: Use the test card details provided in your gateway's documentation to complete the payment.
• Verify Payment Entry: Check ERPNext. A new Payment Entry should be automatically created and submitted, linked to the Sales Invoice. The invoice status should change to "Paid".
• Check Logs: Review the transaction logs in both your ERPNext error log and the payment gateway's dashboard to ensure there are no errors.

Even with careful setup, you might encounter issues. Here are some common errors and how to fix them:

• Authentication Failed / API Key Error: This almost always means you have copied the Key ID or Key Secret incorrectly. Carefully copy and paste them again. Also, ensure you are using Live keys for Live mode and Test keys for Test mode.
• Payment Succeeded but Not Recorded in ERPNext: This is typically a webhook issue. Webhooks are how the payment gateway communicates back to ERPNext after a transaction is completed. Double-check that the webhook URL in your gateway's dashboard is set correctly to `https://[your-site-url]/api/method/erpnext.integrations.doctype.payment_gateway.payment_gateway.webhook`.
• Currency Not Supported: The currency of the Sales Invoice (e.g., USD) must be enabled and supported by your payment gateway account. Check your gateway settings to ensure the currency is active.

Systematic testing is the key to a smooth launch. It builds confidence that your system is robust, reliable, and ready to handle customer payments securely.

Need Help? Let WovLab’s Experts Handle Your ERPNext Integration

While ERPNext offers powerful tools for a DIY erpnext payment gateway integration, the process can become complex, especially when dealing with custom business rules, multi-currency accounting, webhook troubleshooting, and ensuring PCI compliance. Choosing the wrong gateway or a faulty setup can lead to lost sales, accounting errors, and a poor customer experience. Why risk it when you can have experts manage it for you?

At WovLab, we are more than just a digital agency; we are your strategic partner in growth. As a premier Indian firm, we have deep expertise in the Frappe framework and a nuanced understanding of the local and international payment ecosystems. We don't just connect a gateway; we architect a comprehensive payment solution tailored to your business.

WovLab’s comprehensive services include:

• End-to-End ERPNext Development and Customization
• Secure Payment Gateway Integration and Automation
• AI Agent Implementation to Automate Business Processes
• Scalable Cloud Deployment and Management
• Targeted SEO and Digital Marketing for the Indian Market

Our team handles everything from selecting the most cost-effective gateway for your transaction profile to implementing custom fee structures and ensuring your checkout experience is flawless. We ensure every transaction is perfectly reconciled, providing you with a reliable, automated financial system that you can trust. Stop wrestling with API keys and webhooks. Focus on what you do best—running your business—and let WovLab's experts build the robust financial backbone your company deserves. Contact WovLab today for a consultation and let us make your erpnext payment gateway integration seamless, secure, and successful.