3 \v+@sddlmZddlmZddlmZddlmZddl m Z ddl m Z ddl mZdd lmZGd d d ejZGd d d ejZGdddejZGdddejZdS))Decimal)models) gettext_lazy)AUTH_USER_MODEL)get_default_currency) AutoSlugField)currency) bankcardsc@seZdZdZejdejdeddZd\Z Z Z ej ed d d d Z ejed dddZej edd d d Zej edd d d Zejedd dZddZGdddZdS)AbstractTransactiona A transaction for a particular payment source. These are similar to the payment events within the order app but model a slightly different aspect of payment. Crucially, payment sources and transactions have nothing to do with the lines of the order while payment events do. For example: * A 'pre-auth' with a bankcard gateway * A 'settle' with a credit provider (see django-oscar-accounts) zpayment.Source transactionsSource) on_delete related_name verbose_name AuthoriseDebitRefundTypeT) max_lengthblankAmount )decimal_places max_digits ReferenceStatusz Date Created) auto_now_addcCstd|j|jdS)Nz%(type)s of %(amount).2f)typeamount)_txn_typer!)selfr%=/var/www/html/oscar2019/oscar/apps/payment/abstract_models.py__str__,szAbstractTransaction.__str__c@s*eZdZdZdZdgZedZedZdS)zAbstractTransaction.MetaTpaymentz -date_created Transaction TransactionsN) __name__ __module__ __qualname__abstract app_labelorderingr"rverbose_name_pluralr%r%r%r&Meta1s r2N)rrr)r+r,r-__doc__r ForeignKeyCASCADEr"source AUTHORISEDEBITREFUND CharFieldr# DecimalFieldr! referencestatus DateTimeField date_createdr'r2r%r%r%r&r s   r csTeZdZdZejdejdeddZejdejdeddZ ej edd e d Z ej ed d d ed dZej edd d ed dZej edd d ed dZej eddddZej eddddZdZdZGdddZddZfddZd-ddZd.d!d"Zd/d#d$Zde_d0d%d&Zde_d1d'd(Zde_ed)d*Z ed+d,Z!Z"S)2AbstractSourcea A source of payment for an order. This is normally a credit card which has been pre-authed for the order amount, but some applications will allow orders to be paid for using multiple sources such as cheque, credit accounts, gift cards. Each payment source will have its own entry. This source object tracks how much money has been authorised, debited and refunded, which is useful when payment takes place in multiple stages. z order.OrdersourcesOrder)rrrzpayment.SourceTypez Source TypeCurrencyr)rdefaultzAmount Allocatedrz0.00)rrrDzAmount DebitedzAmount RefundedrT)rrZLabelrNc@s$eZdZdZdZedZedZdS)zAbstractSource.MetaTr(r ZSourcesN)r+r,r-r.r/r"rr1r%r%r%r&r2lsr2cCs:tdt|j|j|jd}|jr6|td|j7}|S)Nz+Allocation of %(amount)s from type %(type)s)r!r z (reference: %s))r"ramount_allocated source_typer<)r$ descriptionr%r%r&r'rs   zAbstractSource.__str__cs2tj|||jr.x|jD]}|j|qWdS)N)supersave deferred_txns_create_transaction)r$argskwargsZtxn) __class__r%r&rJzs zAbstractSource.savecCs(|jdkrg|_|jj||||fdS)z Register the data for a transaction that can't be created yet due to FK constraints. This happens at checkout where create an payment source and a transaction but can't save them until the order model exists. N)rKappend)r$r#r!r<r=r%r%r&create_deferred_transactions z*AbstractSource.create_deferred_transactioncCs|jj||||ddS)N)r#r!r<r=)r create)r$r#r!r<r=r%r%r&rLsz"AbstractSource._create_transactioncCs,|j|7_|j|jtj|||dS)zO Convenience method for ring-fencing money against this source N)rFrJrLr r7)r$r!r<r=r%r%r&allocateszAbstractSource.allocatecCs:|dkr|j}|j|7_|j|jtj|||dS)zM Convenience method for recording debits against this source N)balanceamount_debitedrJrLr r8)r$r!r<r=r%r%r&debits zAbstractSource.debitcCs,|j|7_|j|jtj|||dS)zN Convenience method for recording refunds against this source N)amount_refundedrJrLr r9)r$r!r<r=r%r%r&refundszAbstractSource.refundcCs|j|j|jS)z3 Return the balance of this source )rFrVrX)r$r%r%r&rUs zAbstractSource.balancecCs |j|jS)z< Return the amount available to be refunded )rVrX)r$r%r%r&amount_available_for_refundsz*AbstractSource.amount_available_for_refund)NN)rRrR)rRrR)NrRrR)rRrR)#r+r,r-r3rr4r5r"orderrGr:rrr;rrFrVrXr<labelZsubmission_datarKr2r'rJrQrLrT alters_datarWrYpropertyrUrZ __classcell__r%r%)rOr&r@9sR               r@c@sReZdZdZejedddZeeddddedd Z Gd d d Z d d Z dS)AbstractSourceTypez A type of payment source. This could be an external partner like PayPal or DataCash, or an internal source such as a managed account. Namer)rCodenameTz6This is used within forms to identify this source type)r populate_fromunique help_textc@s$eZdZdZdZedZedZdS)zAbstractSourceType.MetaTr(z Source Typez Source TypesN)r+r,r-r.r/r"rr1r%r%r%r&r2sr2cCs|jS)N)rc)r$r%r%r&r'szAbstractSourceType.__str__N) r+r,r-r3rr:r"rcrcoder2r'r%r%r%r&r`s  r`cseZdZdZejeejdeddZ ej edddZ ej edd d d Z ej ed d dZ ejedZej edd d d ZdZdZdZddZfddZGdddZfddZddZeddZeddZd$d d!Zd%d"d#ZZS)&AbstractBankcarda Model representing a user's bankcard. This is used for two purposes: 1. The bankcard form will return an instance of this model that can be used with payment gateways. In this scenario, the instance will have additional attributes (start_date, issue_number, ccv) that payment gateways need but that we don't save. 2. To keep a record of a user's bankcards and allow them to be re-used. This is normally done using the 'partner reference'. .. warning:: Some of the fields of this model (name, expiry_date) are considered "cardholder data" under PCI DSS v2. Hence, if you use this model and store those fields then the requirements for PCI compliance will be more stringent. r User)rrrz Card Typer)rrarET)rrNumber z Expiry DatezPartner ReferenceNcCstd|j|j|jdS)Nz.%(card_type)s %(number)s (Expires: %(expiry)s)) card_typenumberexpiry)r"rlrm expiry_month)r$r%r%r&r' szAbstractBankcard.__str__csd|jdd|_|jdd|_|jdd|_tj|||jdkr`tj|j |_ |j dkr`d|_ dS)N start_date issue_numberccvzUnknown card type) poprprqrrrI__init__idr Z bankcard_typermrl)r$rMrN)rOr%r&rts  zAbstractBankcard.__init__c@s$eZdZdZdZedZedZdS)zAbstractBankcard.MetaTr(BankcardZ BankcardsN)r+r,r-r.r/r"rr1r%r%r%r&r2 sr2cs&|jjds|jtj||dS)NX)rm startswithprepare_for_saverIrJ)r$rMrN)rOr%r&rJ&s zAbstractBankcard.savecCs*d|jdd|_d|_|_|_dS)NzXXXX-XXXX-XXXX-%s)rmrprqrr)r$r%r%r&ry+sz!AbstractBankcard.prepare_for_savecCs|jS)N)rr)r$r%r%r&cvv1szAbstractBankcard.cvvcCsd|jddS)NzXXXX-XXXX-XXXX-%srzr{)rm)r$r%r%r&obfuscated_number5sz"AbstractBankcard.obfuscated_number%m/%ycCs |jj|S)N)rpstrftime)r$formatr%r%r& start_month9szAbstractBankcard.start_monthcCs |jj|S)N) expiry_dater)r$rr%r%r&ro<szAbstractBankcard.expiry_month)r~)r~)r+r,r-r3rr4rr5r"userr:rlrcrm DateFieldrZpartner_referencerprqrrr'rtr2rJryr^r|r}rror_r%r%)rOr&rhs0      rhN)decimalr django.dbrdjango.utils.translationrr"oscar.core.compatroscar.core.utilsroscar.models.fieldsr#oscar.templatetags.currency_filtersrrRr Modelr r@r`rhr%r%r%r&s        +