django-subscription-midtrans
============================

**A production-ready Django package for subscription billing with Midtrans Core API integration.**

.. image:: https://img.shields.io/pypi/v/django-subscription-midtrans.svg
   :target: https://pypi.org/project/django-subscription-midtrans/

.. image:: https://img.shields.io/badge/Python-3.10%2B-blue.svg
   :target: https://python.org

.. image:: https://img.shields.io/badge/Django-4.2%2B-green.svg
   :target: https://djangoproject.com

``django-subscription-midtrans`` provides a full subscription management system with:

- **Subscription Plans** with configurable billing intervals, trials, and feature flags
- **7 Payment Methods**: Credit Card, Bank Transfer (BCA/BNI/BRI/Permata/CIMB), GoPay, ShopeePay, QRIS, E-Channel, Wallet
- **Automatic Billing** via Celery Beat periodic tasks
- **Invoice System** with auto-generated line items
- **Wallet & Top-Up** with internal balance management
- **Webhook Processing** with SHA-512 signature verification
- **Django Unfold Admin** with status badges and bulk actions
- **20+ Django Signals** for lifecycle events
- **REST API** via Django REST Framework

.. important::

   This package uses the **Midtrans Core API** (``/v2/charge``, ``/v1/subscriptions``, ``/v1/invoices``), **NOT** Midtrans Snap.

Contents
--------

.. toctree::
   :maxdepth: 2
   :caption: Getting Started

   installation
   quickstart
   configuration

.. toctree::
   :maxdepth: 2
   :caption: User Guide

   models
   services
   api
   webhooks
   celery_tasks
   signals
   middleware
   wallet
   admin

.. toctree::
   :maxdepth: 2
   :caption: Example Application

   example_app

.. toctree::
   :maxdepth: 2
   :caption: Deployment

   production
   docker

.. toctree::
   :maxdepth: 2
   :caption: Architecture

   diagrams

.. toctree::
   :maxdepth: 1
   :caption: Development

   contributing
   changelog

Indices and tables
------------------

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`