a !fA@sddlmZmZmZmZddlmZddlmZddl m Z ddl m Z ddl mZmZmZmZmZmZddlmZmZmZmZddlmZGd d d ed ed ed ed Zd S) )CreateableAPIResourceDeletableAPIResourceListableAPIResourceUpdateableAPIResource) ListObject)RequestOptions) StripeObject)class_method_variant)ClassVarDictListOptionalcastoverload)Literal NotRequired TypedDictUnpack) quote_plusc @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-<edIeeeeeeeeed/dd0d1d2Zeeed3dd4d5d6Ze e!eed3dd4d7d8Z"e ed3dd9d:d8Z"e#d;ed3dd9dd?d@Z%eeedAddBdCdDZ&eeedEddBdFdGZ'e e dHZ(d.S)KCoupona+ 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). Zcoupon OBJECT_NAMEc@seZdZUeeed<dS)zCoupon.AppliesToproductsN)__name__ __module__ __qualname__r str__annotations__rr\/var/www/html/python-backend/venv/lib/python3.9/site-packages/stripe/api_resources/coupon.py AppliesTo s  rc@seZdZUeed<dS)zCoupon.CurrencyOptions amount_offNrrrintrrrrrCurrencyOptions&s r#c@seZdZUeded<eded<eded<eded<ed ed <eded <ed ed <eded<eded<eded<eded<eded<eded<dS)Coupon.CreateParamsr"r Coupon.CreateParamsAppliesTo applies_torcurrencyz-Dict[str, Coupon.CreateParamsCurrencyOptions]currency_optionsz'Literal['forever', 'once', 'repeating']durationduration_in_months List[str]expandidmax_redemptionsLiteral['']|Dict[str, str]metadatanamefloat percent_off redeem_byNrrrrrrrrr CreateParams,s             r6c@seZdZUeed<dS)z"Coupon.CreateParamsCurrencyOptionsr Nr!rrrrCreateParamsCurrencyOptionsds r7c@seZdZUeded<dS)r%r+rNr5rrrrCreateParamsAppliesTojs  r8c@s eZdZdS)Coupon.DeleteParamsN)rrrrrrr DeleteParamspsr:c@sJeZdZUeded<eded<eded<eded<eded <d S) Coupon.ListParamszCoupon.ListParamsCreated|intcreatedrZ ending_beforer+r,r"limitZstarting_afterNr5rrrr ListParamsss      r>c@s>eZdZUeded<eded<eded<eded<dS)zCoupon.ListParamsCreatedr"gtZgteltZlteNr5rrrrListParamsCreateds     rAc@s>eZdZUeded<eded<eded<eded<d S) Coupon.ModifyParamsz-Dict[str, Coupon.ModifyParamsCurrencyOptions]r(r+r,r/r0rr1Nr5rrrr ModifyParamss    rCc@seZdZUeed<dS)z"Coupon.ModifyParamsCurrencyOptionsr Nr!rrrrModifyParamsCurrencyOptionss rDc@seZdZUeded<dS)Coupon.RetrieveParamsr+r,Nr5rrrrRetrieveParamss  rFr r&r<r'r()foreveronceZ repeatingr)r*r-Zlivemoder.r0r1objectr3r4Ztimes_redeemedZvalidTZdeletedNr$)api_keyidempotency_keystripe_versionstripe_accountparamsreturnc Ks td|d||||||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)clsrJrKrLrMrNrrrcreatesz Coupon.creater9)sidrNrOcKs*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/%srdeleterNrRrrrQ)rSrUrNurlrrr _cls_deletes zCoupon._cls_deletecKsdSrVNr)rUrNrrrrX+sz Coupon.delete)rNrOcKsdSr]rselfrNrrrrX3sr\cKs|jd||dS)rVrXrY)Z_request_and_refreshZ instance_urlr^rrrrX:s r;)rJrLrMrNrOcKs:|jd|||||d}t|ts6tdt|j|S)z1 Returns a list of your coupons. get)rJrLrMrNz%Expected list object from API, got %s)rQrR isinstancer TypeErrortyper)rSrJrLrMrNresultrrrlistGs  z Coupon.listrB)r-rNrOcKs*d|t|f}td|jd||dS)z Updates the metadata of a coupon. Other coupon details (currency, duration, amount_off) are, by design, not editable. rWrrPrYrZ)rSr-rNr[rrrmodifyes z Coupon.modifyrEcKs||fi|}||S)z9 Retrieves the coupon with the given ID. )refresh)rSr-rNinstancerrrretrieverszCoupon.retrieve)r&r()NNNN)NNN))rrr__doc__rr rrrrr#rr6rr7r8r:r>rArCrDrFr r"rr boolr2 classmethodrrTr\r staticmethodrXr rrerfriZ_inner_class_typesrrrrrs 8              rN)Zstripe.api_resources.abstractrrrrZ stripe.api_resources.list_objectrZstripe.request_optionsrZstripe.stripe_objectrZ stripe.utilr typingr r r r rrZtyping_extensionsrrrr urllib.parserrrrrrs