1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144
|
# -*- coding: utf-8 -*-
# File generated from our OpenAPI spec
from stripe._application_fee import ApplicationFee
from stripe._application_fee_refund_service import ApplicationFeeRefundService
from stripe._list_object import ListObject
from stripe._request_options import RequestOptions
from stripe._stripe_service import StripeService
from stripe._util import sanitize_id
from typing import List, cast
from typing_extensions import NotRequired, TypedDict
class ApplicationFeeService(StripeService):
def __init__(self, requestor):
super().__init__(requestor)
self.refunds = ApplicationFeeRefundService(self._requestor)
class ListParams(TypedDict):
charge: NotRequired[str]
"""
Only return application fees for the charge specified by this charge ID.
"""
created: NotRequired["ApplicationFeeService.ListParamsCreated|int"]
"""
Only return applications fees that were created during the given date interval.
"""
ending_before: NotRequired[str]
"""
A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list.
"""
expand: NotRequired[List[str]]
"""
Specifies which fields in the response should be expanded.
"""
limit: NotRequired[int]
"""
A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
"""
starting_after: NotRequired[str]
"""
A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list.
"""
class ListParamsCreated(TypedDict):
gt: NotRequired[int]
"""
Minimum value to filter by (exclusive)
"""
gte: NotRequired[int]
"""
Minimum value to filter by (inclusive)
"""
lt: NotRequired[int]
"""
Maximum value to filter by (exclusive)
"""
lte: NotRequired[int]
"""
Maximum value to filter by (inclusive)
"""
class RetrieveParams(TypedDict):
expand: NotRequired[List[str]]
"""
Specifies which fields in the response should be expanded.
"""
def list(
self,
params: "ApplicationFeeService.ListParams" = {},
options: RequestOptions = {},
) -> ListObject[ApplicationFee]:
"""
Returns a list of application fees you've previously collected. The application fees are returned in sorted order, with the most recent fees appearing first.
"""
return cast(
ListObject[ApplicationFee],
self._request(
"get",
"/v1/application_fees",
base_address="api",
params=params,
options=options,
),
)
async def list_async(
self,
params: "ApplicationFeeService.ListParams" = {},
options: RequestOptions = {},
) -> ListObject[ApplicationFee]:
"""
Returns a list of application fees you've previously collected. The application fees are returned in sorted order, with the most recent fees appearing first.
"""
return cast(
ListObject[ApplicationFee],
await self._request_async(
"get",
"/v1/application_fees",
base_address="api",
params=params,
options=options,
),
)
def retrieve(
self,
id: str,
params: "ApplicationFeeService.RetrieveParams" = {},
options: RequestOptions = {},
) -> ApplicationFee:
"""
Retrieves the details of an application fee that your account has collected. The same information is returned when refunding the application fee.
"""
return cast(
ApplicationFee,
self._request(
"get",
"/v1/application_fees/{id}".format(id=sanitize_id(id)),
base_address="api",
params=params,
options=options,
),
)
async def retrieve_async(
self,
id: str,
params: "ApplicationFeeService.RetrieveParams" = {},
options: RequestOptions = {},
) -> ApplicationFee:
"""
Retrieves the details of an application fee that your account has collected. The same information is returned when refunding the application fee.
"""
return cast(
ApplicationFee,
await self._request_async(
"get",
"/v1/application_fees/{id}".format(id=sanitize_id(id)),
base_address="api",
params=params,
options=options,
),
)
|