A Step-by-Step Guide to Integrating a Payment Gateway with ERPNext

By WovLab Team | March 29, 2026 | 13 min read

Why Your Business Needs ERPNext Payment Gateway Integration

In today's fast-paced digital economy, streamlining financial operations is paramount for business growth and efficiency. The decision to integrate a payment gateway with ERPNext is no longer a luxury but a strategic imperative, especially for businesses in India navigating a diverse digital payment landscape. ERPNext, as a comprehensive open-source ERP system, excels at managing core business processes from manufacturing to human resources. However, its full potential in financial automation is unlocked when seamlessly connected with a robust payment gateway.

The primary benefit lies in enhanced cash flow management. Manual invoicing and payment collection are prone to delays and errors, impacting liquidity. By integrating a payment gateway, businesses can enable customers to pay directly from their invoices or through dedicated payment links, drastically reducing the collection cycle. For instance, a typical SME in India might see a reduction of 5-7 days in average collection period post-integration, translating into significant working capital improvements. This automation extends beyond just receiving payments; it includes automatic reconciliation. When a payment is made, ERPNext can instantly update the corresponding sales invoice status from 'Outstanding' to 'Paid', eliminating manual data entry and minimizing human error. This is crucial for maintaining accurate real-time financial records.

Furthermore, payment gateway integration significantly improves the customer experience. Offering multiple payment options – credit/debit cards, UPI, net banking – directly within the ERPNext generated invoice or web portal reduces friction in the payment process. This convenience can lead to higher customer satisfaction and repeat business. From an operational standpoint, it frees up valuable accounting team resources, allowing them to focus on strategic financial analysis rather than tedious data entry and reconciliation tasks. Security is also a major consideration; reputable payment gateways come with advanced fraud detection and PCI DSS compliance, providing a secure environment for transactions. For Indian businesses, this means adhering to local regulatory guidelines while ensuring data protection for their customers.

Key Insight: Automating payment collection and reconciliation through ERPNext payment gateway integration not only accelerates cash flow but also significantly enhances operational efficiency and customer trust, a non-negotiable for modern enterprises.

Choosing the Right Payment Gateway for ERPNext in India

Selecting the optimal payment gateway is a critical step before you integrate a payment gateway with ERPNext. The Indian market offers a plethora of options, each with its unique features, pricing structures, and ERPNext compatibility. Your choice should align with your business volume, customer demographics, technical capabilities, and specific ERPNext operational requirements. Consider factors such as transaction fees, setup costs, security features, ease of integration, multi-currency support, and the quality of developer documentation and customer support.

For businesses operating within India, popular choices include Razorpay, PayU, Stripe India, and Paytm Business. Each offers specific advantages. For example, Razorpay is known for its comprehensive feature set, including subscription billing, instant refunds, and broad payment method support, making it a strong contender for diverse business models. PayU is another robust option, particularly strong in its mobile payment solutions and widespread merchant network. Stripe India, while globally recognized, also offers excellent developer tools and competitive pricing for certain transaction volumes, appealing to tech-savvy businesses.

Below is a comparative table to help guide your decision, focusing on key criteria relevant for ERPNext integration in the Indian context:

It's vital to perform due diligence: review their terms of service, understand their security protocols, and test their support responsiveness. Some gateways might offer preferential rates for high-volume merchants or specific business categories. Always confirm ERPNext's direct integration capabilities or available community-contributed apps for your chosen gateway, as this will significantly impact the ease and cost of implementation. WovLab often recommends Razorpay or Stripe for their robust APIs and developer-friendly environments, which simplify complex ERPNext customizations.

Pre-Integration Checklist: Gathering Your Credentials and Settings

Before you embark on the technical journey to integrate a payment gateway with ERPNext, thorough preparation is crucial. A systematic pre-integration checklist ensures that you have all the necessary credentials, configurations, and prerequisites in place, minimizing potential roadblocks during the actual setup process. Skipping this step can lead to frustrating delays and security vulnerabilities.

Here’s a detailed checklist of items you must gather and configure:

1. Payment Gateway Account Activation: Ensure your chosen payment gateway account (e.g., Razorpay, Stripe) is fully set up, verified, and active. This typically involves submitting KYC documents, bank account details, and undergoing a verification process. Most gateways will require business registration proof (GSTN, PAN for business), bank statements, and authorized signatory details.
2. API Keys and Secrets: From your payment gateway dashboard, locate and securely retrieve your API Keys. These usually include a Publisher Key (or API Key) and a Secret Key (or API Secret). These are critical for ERPNext to authenticate and communicate with the payment gateway. Treat these as highly confidential; they should never be publicly exposed or shared insecurely. Some gateways might also provide a Webhook Secret.
3. Webhook URLs and Configuration: Understand how webhooks function. Webhooks are essential for the payment gateway to send real-time notifications back to ERPNext about transaction statuses (e.g., successful payment, failed payment, refund). You'll typically configure a specific ERPNext URL (e.g., https://your-erpnext-domain.com/api/method/frappe.integrations.doctype.payment_gateway.payment_gateway.api_url or a specific custom endpoint) in your payment gateway dashboard for these notifications.
4. ERPNext Setup Verification:
   • Company Details: Ensure your ERPNext company profile is complete and accurate, including your legal name, address, and GSTIN (if applicable).
   • Currency Configuration: Confirm that the currency used in your ERPNext (e.g., INR) matches the primary operating currency of your payment gateway account.
   • User Permissions: Ensure the user performing the integration in ERPNext has the necessary administrative permissions (e.g., System Manager role) to create and modify Payment Gateways and related settings.
5. Network Accessibility: If your ERPNext instance is behind a firewall or specific network policies, ensure that it can send and receive requests from the payment gateway's IP addresses for API calls and webhooks. This might involve whitelisting certain IP ranges.
6. Test Environment Readiness: It is highly recommended to perform initial integration and testing in a staging or development ERPNext environment before deploying to your live production system. This minimizes risks to live data and operations.

Expert Tip: Always generate fresh API keys specifically for your ERPNext integration rather than reusing keys from other applications. This enhances security and simplifies key rotation if ever compromised.

Having these elements ready will significantly streamline the subsequent configuration steps within ERPNext, making the integration process smooth and efficient.

Step-by-Step: How to Configure the Payment Gateway in ERPNext

Once you have completed your pre-integration checklist, the actual process to configure the payment gateway in ERPNext is straightforward. ERPNext is designed with a flexible integration framework that allows various payment gateways to be set up with minimal custom code, provided the gateway offers standard API access.

Here’s a detailed step-by-step guide:

1. Navigate to Payment Gateway Settings:
   • Log in to your ERPNext instance as a System Manager.
   • In the search bar (Ctrl+G or Cmd+G), type "Payment Gateway" and select the 'Payment Gateway' doctype.
   • Click on 'New' to create a new Payment Gateway entry.
2. Fill in Basic Gateway Details:
   • Payment Gateway Name: Give it a descriptive name, e.g., "Razorpay India" or "Stripe Payments".
   • Gateway Type: Select the appropriate gateway from the dropdown list. ERPNext provides native support for popular gateways like 'Razorpay', 'Stripe', 'Paypal', 'Braintree', 'PayUMoney', etc. If your chosen gateway isn't listed (e.g., Paytm Business or a highly customized integration), you might need a custom app or to select 'Custom' and provide the API endpoint.
   • Enabled: Check this box to activate the payment gateway.
3. Enter API Credentials:
   • Based on your chosen Gateway Type, ERPNext will display fields for relevant API credentials. For example, for Razorpay, you'll see fields for 'API Key' (your Publisher Key) and 'API Secret' (your Secret Key).
   • Carefully copy and paste these keys from your payment gateway dashboard into the corresponding ERPNext fields. Double-check for any leading or trailing spaces.
   • For gateways like Stripe, you might also need to enter the 'Webhook Secret'.
4. Configure Additional Settings (if applicable):
   • Is Sandbox: If you are setting this up for a test environment, check this box. This tells ERPNext to use the payment gateway's sandbox environment, preventing real transactions. Remember to uncheck this for production.
   • Disable for Sales Order: You can choose whether to allow payments directly from Sales Orders or only from Sales Invoices.
   • Payment Account: Select the specific ERPNext Bank or Cash account that will be used to record payments received via this gateway. This is crucial for automated reconciliation.
   • Message for Payment Request: You can add a custom message that appears on the payment page for your customers.
5. Save the Payment Gateway:
   • Once all details are filled in, click 'Save'. ERPNext will attempt to validate the API keys with the payment gateway. If there's an issue, it might show an error immediately.
6. Link to Payment Request or Sales Invoice:
   • After saving, you can now generate Payment Requests or Sales Invoices in ERPNext.
   • When creating a Sales Invoice, you will see an option to "Send Payment Link" or "Create Payment Request". Upon selection, the integrated payment gateway will be available as an option.
   • ERPNext will generate a unique payment URL that you can send to your customers. When customers click this link, they are redirected to the payment gateway's secure page to complete the transaction.

Practical Example: For Razorpay, after saving the gateway, navigate to a 'Sales Invoice'. Click on 'Actions' and then 'Create Payment Request'. You'll see your "Razorpay India" gateway listed. Select it, and ERPNext will generate a payment link which you can email or share directly with the customer. Upon successful payment, ERPNext automatically marks the invoice as 'Paid' and creates a 'Payment Entry' linked to your designated bank account.

This structured approach ensures that your ERPNext system is correctly configured to communicate with your chosen payment gateway, ready to process transactions securely and efficiently.

Testing and Troubleshooting Your ERPNext Payment Integration

After you integrate a payment gateway with ERPNext, thorough testing is not just a recommendation—it's an absolute necessity. Even with a perfect configuration, unexpected issues can arise. A systematic testing approach in a non-production environment ensures that the integration functions as expected before it impacts your live business operations. This phase validates end-to-end functionality, from payment link generation to successful transaction recording and reconciliation within ERPNext.

Systematic Testing Steps:

1. Test in Sandbox Mode: Always perform initial tests using your payment gateway's sandbox (test) environment. This allows you to simulate real transactions without using actual funds. Ensure the 'Is Sandbox' checkbox is ticked in your ERPNext Payment Gateway settings.
2. Generate Payment Links:
   • Create a dummy 'Sales Invoice' or 'Payment Request' in your ERPNext test environment.
   • Generate a payment link through your newly configured payment gateway.
   • Access this link in a browser, mimicking a customer.
3. Perform Various Transaction Scenarios:
   • Successful Payment: Use test card details (provided by your payment gateway) to complete a successful transaction. Verify that the payment gateway confirms success.
   • Failed Payment: Simulate a failed payment (e.g., incorrect card details, insufficient funds) to ensure ERPNext handles failures gracefully.
   • Refund (Optional): If your business model involves refunds, test initiating a refund from within ERPNext (if supported by the integration) and verify it's processed correctly by the gateway.
4. Verify ERPNext Updates:
   • After each test transaction, check the corresponding 'Sales Invoice' or 'Payment Request' in ERPNext.
   • Successful Payment: The invoice status should change from 'Outstanding' to 'Paid'. A new 'Payment Entry' should be automatically created and linked to the correct bank account.
   • Failed Payment: The invoice status should remain 'Outstanding' or revert if it was temporarily marked. No 'Payment Entry' should be created.
5. Check Payment Gateway Dashboard: Confirm that the transactions (successful or failed) are accurately reflected in your payment gateway's dashboard.
6. Review ERPNext Logs: For any issues, check ERPNext's error logs (Setup > Audit Trail > Error Log) for clues.

Common Troubleshooting Scenarios:

• "Invalid API Key/Secret": Double-check that you've correctly copied your API keys from your payment gateway dashboard into ERPNext. Ensure no extra spaces. Confirm you're using live keys for production and sandbox keys for testing.
• "Webhook Failed/Payment Status Not Updating":
  • Verify the Webhook URL configured in your payment gateway dashboard. It must point to the correct ERPNext endpoint.
  • Ensure your ERPNext instance is publicly accessible and not blocked by firewalls from receiving incoming webhook notifications from the payment gateway's IP addresses.
  • Check ERPNext's 'Webhook Events' (if available in your version) or 'Error Log' for any incoming webhook processing failures.
• "Payment Page Not Loading":
  • Ensure the payment link generated by ERPNext is valid and not expired.
  • Check network connectivity and browser console for JavaScript errors.
  • Confirm your payment gateway account is fully active and not suspended.
• "Incorrect Account Reconciliation": Verify the 'Payment Account' selected in your ERPNext Payment Gateway settings is the correct bank account for automatic payment entries.

Actionable Tip: For complex issues, enable developer mode in ERPNext (by modifying site_config.json) to get more detailed error messages and stack traces, which can be invaluable for pinpointing the root cause.

A meticulous testing phase minimizes post-deployment headaches and ensures a reliable and secure payment process for your business and customers.

Need Expert Help? WovLab’s ERPNext Integration Services

While the process to integrate a payment gateway with ERPNext can be managed by an in-house team with technical proficiency, many businesses encounter unique challenges that require specialized expertise. Whether it's navigating complex regulatory requirements in India, integrating with multiple payment gateways for diverse customer segments, or developing custom functionalities not natively supported, the journey can become intricate and time-consuming. This is where WovLab, a premier digital agency from India, steps in.

WovLab specializes in delivering robust ERPNext integration services, ensuring your payment gateway setup is not just functional but also optimized for performance, security, and scalability. Our team of ERPNext experts and payment gateway specialists possesses in-depth knowledge of both the ERPNext framework and the nuances of various Indian and international payment systems like Razorpay, Stripe, PayU, and Paytm. We understand that every business has unique workflows and compliance needs, and a one-size-fits-all approach simply doesn't cut it.

How WovLab Can Support Your ERPNext Payment Integration:

• Custom ERPNext Development: If your payment gateway isn't natively supported, or if you require specific business logic for payment processing (e.g., dynamic tax calculations based on payment method, advanced subscription billing integration), our developers can build custom apps and scripts to extend ERPNext's capabilities.
• Multi-Gateway Integration: For businesses serving a wide demographic, integrating with multiple payment gateways can be crucial. WovLab can architect and implement solutions that allow your customers to choose from various payment options seamlessly within ERPNext.
• Secure & Compliant Setup: We ensure your integration adheres to all necessary security standards (e.g., PCI DSS where applicable) and local Indian regulations, minimizing risks of data breaches and non-compliance penalties. This includes secure API key management and webhook configuration.
• Data Migration & Reconciliation: Beyond just transactions, we help set up accurate payment data synchronization and automated reconciliation processes within ERPNext, ensuring your financial reports are always precise and up-to-date.
• Performance Optimization: Our team optimizes your ERPNext instance and payment integration points to handle high transaction volumes efficiently, ensuring a smooth customer experience even during peak periods.
• Ongoing Support & Maintenance: Integration is not a one-time task. WovLab provides continuous support, monitoring, and maintenance services to ensure your payment gateway integration remains stable, secure, and up-to-date with ERPNext and payment gateway API changes.
• Consultation & Strategy: Unsure which payment gateway is right for your business in India, or how to best leverage ERPNext for your specific payment workflows? WovLab offers expert consultation to help you define a clear strategy.

WovLab Differentiator: As an Indian digital agency (wovlab.com) with expertise spanning AI Agents, Dev, SEO/GEO, Marketing, ERP, Cloud, Payments, Video, and Operations, we bring a holistic perspective. We don't just solve a technical problem; we integrate solutions that contribute to your overall business strategy and growth.

By partnering with WovLab, you can avoid the complexities and potential pitfalls of DIY integration, allowing your team to focus on core business activities while we ensure your ERPNext payment ecosystem is robust, efficient, and future-proof. Contact us today to discuss your ERPNext payment integration needs and empower your business with seamless financial operations.