fix: build absolute url (#157)

* fix: build absolute url for auto connect

* fix: add docs for sites

Author: ali-zahedi

README.md

@@ -156,6 +156,36 @@
    <p dir="rtl">
    اگر نیاز ندارید توابع داخلی را اوررایت کنیدو فقط به این نیاز دارید که مسیر یو ار ال های داخلی را در اپ جداگانه ای قرارگیرد میتوانید از این گزینه برای ادرسی دهی محل قرار گیری اپ استفاده کنید
    </p>
+
+
+<h3 dir="rtl">فعال‌سازی Django Sites و تعیین پروتکل/دامنه</h3> <p dir="rtl"> اگر می‌خواهید از قابلیت <code>auto_connect</code> استفاده کنید  باید آدرس های کامل (به‌همراه دامنه) بسازیم، فریم‌ورک <code>django.contrib.sites</code> را فعال کنید و پروتکل پیش‌فرض را مشخص کنید. </p>
+
+```python
+INSTALLED_APPS = [
+    # ...
+    "django.contrib.sites",  # برای مدیریت دامنهٔ فعلی
+    "azbankgateways",
+    # ...
+]
+
+
+# شناسه سایت فعلی (معمولاً 1)
+SITE_ID = 1
+
+# پروتکل پیش‌فرض برای ساخت URL کامل
+DEFAULT_PROTOCOL = "https"  # در صورت نیاز می‌توانید "http" بگذارید
+```
+<p dir="rtl"> سپس مایگریت‌ها را اجرا کنید: </p>
+
+```bash
+python manage.py migrate
+```
+
+<p dir="rtl"> حالا از مسیر <b>Admin → Sites → Sites</b> رکورد با شناسه ۱ (یا رکورد موردنظر) را باز کنید و: </p>
+<p dir="rtl"><b>Name</b>: نام سایت (دلخواه)</p>
+<p dir="rtl"><b>Domain name</b>: دامنهٔ سایت بدون پروتکل و بدون اسلش پایانی (مثلاً <code>example.com</code>)</p>
+
+
 ### urls.py
 
 <p dir="rtl">

azbankgateways/banks/banks.py

@@ -10,6 +10,8 @@
 from django.urls import reverse
 from django.utils import timezone
 
+from azbankgateways.utils import append_querystring, build_full_url
+
 from .. import default_settings as settings
 from ..exceptions import (
     AmountDoesNotSupport,
@@ -19,7 +21,6 @@
     SafeSettingsEnabled,
 )
 from ..models import Bank, CurrencyEnum, PaymentStatus
-from ..utils import append_querystring
 
 
 # TODO: handle and expire record after 15 minutes
@@ -375,14 +376,15 @@ def get_gateway_payment_url(self):
         return redirect_url
 
     def _get_gateway_callback_url(self):
-        url = reverse(settings.CALLBACK_NAMESPACE)
         if self.get_request():
+            url = reverse(settings.CALLBACK_NAMESPACE)
             url_parts = list(parse.urlparse(url))
             if not (url_parts[0] and url_parts[1]):
                 url = self.get_request().build_absolute_uri(url)
             query = dict(parse.parse_qsl(self.get_request().GET.urlencode()))
             query.update({"bank_type": self.get_bank_type()})
             query.update({"identifier": self.identifier})
             url = append_querystring(url, query)
-
+        else:
+            url = build_full_url(settings.CALLBACK_NAMESPACE)
         return url

azbankgateways/utils.py

@@ -1,6 +1,9 @@
 import json
 from urllib import parse
 
+from django.conf import settings
+from django.urls import reverse
+
 from azbankgateways.types import DictQuerystring
 
 
@@ -33,3 +36,28 @@ def split_to_dict_querystring(url: str) -> DictQuerystring:
     url_parts[5] = ""
 
     return parse.urlunparse(url_parts), query
+
+
+def build_full_url(viewname: str, *args, **kwargs):
+    """
+    Build a full absolute URL including domain if Sites framework is available.
+    Falls back to relative path if no site is configured.
+    """
+    # Generate the path part
+    path = reverse(viewname, args=args, kwargs=kwargs)
+
+    # Try to use django.contrib.sites if installed
+    if "django.contrib.sites" in settings.INSTALLED_APPS:
+        try:
+            from django.contrib.sites.models import Site
+
+            site = Site.objects.get_current()
+            if site and site.domain:
+                protocol = getattr(settings, "DEFAULT_PROTOCOL", "https")
+                return f"{protocol}://{site.domain}{path}"
+        except Exception:
+            # Any issue with Sites, just return relative path
+            pass
+
+    # Fallback: return only relative path
+    return path