Stripe payment integration

Use Stripe to collect payments against ERPNext Payment Requests. Customers pay on a Stripe-hosted checkout page, and ERPNext records successful payments against the original transaction.

What the integration does

• Accepts one-time and partial payments against Sales Invoices and Sales Orders
• Starts recurring payments for ERPNext Subscriptions
• Creates and submits Payment Entries after successful payment
• Records Stripe events in the Stripe Webhook Log
• Supports transactions in currencies accepted by both the integration and your Stripe account

How a payment moves through the integration

1. An ERPNext user creates a Payment Request against a supported document.
2. The customer opens the Payment URL and is redirected to Stripe Checkout.
3. Stripe collects the payment and returns the customer to ERPNext.
4. Stripe also sends a signed webhook event to ERPNext.
5. ERPNext creates the Payment Entry and updates the referenced document.

The return request and webhook can arrive in either order. The integration processes the payment once and ignores later duplicate delivery.

Set up Stripe

Install the payment_core and stripe_payment apps, sign in as a System Manager, and make sure the ERPNext site has a public HTTPS address. Use Stripe test keys while completing these guides:

Complete these guides in order:

1. Get your Stripe API keys
2. Connect ERPNext to Stripe
3. Set up webhooks
4. Accept a one-time test payment
5. Check whether the payment synced

Related topics

• How Stripe Checkout works
• Accept partial payments
• Manage subscriptions
• Accept payments in multiple currencies

Prerequisites

Install the required apps in this order:

1. Payment Core must be installed on the ERPNext site first. It provides the shared payment workflow used by payment-provider apps. It does not accept payments by itself.
2. Stripe Payment must be installed after Payment Core. It adds Stripe credentials, hosted Checkout, webhook processing, payment reconciliation, and subscription support.

You also need:

• A Stripe account with permission to access its API keys and webhook settings.
• An ERPNext site that is reachable from the public internet over HTTPS so Stripe webhooks can reach it.

The repository for app is hosted on GitHub: Stripe Payment