System check plans_payments.W001 warns when the installed django-payments has no Payment.autocomplete_with_wallet(). Released django-payments lacks it, so automatic renewals failed with an AttributeError on the day they were due.

An automatic renewal that needs 3-D Secure is logged instead of printed to stdout, without the member’s payment link.

The package’s long description is declared as reStructuredText.

A confirmed payment never removes the subscription. 2.4.0 removed it when the payment’s variant differed from the subscription’s provider, so a subscriber who bought a one-off period or an upgrade with another payment method (a payu card payment against a payu-recurring subscription, a PayPal one-off) lost the renewal. The subscription now changes only when a confirmed payment stores a new renew token. A payment with another variant also no longer marks the stored token verified, since it did not use it.

Payment.replace_renew_token (and the matching create_payment_object argument) lets a payment collect new payment details for an existing subscription. get_renew_token() and get_renew_data() return None for it, so the provider asks for a card (with 3-D Secure) instead of charging the stored token, and the token it receives is kept in Payment.new_renew_token and written to the subscription only when the payment is confirmed. Before, a member whose stored card kept failing could only retry that card, and a declined new card would have replaced the stored one, leaving the subscription without a usable token. Both columns are nullable, so code without them can still insert payments during a deploy.

A failed payment cancels its order based on the stored order row, locked, and writes only status. It used the order in memory, which can be stale, and saved it whole, so an order completed meanwhile became CANCELED and lost its completion date.

A subscription with another payment provider is removed when the new payment is confirmed, not when it is created. create_payment_object deleted it as soon as a payment with another method was started, so a buyer who tried another method and gave up lost a working subscription.

Tested on Django 4.2-6.1 with Python 3.10-3.14, each Django version on the Python versions it supports (added Django 6.0/6.1 and Python 3.14). The tests run against the django-payments fork commit BlenderKit runs in production instead of the work-in-progress model-payu branch.

PLANS_PAYMENTS_COMPLETE_ORDER_AFTER_COMMIT (default False) completes the order after the confirmed payment commits instead of inside the same transaction. A failing complete_order() no longer rolls back the confirmation of a payment the provider has already captured (a PayPal checkout left the buyer charged with the payment still waiting).

CreatePaymentView’s in-flight join and decline cooldown consider only payments of the requested variant. A checkout page that pre-creates a card payment for an embedded widget on page load no longer captures a click on another method (every “Pay with PayPal” click within the join window was redirected to the card payment), and a buyer whose card was just declined can switch to another method without waiting out the cooldown.

Payment.set_renew_token on a plan-change order (an order without a pricing) stores only the token-related values on the existing RecurringUserPlan instead of re-arming it from the order, which left the renewal with pricing=None and the one-off difference as its amount.

make CreatePaymentView idempotent: an attempt while a previous payment is in flight joins it instead of creating a twin, and an attempt right after a decline waits out a short cooldown (banks read rapid-fire retries as fraud). Configurable via PLANS_PAYMENTS_JOIN_IN_FLIGHT_SECONDS (default 180) and PLANS_PAYMENTS_DECLINE_COOLDOWN_SECONDS (default 60); 0 disables.

fix create_payment_object crashing with BillingInfo.DoesNotExist for users without saved billing info – billing fields fall back to empty strings.

fix renew_accounts charging automatic renewals for free plans: an armed RecurringUserPlan surviving a switch to a free plan took the customer’s money and extended nothing. The renewal is skipped with a warning instead.

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.

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

fix the release

fix the release

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

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

do not check whether a confirmed payment of a completed order is left anymore

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

fix typo in payment description

add optional returning orders when payments are refunded

add change_reason for django-simple-history

specify sender=Payment for change_payment_status receiver

bugfix release (fix prevoius bad release)

add some indexes to Payment model

reword Payment description to ommit word “Subscribtion” which might raise warnings for banks/card providers

correction release, include wheel update, correctly rebase to master

Fix transaction fee double counting

Fix migrations

Recurring payments functionality

Payment process without capturing should work

Automatic buttons generation

First release on PyPI.