o BiRQ@sddlmZddlmZddlmZddlmZddlm Z ddl m Z ddl m Z ddlmZmZdd lmZmZmZmZmZmZdd lmZmZmZmZGd d d ed ed ed e d Zd S))CreateableAPIResource)DeletableAPIResource) ListObject)ListableAPIResource)RequestOptions) StripeObject)UpdateableAPIResource)class_method_variant sanitize_id)ClassVarDictListOptionalcastoverload)Literal NotRequired TypedDictUnpackc@seZdZUdZdZeeded<GdddeZ GdddeZ Gdd d e Z Gd d d e ZGd d d e ZGddde ZGddde ZGddde ZGddde ZGddde ZGddde Zeeed< ee ed<eed< eeed< eeee fed< eded < eeed!< eed"< eed#< eeed$< eeeefed%< eeed&< eded'< eeed(< eeed)< eed*< eed+< eed,ed-< ed.ed/d0dfd1d2Zed.ed/d0dfd3d4Zed5ed.ed6d0dfd7d8Z e!e"d5ed.ed6d0dfd9d:Z#e!d.ed6d0dfd;d:Z#e$d<d.ed6d0dfd=d:Z#ed5ed.ed6d0dfd>d?Z%e!e"d5ed.ed6d0dfd@dAZ&e!d.ed6d0dfdBdAZ&e$dCd.ed6d0dfdDdAZ&ed.edEd0e'dfdFdGZ(ed.edEd0e'dfdHdIZ)ed"ed.edJd0dfdKdLZ*ed"ed.edJd0dfdMdNZ+ed"ed.edOd0dfdPdQZ,ed"ed.edOd0dfdRdSZ-e e dTZ.dUS)VCoupona+ A coupon contains information about a percent-off or amount-off discount you might want to apply to a customer. Coupons may be applied to [subscriptions](https://stripe.com/docs/api#subscriptions), [invoices](https://stripe.com/docs/api#invoices), [checkout sessions](https://stripe.com/docs/api/checkout/sessions), [quotes](https://stripe.com/docs/api#quotes), and more. Coupons do not work with conventional one-off [charges](https://stripe.com/docs/api#create_charge) or [payment intents](https://stripe.com/docs/api/payment_intents). coupon OBJECT_NAMEc@seZdZUeeed<dS)zCoupon.AppliesToproductsN)__name__ __module__ __qualname__r str__annotations__rrN/var/www/html/Trade-python/venv/lib/python3.10/site-packages/stripe/_coupon.py AppliesTos r c@eZdZUeed<dS)zCoupon.CurrencyOptions amount_offNrrrintrrrrrCurrencyOptions# r%c@seZdZUeeed< eded< eeed< eeedfed< eeded< eeed < ee eed < eeed < eeed < ed ed< eeed< ee ed< eeed<dS)Coupon.CreateParamsr"Coupon.CreateParamsAppliesTo applies_tocurrency"Coupon.CreateParamsCurrencyOptionscurrency_optionsforeveronce repeatingdurationduration_in_monthsexpandidmax_redemptionsLiteral['']|Dict[str, str]metadataname percent_off redeem_byN) rrrrr$rrr rr floatrrrr CreateParams)s:           r<c@eZdZUeeeed<dS)r(rNrrrrr rrrrrrCreateParamsAppliesToa r?c@r!)r+r"Nr#rrrrCreateParamsCurrencyOptionsgr&rAc@s eZdZdS)Coupon.DeleteParamsN)rrrrrrr DeleteParamsmsrCc@sVeZdZUeded< eeed< eeeed< eeed< eeed<dS)Coupon.ListParamszCoupon.ListParamsCreated|intcreated ending_beforer3limitstarting_afterN)rrrrrrr r$rrrr ListParamsps    rIc@sDeZdZUeeed< eeed< eeed< eeed<dS)zCoupon.ListParamsCreatedgtgteltlteN)rrrrr$rrrrrListParamsCreateds    rNc@sPeZdZUeeedfed< eeeed< eded< eeed<dS)Coupon.ModifyParams"Coupon.ModifyParamsCurrencyOptionsr,r3r6r7r8N)rrrrr rrr rrrr ModifyParamss    rQc@r!)rPr"Nr#rrrrModifyParamsCurrencyOptionsr&rRc@r=)Coupon.RetrieveParamsr3Nr>rrrrRetrieveParamsr@rTr"r)rEr*r,r-r1r2r4livemoder5r7r8objectr9r:times_redeemedvalidTdeletedparamsr'returncKstd|jd||dS) You can create coupons easily via the [coupon management](https://dashboard.stripe.com/coupons) page of the Stripe dashboard. Coupon creation is also accessible via the API if you need to create coupons on the fly. A coupon has either a percent_off or an amount_off and currency. If you set an amount_off, that amount will be subtracted from any invoice's subtotal. For example, an invoice with a subtotal of 100 will have a final total of 0 if a coupon with an amount_off of 200 is applied to it and an invoice with a subtotal of 300 will have a final total of 100 if a coupon with an amount_off of 200 is applied to it. rpostrZ)r_static_request class_urlclsrZrrrcreatesz Coupon.createcs"td|jd||dIdHS)r\rr]r^N)r_static_request_asyncr`rarrr create_asyncs  zCoupon.create_asyncsidrBcK*d|t|f}td|jd||dS)D You can delete coupons via the [coupon management](https://dashboard.stripe.com/coupons) page of the Stripe dashboard. However, deleting a coupon does not affect any customers who have already applied the coupon; it means that new customers can't redeem the coupon. You can also delete coupons via the API. %s/%srdeleter^r`r rr_rbrfrZurlrrr _cls_delete zCoupon._cls_deletecKdSrhNrrfrZrrrrj1sz Coupon.deletecKrprqrselfrZrrrrj9srncKs|jd||dS)rhrjr^)_request_and_refresh instance_urlrsrrrrj@s c2d|t|f}td|jd||dIdHS)rhrirrjr^Nr`r rrdrlrrr_cls_delete_asyncM zCoupon._cls_delete_asynccdSrqrrrrrr delete_async^szCoupon.delete_asynccr{rqrrsrrrr|hsrycs|jd||dIdHS)rhrjr^N)_request_and_refresh_asyncrvrsrrrr|qs  rDcKs4|jd||d}t|tstdt|j|S)1 Returns a list of your coupons. getr^%Expected list object from API, got %s)r_r` isinstancer TypeErrortyperrbrZresultrrrlist~s z Coupon.listcs<|jd||dIdH}t|tstdt|j|S)r~rr^Nr)rdr`rrrrrrrrr list_asyncs zCoupon.list_asyncrOcKrg) Updates the metadata of a coupon. Other coupon details (currency, duration, amount_off) are, by design, not editable. rirr]r^rkrbr4rZrmrrrmodifyroz Coupon.modifycrw)rrirr]r^Nrxrrrr modify_asyncrzzCoupon.modify_asyncrScKs||fi|}||S)9 Retrieves the coupon with the given ID. )refreshrbr4rZinstancerrrretrieveszCoupon.retrievecs$||fi|}|IdH|S)rN) refresh_asyncrrrrretrieve_asyncszCoupon.retrieve_async)r)r,N)/rrr__doc__rr rrrr r%rr<rr?rArCrIrNrQrRrTrr$rr boolr; classmethodrrcrernr staticmethodrjr ryr|rrrrrrr_inner_class_typesrrrrrs0 8                           rN)stripe._createable_api_resourcerstripe._deletable_api_resourcerstripe._list_objectrstripe._listable_api_resourcerstripe._request_optionsrstripe._stripe_objectrstripe._updateable_api_resourcer stripe._utilr r typingr r r rrrtyping_extensionsrrrrrrrrrs