mollie-api-py 1.0.0__py3-none-any.whl

mollie/models/entity_payment_route.py

@@ -0,0 +1,111 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+
+from __future__ import annotations
+from .amount import Amount, AmountTypedDict
+from .route_destination_type import RouteDestinationType
+from .url import URL, URLTypedDict
+from mollie.types import BaseModel, Nullable, OptionalNullable, UNSET, UNSET_SENTINEL
+import pydantic
+from pydantic import model_serializer
+from typing_extensions import Annotated, NotRequired, TypedDict
+
+
+class EntityPaymentRouteDestinationTypedDict(TypedDict):
+    r"""The destination of this portion of the payment."""
+
+    type: RouteDestinationType
+    r"""The type of destination. Currently only the destination type `organization` is supported."""
+    organization_id: str
+
+
+class EntityPaymentRouteDestination(BaseModel):
+    r"""The destination of this portion of the payment."""
+
+    type: RouteDestinationType
+    r"""The type of destination. Currently only the destination type `organization` is supported."""
+
+    organization_id: Annotated[str, pydantic.Field(alias="organizationId")]
+
+
+class EntityPaymentRouteLinksTypedDict(TypedDict):
+    r"""An object with several relevant URLs. Every URL object will contain an `href` and a `type` field."""
+
+    self_: URLTypedDict
+    r"""In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field."""
+    payment: URLTypedDict
+    r"""In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field."""
+
+
+class EntityPaymentRouteLinks(BaseModel):
+    r"""An object with several relevant URLs. Every URL object will contain an `href` and a `type` field."""
+
+    self_: Annotated[URL, pydantic.Field(alias="self")]
+    r"""In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field."""
+
+    payment: URL
+    r"""In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field."""
+
+
+class EntityPaymentRouteTypedDict(TypedDict):
+    amount: AmountTypedDict
+    r"""In v2 endpoints, monetary amounts are represented as objects with a `currency` and `value` field."""
+    destination: EntityPaymentRouteDestinationTypedDict
+    r"""The destination of this portion of the payment."""
+    links: EntityPaymentRouteLinksTypedDict
+    r"""An object with several relevant URLs. Every URL object will contain an `href` and a `type` field."""
+    release_date: NotRequired[Nullable[str]]
+    r"""Optionally, schedule this portion of the payment to be transferred to its destination on a later date. The
+    date must be given in `YYYY-MM-DD` format.
+
+    If no date is given, the funds become available to the connected merchant as soon as the payment succeeds.
+    """
+
+
+class EntityPaymentRoute(BaseModel):
+    amount: Amount
+    r"""In v2 endpoints, monetary amounts are represented as objects with a `currency` and `value` field."""
+
+    destination: EntityPaymentRouteDestination
+    r"""The destination of this portion of the payment."""
+
+    links: Annotated[EntityPaymentRouteLinks, pydantic.Field(alias="_links")]
+    r"""An object with several relevant URLs. Every URL object will contain an `href` and a `type` field."""
+
+    release_date: Annotated[
+        OptionalNullable[str], pydantic.Field(alias="releaseDate")
+    ] = UNSET
+    r"""Optionally, schedule this portion of the payment to be transferred to its destination on a later date. The
+    date must be given in `YYYY-MM-DD` format.
+
+    If no date is given, the funds become available to the connected merchant as soon as the payment succeeds.
+    """
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = ["releaseDate"]
+        nullable_fields = ["releaseDate"]
+        null_default_fields = []
+
+        serialized = handler(self)
+
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k)
+            serialized.pop(k, None)
+
+            optional_nullable = k in optional_fields and k in nullable_fields
+            is_set = (
+                self.__pydantic_fields_set__.intersection({n})
+                or k in null_default_fields
+            )  # pylint: disable=no-member
+
+            if val is not None and val != UNSET_SENTINEL:
+                m[k] = val
+            elif val != UNSET_SENTINEL and (
+                not k in optional_fields or (optional_nullable and is_set)
+            ):
+                m[k] = val
+
+        return m

mollie/models/entity_payment_route_response.py

@@ -0,0 +1,140 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+
+from __future__ import annotations
+from .amount import Amount, AmountTypedDict
+from .mode import Mode
+from .route_destination_type_response import RouteDestinationTypeResponse
+from .url import URL, URLTypedDict
+from mollie.types import BaseModel, Nullable, OptionalNullable, UNSET, UNSET_SENTINEL
+from mollie.utils import validate_open_enum
+import pydantic
+from pydantic import model_serializer
+from pydantic.functional_validators import PlainValidator
+from typing_extensions import Annotated, NotRequired, TypedDict
+
+
+class EntityPaymentRouteResponseDestinationTypedDict(TypedDict):
+    r"""The destination of this portion of the payment."""
+
+    type: RouteDestinationTypeResponse
+    r"""The type of destination. Currently only the destination type `organization` is supported."""
+    organization_id: str
+
+
+class EntityPaymentRouteResponseDestination(BaseModel):
+    r"""The destination of this portion of the payment."""
+
+    type: Annotated[
+        RouteDestinationTypeResponse, PlainValidator(validate_open_enum(False))
+    ]
+    r"""The type of destination. Currently only the destination type `organization` is supported."""
+
+    organization_id: Annotated[str, pydantic.Field(alias="organizationId")]
+
+
+class EntityPaymentRouteResponseLinksTypedDict(TypedDict):
+    r"""An object with several relevant URLs. Every URL object will contain an `href` and a `type` field."""
+
+    self_: URLTypedDict
+    r"""In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field."""
+    payment: URLTypedDict
+    r"""In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field."""
+
+
+class EntityPaymentRouteResponseLinks(BaseModel):
+    r"""An object with several relevant URLs. Every URL object will contain an `href` and a `type` field."""
+
+    self_: Annotated[URL, pydantic.Field(alias="self")]
+    r"""In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field."""
+
+    payment: URL
+    r"""In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field."""
+
+
+class EntityPaymentRouteResponseTypedDict(TypedDict):
+    resource: str
+    r"""Indicates the response contains a route object. Will always contain the string `route` for this endpoint."""
+    id: str
+    r"""The identifier uniquely referring to this route. Mollie will always refer to the route by this ID.
+    Example: `rt_5B8cwPMGnU6qLbRvo7qEZo`.
+    """
+    mode: Mode
+    r"""Whether this entity was created in live mode or in test mode."""
+    amount: AmountTypedDict
+    r"""In v2 endpoints, monetary amounts are represented as objects with a `currency` and `value` field."""
+    destination: EntityPaymentRouteResponseDestinationTypedDict
+    r"""The destination of this portion of the payment."""
+    created_at: str
+    r"""The date and time when the route was created. The date is given in ISO 8601 format."""
+    links: EntityPaymentRouteResponseLinksTypedDict
+    r"""An object with several relevant URLs. Every URL object will contain an `href` and a `type` field."""
+    release_date: NotRequired[Nullable[str]]
+    r"""Optionally, schedule this portion of the payment to be transferred to its destination on a later date. The
+    date must be given in `YYYY-MM-DD` format.
+
+    If no date is given, the funds become available to the connected merchant as soon as the payment succeeds.
+    """
+
+
+class EntityPaymentRouteResponse(BaseModel):
+    resource: str
+    r"""Indicates the response contains a route object. Will always contain the string `route` for this endpoint."""
+
+    id: str
+    r"""The identifier uniquely referring to this route. Mollie will always refer to the route by this ID.
+    Example: `rt_5B8cwPMGnU6qLbRvo7qEZo`.
+    """
+
+    mode: Annotated[Mode, PlainValidator(validate_open_enum(False))]
+    r"""Whether this entity was created in live mode or in test mode."""
+
+    amount: Amount
+    r"""In v2 endpoints, monetary amounts are represented as objects with a `currency` and `value` field."""
+
+    destination: EntityPaymentRouteResponseDestination
+    r"""The destination of this portion of the payment."""
+
+    created_at: Annotated[str, pydantic.Field(alias="createdAt")]
+    r"""The date and time when the route was created. The date is given in ISO 8601 format."""
+
+    links: Annotated[EntityPaymentRouteResponseLinks, pydantic.Field(alias="_links")]
+    r"""An object with several relevant URLs. Every URL object will contain an `href` and a `type` field."""
+
+    release_date: Annotated[
+        OptionalNullable[str], pydantic.Field(alias="releaseDate")
+    ] = UNSET
+    r"""Optionally, schedule this portion of the payment to be transferred to its destination on a later date. The
+    date must be given in `YYYY-MM-DD` format.
+
+    If no date is given, the funds become available to the connected merchant as soon as the payment succeeds.
+    """
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = ["releaseDate"]
+        nullable_fields = ["releaseDate"]
+        null_default_fields = []
+
+        serialized = handler(self)
+
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k)
+            serialized.pop(k, None)
+
+            optional_nullable = k in optional_fields and k in nullable_fields
+            is_set = (
+                self.__pydantic_fields_set__.intersection({n})
+                or k in null_default_fields
+            )  # pylint: disable=no-member
+
+            if val is not None and val != UNSET_SENTINEL:
+                m[k] = val
+            elif val != UNSET_SENTINEL and (
+                not k in optional_fields or (optional_nullable and is_set)
+            ):
+                m[k] = val
+
+        return m

mollie/models/entity_permission.py

@@ -0,0 +1,61 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+
+from __future__ import annotations
+from .url import URL, URLTypedDict
+from mollie.types import BaseModel
+import pydantic
+from typing import Optional
+from typing_extensions import Annotated, NotRequired, TypedDict
+
+
+class EntityPermissionLinksTypedDict(TypedDict):
+    r"""An object with several relevant URLs. Every URL object will contain an `href` and a `type` field."""
+
+    self_: NotRequired[URLTypedDict]
+    r"""In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field."""
+    documentation: NotRequired[URLTypedDict]
+    r"""In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field."""
+
+
+class EntityPermissionLinks(BaseModel):
+    r"""An object with several relevant URLs. Every URL object will contain an `href` and a `type` field."""
+
+    self_: Annotated[Optional[URL], pydantic.Field(alias="self")] = None
+    r"""In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field."""
+
+    documentation: Optional[URL] = None
+    r"""In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field."""
+
+
+class EntityPermissionTypedDict(TypedDict):
+    resource: str
+    r"""Indicates the response contains a permission object. Will always contain the string `permission` for this
+    endpoint.
+    """
+    id: str
+    r"""The identifier uniquely referring to this permission. Example: `payments.read`."""
+    description: str
+    r"""A short description of what kind of access the permission enables."""
+    granted: bool
+    r"""Whether this permission is granted to the app by the organization."""
+    links: EntityPermissionLinksTypedDict
+    r"""An object with several relevant URLs. Every URL object will contain an `href` and a `type` field."""
+
+
+class EntityPermission(BaseModel):
+    resource: str
+    r"""Indicates the response contains a permission object. Will always contain the string `permission` for this
+    endpoint.
+    """
+
+    id: str
+    r"""The identifier uniquely referring to this permission. Example: `payments.read`."""
+
+    description: str
+    r"""A short description of what kind of access the permission enables."""
+
+    granted: bool
+    r"""Whether this permission is granted to the app by the organization."""
+
+    links: Annotated[EntityPermissionLinks, pydantic.Field(alias="_links")]
+    r"""An object with several relevant URLs. Every URL object will contain an `href` and a `type` field."""

mollie/models/entity_refund_response.py

@@ -0,0 +1,361 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+
+from __future__ import annotations
+from .amount import Amount, AmountTypedDict
+from .metadata import Metadata, MetadataTypedDict
+from .mode import Mode
+from .refund_external_reference_type_response import RefundExternalReferenceTypeResponse
+from .url import URL, URLTypedDict
+from .url_nullable import URLNullable, URLNullableTypedDict
+from enum import Enum
+from mollie import utils
+from mollie.types import BaseModel, Nullable, OptionalNullable, UNSET, UNSET_SENTINEL
+from mollie.utils import validate_open_enum
+import pydantic
+from pydantic import model_serializer
+from pydantic.functional_validators import PlainValidator
+from typing import List, Optional
+from typing_extensions import Annotated, NotRequired, TypedDict
+
+
+class EntityRefundResponseSettlementAmountTypedDict(TypedDict):
+    r"""This optional field will contain the approximate amount that will be deducted from your account balance, converted
+    to the currency your account is settled in.
+
+    The amount is a **negative** amount.
+
+    If the refund is not directly processed by Mollie, for example for PayPal refunds, the settlement amount will be
+    zero.
+
+    Since the field contains an estimated amount during refund processing, it may change over time. For example, while
+    the refund is queued the settlement amount is likely not yet available.
+
+    To retrieve accurate settlement amounts we recommend using the
+    [List balance transactions endpoint](list-balance-transactions) instead.
+    """
+
+    currency: str
+    r"""A three-character ISO 4217 currency code."""
+    value: str
+    r"""A string containing an exact monetary amount in the given currency."""
+
+
+class EntityRefundResponseSettlementAmount(BaseModel):
+    r"""This optional field will contain the approximate amount that will be deducted from your account balance, converted
+    to the currency your account is settled in.
+
+    The amount is a **negative** amount.
+
+    If the refund is not directly processed by Mollie, for example for PayPal refunds, the settlement amount will be
+    zero.
+
+    Since the field contains an estimated amount during refund processing, it may change over time. For example, while
+    the refund is queued the settlement amount is likely not yet available.
+
+    To retrieve accurate settlement amounts we recommend using the
+    [List balance transactions endpoint](list-balance-transactions) instead.
+    """
+
+    currency: str
+    r"""A three-character ISO 4217 currency code."""
+
+    value: str
+    r"""A string containing an exact monetary amount in the given currency."""
+
+
+class EntityRefundResponseStatus(str, Enum, metaclass=utils.OpenEnumMeta):
+    QUEUED = "queued"
+    PENDING = "pending"
+    PROCESSING = "processing"
+    REFUNDED = "refunded"
+    FAILED = "failed"
+    CANCELED = "canceled"
+
+
+class EntityRefundResponseExternalReferenceTypedDict(TypedDict):
+    type: NotRequired[RefundExternalReferenceTypeResponse]
+    r"""Specifies the reference type"""
+    id: NotRequired[str]
+    r"""Unique reference from the payment provider"""
+
+
+class EntityRefundResponseExternalReference(BaseModel):
+    type: Annotated[
+        Optional[RefundExternalReferenceTypeResponse],
+        PlainValidator(validate_open_enum(False)),
+    ] = None
+    r"""Specifies the reference type"""
+
+    id: Optional[str] = None
+    r"""Unique reference from the payment provider"""
+
+
+class EntityRefundResponseSourceTypedDict(TypedDict):
+    r"""Where the funds will be pulled back from."""
+
+    organization_id: NotRequired[str]
+
+
+class EntityRefundResponseSource(BaseModel):
+    r"""Where the funds will be pulled back from."""
+
+    organization_id: Annotated[
+        Optional[str], pydantic.Field(alias="organizationId")
+    ] = None
+
+
+class EntityRefundResponseRoutingReversalTypedDict(TypedDict):
+    amount: NotRequired[AmountTypedDict]
+    r"""In v2 endpoints, monetary amounts are represented as objects with a `currency` and `value` field."""
+    source: NotRequired[EntityRefundResponseSourceTypedDict]
+    r"""Where the funds will be pulled back from."""
+
+
+class EntityRefundResponseRoutingReversal(BaseModel):
+    amount: Optional[Amount] = None
+    r"""In v2 endpoints, monetary amounts are represented as objects with a `currency` and `value` field."""
+
+    source: Optional[EntityRefundResponseSource] = None
+    r"""Where the funds will be pulled back from."""
+
+
+class EntityRefundResponseLinksTypedDict(TypedDict):
+    r"""An object with several relevant URLs. Every URL object will contain an `href` and a `type` field."""
+
+    self_: URLTypedDict
+    r"""In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field."""
+    payment: URLTypedDict
+    r"""In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field."""
+    documentation: URLTypedDict
+    r"""In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field."""
+    settlement: NotRequired[Nullable[URLNullableTypedDict]]
+    r"""In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field."""
+
+
+class EntityRefundResponseLinks(BaseModel):
+    r"""An object with several relevant URLs. Every URL object will contain an `href` and a `type` field."""
+
+    self_: Annotated[URL, pydantic.Field(alias="self")]
+    r"""In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field."""
+
+    payment: URL
+    r"""In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field."""
+
+    documentation: URL
+    r"""In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field."""
+
+    settlement: OptionalNullable[URLNullable] = UNSET
+    r"""In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field."""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = ["settlement"]
+        nullable_fields = ["settlement"]
+        null_default_fields = []
+
+        serialized = handler(self)
+
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k)
+            serialized.pop(k, None)
+
+            optional_nullable = k in optional_fields and k in nullable_fields
+            is_set = (
+                self.__pydantic_fields_set__.intersection({n})
+                or k in null_default_fields
+            )  # pylint: disable=no-member
+
+            if val is not None and val != UNSET_SENTINEL:
+                m[k] = val
+            elif val != UNSET_SENTINEL and (
+                not k in optional_fields or (optional_nullable and is_set)
+            ):
+                m[k] = val
+
+        return m
+
+
+class EntityRefundResponseTypedDict(TypedDict):
+    resource: str
+    r"""Indicates the response contains a refund object. Will always contain the string `refund` for this endpoint."""
+    id: str
+    r"""The identifier uniquely referring to this refund. Mollie assigns this identifier at refund creation time. Mollie
+    will always refer to the refund by this ID. Example: `re_4qqhO89gsT`.
+    """
+    mode: Mode
+    r"""Whether this entity was created in live mode or in test mode."""
+    description: str
+    r"""The description of the refund that may be shown to your customer, depending on the payment method used."""
+    amount: AmountTypedDict
+    r"""In v2 endpoints, monetary amounts are represented as objects with a `currency` and `value` field."""
+    metadata: Nullable[MetadataTypedDict]
+    r"""Provide any data you like, for example a string or a JSON object. We will save the data alongside the entity. Whenever
+    you fetch the entity with our API, we will also include the metadata. You can use up to approximately 1kB.
+    """
+    status: EntityRefundResponseStatus
+    created_at: str
+    r"""The entity's date and time of creation, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format."""
+    links: EntityRefundResponseLinksTypedDict
+    r"""An object with several relevant URLs. Every URL object will contain an `href` and a `type` field."""
+    settlement_amount: NotRequired[
+        Nullable[EntityRefundResponseSettlementAmountTypedDict]
+    ]
+    r"""This optional field will contain the approximate amount that will be deducted from your account balance, converted
+    to the currency your account is settled in.
+
+    The amount is a **negative** amount.
+
+    If the refund is not directly processed by Mollie, for example for PayPal refunds, the settlement amount will be
+    zero.
+
+    Since the field contains an estimated amount during refund processing, it may change over time. For example, while
+    the refund is queued the settlement amount is likely not yet available.
+
+    To retrieve accurate settlement amounts we recommend using the
+    [List balance transactions endpoint](list-balance-transactions) instead.
+    """
+    payment_id: NotRequired[str]
+    r"""The unique identifier of the payment this refund was created for.
+    The full payment object can be retrieved via the payment URL in the `_links` object.
+    """
+    settlement_id: NotRequired[Nullable[str]]
+    r"""The identifier referring to the settlement this refund was settled with. This field is omitted if the refund is not settled (yet)."""
+    external_reference: NotRequired[EntityRefundResponseExternalReferenceTypedDict]
+    routing_reversals: NotRequired[
+        Nullable[List[EntityRefundResponseRoutingReversalTypedDict]]
+    ]
+    r"""*This feature is only available to marketplace operators.*
+
+    When creating refunds for *routed* payments, by default the full amount is deducted from your balance.
+
+    If you want to pull back funds from the connected merchant(s), you can use this parameter to specify what amount
+    needs to be reversed from which merchant(s).
+
+    If you simply want to fully reverse the routed funds, you can also use the `reverseRouting` parameter instead.
+    """
+
+
+class EntityRefundResponse(BaseModel):
+    resource: str
+    r"""Indicates the response contains a refund object. Will always contain the string `refund` for this endpoint."""
+
+    id: str
+    r"""The identifier uniquely referring to this refund. Mollie assigns this identifier at refund creation time. Mollie
+    will always refer to the refund by this ID. Example: `re_4qqhO89gsT`.
+    """
+
+    mode: Annotated[Mode, PlainValidator(validate_open_enum(False))]
+    r"""Whether this entity was created in live mode or in test mode."""
+
+    description: str
+    r"""The description of the refund that may be shown to your customer, depending on the payment method used."""
+
+    amount: Amount
+    r"""In v2 endpoints, monetary amounts are represented as objects with a `currency` and `value` field."""
+
+    metadata: Nullable[Metadata]
+    r"""Provide any data you like, for example a string or a JSON object. We will save the data alongside the entity. Whenever
+    you fetch the entity with our API, we will also include the metadata. You can use up to approximately 1kB.
+    """
+
+    status: Annotated[
+        EntityRefundResponseStatus, PlainValidator(validate_open_enum(False))
+    ]
+
+    created_at: Annotated[str, pydantic.Field(alias="createdAt")]
+    r"""The entity's date and time of creation, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format."""
+
+    links: Annotated[EntityRefundResponseLinks, pydantic.Field(alias="_links")]
+    r"""An object with several relevant URLs. Every URL object will contain an `href` and a `type` field."""
+
+    settlement_amount: Annotated[
+        OptionalNullable[EntityRefundResponseSettlementAmount],
+        pydantic.Field(alias="settlementAmount"),
+    ] = UNSET
+    r"""This optional field will contain the approximate amount that will be deducted from your account balance, converted
+    to the currency your account is settled in.
+
+    The amount is a **negative** amount.
+
+    If the refund is not directly processed by Mollie, for example for PayPal refunds, the settlement amount will be
+    zero.
+
+    Since the field contains an estimated amount during refund processing, it may change over time. For example, while
+    the refund is queued the settlement amount is likely not yet available.
+
+    To retrieve accurate settlement amounts we recommend using the
+    [List balance transactions endpoint](list-balance-transactions) instead.
+    """
+
+    payment_id: Annotated[Optional[str], pydantic.Field(alias="paymentId")] = None
+    r"""The unique identifier of the payment this refund was created for.
+    The full payment object can be retrieved via the payment URL in the `_links` object.
+    """
+
+    settlement_id: Annotated[
+        OptionalNullable[str], pydantic.Field(alias="settlementId")
+    ] = UNSET
+    r"""The identifier referring to the settlement this refund was settled with. This field is omitted if the refund is not settled (yet)."""
+
+    external_reference: Annotated[
+        Optional[EntityRefundResponseExternalReference],
+        pydantic.Field(alias="externalReference"),
+    ] = None
+
+    routing_reversals: Annotated[
+        OptionalNullable[List[EntityRefundResponseRoutingReversal]],
+        pydantic.Field(alias="routingReversals"),
+    ] = UNSET
+    r"""*This feature is only available to marketplace operators.*
+
+    When creating refunds for *routed* payments, by default the full amount is deducted from your balance.
+
+    If you want to pull back funds from the connected merchant(s), you can use this parameter to specify what amount
+    needs to be reversed from which merchant(s).
+
+    If you simply want to fully reverse the routed funds, you can also use the `reverseRouting` parameter instead.
+    """
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = [
+            "settlementAmount",
+            "paymentId",
+            "settlementId",
+            "externalReference",
+            "routingReversals",
+        ]
+        nullable_fields = [
+            "settlementAmount",
+            "metadata",
+            "settlementId",
+            "routingReversals",
+        ]
+        null_default_fields = []
+
+        serialized = handler(self)
+
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k)
+            serialized.pop(k, None)
+
+            optional_nullable = k in optional_fields and k in nullable_fields
+            is_set = (
+                self.__pydantic_fields_set__.intersection({n})
+                or k in null_default_fields
+            )  # pylint: disable=no-member
+
+            if val is not None and val != UNSET_SENTINEL:
+                m[k] = val
+            elif val != UNSET_SENTINEL and (
+                not k in optional_fields or (optional_nullable and is_set)
+            ):
+                m[k] = val
+
+        return m