django payment manager
1.0.0
Dies ist ein Django -Zahlungsantrag, mit dem Sie sich problemlos in PayPal integrieren können, um Zahlungen zu akzeptieren. Diese App ist so konzipiert, dass Sie flexibel sind und es Ihnen ermöglichen, Zahlungen für jede Art von Service oder Produkt zu sammeln.
<head> -Tag Ihrer base.html -Vorlage hinzu: < head >
<!-- other tags -->
< title > My title </ title >
{% block scriptHead %}{% endblock %} <!-- this line must be added -->
</ head >Um die Anwendung zu verwenden, muss ein Modell mit mindestens dem folgenden Feld erstellt werden:
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
passDieses Modell sollte die Informationen darstellen, die Sie an den Zahlungsantrag übergeben möchten. Dies kann Details zum Service oder zum Produkt enthalten, das Sie verkaufen, sowie alle anderen erforderlichen Informationen.
Mit Ihrem erstellten Modell können Sie die Zahlungs -App jetzt in Ihre vorhandene Anwendung integrieren. Fügen Sie die folgenden Einstellungen zu den Einstellungen Ihres Django -Projekts hinzu.
# settings.py
INSTALLED_APPS = [
# other apps
'payment' ,
] Bei Bedarf ist die URL, die als Einstiegspunkt für den Antrag verwendet wird 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 nameDefault_email_message ist die Standardnachricht, die Sie an den Benutzer senden möchten, lassen Sie leer, wenn Sie eine direkt in der Vorlage hinzufügen möchten oder wenn Sie die Standardeinstellung in der Vorlage verwenden möchten, die lautet:
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 } ."Die folgenden Objekte werden an die E -Mail -Vorlage übergeben:
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 ist ein Objekt, das die folgenden Attribute enthält:
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
Sie können die Nachricht in der E -Mail anpassen, indem Sie die Objektnachricht nicht verwenden und Ihre Nachricht direkt in die Vorlage einfügen oder einen Standardwert der Nachricht in den Einstellungen hinzufügen.
Das Attribut im Objekt Payment_info kann verwendet werden, um die Informationen in Ihrer Vorlage anzuzeigen.
Befolgen Sie die Anweisungen in der Dokumentation der App, um die erforderlichen Ansichten einzurichten.
Sobald alles eingerichtet ist, können Sie mit der Annahme von Zahlungen über PayPal beginnen.
