gr4vy 1.10.17__py3-none-any.whl → 1.10.19__py3-none-any.whl

gr4vy/_version.py

@@ -3,10 +3,10 @@
 import importlib.metadata
 
 __title__: str = "gr4vy"
-__version__: str = "1.10.17"
+__version__: str = "1.10.19"
 __openapi_doc_version__: str = "1.0.0"
-__gen_version__: str = "2.798.0"
-__user_agent__: str = "speakeasy-sdk/python 1.10.17 2.798.0 1.0.0 gr4vy"
+__gen_version__: str = "2.801.2"
+__user_agent__: str = "speakeasy-sdk/python 1.10.19 2.801.2 1.0.0 gr4vy"
 
 try:
     if __package__ is not None:

gr4vy/all.py

@@ -15,6 +15,7 @@ class All(BaseSDK):
         *,
         transaction_id: str,
         merchant_account_id: Optional[str] = None,
+        idempotency_key: OptionalNullable[str] = UNSET,
         reason: OptionalNullable[str] = UNSET,
         external_identifier: OptionalNullable[str] = UNSET,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
@@ -28,6 +29,7 @@ class All(BaseSDK):
 
         :param transaction_id: The ID of the transaction
         :param merchant_account_id: The ID of the merchant account to use for this request.
+        :param idempotency_key: A unique key that identifies this request. Providing this header will make this an idempotent request. We recommend using V4 UUIDs, or another random string with enough entropy to avoid collisions.
         :param reason: An optional reason to attach extra context to the refund requests.
         :param external_identifier: An external identifier that can be used to match the refunds against your own records.
         :param retries: Override the default retry configuration for this method
@@ -48,6 +50,7 @@ class All(BaseSDK):
         request = models.CreateFullTransactionRefundRequest(
             transaction_id=transaction_id,
             merchant_account_id=merchant_account_id,
+            idempotency_key=idempotency_key,
             transaction_refund_all_create=models.TransactionRefundAllCreate(
                 reason=reason,
                 external_identifier=external_identifier,
@@ -174,6 +177,7 @@ class All(BaseSDK):
         *,
         transaction_id: str,
         merchant_account_id: Optional[str] = None,
+        idempotency_key: OptionalNullable[str] = UNSET,
         reason: OptionalNullable[str] = UNSET,
         external_identifier: OptionalNullable[str] = UNSET,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
@@ -187,6 +191,7 @@ class All(BaseSDK):
 
         :param transaction_id: The ID of the transaction
         :param merchant_account_id: The ID of the merchant account to use for this request.
+        :param idempotency_key: A unique key that identifies this request. Providing this header will make this an idempotent request. We recommend using V4 UUIDs, or another random string with enough entropy to avoid collisions.
         :param reason: An optional reason to attach extra context to the refund requests.
         :param external_identifier: An external identifier that can be used to match the refunds against your own records.
         :param retries: Override the default retry configuration for this method
@@ -207,6 +212,7 @@ class All(BaseSDK):
         request = models.CreateFullTransactionRefundRequest(
             transaction_id=transaction_id,
             merchant_account_id=merchant_account_id,
+            idempotency_key=idempotency_key,
             transaction_refund_all_create=models.TransactionRefundAllCreate(
                 reason=reason,
                 external_identifier=external_identifier,

gr4vy/models/create_full_transaction_refundop.py

@@ -53,6 +53,8 @@ class CreateFullTransactionRefundRequestTypedDict(TypedDict):
     r"""The ID of the transaction"""
     merchant_account_id: NotRequired[str]
     r"""The ID of the merchant account to use for this request."""
+    idempotency_key: NotRequired[Nullable[str]]
+    r"""A unique key that identifies this request. Providing this header will make this an idempotent request. We recommend using V4 UUIDs, or another random string with enough entropy to avoid collisions."""
     transaction_refund_all_create: NotRequired[
         Nullable[TransactionRefundAllCreateTypedDict]
     ]
@@ -71,6 +73,13 @@ class CreateFullTransactionRefundRequest(BaseModel):
     ] = None
     r"""The ID of the merchant account to use for this request."""
 
+    idempotency_key: Annotated[
+        OptionalNullable[str],
+        pydantic.Field(alias="idempotency-key"),
+        FieldMetadata(header=HeaderMetadata(style="simple", explode=False)),
+    ] = UNSET
+    r"""A unique key that identifies this request. Providing this header will make this an idempotent request. We recommend using V4 UUIDs, or another random string with enough entropy to avoid collisions."""
+
     transaction_refund_all_create: Annotated[
         OptionalNullable[TransactionRefundAllCreate],
         FieldMetadata(request=RequestMetadata(media_type="application/json")),
@@ -78,8 +87,10 @@ class CreateFullTransactionRefundRequest(BaseModel):
 
     @model_serializer(mode="wrap")
     def serialize_model(self, handler):
-        optional_fields = set(["merchant_account_id", "TransactionRefundAllCreate"])
-        nullable_fields = set(["TransactionRefundAllCreate"])
+        optional_fields = set(
+            ["merchant_account_id", "idempotency-key", "TransactionRefundAllCreate"]
+        )
+        nullable_fields = set(["idempotency-key", "TransactionRefundAllCreate"])
         serialized = handler(self)
         m = {}
 

gr4vy/models/create_transaction_refundop.py

@@ -5,7 +5,7 @@ from .transactionrefundcreate import (
     TransactionRefundCreate,
     TransactionRefundCreateTypedDict,
 )
-from gr4vy.types import BaseModel, UNSET_SENTINEL
+from gr4vy.types import BaseModel, Nullable, OptionalNullable, UNSET, UNSET_SENTINEL
 from gr4vy.utils import (
     FieldMetadata,
     HeaderMetadata,
@@ -54,6 +54,8 @@ class CreateTransactionRefundRequestTypedDict(TypedDict):
     transaction_refund_create: TransactionRefundCreateTypedDict
     merchant_account_id: NotRequired[str]
     r"""The ID of the merchant account to use for this request."""
+    idempotency_key: NotRequired[Nullable[str]]
+    r"""A unique key that identifies this request. Providing this header will make this an idempotent request. We recommend using V4 UUIDs, or another random string with enough entropy to avoid collisions."""
 
 
 class CreateTransactionRefundRequest(BaseModel):
@@ -74,18 +76,34 @@ class CreateTransactionRefundRequest(BaseModel):
     ] = None
     r"""The ID of the merchant account to use for this request."""
 
+    idempotency_key: Annotated[
+        OptionalNullable[str],
+        pydantic.Field(alias="idempotency-key"),
+        FieldMetadata(header=HeaderMetadata(style="simple", explode=False)),
+    ] = UNSET
+    r"""A unique key that identifies this request. Providing this header will make this an idempotent request. We recommend using V4 UUIDs, or another random string with enough entropy to avoid collisions."""
+
     @model_serializer(mode="wrap")
     def serialize_model(self, handler):
-        optional_fields = set(["merchant_account_id"])
+        optional_fields = set(["merchant_account_id", "idempotency-key"])
+        nullable_fields = set(["idempotency-key"])
         serialized = handler(self)
         m = {}
 
         for n, f in type(self).model_fields.items():
             k = f.alias or n
             val = serialized.get(k)
+            is_nullable_and_explicitly_set = (
+                k in nullable_fields
+                and (self.__pydantic_fields_set__.intersection({n}))  # pylint: disable=no-member
+            )
 
             if val != UNSET_SENTINEL:
-                if val is not None or k not in optional_fields:
+                if (
+                    val is not None
+                    or k not in optional_fields
+                    or is_nullable_and_explicitly_set
+                ):
                     m[k] = val
 
         return m

gr4vy/transactions_refunds.py

@@ -325,6 +325,7 @@ class TransactionsRefunds(BaseSDK):
         *,
         transaction_id: str,
         merchant_account_id: Optional[str] = None,
+        idempotency_key: OptionalNullable[str] = UNSET,
         amount: OptionalNullable[int] = UNSET,
         target_type: Optional[models.RefundTargetType] = None,
         target_id: OptionalNullable[str] = UNSET,
@@ -341,6 +342,7 @@ class TransactionsRefunds(BaseSDK):
 
         :param transaction_id: The ID of the transaction
         :param merchant_account_id: The ID of the merchant account to use for this request.
+        :param idempotency_key: A unique key that identifies this request. Providing this header will make this an idempotent request. We recommend using V4 UUIDs, or another random string with enough entropy to avoid collisions.
         :param amount: The amount to refund, in the smallest currency unit (e.g., cents). If omitted, a full refund will be requested.
         :param target_type:
         :param target_id: The optional ID of the instrument to refund for. This is only required when the `target_type` is set to `gift-card-redemption`.
@@ -364,6 +366,7 @@ class TransactionsRefunds(BaseSDK):
         request = models.CreateTransactionRefundRequest(
             transaction_id=transaction_id,
             merchant_account_id=merchant_account_id,
+            idempotency_key=idempotency_key,
             transaction_refund_create=models.TransactionRefundCreate(
                 amount=amount,
                 target_type=target_type,
@@ -493,6 +496,7 @@ class TransactionsRefunds(BaseSDK):
         *,
         transaction_id: str,
         merchant_account_id: Optional[str] = None,
+        idempotency_key: OptionalNullable[str] = UNSET,
         amount: OptionalNullable[int] = UNSET,
         target_type: Optional[models.RefundTargetType] = None,
         target_id: OptionalNullable[str] = UNSET,
@@ -509,6 +513,7 @@ class TransactionsRefunds(BaseSDK):
 
         :param transaction_id: The ID of the transaction
         :param merchant_account_id: The ID of the merchant account to use for this request.
+        :param idempotency_key: A unique key that identifies this request. Providing this header will make this an idempotent request. We recommend using V4 UUIDs, or another random string with enough entropy to avoid collisions.
         :param amount: The amount to refund, in the smallest currency unit (e.g., cents). If omitted, a full refund will be requested.
         :param target_type:
         :param target_id: The optional ID of the instrument to refund for. This is only required when the `target_type` is set to `gift-card-redemption`.
@@ -532,6 +537,7 @@ class TransactionsRefunds(BaseSDK):
         request = models.CreateTransactionRefundRequest(
             transaction_id=transaction_id,
             merchant_account_id=merchant_account_id,
+            idempotency_key=idempotency_key,
             transaction_refund_create=models.TransactionRefundCreate(
                 amount=amount,
                 target_type=target_type,

{gr4vy-1.10.17.dist-info → gr4vy-1.10.19.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gr4vy
-Version: 1.10.17
+Version: 1.10.19
 Summary: Python Client SDK Generated by Speakeasy.
 Author: Gr4vy
 Requires-Python: >=3.9.2

{gr4vy-1.10.17.dist-info → gr4vy-1.10.19.dist-info}/RECORD

@@ -2,10 +2,10 @@ gr4vy/__init__.py,sha256=w2u919V3Tzv4zEPQ-OYJ79gQ_4_SyW7GOFFoHtqXDFA,401
 gr4vy/_hooks/__init__.py,sha256=p5J13DeYuISQyQWirjJAObHIf2VtIlOtFqnIpvjjVwk,118
 gr4vy/_hooks/sdkhooks.py,sha256=3jKTs2B1lcAxBMJge9C-qL0RGbKGLcrHvikzi67Tbdo,2493
 gr4vy/_hooks/types.py,sha256=0O7dbbolkiFAnHkNULvwoLsiXJu0_Wmhev163bvZbW8,3039
-gr4vy/_version.py,sha256=qEbwtZxJnbjx-HjQM0A5lpnWoicUNw0Dp7h2vZUczXk,456
+gr4vy/_version.py,sha256=64fvW1Wezpen5wHMr90NZkcb33Dg4s4uHQs-XgsiGdc,456
 gr4vy/account_updater.py,sha256=mmTd25Oap80PBqQ3p4MvZ_buT5VS0zWc8s8cqfI7iyA,607
 gr4vy/actions.py,sha256=M0SgxWTiduh6x8zvOzO7wghlPz58jSJDJ1EjlvgjNXc,14008
-gr4vy/all.py,sha256=dSRtcZcQ7gc9MYmgUFdExz077A5UjbLns7Zg48BQPtg,15248
+gr4vy/all.py,sha256=D1JZzBF24nXZqVtjDTMCRvMbq-S7JSQK0TYw6yiJc00,15910
 gr4vy/audit_logs.py,sha256=xbdj2X5OfgDu8SE5yk8aRlJcNlU-k7AZRFTQMGJGGVM,17159
 gr4vy/auth.py,sha256=gxS5MjLUA0r1mSZADniCIQV4khqAn7FMvrTh-9Czm1g,8714
 gr4vy/balances.py,sha256=OlFgk2Zj7r8hOMkVsY01hO_AutfpbIOYUHylSQhRKF4,14472
@@ -108,7 +108,7 @@ gr4vy/models/configure_digital_walletop.py,sha256=99-HWU0tTWSORRj7Wv8RZXVE6HNDU8
 gr4vy/models/create_account_updater_jobop.py,sha256=f-LsXDXbmAGmbwU_cuGj4FIqsPf_N8FYZCDxZcRGU1U,2608
 gr4vy/models/create_apple_pay_digital_wallet_sessionop.py,sha256=s6nUOuFgcPWqwaFl7_G4hVM_tQCcAFJor4uTVyCuVZQ,2645
 gr4vy/models/create_checkout_sessionop.py,sha256=2_Im7XYVKKGsiH1LBc2MJpUv1ZmYBGmDuy_N5-ne39s,2626
-gr4vy/models/create_full_transaction_refundop.py,sha256=zkM_doGRADWQjZmZ78eEfaDu1vMlaeZEazMbIoFJgRo,3403
+gr4vy/models/create_full_transaction_refundop.py,sha256=ZpvyRyNX8Es6tH25p4GBntapNwPLAa4kuuvCaTTzt0k,4133
 gr4vy/models/create_gift_cardop.py,sha256=b3TrBsc4TURRfG8tlEPfpvIEGHuZBWCe_kJKu6Jnxo8,2494
 gr4vy/models/create_google_pay_digital_wallet_sessionop.py,sha256=DMq6vZh-w4QKKe8R9gJuXTxC5yZuR6AnsMb_ISY3UB4,2656
 gr4vy/models/create_payment_method_network_token_cryptogramop.py,sha256=LUaK8j5JteWJCBLaGaOPamCXIyFbAqXX3Hd3zA_OZBE,3110
@@ -121,7 +121,7 @@ gr4vy/models/create_payment_serviceop.py,sha256=Eo3lO6Ill-_lI9X2uxTOwB6n88G99t3R
 gr4vy/models/create_payoutop.py,sha256=pB5jABm11pB7xp9LUbTJbNioTVfJUGRTT9NL2D9-Y7g,2470
 gr4vy/models/create_report_execution_urlop.py,sha256=WuXjUREAw6CTuS1OkCshvkRa4wBuXxBVqtXZfUniGdo,3271
 gr4vy/models/create_three_ds_scenarioop.py,sha256=CiBksCgTg79ypQ1pSzk0OgF1Q5NsZ-CrnsOpf4oc3O8,2623
-gr4vy/models/create_transaction_refundop.py,sha256=k7Pf6Bc115rGS1IY1FIqBWVekt7y6UxaLGTVTCz6jRg,2864
+gr4vy/models/create_transaction_refundop.py,sha256=33iB4DhMo9jK93zJvtuduBGZIBdljOYKenMjhTMxPvI,3949
 gr4vy/models/create_transactionop.py,sha256=ZQnhJwdB4qhEtPCKvzyWJxWG5fe-DsAnXImQUx5Pe4Q,4314
 gr4vy/models/createsession.py,sha256=k680YHp6sJ3AwBsFN_SACZXYOnmxd1gnP8YDDRK93X8,2773
 gr4vy/models/createsessionstatus.py,sha256=8RrlFPRhsWBPCUjVhOpz-x-DIzEq7LVjavaK3_XIAJM,295
@@ -438,7 +438,7 @@ gr4vy/sdkconfiguration.py,sha256=aBQ8gY9aOjf1TL0kSLat8hEIoH4lCE9_PhihyhBpRE4,198
 gr4vy/sessions.py,sha256=AA32Wu6OmJbJ7GdypptwmK31SbZH4VLLuo3gnzD4nJE,41837
 gr4vy/three_ds_scenarios.py,sha256=FJsCE7T8jyPspn7VXCDfJPXzfTYGkXgbrVTT-zNzK0Y,59670
 gr4vy/transactions.py,sha256=BllzoYY8qTVSZ0T-WlEN6R-i5ocDFSUJlajVhhE4MB0,170925
-gr4vy/transactions_refunds.py,sha256=mAzll7rTt7VV0n7wHlAfK5KY81JhWJ1333KjXXGOdFo,43819
+gr4vy/transactions_refunds.py,sha256=NGbQsGD8TGc-HT8INOCapLZumJs3OF32qBsH8fyPhT8,44481
 gr4vy/transactions_settlements.py,sha256=oxVGRIMmcwKhZWN0KWW1Wm3831m5y55SU17LMRaKmEM,27902
 gr4vy/types/__init__.py,sha256=RArOwSgeeTIva6h-4ttjXwMUeCkz10nAFBL9D-QljI4,377
 gr4vy/types/basemodel.py,sha256=MULDVywSVxR0lo8h5wMnXnkBFXLK5DXmBKD1eXAVKgE,2879
@@ -460,6 +460,6 @@ gr4vy/utils/unmarshal_json_response.py,sha256=G4h8gLOK09kjhPiUZjgIMm6zntcbxpvb_m
 gr4vy/utils/url.py,sha256=BgGPgcTA6MRK4bF8fjP2dUopN3NzEzxWMXPBVg8NQUA,5254
 gr4vy/utils/values.py,sha256=CcaCXEa3xHhkUDROyXZocN8f0bdITftv9Y0P9lTf0YM,3517
 gr4vy/webhooks.py,sha256=2L-ZhdK-XU2X0AkVqgZvhfRqDCKUVs7R4UNCmZJR78w,1359
-gr4vy-1.10.17.dist-info/METADATA,sha256=l-OWwzr1WOcbQ0jNDuck0KhUicxf02YlZuJbulj-3k8,44924
-gr4vy-1.10.17.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
-gr4vy-1.10.17.dist-info/RECORD,,
+gr4vy-1.10.19.dist-info/METADATA,sha256=NNawii6MER5b7WKWW_Rxbh81ywi5V0AFQjf9sY-WHmc,44924
+gr4vy-1.10.19.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+gr4vy-1.10.19.dist-info/RECORD,,