Name: Django ATHM
Author: Django ATHM

Optional Quick-Start

Try it yourself

The included template tag provides a pre-built payment button for quick integration.

Tip Amount

$3.00

Supporting Django ATHM development

Real payment

Approving this transaction will charge $3.00 to your account. Thanks for supporting the project!

# views.py

def tip_page(request):

    context = {

        "ATHM_CONFIG": {

            "total": 3.00,

            "subtotal": 3.00,

            "tax": 0.00,

            # ...

    return render(...)

{# tip.html #}

{% load django_athm %}

{% athm_button ATHM_CONFIG %}

Everything you need

Developed for Django users who want payment integration without the complexity.

Transactions, items, and customers automatically saved to your database on callback.

Read-only dashboard with search, filtering, batch refunds, and webhook management.

Four signals: payment_completed, payment_cancelled, payment_expired, refund_sent.

Process full or partial refunds directly from Django Admin with batch support.

Automatic webhook handling with idempotency keys. Events logged and deduplicated.

Reconcile with ATH Móvil via athm_sync management command.

Familiar patterns with batteries included.

Handle payment events with signals

# signals.py

from django.dispatch import receiver

from django_athm.signals import payment_completed

@receiver(payment_completed)

def handle_payment(sender, payment, **kwargs):

    # Send confirmation email

    # Update inventory

    # Trigger fulfillment

    send_receipt(payment.customer_email, payment)

Query webhook events with automatic deduplication

from django_athm.models import WebhookEvent

# Get all processed webhook events

WebhookEvent.objects.filter(

    event_type="ecommerce_completed",

    processed=True

# Events: ecommerce_completed, ecommerce_cancelled,

# ecommerce_expired, payment, refund

Reconcile transactions with ATH Móvil

python manage.py athm_sync \

  --from-date 2025-01-01 \

  --to-date 2025-01-31

# Query customer history

from django_athm.models import Client

client = Client.objects.get(phone="7871234567")

payments = client.payment_set.all()