---
title: "How it works"
space: "Integrations"
url: "https://integrations.frappe.cloud/integrations/payment-integration/payment-core/payment-core-without-eprnext/how-it-works"
updated: "2026-11-13"
---

Payment Core operates in one of two modes depending on the site:


| Site has                                        | Mode              | What you get                                                                                                         |
| ----------------------------------------------- | ----------------- | -------------------------------------------------------------------------------------------------------------------- |
| ERPNext                                         | Gateway-only      | Payment Core acts as the gateway layer for ERPNext's Payment Request flow; no shared ledger doctypes are installed   |
| Plain Frappe (no ERPNext)                       | **Shared ledger** | Payment Transaction, Payment Receipt, and Payment Field Mapping doctypes; Payment Core is the complete payment layer |
| An app declaring `uses_own_payment_flow = True` | Gateway-only      | Your app keeps its own payment doctypes; Payment Core provides the gateway registry and checkout                     |


This page covers the **shared ledger mode** (plain Frappe sites).

## Installation

### Prerequisites

- A Frappe bench with Frappe `version-16` or `develop`
- Python 3.14 or newer (for `develop`)

### Install Payment Core

```
bench get-app https://github.com/aerele/payment-core --branch develop
bench --site your-site install-app payment_core
```

### Install a gateway app

Payment Core cannot process payments on its own; you need at least one gateway app:

```
# Stripe
bench get-app https://github.com/aerele/stripe-payment --branch develop
bench --site your-site install-app stripe_payment

# Razorpay
bench get-app https://github.com/aerele/razorpay-payment --branch develop
bench --site your-site install-app razorpay_payment
```

Run migrate and clear cache:

```
bench --site your-site migrate
bench --site your-site clear-cache
```