Almost automatic integration between django-plans and django-payments. This will add payment buttons to the order page and automatically confirm the Order after the payment. Optionally, it can return the corresponding order when a payment is refunded.
Documentation
The full documentation is at https://django-plans-payments.readthedocs.io.
Quickstart
Install and configure django-plans and django-payments apps. Capture mode is not yet supported, so PAYMENT_VARINANTS with 'capture': False will not get confirmed.
Install Django plans payments:
pip install django-plans-payments
Add it to your INSTALLED_APPS, before the plans:
INSTALLED_APPS = (
...
'related_admin',
'plans_payments',
'plans',
...
)Add Django plans_payments to the URL patterns:
urlpatterns = [
...
url(r'^plans-payments', include('plans_payments.urls')),
...
]Set django-plans settings and set model to:
PAYMENT_MODEL = 'plans_payments.Payment'Customer IP address
Customer IP address is stored in Payment model and used for some payment providers (i.e. PayU). For security reasons django-plans-payments does acquire the IP only from request REMOTE_ADDR parameter. If you are behind proxy, you will need to setup some mechanism to populate this variable from HTTP_X_FORWARDED_FOR parameter. The suggested solution is to use django-httpforwardedfor or django-xff application for that.
Running Tests
Does the code actually work?
source <YOURVIRTUALENV>/bin/activate (myenv) $ pip install tox (myenv) $ tox
Credits
Tools used in rendering this package:
History
2.2.0 (2026-07-23)
add Payment.invalidate_renew_token() - payment providers call it when the gateway reports the stored recurring token as permanently dead (e.g. PayU INVALID_TOKEN). The token is marked unverified so renewal tasks stop selecting the account and get_renew_token() returns None; the new plans_payments.signals.renew_token_invalidated signal lets host apps prompt the user to update their payment method.
add a pre-commit config (black/isort/flake8 at line length 119 plus hygiene hooks) and run it in CI, so local and CI lint cannot drift.
2.1.0 (2026-07-21)
Don’t disable token_verified on an unsuccessful renewal attempt, so a transient payment failure no longer permanently disarms automatic renewals
Add get_renew_data() and pass provider metadata (e.g. Stripe customer_id) through set_renew_token(**kwargs)
Add migration for the new django-payments PaymentStatus.CANCELLED (choices-only, database no-op)
Tests: drop the unused pytz dependency, satisfy current black
2.0.2 (2025-05-29)
fix the release
2.0.1 (2025-05-29)
fix the release
2.0.0 (2025-05-29)
Implement the wallet logic
Drop support for Python 3.8, Django 4.1
Add support for Django 5.2
don’t obscure Exceptions by catching them
1.5.0 (2025-02-28)
Drop support for Python 3.7
Add support for Python 3.13, Django 5.1
fix the wrong assumption that Payment.extra_data["response"] contains a "transactions" key
1.4.1 (2024-04-24)
do not check whether a confirmed payment of a completed order is left anymore
1.4.0 (2024-04-15)
migrate to RecurringUserPlan.renewal_triggered_by
add renewal_triggered_by parameter to Payment.set_renew_token
deprecate automatic_renewal parameter of Payment.set_renew_token; use renewal_triggered_by parameter instead
deprecate None value of renewal_triggered_by parameter of Payment.set_renew_token; set an AbstractRecurringUserPlan.RENEWAL_TRIGGERED_BY instead
1.3.1 (2024-04-15)
fix typo in payment description
1.3.0 (2024-04-12)
add optional returning orders when payments are refunded
1.2.2 (2023-12-20)
add change_reason for django-simple-history
1.2.1 (2023-12-19)
specify sender=Payment for change_payment_status receiver
1.2.0 (2023-10-16)
bugfix release (fix prevoius bad release)
1.1.3 (2023-10-15)
add some indexes to Payment model
1.1.2 (2023-03-29)
reword Payment description to ommit word “Subscribtion” which might raise warnings for banks/card providers
1.1.1 (2023-01-27)
correction release, include wheel update, correctly rebase to master
1.1.0 (2023-01-27)
Fix transaction fee double counting
1.0.1 (2022-12-09)
Fix migrations
1.0.0 (2022-12-08)
Recurring payments functionality
0.2.0 (2018-08-05)
Payment process without capturing should work
Automatic buttons generation
0.1.0 (2018-07-23)
First release on PyPI.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file django_plans_payments-2.2.0.tar.gz.
File metadata
- Download URL: django_plans_payments-2.2.0.tar.gz
- Upload date:
- Size: 23.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
94aa45c6cbf1d663b34781b84513ef60cd2b73444cc8a4e156fc0b8b915ae683
|
|
| MD5 |
23fa01820130004896c41a2ae8e07572
|
|
| BLAKE2b-256 |
a14e0cddb099533270dc3a59466eb614d2c78df51b87151573f486434e8f38a3
|
File details
Details for the file django_plans_payments-2.2.0-py3-none-any.whl.
File metadata
- Download URL: django_plans_payments-2.2.0-py3-none-any.whl
- Upload date:
- Size: 21.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a186777d74c68fb4ec9ce859263e5bc4528b46bbee39f91817847ab1044354b2
|
|
| MD5 |
3c01425f6823f438e0ce189d5c353d53
|
|
| BLAKE2b-256 |
de91fc3588d9093ab47ffa6f3f6ae3f7402bf6cc3c73a81c60da796d6744ba91
|
