Stripe Integration
ERPNext integrates with Stripe to securely accept online payments. In addition to one-time payments, Stripe integration also supports recurring subscription billing through Stripe Billing Plans.
Summary
- Accept one-time online payments using Stripe.
- Supports recurring subscription billing.
- Automatically creates Payment Gateway and Bank accounts.
- Generates Payment Gateway Account for payment configuration.
- Supports payments in a wide range of global currencies.
Prerequisites
- An active Stripe account.
- Publishable Key.
- Secret Key.
Access Stripe Settings
Navigate to:
Explore > Integrations > Stripe Settings
Configure Stripe
- Open Stripe Settings.
- Enter the following credentials:
- Publishable Key
- Secret Key
- Save the configuration.
- Enable the Stripe integration.
What Happens After Enabling?
- A Payment Gateway record is created automatically.
- A Bank account is added to the Chart of Accounts.
- A Payment Gateway Account is generated for payment configuration.
Payment Gateway Account
The Payment Gateway Account serves as the central configuration point for Stripe payments. From here you can:
- Select the Bank account used for Stripe transactions.
- Configure the default Payment Request email template.
- Manage payment gateway settings independently of Stripe credentials.
Chart of Accounts Entry
When Stripe is enabled, ERPNext automatically creates a Bank-type account in the Chart of Accounts for recording Stripe transactions.
Recurring Subscription Billing
ERPNext supports recurring payments through Stripe’s subscription system.
Create Payment Plans
- Create one or more subscription plans in your Stripe account.
- Create corresponding Payment Plan records in ERPNext.
- Link each ERPNext Payment Plan to the matching Stripe billing plan.
Create Subscription Payment Requests
When creating a Payment Request:
- Enable the Is a Subscription option.
- Select the appropriate Payment Plan.
- Save the Payment Request.
ERPNext retrieves the available subscription plan details and automatically creates the corresponding customer subscription in Stripe.
Subscription Workflow
- Create subscription plans in Stripe.
- Create matching Payment Plans in ERPNext.
- Create a Payment Request.
- Enable Is a Subscription.
- Select the desired Payment Plan.
- ERPNext automatically creates the customer subscription in Stripe.
Supported Transaction Currencies
| Supported Currencies |
|---|
| AED, ALL, ANG, ARS, AUD, AWG, BBD, BDT, BIF, BMD, BND, BOB, BRL, BSD, BWP, BZD, CAD, CHF, CLP, CNY, COP, CRC, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ETB, EUR, FJD, FKP, GBP, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, ISK, JMD, JPY, KES, KHR, KMF, KRW, KYD, KZT, LAK, LBP, LKR, LRD, MAD, MDL, MNT, MOP, MRO, MUR, MVR, MWK, MXN, MYR, NAD, NGN, NIO, NOK, NPR, NZD, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RUB, SAR, SBD, SCR, SEK, SGD, SHP, SLL, SOS, STD, SVC, SZL, THB, TOP, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VND, VUV, WST, XAF, XOF, XPF, YER, ZAR |
Result
After configuration, ERPNext can securely process one-time payments and recurring subscription payments through Stripe while automatically recording all payment transactions in the accounting system.
