Install Vatly Django
Start with a normal Django project, including its auth, sessions, messages and CSRF configuration. Install the pinned alpha:
python -m pip install vatly-django==0.1.0a3
This also installs vatly-api-python==0.1.0a3 and vatly-fluent-python==0.1.0a3.
Add the billing app to your existing settings.py app list:
INSTALLED_APPS += ["vatly_django"]
Keep Django's generated authentication/session/CSRF middleware. If you use admin, keep its standard template context processors and messages middleware too.
Mount the billing URLs
Add this entry to your project URL configuration (preserve your other routes):
from django.urls import include, path
urlpatterns = [path("billing/", include("vatly_django.urls"))]
Route under /billing/ | Method | Protection |
|---|---|---|
checkout/<offer>/ | POST | Login, CSRF and server-owned offer |
portal/ | POST | Login, CSRF and authorized customer binding |
webhook/ | POST | Raw-body Vatly signature; CSRF-exempt |
Configure the required settings, then create the tables:
python manage.py migrate
python manage.py check
No migration or setup command creates remote customers, products or webhook endpoints. Use HTTPS and your deployment's normal host/CSRF settings in production. PostgreSQL is recommended for concurrent workers; SQLite is suitable for local use.