dodopayments 1.51.1__py3-none-any.whl → 1.56.5__py3-none-any.whl

dodopayments/resources/customers/wallets/wallets.py

@@ -0,0 +1,191 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+import httpx
+
+from ...._types import Body, Query, Headers, NotGiven, not_given
+from ...._compat import cached_property
+from ...._resource import SyncAPIResource, AsyncAPIResource
+from ...._response import (
+    to_raw_response_wrapper,
+    to_streamed_response_wrapper,
+    async_to_raw_response_wrapper,
+    async_to_streamed_response_wrapper,
+)
+from .ledger_entries import (
+    LedgerEntriesResource,
+    AsyncLedgerEntriesResource,
+    LedgerEntriesResourceWithRawResponse,
+    AsyncLedgerEntriesResourceWithRawResponse,
+    LedgerEntriesResourceWithStreamingResponse,
+    AsyncLedgerEntriesResourceWithStreamingResponse,
+)
+from ...._base_client import make_request_options
+from ....types.customers.wallet_list_response import WalletListResponse
+
+__all__ = ["WalletsResource", "AsyncWalletsResource"]
+
+
+class WalletsResource(SyncAPIResource):
+    @cached_property
+    def ledger_entries(self) -> LedgerEntriesResource:
+        return LedgerEntriesResource(self._client)
+
+    @cached_property
+    def with_raw_response(self) -> WalletsResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/dodopayments/dodopayments-python#accessing-raw-response-data-eg-headers
+        """
+        return WalletsResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> WalletsResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/dodopayments/dodopayments-python#with_streaming_response
+        """
+        return WalletsResourceWithStreamingResponse(self)
+
+    def list(
+        self,
+        customer_id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> WalletListResponse:
+        """
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not customer_id:
+            raise ValueError(f"Expected a non-empty value for `customer_id` but received {customer_id!r}")
+        return self._get(
+            f"/customers/{customer_id}/wallets",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=WalletListResponse,
+        )
+
+
+class AsyncWalletsResource(AsyncAPIResource):
+    @cached_property
+    def ledger_entries(self) -> AsyncLedgerEntriesResource:
+        return AsyncLedgerEntriesResource(self._client)
+
+    @cached_property
+    def with_raw_response(self) -> AsyncWalletsResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/dodopayments/dodopayments-python#accessing-raw-response-data-eg-headers
+        """
+        return AsyncWalletsResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncWalletsResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/dodopayments/dodopayments-python#with_streaming_response
+        """
+        return AsyncWalletsResourceWithStreamingResponse(self)
+
+    async def list(
+        self,
+        customer_id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> WalletListResponse:
+        """
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not customer_id:
+            raise ValueError(f"Expected a non-empty value for `customer_id` but received {customer_id!r}")
+        return await self._get(
+            f"/customers/{customer_id}/wallets",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=WalletListResponse,
+        )
+
+
+class WalletsResourceWithRawResponse:
+    def __init__(self, wallets: WalletsResource) -> None:
+        self._wallets = wallets
+
+        self.list = to_raw_response_wrapper(
+            wallets.list,
+        )
+
+    @cached_property
+    def ledger_entries(self) -> LedgerEntriesResourceWithRawResponse:
+        return LedgerEntriesResourceWithRawResponse(self._wallets.ledger_entries)
+
+
+class AsyncWalletsResourceWithRawResponse:
+    def __init__(self, wallets: AsyncWalletsResource) -> None:
+        self._wallets = wallets
+
+        self.list = async_to_raw_response_wrapper(
+            wallets.list,
+        )
+
+    @cached_property
+    def ledger_entries(self) -> AsyncLedgerEntriesResourceWithRawResponse:
+        return AsyncLedgerEntriesResourceWithRawResponse(self._wallets.ledger_entries)
+
+
+class WalletsResourceWithStreamingResponse:
+    def __init__(self, wallets: WalletsResource) -> None:
+        self._wallets = wallets
+
+        self.list = to_streamed_response_wrapper(
+            wallets.list,
+        )
+
+    @cached_property
+    def ledger_entries(self) -> LedgerEntriesResourceWithStreamingResponse:
+        return LedgerEntriesResourceWithStreamingResponse(self._wallets.ledger_entries)
+
+
+class AsyncWalletsResourceWithStreamingResponse:
+    def __init__(self, wallets: AsyncWalletsResource) -> None:
+        self._wallets = wallets
+
+        self.list = async_to_streamed_response_wrapper(
+            wallets.list,
+        )
+
+    @cached_property
+    def ledger_entries(self) -> AsyncLedgerEntriesResourceWithStreamingResponse:
+        return AsyncLedgerEntriesResourceWithStreamingResponse(self._wallets.ledger_entries)

dodopayments/resources/discounts.py

@@ -2,13 +2,13 @@
 
 from __future__ import annotations
 
-from typing import List, Union, Optional
+from typing import Union, Optional
 from datetime import datetime
 
 import httpx
 
 from ..types import DiscountType, discount_list_params, discount_create_params, discount_update_params
-from .._types import NOT_GIVEN, Body, Query, Headers, NoneType, NotGiven
+from .._types import Body, Omit, Query, Headers, NoneType, NotGiven, SequenceNotStr, omit, not_given
 from .._utils import maybe_transform, async_maybe_transform
 from .._compat import cached_property
 from .._resource import SyncAPIResource, AsyncAPIResource
@@ -51,18 +51,18 @@ class DiscountsResource(SyncAPIResource):
         *,
         amount: int,
         type: DiscountType,
-        code: Optional[str] | NotGiven = NOT_GIVEN,
-        expires_at: Union[str, datetime, None] | NotGiven = NOT_GIVEN,
-        name: Optional[str] | NotGiven = NOT_GIVEN,
-        restricted_to: Optional[List[str]] | NotGiven = NOT_GIVEN,
-        subscription_cycles: Optional[int] | NotGiven = NOT_GIVEN,
-        usage_limit: Optional[int] | NotGiven = NOT_GIVEN,
+        code: Optional[str] | Omit = omit,
+        expires_at: Union[str, datetime, None] | Omit = omit,
+        name: Optional[str] | Omit = omit,
+        restricted_to: Optional[SequenceNotStr[str]] | Omit = omit,
+        subscription_cycles: Optional[int] | Omit = omit,
+        usage_limit: Optional[int] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> Discount:
         """
         POST /discounts If `code` is omitted or empty, a random 16-char uppercase code
@@ -133,7 +133,7 @@ class DiscountsResource(SyncAPIResource):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> Discount:
         """
         GET /discounts/{discount_id}
@@ -161,20 +161,20 @@ class DiscountsResource(SyncAPIResource):
         self,
         discount_id: str,
         *,
-        amount: Optional[int] | NotGiven = NOT_GIVEN,
-        code: Optional[str] | NotGiven = NOT_GIVEN,
-        expires_at: Union[str, datetime, None] | NotGiven = NOT_GIVEN,
-        name: Optional[str] | NotGiven = NOT_GIVEN,
-        restricted_to: Optional[List[str]] | NotGiven = NOT_GIVEN,
-        subscription_cycles: Optional[int] | NotGiven = NOT_GIVEN,
-        type: Optional[DiscountType] | NotGiven = NOT_GIVEN,
-        usage_limit: Optional[int] | NotGiven = NOT_GIVEN,
+        amount: Optional[int] | Omit = omit,
+        code: Optional[str] | Omit = omit,
+        expires_at: Union[str, datetime, None] | Omit = omit,
+        name: Optional[str] | Omit = omit,
+        restricted_to: Optional[SequenceNotStr[str]] | Omit = omit,
+        subscription_cycles: Optional[int] | Omit = omit,
+        type: Optional[DiscountType] | Omit = omit,
+        usage_limit: Optional[int] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> Discount:
         """
         PATCH /discounts/{discount_id}
@@ -234,14 +234,14 @@ class DiscountsResource(SyncAPIResource):
     def list(
         self,
         *,
-        page_number: int | NotGiven = NOT_GIVEN,
-        page_size: int | NotGiven = NOT_GIVEN,
+        page_number: int | Omit = omit,
+        page_size: int | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SyncDefaultPageNumberPagination[Discount]:
         """
         GET /discounts
@@ -287,7 +287,7 @@ class DiscountsResource(SyncAPIResource):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> None:
         """
         DELETE /discounts/{discount_id}
@@ -338,18 +338,18 @@ class AsyncDiscountsResource(AsyncAPIResource):
         *,
         amount: int,
         type: DiscountType,
-        code: Optional[str] | NotGiven = NOT_GIVEN,
-        expires_at: Union[str, datetime, None] | NotGiven = NOT_GIVEN,
-        name: Optional[str] | NotGiven = NOT_GIVEN,
-        restricted_to: Optional[List[str]] | NotGiven = NOT_GIVEN,
-        subscription_cycles: Optional[int] | NotGiven = NOT_GIVEN,
-        usage_limit: Optional[int] | NotGiven = NOT_GIVEN,
+        code: Optional[str] | Omit = omit,
+        expires_at: Union[str, datetime, None] | Omit = omit,
+        name: Optional[str] | Omit = omit,
+        restricted_to: Optional[SequenceNotStr[str]] | Omit = omit,
+        subscription_cycles: Optional[int] | Omit = omit,
+        usage_limit: Optional[int] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> Discount:
         """
         POST /discounts If `code` is omitted or empty, a random 16-char uppercase code
@@ -420,7 +420,7 @@ class AsyncDiscountsResource(AsyncAPIResource):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> Discount:
         """
         GET /discounts/{discount_id}
@@ -448,20 +448,20 @@ class AsyncDiscountsResource(AsyncAPIResource):
         self,
         discount_id: str,
         *,
-        amount: Optional[int] | NotGiven = NOT_GIVEN,
-        code: Optional[str] | NotGiven = NOT_GIVEN,
-        expires_at: Union[str, datetime, None] | NotGiven = NOT_GIVEN,
-        name: Optional[str] | NotGiven = NOT_GIVEN,
-        restricted_to: Optional[List[str]] | NotGiven = NOT_GIVEN,
-        subscription_cycles: Optional[int] | NotGiven = NOT_GIVEN,
-        type: Optional[DiscountType] | NotGiven = NOT_GIVEN,
-        usage_limit: Optional[int] | NotGiven = NOT_GIVEN,
+        amount: Optional[int] | Omit = omit,
+        code: Optional[str] | Omit = omit,
+        expires_at: Union[str, datetime, None] | Omit = omit,
+        name: Optional[str] | Omit = omit,
+        restricted_to: Optional[SequenceNotStr[str]] | Omit = omit,
+        subscription_cycles: Optional[int] | Omit = omit,
+        type: Optional[DiscountType] | Omit = omit,
+        usage_limit: Optional[int] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> Discount:
         """
         PATCH /discounts/{discount_id}
@@ -521,14 +521,14 @@ class AsyncDiscountsResource(AsyncAPIResource):
     def list(
         self,
         *,
-        page_number: int | NotGiven = NOT_GIVEN,
-        page_size: int | NotGiven = NOT_GIVEN,
+        page_number: int | Omit = omit,
+        page_size: int | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> AsyncPaginator[Discount, AsyncDefaultPageNumberPagination[Discount]]:
         """
         GET /discounts
@@ -574,7 +574,7 @@ class AsyncDiscountsResource(AsyncAPIResource):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> None:
         """
         DELETE /discounts/{discount_id}

dodopayments/resources/disputes.py

@@ -9,7 +9,7 @@ from typing_extensions import Literal
 import httpx
 
 from ..types import dispute_list_params
-from .._types import NOT_GIVEN, Body, Query, Headers, NotGiven
+from .._types import Body, Omit, Query, Headers, NotGiven, omit, not_given
 from .._utils import maybe_transform
 from .._compat import cached_property
 from .._resource import SyncAPIResource, AsyncAPIResource
@@ -56,7 +56,7 @@ class DisputesResource(SyncAPIResource):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> GetDispute:
         """
         Args:
@@ -81,10 +81,10 @@ class DisputesResource(SyncAPIResource):
     def list(
         self,
         *,
-        created_at_gte: Union[str, datetime] | NotGiven = NOT_GIVEN,
-        created_at_lte: Union[str, datetime] | NotGiven = NOT_GIVEN,
-        customer_id: str | NotGiven = NOT_GIVEN,
-        dispute_stage: Literal["pre_dispute", "dispute", "pre_arbitration"] | NotGiven = NOT_GIVEN,
+        created_at_gte: Union[str, datetime] | Omit = omit,
+        created_at_lte: Union[str, datetime] | Omit = omit,
+        customer_id: str | Omit = omit,
+        dispute_stage: Literal["pre_dispute", "dispute", "pre_arbitration"] | Omit = omit,
         dispute_status: Literal[
             "dispute_opened",
             "dispute_expired",
@@ -94,15 +94,15 @@ class DisputesResource(SyncAPIResource):
             "dispute_won",
             "dispute_lost",
         ]
-        | NotGiven = NOT_GIVEN,
-        page_number: int | NotGiven = NOT_GIVEN,
-        page_size: int | NotGiven = NOT_GIVEN,
+        | Omit = omit,
+        page_number: int | Omit = omit,
+        page_size: int | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SyncDefaultPageNumberPagination[DisputeListResponse]:
         """
         Args:
@@ -182,7 +182,7 @@ class AsyncDisputesResource(AsyncAPIResource):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> GetDispute:
         """
         Args:
@@ -207,10 +207,10 @@ class AsyncDisputesResource(AsyncAPIResource):
     def list(
         self,
         *,
-        created_at_gte: Union[str, datetime] | NotGiven = NOT_GIVEN,
-        created_at_lte: Union[str, datetime] | NotGiven = NOT_GIVEN,
-        customer_id: str | NotGiven = NOT_GIVEN,
-        dispute_stage: Literal["pre_dispute", "dispute", "pre_arbitration"] | NotGiven = NOT_GIVEN,
+        created_at_gte: Union[str, datetime] | Omit = omit,
+        created_at_lte: Union[str, datetime] | Omit = omit,
+        customer_id: str | Omit = omit,
+        dispute_stage: Literal["pre_dispute", "dispute", "pre_arbitration"] | Omit = omit,
         dispute_status: Literal[
             "dispute_opened",
             "dispute_expired",
@@ -220,15 +220,15 @@ class AsyncDisputesResource(AsyncAPIResource):
             "dispute_won",
             "dispute_lost",
         ]
-        | NotGiven = NOT_GIVEN,
-        page_number: int | NotGiven = NOT_GIVEN,
-        page_size: int | NotGiven = NOT_GIVEN,
+        | Omit = omit,
+        page_number: int | Omit = omit,
+        page_size: int | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> AsyncPaginator[DisputeListResponse, AsyncDefaultPageNumberPagination[DisputeListResponse]]:
         """
         Args:

dodopayments/resources/invoices/payments.py

@@ -4,7 +4,7 @@ from __future__ import annotations
 
 import httpx
 
-from ..._types import NOT_GIVEN, Body, Query, Headers, NotGiven
+from ..._types import Body, Query, Headers, NotGiven, not_given
 from ..._compat import cached_property
 from ..._resource import SyncAPIResource, AsyncAPIResource
 from ..._response import (
@@ -51,7 +51,7 @@ class PaymentsResource(SyncAPIResource):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> BinaryAPIResponse:
         """
         Args:
@@ -74,6 +74,38 @@ class PaymentsResource(SyncAPIResource):
             cast_to=BinaryAPIResponse,
         )
 
+    def retrieve_refund(
+        self,
+        refund_id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> BinaryAPIResponse:
+        """
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not refund_id:
+            raise ValueError(f"Expected a non-empty value for `refund_id` but received {refund_id!r}")
+        extra_headers = {"Accept": "application/pdf", **(extra_headers or {})}
+        return self._get(
+            f"/invoices/refunds/{refund_id}",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=BinaryAPIResponse,
+        )
+
 
 class AsyncPaymentsResource(AsyncAPIResource):
     @cached_property
@@ -104,7 +136,7 @@ class AsyncPaymentsResource(AsyncAPIResource):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> AsyncBinaryAPIResponse:
         """
         Args:
@@ -127,6 +159,38 @@ class AsyncPaymentsResource(AsyncAPIResource):
             cast_to=AsyncBinaryAPIResponse,
         )
 
+    async def retrieve_refund(
+        self,
+        refund_id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> AsyncBinaryAPIResponse:
+        """
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not refund_id:
+            raise ValueError(f"Expected a non-empty value for `refund_id` but received {refund_id!r}")
+        extra_headers = {"Accept": "application/pdf", **(extra_headers or {})}
+        return await self._get(
+            f"/invoices/refunds/{refund_id}",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=AsyncBinaryAPIResponse,
+        )
+
 
 class PaymentsResourceWithRawResponse:
     def __init__(self, payments: PaymentsResource) -> None:
@@ -136,6 +200,10 @@ class PaymentsResourceWithRawResponse:
             payments.retrieve,
             BinaryAPIResponse,
         )
+        self.retrieve_refund = to_custom_raw_response_wrapper(
+            payments.retrieve_refund,
+            BinaryAPIResponse,
+        )
 
 
 class AsyncPaymentsResourceWithRawResponse:
@@ -146,6 +214,10 @@ class AsyncPaymentsResourceWithRawResponse:
             payments.retrieve,
             AsyncBinaryAPIResponse,
         )
+        self.retrieve_refund = async_to_custom_raw_response_wrapper(
+            payments.retrieve_refund,
+            AsyncBinaryAPIResponse,
+        )
 
 
 class PaymentsResourceWithStreamingResponse:
@@ -156,6 +228,10 @@ class PaymentsResourceWithStreamingResponse:
             payments.retrieve,
             StreamedBinaryAPIResponse,
         )
+        self.retrieve_refund = to_custom_streamed_response_wrapper(
+            payments.retrieve_refund,
+            StreamedBinaryAPIResponse,
+        )
 
 
 class AsyncPaymentsResourceWithStreamingResponse:
@@ -166,3 +242,7 @@ class AsyncPaymentsResourceWithStreamingResponse:
             payments.retrieve,
             AsyncStreamedBinaryAPIResponse,
         )
+        self.retrieve_refund = async_to_custom_streamed_response_wrapper(
+            payments.retrieve_refund,
+            AsyncStreamedBinaryAPIResponse,
+        )