+hB ddlmZmZmZmZddlmZddlmZddl m Z ddl m Z ddl mZmZmZmZmZmZddlmZmZmZmZmZddlmZGd d ed ed ed ed Zy ) )CreateableAPIResourceDeletableAPIResourceListableAPIResourceUpdateableAPIResource) ListObject)RequestOptions) StripeObject)class_method_variant)ClassVarDictListOptionalcastoverload)Literal NotRequired TypedDictUnpack TYPE_CHECKING) quote_plusceZdZUdZdZeeded<GddeZ GddeZ e rcGdd e Z Gd d eZGd d eZGdde ZGdde ZGddeZGdde ZGddeZGdde Zeeed< ee ed<eed< eeed< eeee fed< eded < eeed!< eed"< eed#< eeed$< eeeefed%< eeed&< eded'< eeed(< eeed)< eed*< eed+< eed,ed-< e dEd/eed0eed1eed2eed3ed4d5df d6Zed7ed3ed8d5dfd9Z e!e"d7ed3ed8d5dfd:Z#e!d3ed8d5dfd;Z#e$d<d3ed8d5dfd=Z#e dFd/eed1eed2eed3ed>d5e%df d?Z&ed"ed3ed@d5dfdAZ'ed"ed3edBd5dfdCZ(e e dDZ)y.)GCoupona+ 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_NAMEceZdZUeeed<y)Coupon.AppliesToproductsN)__name__ __module__ __qualname__r str__annotations__N/var/www/html/venv/lib/python3.12/site-packages/stripe/api_resources/coupon.py AppliesTor&ss) r$r&ceZdZUeed<y)Coupon.CurrencyOptions amount_offNrrr intr"r#r$r%CurrencyOptionsr(,s  r$r,ceZdZUeded< eded< eded< eded< ed ed < eded < ed ed < eded< eded< eded< eded< eded< eded<y)Coupon.CreateParamsr+r)Coupon.CreateParamsAppliesTo applies_tor!currencyz-Dict[str, Coupon.CreateParamsCurrencyOptions]currency_optionsz'Literal['forever', 'once', 'repeating']durationduration_in_months List[str]expandidmax_redemptionsLiteral['']|Dict[str, str]metadatanamefloat percent_off redeem_byNrrr rr"r#r$r% CreateParamsr.4s#E* * $$BC C "%( ( *?  ""KL L !,E 2 2  , , E" " )/ / "">? ? e$ $ %W- - #5) ) r$r@ceZdZUeed<y)"Coupon.CreateParamsCurrencyOptionsr)Nr*r#r$r%CreateParamsCurrencyOptionsrBl O r$rCceZdZUeded<y)r/r5rNr?r#r$r%CreateParamsAppliesTozCoupon.CreateParamsAppliesTors!+. . r$rFc eZdZy)Coupon.DeleteParamsN)rrr r#r$r% DeleteParamsrHxs r$rIcfeZdZUeded< eded< eded< eded< eded <y ) Coupon.ListParamszCoupon.ListParamsCreated|intcreatedr! ending_beforer5r6r+limitstarting_afterNr?r#r$r% ListParamsrK{s[ !?@ @ 'u- -  , , u% % (. . r$rPcTeZdZUeded< eded< eded< eded<y)Coupon.ListParamsCreatedr+gtgteltlteNr?r#r$r%ListParamsCreatedrRsHE" " U# # E" " U# # r$rWcTeZdZUeded< eded< eded< eded<y ) Coupon.ModifyParamsz-Dict[str, Coupon.ModifyParamsCurrencyOptions]r2r5r6r9r:r!r;Nr?r#r$r% ModifyParamsrYsN)?   , , "">? ? e$ $ r$rZceZdZUeed<y)"Coupon.ModifyParamsCurrencyOptionsr)Nr*r#r$r%ModifyParamsCurrencyOptionsr\rDr$r]ceZdZUeded<y)Coupon.RetrieveParamsr5r6Nr?r#r$r%RetrieveParamsr_s , , r$r`r)r0rLr1r2)foreveronce repeatingr3r4r7livemoder8r:r;objectr=r>times_redeemedvalidTdeletedNapi_keyidempotency_keystripe_versionstripe_accountparamsr.returnc `td|jd|j|||||S)a 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. rpost)r_static_request class_url)clsrirjrkrlrms r%createz Coupon.create s=        r$sidrHc z|jdt|}td|jd||S)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. /rdeletermrrrrrq)rsrurmurls r% _cls_deletezCoupon._cls_delete$s=*S/:    #f  =  r$c yrwNr#)rurms r%ryz Coupon.delete1s r$c yrr#selfrms r%ryz Coupon.delete9s r$r}c F|jd|j|S)rwryrz)_request_and_refresh instance_urlrs r%ryz Coupon.delete@s.((     )  r$rKc |jd|j||||}t|ts!t dt |j z|S)z1 Returns a list of your coupons. get)rirkrlrmz%Expected list object from API, got %s)rqrr isinstancer TypeErrortyper)rsrirkrlrmresults r%listz Coupon.listMsf$$  MMO)) % &*-7<((*   r$rYc z|jdt|}td|jd||S)z Updates the metadata of a coupon. Other coupon details (currency, duration, amount_off) are, by design, not editable. rxrrprzr{)rsr7rmr|s r%modifyz Coupon.modifyis=*R.9    F  ;  r$r_c 8||fi|}|j|S)z9 Retrieves the coupon with the given ID. )refresh)rsr7rminstances r%retrievezCoupon.retrievevs$r$V$r$)r0r2)NNNN)NNN)*rrr __doc__rr rr"r r&r,rrr@rrCrFrIrPrWrZr]r`rr+r!r boolr< classmethodrrtr}r staticmethodryr rrrr_inner_class_typesr#r$r%rrs  08K'(+,7 L  , 6 >6 p )   I   >   ,   $ > ( )   ^   ## LsmtC$89::455! % GNc]"tCH~&& 3- H % } Kgdm $$"&)-(,(,  # "# !  !  ./     4    !'(=!>       C 6*?#@ X   v&;<   -(  45    )  "&(,(, #! !  ,-  H  6    &'< =       &'> ?  +r$rN)stripe.api_resources.abstractrrrr stripe.api_resources.list_objectrstripe.request_optionsrstripe.stripe_objectr stripe.utilr typingr r r rrrtyping_extensionsrrrrr urllib.parserrr#r$r%rs^ 81-,AA$l(#"!(# lr$