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-16ordevelop - 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
Last updated 6 days ago
Was this helpful?