django payment manager下载django payment manager源代码下载

Django付款经理

这是一个Django付款应用程序，可让您轻松地与PayPal集成以接受付款。该应用程序旨在灵活，使您可以为任何类型的服务或产品收取付款。

安装

在base.html模板的<head>标签中添加以下代码：

 < 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 project settings.py文件中，根据需要调整值：

 # 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