django payment managerダウンロード-Django django payment managerソースコードダウンロード

Django Payment Manager

これは、PayPalと簡単に統合して支払いを受け入れることができるDjango支払いアプリケーションです。このアプリは柔軟性があるように設計されており、あらゆる種類のサービスまたは製品の支払いを収集できます。

インストール

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プロジェクトの設定に追加し、必要に応じて値を調整します。

 # 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