django payment manager Download - django payment manager Download تنزيل رمز المصدر

مدير الدفع Django

هذا تطبيق دفع Django يسمح لك بالاندماج بسهولة مع PayPal لقبول المدفوعات. تم تصميم هذا التطبيق ليكون مرنًا ، مما يتيح لك جمع المدفوعات لأي نوع من الخدمة أو المنتج.

تثبيت

أضف الكود التالي داخل علامة <head> من قالب base.html الخاص بك:

 < head >
    <!-- other tags -->
    < title > My title </ title >
    {% block scriptHead %}{% endblock %} <!-- this line must be added -->
</ head >

لاستخدام التطبيق ، يجب إنشاء نموذج مع الحقل التالي على الأقل:

قم بإنشاء نموذج في تطبيق Django الخاص بك يتضمن على الأقل الحقول التالية:

 from django . db import models
from payment . utils import get_timestamp , generate_random_id


class InfoToPassToPaymentApplication ( models . Model ):
    id_request = models . CharField ( max_length = 255 , null = True , blank = True )
    amount = models . DecimalField ( max_digits = 10 , decimal_places = 2 , null = True , blank = True )
    currency = models . CharField ( max_length = 3 , null = True , blank = True )

    # Add any other fields you want

    def save ( self , * args , ** kwargs ):
        if self . id_request is None :
            self . id_request = f" { get_timestamp () } { generate_random_id () } "  # You must create this function or use another method to generate a unique id
        return super (). save ( * args , ** kwargs )

    def get_id_request ( self ):
        return self . id_request

    def get_amount_to_pay ( self ):
        return self . amount

    def get_currency ( self ):
        return self . currency

    def set_paid_status ( self , status : bool ):
        self . is_paid = status

    def get_name ( self ):
        # return the name of the service or product
        pass

    def get_img_url ( self ):
        # return the url of the image of the service or product
        pass

    def get_user_name ( self ):
        # return the name of the user who is going to pay
        pass

    def get_user_email ( self ):
        # return the email of the user who is going to pay
        pass

يجب أن يمثل هذا النموذج المعلومات التي تريد نقلها إلى طلب الدفع. يمكن أن يتضمن ذلك تفاصيل حول الخدمة أو المنتج الذي تبيعه ، وكذلك أي معلومات ضرورية أخرى.

الاستخدام

مع إنشاء النموذج الخاص بك ، يمكنك الآن دمج تطبيق الدفع مع التطبيق الحالي. أضف الإعدادات التالية إلى إعدادات مشروع Django الخاص بك.

 # settings.py

INSTALLED_APPS = [
    # other apps
    'payment' ,
]

إذا لزم الأمر ، فإن عنوان URL المستخدم كنقطة دخول إلى التطبيق هو payment:payment_linked .

 # settings.py

# payment settings
PAYMENT_PAYPAL_ENVIRONMENT = 'sandbox'  # or 'production'
PAYMENT_PAYPAL_CLIENT_ID = 'your_paypal_client_id'
PAYMENT_PAYPAL_CLIENT_SECRET = 'your_paypal_client_secret'

# fees
# if you want to apply the default PayPal fee, set the following to True or add the fee to your model
PAYMENT_APPLY_PAYPAL_FEES = False  # (2.90% + 0.35$ per transaction, if card 2.10% + 0.35$ as of 2023-05-06) default is False
PAYMENT_SPLIT_PAYPAL_FEES = False  # split the fees between you and the user (if PAYMENT_APPLY_PAYPAL_FEES = True)  default  is False
# if you want to apply your own percentage fees (can't have both)
PAYMENT_FEES = 0.03 if not PAYMENT_APPLY_PAYPAL_FEES else 0.00  # default is 0.00

# basic
PAYMENT_BASE_TEMPLATE = 'base_templates/base.html'  # or your own base template path
PAYMENT_WEBSITE_NAME = 'My Website'  # or your website name
PAYMENT_MODEL = 'your_app_name.InfoToPassToPaymentApplication'  # Replace with your app and model name
PAYMENT_REDIRECT_SUCCESS_URL = 'your_app_name:success_view_name'  # Replace with your app and success view name

# Additional to the default email settings
# if the following are not defined, the default templates are applied
DEFAULT_FROM_EMAIL = "webmaster@localhost"  # the default from email that you're using
DEFAULT_EMAIL_MESSAGE = None  # leave as None if you want to use the default message in the template
DEFAULT_EMAIL_PAYMENT_SUCCESS_TEMPLATE = 'template/emails/payment_success.html'  # an example of name

default_email_message هي الرسالة الافتراضية التي تريد إرسالها إلى المستخدم أو اتركها فارغة إذا كنت تريد إضافة واحدة مباشرة في القالب أو إذا كنت تريد استخدام الرسالة الافتراضية في القالب وهو:

 link = request . build_absolute_uri ( payment_info . get_absolute_url ())
message = DEFAULT_EMAIL_MESSAGE or f"Thank you for your payment, it's been received and your booking is now confirmed" 
                                       f"You can view it by clicking <a href=' { link } '>here</a> " 
                                       f"We're excited to have you on board! Your order # is { order_id } ."

يتم تمرير الكائنات التالية إلى قالب البريد الإلكتروني:

 context = {
    'first_name' : first_name ,
    'company' : PAYMENT_WEBSITE_NAME ,
    "order_id" : order_id ,
    "payment_info" : payment_info ,
    'message' : message ,
    'current_year' : datetime . datetime . now (). year ,
}

Payment_info هو كائن يحتوي على السمات التالية:

 from django . contrib . contenttypes . fields import GenericForeignKey
from django . contrib . contenttypes . models import ContentType
from django . db import models

class PaymentInfo :
    order_id = models . CharField ( max_length = 255 , unique = True )
    reference_id = models . CharField ( max_length = 255 )
    amount = models . DecimalField ( max_digits = 10 , decimal_places = 2 )
    fee = models . DecimalField ( max_digits = 10 , decimal_places = 2 , null = True , blank = True )
    currency = models . CharField ( max_length = 3 )
    status = models . CharField ( max_length = 20 )
    
    linked_object_type = models . ForeignKey ( ContentType , on_delete = models . CASCADE , null = True , blank = True )
    linked_object_id = models . PositiveIntegerField ( null = True , blank = True )
    linked_object = GenericForeignKey ( 'linked_object_type' , 'linked_object_id' )

    # meta data
    created_at = models . DateTimeField ( auto_now_add = True )
    updated_at = models . DateTimeField ( auto_now = True )

    def get_order_id ( self ):
        return self . order_id

    def get_reference_id ( self ):
        return self . reference_id

    def get_amount ( self ):
        return self . amount

    def get_currency ( self ):
        return self . currency

    def get_status ( self ):
        return self . status

    def get_linked_object ( self ):
        return self . linked_object

    def get_created_at ( self ):
        return self . created_at

    def get_updated_at ( self ):
        return self . updated_at

    def get_total_amount ( self ):
        return self . amount + self . fee
    
    def get_fee ( self ):
        return self . fee

    def get_absolute_url ( self ):
        # implemented in the payment app
        pass

يمكنك تخصيص الرسالة في البريد الإلكتروني من خلال عدم استخدام رسالة الكائن ووضع رسالتك مباشرة في القالب أو عن طريق إضافة القيمة الافتراضية للرسالة في الإعدادات.

يمكن استخدام السمة في كائن payment_info لعرض المعلومات في القالب الخاص بك.

اتبع الإرشادات الواردة في وثائق التطبيق لإعداد المشاهدات المطلوبة.

بمجرد إعداد كل شيء ، يمكنك البدء في قبول المدفوعات من خلال PayPal.

يوسع