gr4vy 1.1.29__py3-none-any.whl → 1.10.9__py3-none-any.whl

gr4vy/transactions.py

@@ -5,6 +5,7 @@ from .sdkconfiguration import SDKConfiguration
 from datetime import datetime
 from gr4vy import errors, models, utils
 from gr4vy._hooks import HookContext
+from gr4vy.actions import Actions
 from gr4vy.events import Events
 from gr4vy.transactions_refunds import TransactionsRefunds
 from gr4vy.transactions_settlements import TransactionsSettlements
@@ -17,18 +18,26 @@ from typing import Any, Dict, List, Mapping, Optional, Union
 
 class Transactions(BaseSDK):
     refunds: TransactionsRefunds
+    actions: Actions
     events: Events
     settlements: TransactionsSettlements
 
-    def __init__(self, sdk_config: SDKConfiguration) -> None:
-        BaseSDK.__init__(self, sdk_config)
+    def __init__(
+        self, sdk_config: SDKConfiguration, parent_ref: Optional[object] = None
+    ) -> None:
+        BaseSDK.__init__(self, sdk_config, parent_ref=parent_ref)
         self.sdk_configuration = sdk_config
         self._init_sdks()
 
     def _init_sdks(self):
-        self.refunds = TransactionsRefunds(self.sdk_configuration)
-        self.events = Events(self.sdk_configuration)
-        self.settlements = TransactionsSettlements(self.sdk_configuration)
+        self.refunds = TransactionsRefunds(
+            self.sdk_configuration, parent_ref=self.parent_ref
+        )
+        self.actions = Actions(self.sdk_configuration, parent_ref=self.parent_ref)
+        self.events = Events(self.sdk_configuration, parent_ref=self.parent_ref)
+        self.settlements = TransactionsSettlements(
+            self.sdk_configuration, parent_ref=self.parent_ref
+        )
 
     def list(
         self,
@@ -75,6 +84,7 @@ class Transactions(BaseSDK):
         is_subsequent_payment: OptionalNullable[bool] = UNSET,
         merchant_initiated: OptionalNullable[bool] = UNSET,
         used_3ds: OptionalNullable[bool] = UNSET,
+        disputed: OptionalNullable[bool] = UNSET,
         buyer_search: OptionalNullable[List[str]] = UNSET,
         merchant_account_id: Optional[str] = None,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
@@ -128,6 +138,7 @@ class Transactions(BaseSDK):
         :param is_subsequent_payment: Filters for transactions where the `is_subsequent_payment` matches the provided value.
         :param merchant_initiated: Filters for transactions where the `merchant_initiated` matches the provided value.
         :param used_3ds: Filters for transactions that attempted 3DS authentication or not.
+        :param disputed: Filters for transactions that have been disputed.
         :param buyer_search: Filters the results to only get the items for which some of the buyer data contains exactly the provided `buyer_search` values.
         :param merchant_account_id: The ID of the merchant account to use for this request.
         :param retries: Override the default retry configuration for this method
@@ -188,6 +199,7 @@ class Transactions(BaseSDK):
             is_subsequent_payment=is_subsequent_payment,
             merchant_initiated=merchant_initiated,
             used_3ds=used_3ds,
+            disputed=disputed,
             buyer_search=buyer_search,
             merchant_account_id=merchant_account_id,
         )
@@ -208,6 +220,7 @@ class Transactions(BaseSDK):
                 merchant_account_id=self.sdk_configuration.globals.merchant_account_id,
             ),
             security=self.sdk_configuration.security,
+            allow_empty_value=None,
             timeout_ms=timeout_ms,
         )
 
@@ -228,7 +241,7 @@ class Transactions(BaseSDK):
                 config=self.sdk_configuration,
                 base_url=base_url or "",
                 operation_id="list_transactions",
-                oauth2_scopes=[],
+                oauth2_scopes=None,
                 security_source=get_security_from_env(
                     self.sdk_configuration.security, models.Security
                 ),
@@ -261,7 +274,7 @@ class Transactions(BaseSDK):
                 return None
 
             next_cursor = next_cursor[0]
-            if next_cursor is None:
+            if next_cursor is None or str(next_cursor).strip() == "":
                 return None
 
             return self.list(
@@ -307,6 +320,7 @@ class Transactions(BaseSDK):
                 is_subsequent_payment=is_subsequent_payment,
                 merchant_initiated=merchant_initiated,
                 used_3ds=used_3ds,
+                disputed=disputed,
                 buyer_search=buyer_search,
                 merchant_account_id=merchant_account_id,
                 retries=retries,
@@ -410,6 +424,7 @@ class Transactions(BaseSDK):
         is_subsequent_payment: OptionalNullable[bool] = UNSET,
         merchant_initiated: OptionalNullable[bool] = UNSET,
         used_3ds: OptionalNullable[bool] = UNSET,
+        disputed: OptionalNullable[bool] = UNSET,
         buyer_search: OptionalNullable[List[str]] = UNSET,
         merchant_account_id: Optional[str] = None,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
@@ -463,6 +478,7 @@ class Transactions(BaseSDK):
         :param is_subsequent_payment: Filters for transactions where the `is_subsequent_payment` matches the provided value.
         :param merchant_initiated: Filters for transactions where the `merchant_initiated` matches the provided value.
         :param used_3ds: Filters for transactions that attempted 3DS authentication or not.
+        :param disputed: Filters for transactions that have been disputed.
         :param buyer_search: Filters the results to only get the items for which some of the buyer data contains exactly the provided `buyer_search` values.
         :param merchant_account_id: The ID of the merchant account to use for this request.
         :param retries: Override the default retry configuration for this method
@@ -523,6 +539,7 @@ class Transactions(BaseSDK):
             is_subsequent_payment=is_subsequent_payment,
             merchant_initiated=merchant_initiated,
             used_3ds=used_3ds,
+            disputed=disputed,
             buyer_search=buyer_search,
             merchant_account_id=merchant_account_id,
         )
@@ -543,6 +560,7 @@ class Transactions(BaseSDK):
                 merchant_account_id=self.sdk_configuration.globals.merchant_account_id,
             ),
             security=self.sdk_configuration.security,
+            allow_empty_value=None,
             timeout_ms=timeout_ms,
         )
 
@@ -563,7 +581,7 @@ class Transactions(BaseSDK):
                 config=self.sdk_configuration,
                 base_url=base_url or "",
                 operation_id="list_transactions",
-                oauth2_scopes=[],
+                oauth2_scopes=None,
                 security_source=get_security_from_env(
                     self.sdk_configuration.security, models.Security
                 ),
@@ -596,7 +614,7 @@ class Transactions(BaseSDK):
                 return None
 
             next_cursor = next_cursor[0]
-            if next_cursor is None:
+            if next_cursor is None or str(next_cursor).strip() == "":
                 return None
 
             return self.list(
@@ -642,6 +660,7 @@ class Transactions(BaseSDK):
                 is_subsequent_payment=is_subsequent_payment,
                 merchant_initiated=merchant_initiated,
                 used_3ds=used_3ds,
+                disputed=disputed,
                 buyer_search=buyer_search,
                 merchant_account_id=merchant_account_id,
                 retries=retries,
@@ -716,7 +735,7 @@ class Transactions(BaseSDK):
             ]
         ] = UNSET,
         buyer: OptionalNullable[
-            Union[models.GuestBuyerInput, models.GuestBuyerInputTypedDict]
+            Union[models.GuestBuyer, models.GuestBuyerTypedDict]
         ] = UNSET,
         buyer_id: OptionalNullable[str] = UNSET,
         buyer_external_identifier: OptionalNullable[str] = UNSET,
@@ -762,6 +781,15 @@ class Transactions(BaseSDK):
             Union[models.Recipient, models.RecipientTypedDict]
         ] = UNSET,
         installment_count: OptionalNullable[int] = UNSET,
+        tax_amount: OptionalNullable[int] = UNSET,
+        merchant_tax_id: OptionalNullable[str] = UNSET,
+        purchase_order_number: OptionalNullable[str] = UNSET,
+        customer_reference_number: OptionalNullable[str] = UNSET,
+        amount_includes_tax: OptionalNullable[bool] = UNSET,
+        supplier_order_number: OptionalNullable[str] = UNSET,
+        duty_amount: OptionalNullable[int] = UNSET,
+        shipping_amount: OptionalNullable[int] = UNSET,
+        integration_client: OptionalNullable[models.IntegrationClient] = UNSET,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
@@ -775,7 +803,9 @@ class Transactions(BaseSDK):
         :param currency: A supported ISO 4217 currency code. For redirect requests, this value must match the one specified for `currency` in `payment_method`.
         :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 x_forwarded_for: The IP address to forward from the customer. Use this when calling our API from the server side to ensure the customer's address is passed to downstream services, rather than your server IP.
+        :param x_forwarded_for: The IP address to forward from the customer. Use this when calling
+            our API from the server side to ensure the customer's address is
+            passed to downstream services, rather than your server IP.
         :param country: The 2-letter ISO code of the country where the transaction is processed. This is also used to filter the payment services that can process the transaction. If this value is provided for redirect requests and it's not `null`, it must match the one specified for `country` in `payment_method`. Otherwise, the value specified for `country` in `payment_method` will be assumed implicitly.
         :param payment_method: The optional payment method to use for this transaction. This field is required if no `gift_cards` have been added.
         :param buyer: Guest buyer details provided inline rather than creating a buyer resource beforehand and using the `buyer_id` or `buyer_external_identifier` keys. No buyer resource will be created on Gr4vy when used.
@@ -784,10 +814,23 @@ class Transactions(BaseSDK):
         :param gift_cards: The optional gift card(s) to use for this transaction. At least one gift card is required if no other `payment_method` has been added. By default, only a maximum limit of 10 gift cards may be used in a single transaction. Please contact our team to change this limit.
         :param external_identifier: An external identifier that can be used to match the transaction against your own records.
         :param intent:
-        :param store: Whether or not to also try and store the payment method with us so that it can be used again for future use. This is only supported for payment methods that support this feature. There are also a few restrictions on how the flag may be set:  * The flag has to be set to `true` when the `payment_source` is set to `recurring` or `installment`, and `merchant_initiated` is set to `false`. * The flag has to be set to `false` (or not set) when using a previously vaulted payment method.
+        :param store: Whether or not to also try and store the payment method with us so that it can be used again for future use. This is only supported for payment methods that support this feature. There are also a few restrictions on how the flag may be set:
+
+            * The flag has to be set to `true` when the `payment_source` is set to `recurring` or `installment`, and `merchant_initiated` is set to `false`.
+            * The flag has to be set to `false` (or not set) when using a previously vaulted payment method.
         :param three_d_secure_data: Pass through 3-D Secure data to support external 3-D Secure authorisation. If using an external 3-D Secure provider, you should not pass a `redirect_url` in the `payment_method` object for a transaction.
         :param metadata: Any additional information about the transaction that you would like to store as key-value pairs. This data is passed to payment service providers that support it.
-        :param is_subsequent_payment: Indicates whether the transaction represents a subsequent payment coming from a setup recurring payment. Please note there are some restrictions on how this flag may be used.  The flag can only be `false` (or not set) when the transaction meets one of the following criteria:  * It is not `merchant_initiated`. * `payment_source` is set to `card_on_file`.  The flag can only be set to `true` when the transaction meets one of the following criteria: * It is not `merchant_initiated`. * `payment_source` is set to `recurring` or `installment` and `merchant_initiated` is set to `true`. * `payment_source` is set to `card_on_file`.
+        :param is_subsequent_payment: Indicates whether the transaction represents a subsequent payment coming from a setup recurring payment. Please note there are some restrictions on how this flag may be used.
+
+            The flag can only be `false` (or not set) when the transaction meets one of the following criteria:
+
+            * It is not `merchant_initiated`.
+            * `payment_source` is set to `card_on_file`.
+
+            The flag can only be set to `true` when the transaction meets one of the following criteria:
+            * It is not `merchant_initiated`.
+            * `payment_source` is set to `recurring` or `installment` and `merchant_initiated` is set to `true`.
+            * `payment_source` is set to `card_on_file`.
         :param merchant_initiated: Indicates whether the transaction was initiated by the merchant (true) or customer (false).
         :param payment_source: The way payment method information made it to this transaction.
         :param airline: The airline addendum data which describes the airline booking associated with this transaction.
@@ -797,13 +840,27 @@ class Transactions(BaseSDK):
         :param browser_info: Information about the browser used by the buyer. This can be used by anti-fraud services.
         :param shipping_details_id: The unique identifier of a set of shipping details stored for the buyer. If provided, the created transaction will include a copy of the details at the point of transaction creation; i.e. it will not be affected by later changes to the detail in the database.
         :param connection_options: Allows for passing optional configuration per connection to take advantage of connection specific features. When provided, the data is only passed to the target connection type to prevent sharing configuration across connections. Please note that each of the keys this object are in kebab-case, for example `cybersource-anti-fraud` as they represent the ID of the connector. All the other keys will be snake case, for example `merchant_defined_data` or camel case to match an external API that the connector uses.
-        :param async_capture: Whether to capture the transaction asynchronously.  - When `async_capture` is `false` (default), the transaction is captured in the same request. - When `async_capture` is `true`, the transaction is automatically captured at a later time.  Redirect transactions are not affected by this flag. This flag can only be set to `true` when `intent` is set to `capture`.
+        :param async_capture: Whether to capture the transaction asynchronously.
+
+            - When `async_capture` is `false` (default), the transaction is captured in the same request.
+            - When `async_capture` is `true`, the transaction is automatically captured at a later time.
+
+            Redirect transactions are not affected by this flag. This flag can only be set to `true` when `intent` is set to `capture`.
         :param anti_fraud_fingerprint: This field represents the fingerprint data to be passed to the active anti-fraud service.
         :param payment_service_id: The unique identifier of an existing payment service. When provided, the created transaction will be processed by the given payment service and any routing rules will be skipped.
         :param account_funding_transaction: Marks the transaction as an AFT. Requires the payment service to support this feature, and might `recipient` and `buyer` data
         :param allow_partial_authorization: Defines if the transaction will allow for a partial authorization.
         :param recipient: The recipient of any account to account funding. For use with AFTs.
         :param installment_count: The number of installments a buyer is required to make.
+        :param tax_amount: The sales tax amount for this transaction, represented as a monetary amount in the smallest currency unit for the given currency, for example `1299` cents to create an authorization for `$12.99`
+        :param merchant_tax_id: Merchant tax ID (for example, EIN or VAT number).
+        :param purchase_order_number: Invoice number or Purchase Order number.
+        :param customer_reference_number: Customer code or reference.
+        :param amount_includes_tax: Whether the tax is included in the amount.
+        :param supplier_order_number: The merchant's unique identifier for the sales order or invoice.
+        :param duty_amount: Total charges for import/export duties.
+        :param shipping_amount: Total shipping amount.
+        :param integration_client: Defines the client where the session for this transaction is going to be used. Please refer to the connections documentation for more guidance.
         :param retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method
         :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
@@ -832,7 +889,7 @@ class Transactions(BaseSDK):
                     OptionalNullable[models.TransactionCreatePaymentMethod],
                 ),
                 buyer=utils.get_pydantic_model(
-                    buyer, OptionalNullable[models.GuestBuyerInput]
+                    buyer, OptionalNullable[models.GuestBuyer]
                 ),
                 buyer_id=buyer_id,
                 buyer_external_identifier=buyer_external_identifier,
@@ -876,6 +933,15 @@ class Transactions(BaseSDK):
                     recipient, OptionalNullable[models.Recipient]
                 ),
                 installment_count=installment_count,
+                tax_amount=tax_amount,
+                merchant_tax_id=merchant_tax_id,
+                purchase_order_number=purchase_order_number,
+                customer_reference_number=customer_reference_number,
+                amount_includes_tax=amount_includes_tax,
+                supplier_order_number=supplier_order_number,
+                duty_amount=duty_amount,
+                shipping_amount=shipping_amount,
+                integration_client=integration_client,
             ),
         )
 
@@ -902,6 +968,7 @@ class Transactions(BaseSDK):
                 "json",
                 models.TransactionCreate,
             ),
+            allow_empty_value=None,
             timeout_ms=timeout_ms,
         )
 
@@ -918,7 +985,7 @@ class Transactions(BaseSDK):
                 config=self.sdk_configuration,
                 base_url=base_url or "",
                 operation_id="create_transaction",
-                oauth2_scopes=[],
+                oauth2_scopes=None,
                 security_source=get_security_from_env(
                     self.sdk_configuration.security, models.Security
                 ),
@@ -1009,7 +1076,7 @@ class Transactions(BaseSDK):
             ]
         ] = UNSET,
         buyer: OptionalNullable[
-            Union[models.GuestBuyerInput, models.GuestBuyerInputTypedDict]
+            Union[models.GuestBuyer, models.GuestBuyerTypedDict]
         ] = UNSET,
         buyer_id: OptionalNullable[str] = UNSET,
         buyer_external_identifier: OptionalNullable[str] = UNSET,
@@ -1055,6 +1122,15 @@ class Transactions(BaseSDK):
             Union[models.Recipient, models.RecipientTypedDict]
         ] = UNSET,
         installment_count: OptionalNullable[int] = UNSET,
+        tax_amount: OptionalNullable[int] = UNSET,
+        merchant_tax_id: OptionalNullable[str] = UNSET,
+        purchase_order_number: OptionalNullable[str] = UNSET,
+        customer_reference_number: OptionalNullable[str] = UNSET,
+        amount_includes_tax: OptionalNullable[bool] = UNSET,
+        supplier_order_number: OptionalNullable[str] = UNSET,
+        duty_amount: OptionalNullable[int] = UNSET,
+        shipping_amount: OptionalNullable[int] = UNSET,
+        integration_client: OptionalNullable[models.IntegrationClient] = UNSET,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
@@ -1068,7 +1144,9 @@ class Transactions(BaseSDK):
         :param currency: A supported ISO 4217 currency code. For redirect requests, this value must match the one specified for `currency` in `payment_method`.
         :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 x_forwarded_for: The IP address to forward from the customer. Use this when calling our API from the server side to ensure the customer's address is passed to downstream services, rather than your server IP.
+        :param x_forwarded_for: The IP address to forward from the customer. Use this when calling
+            our API from the server side to ensure the customer's address is
+            passed to downstream services, rather than your server IP.
         :param country: The 2-letter ISO code of the country where the transaction is processed. This is also used to filter the payment services that can process the transaction. If this value is provided for redirect requests and it's not `null`, it must match the one specified for `country` in `payment_method`. Otherwise, the value specified for `country` in `payment_method` will be assumed implicitly.
         :param payment_method: The optional payment method to use for this transaction. This field is required if no `gift_cards` have been added.
         :param buyer: Guest buyer details provided inline rather than creating a buyer resource beforehand and using the `buyer_id` or `buyer_external_identifier` keys. No buyer resource will be created on Gr4vy when used.
@@ -1077,10 +1155,23 @@ class Transactions(BaseSDK):
         :param gift_cards: The optional gift card(s) to use for this transaction. At least one gift card is required if no other `payment_method` has been added. By default, only a maximum limit of 10 gift cards may be used in a single transaction. Please contact our team to change this limit.
         :param external_identifier: An external identifier that can be used to match the transaction against your own records.
         :param intent:
-        :param store: Whether or not to also try and store the payment method with us so that it can be used again for future use. This is only supported for payment methods that support this feature. There are also a few restrictions on how the flag may be set:  * The flag has to be set to `true` when the `payment_source` is set to `recurring` or `installment`, and `merchant_initiated` is set to `false`. * The flag has to be set to `false` (or not set) when using a previously vaulted payment method.
+        :param store: Whether or not to also try and store the payment method with us so that it can be used again for future use. This is only supported for payment methods that support this feature. There are also a few restrictions on how the flag may be set:
+
+            * The flag has to be set to `true` when the `payment_source` is set to `recurring` or `installment`, and `merchant_initiated` is set to `false`.
+            * The flag has to be set to `false` (or not set) when using a previously vaulted payment method.
         :param three_d_secure_data: Pass through 3-D Secure data to support external 3-D Secure authorisation. If using an external 3-D Secure provider, you should not pass a `redirect_url` in the `payment_method` object for a transaction.
         :param metadata: Any additional information about the transaction that you would like to store as key-value pairs. This data is passed to payment service providers that support it.
-        :param is_subsequent_payment: Indicates whether the transaction represents a subsequent payment coming from a setup recurring payment. Please note there are some restrictions on how this flag may be used.  The flag can only be `false` (or not set) when the transaction meets one of the following criteria:  * It is not `merchant_initiated`. * `payment_source` is set to `card_on_file`.  The flag can only be set to `true` when the transaction meets one of the following criteria: * It is not `merchant_initiated`. * `payment_source` is set to `recurring` or `installment` and `merchant_initiated` is set to `true`. * `payment_source` is set to `card_on_file`.
+        :param is_subsequent_payment: Indicates whether the transaction represents a subsequent payment coming from a setup recurring payment. Please note there are some restrictions on how this flag may be used.
+
+            The flag can only be `false` (or not set) when the transaction meets one of the following criteria:
+
+            * It is not `merchant_initiated`.
+            * `payment_source` is set to `card_on_file`.
+
+            The flag can only be set to `true` when the transaction meets one of the following criteria:
+            * It is not `merchant_initiated`.
+            * `payment_source` is set to `recurring` or `installment` and `merchant_initiated` is set to `true`.
+            * `payment_source` is set to `card_on_file`.
         :param merchant_initiated: Indicates whether the transaction was initiated by the merchant (true) or customer (false).
         :param payment_source: The way payment method information made it to this transaction.
         :param airline: The airline addendum data which describes the airline booking associated with this transaction.
@@ -1090,13 +1181,27 @@ class Transactions(BaseSDK):
         :param browser_info: Information about the browser used by the buyer. This can be used by anti-fraud services.
         :param shipping_details_id: The unique identifier of a set of shipping details stored for the buyer. If provided, the created transaction will include a copy of the details at the point of transaction creation; i.e. it will not be affected by later changes to the detail in the database.
         :param connection_options: Allows for passing optional configuration per connection to take advantage of connection specific features. When provided, the data is only passed to the target connection type to prevent sharing configuration across connections. Please note that each of the keys this object are in kebab-case, for example `cybersource-anti-fraud` as they represent the ID of the connector. All the other keys will be snake case, for example `merchant_defined_data` or camel case to match an external API that the connector uses.
-        :param async_capture: Whether to capture the transaction asynchronously.  - When `async_capture` is `false` (default), the transaction is captured in the same request. - When `async_capture` is `true`, the transaction is automatically captured at a later time.  Redirect transactions are not affected by this flag. This flag can only be set to `true` when `intent` is set to `capture`.
+        :param async_capture: Whether to capture the transaction asynchronously.
+
+            - When `async_capture` is `false` (default), the transaction is captured in the same request.
+            - When `async_capture` is `true`, the transaction is automatically captured at a later time.
+
+            Redirect transactions are not affected by this flag. This flag can only be set to `true` when `intent` is set to `capture`.
         :param anti_fraud_fingerprint: This field represents the fingerprint data to be passed to the active anti-fraud service.
         :param payment_service_id: The unique identifier of an existing payment service. When provided, the created transaction will be processed by the given payment service and any routing rules will be skipped.
         :param account_funding_transaction: Marks the transaction as an AFT. Requires the payment service to support this feature, and might `recipient` and `buyer` data
         :param allow_partial_authorization: Defines if the transaction will allow for a partial authorization.
         :param recipient: The recipient of any account to account funding. For use with AFTs.
         :param installment_count: The number of installments a buyer is required to make.
+        :param tax_amount: The sales tax amount for this transaction, represented as a monetary amount in the smallest currency unit for the given currency, for example `1299` cents to create an authorization for `$12.99`
+        :param merchant_tax_id: Merchant tax ID (for example, EIN or VAT number).
+        :param purchase_order_number: Invoice number or Purchase Order number.
+        :param customer_reference_number: Customer code or reference.
+        :param amount_includes_tax: Whether the tax is included in the amount.
+        :param supplier_order_number: The merchant's unique identifier for the sales order or invoice.
+        :param duty_amount: Total charges for import/export duties.
+        :param shipping_amount: Total shipping amount.
+        :param integration_client: Defines the client where the session for this transaction is going to be used. Please refer to the connections documentation for more guidance.
         :param retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method
         :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
@@ -1125,7 +1230,7 @@ class Transactions(BaseSDK):
                     OptionalNullable[models.TransactionCreatePaymentMethod],
                 ),
                 buyer=utils.get_pydantic_model(
-                    buyer, OptionalNullable[models.GuestBuyerInput]
+                    buyer, OptionalNullable[models.GuestBuyer]
                 ),
                 buyer_id=buyer_id,
                 buyer_external_identifier=buyer_external_identifier,
@@ -1169,6 +1274,15 @@ class Transactions(BaseSDK):
                     recipient, OptionalNullable[models.Recipient]
                 ),
                 installment_count=installment_count,
+                tax_amount=tax_amount,
+                merchant_tax_id=merchant_tax_id,
+                purchase_order_number=purchase_order_number,
+                customer_reference_number=customer_reference_number,
+                amount_includes_tax=amount_includes_tax,
+                supplier_order_number=supplier_order_number,
+                duty_amount=duty_amount,
+                shipping_amount=shipping_amount,
+                integration_client=integration_client,
             ),
         )
 
@@ -1195,6 +1309,7 @@ class Transactions(BaseSDK):
                 "json",
                 models.TransactionCreate,
             ),
+            allow_empty_value=None,
             timeout_ms=timeout_ms,
         )
 
@@ -1211,7 +1326,7 @@ class Transactions(BaseSDK):
                 config=self.sdk_configuration,
                 base_url=base_url or "",
                 operation_id="create_transaction",
-                oauth2_scopes=[],
+                oauth2_scopes=None,
                 security_source=get_security_from_env(
                     self.sdk_configuration.security, models.Security
                 ),
@@ -1338,6 +1453,7 @@ class Transactions(BaseSDK):
                 merchant_account_id=self.sdk_configuration.globals.merchant_account_id,
             ),
             security=self.sdk_configuration.security,
+            allow_empty_value=None,
             timeout_ms=timeout_ms,
         )
 
@@ -1358,7 +1474,7 @@ class Transactions(BaseSDK):
                 config=self.sdk_configuration,
                 base_url=base_url or "",
                 operation_id="get_transaction",
-                oauth2_scopes=[],
+                oauth2_scopes=None,
                 security_source=get_security_from_env(
                     self.sdk_configuration.security, models.Security
                 ),
@@ -1485,6 +1601,7 @@ class Transactions(BaseSDK):
                 merchant_account_id=self.sdk_configuration.globals.merchant_account_id,
             ),
             security=self.sdk_configuration.security,
+            allow_empty_value=None,
             timeout_ms=timeout_ms,
         )
 
@@ -1505,7 +1622,7 @@ class Transactions(BaseSDK):
                 config=self.sdk_configuration,
                 base_url=base_url or "",
                 operation_id="get_transaction",
-                oauth2_scopes=[],
+                oauth2_scopes=None,
                 security_source=get_security_from_env(
                     self.sdk_configuration.security, models.Security
                 ),
@@ -1658,6 +1775,7 @@ class Transactions(BaseSDK):
                 "json",
                 models.TransactionUpdate,
             ),
+            allow_empty_value=None,
             timeout_ms=timeout_ms,
         )
 
@@ -1674,7 +1792,7 @@ class Transactions(BaseSDK):
                 config=self.sdk_configuration,
                 base_url=base_url or "",
                 operation_id="update_transaction",
-                oauth2_scopes=[],
+                oauth2_scopes=None,
                 security_source=get_security_from_env(
                     self.sdk_configuration.security, models.Security
                 ),
@@ -1827,6 +1945,7 @@ class Transactions(BaseSDK):
                 "json",
                 models.TransactionUpdate,
             ),
+            allow_empty_value=None,
             timeout_ms=timeout_ms,
         )
 
@@ -1843,7 +1962,7 @@ class Transactions(BaseSDK):
                 config=self.sdk_configuration,
                 base_url=base_url or "",
                 operation_id="update_transaction",
-                oauth2_scopes=[],
+                oauth2_scopes=None,
                 security_source=get_security_from_env(
                     self.sdk_configuration.security, models.Security
                 ),
@@ -1992,6 +2111,7 @@ class Transactions(BaseSDK):
                 "json",
                 models.TransactionCaptureCreate,
             ),
+            allow_empty_value=None,
             timeout_ms=timeout_ms,
         )
 
@@ -2008,7 +2128,7 @@ class Transactions(BaseSDK):
                 config=self.sdk_configuration,
                 base_url=base_url or "",
                 operation_id="capture_transaction",
-                oauth2_scopes=[],
+                oauth2_scopes=None,
                 security_source=get_security_from_env(
                     self.sdk_configuration.security, models.Security
                 ),
@@ -2157,6 +2277,7 @@ class Transactions(BaseSDK):
                 "json",
                 models.TransactionCaptureCreate,
             ),
+            allow_empty_value=None,
             timeout_ms=timeout_ms,
         )
 
@@ -2173,7 +2294,7 @@ class Transactions(BaseSDK):
                 config=self.sdk_configuration,
                 base_url=base_url or "",
                 operation_id="capture_transaction",
-                oauth2_scopes=[],
+                oauth2_scopes=None,
                 security_source=get_security_from_env(
                     self.sdk_configuration.security, models.Security
                 ),
@@ -2303,6 +2424,7 @@ class Transactions(BaseSDK):
                 merchant_account_id=self.sdk_configuration.globals.merchant_account_id,
             ),
             security=self.sdk_configuration.security,
+            allow_empty_value=None,
             timeout_ms=timeout_ms,
         )
 
@@ -2319,7 +2441,7 @@ class Transactions(BaseSDK):
                 config=self.sdk_configuration,
                 base_url=base_url or "",
                 operation_id="void_transaction",
-                oauth2_scopes=[],
+                oauth2_scopes=None,
                 security_source=get_security_from_env(
                     self.sdk_configuration.security, models.Security
                 ),
@@ -2449,6 +2571,7 @@ class Transactions(BaseSDK):
                 merchant_account_id=self.sdk_configuration.globals.merchant_account_id,
             ),
             security=self.sdk_configuration.security,
+            allow_empty_value=None,
             timeout_ms=timeout_ms,
         )
 
@@ -2465,7 +2588,7 @@ class Transactions(BaseSDK):
                 config=self.sdk_configuration,
                 base_url=base_url or "",
                 operation_id="void_transaction",
-                oauth2_scopes=[],
+                oauth2_scopes=None,
                 security_source=get_security_from_env(
                     self.sdk_configuration.security, models.Security
                 ),
@@ -2540,6 +2663,294 @@ class Transactions(BaseSDK):
 
         raise errors.APIError("Unexpected response received", http_res)
 
+    def cancel(
+        self,
+        *,
+        transaction_id: str,
+        merchant_account_id: Optional[str] = None,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.TransactionCancel:
+        r"""Cancel transaction
+
+        Cancels a pending transaction. If the transaction was successfully authorized, or was already captured, the cancel will not be processed.
+
+        :param transaction_id: The ID of the transaction
+        :param merchant_account_id: The ID of the merchant account to use for this request.
+        :param retries: Override the default retry configuration for this method
+        :param server_url: Override the default server URL for this method
+        :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
+        :param http_headers: Additional headers to set or replace on requests.
+        """
+        base_url = None
+        url_variables = None
+        if timeout_ms is None:
+            timeout_ms = self.sdk_configuration.timeout_ms
+
+        if server_url is not None:
+            base_url = server_url
+        else:
+            base_url = self._get_url(base_url, url_variables)
+
+        request = models.CancelTransactionRequest(
+            transaction_id=transaction_id,
+            merchant_account_id=merchant_account_id,
+        )
+
+        req = self._build_request(
+            method="POST",
+            path="/transactions/{transaction_id}/cancel",
+            base_url=base_url,
+            url_variables=url_variables,
+            request=request,
+            request_body_required=False,
+            request_has_path_params=True,
+            request_has_query_params=True,
+            user_agent_header="user-agent",
+            accept_header_value="application/json",
+            http_headers=http_headers,
+            _globals=models.CancelTransactionGlobals(
+                merchant_account_id=self.sdk_configuration.globals.merchant_account_id,
+            ),
+            security=self.sdk_configuration.security,
+            allow_empty_value=None,
+            timeout_ms=timeout_ms,
+        )
+
+        if retries == UNSET:
+            if self.sdk_configuration.retry_config is not UNSET:
+                retries = self.sdk_configuration.retry_config
+
+        retry_config = None
+        if isinstance(retries, utils.RetryConfig):
+            retry_config = (retries, ["429", "500", "502", "503", "504"])
+
+        http_res = self.do_request(
+            hook_ctx=HookContext(
+                config=self.sdk_configuration,
+                base_url=base_url or "",
+                operation_id="cancel_transaction",
+                oauth2_scopes=None,
+                security_source=get_security_from_env(
+                    self.sdk_configuration.security, models.Security
+                ),
+            ),
+            request=req,
+            error_status_codes=[
+                "400",
+                "401",
+                "403",
+                "404",
+                "405",
+                "409",
+                "422",
+                "425",
+                "429",
+                "4XX",
+                "500",
+                "502",
+                "504",
+                "5XX",
+            ],
+            retry_config=retry_config,
+        )
+
+        response_data: Any = None
+        if utils.match_response(http_res, "200", "application/json"):
+            return unmarshal_json_response(models.TransactionCancel, http_res)
+        if utils.match_response(http_res, "400", "application/json"):
+            response_data = unmarshal_json_response(errors.Error400Data, http_res)
+            raise errors.Error400(response_data, http_res)
+        if utils.match_response(http_res, "401", "application/json"):
+            response_data = unmarshal_json_response(errors.Error401Data, http_res)
+            raise errors.Error401(response_data, http_res)
+        if utils.match_response(http_res, "403", "application/json"):
+            response_data = unmarshal_json_response(errors.Error403Data, http_res)
+            raise errors.Error403(response_data, http_res)
+        if utils.match_response(http_res, "404", "application/json"):
+            response_data = unmarshal_json_response(errors.Error404Data, http_res)
+            raise errors.Error404(response_data, http_res)
+        if utils.match_response(http_res, "405", "application/json"):
+            response_data = unmarshal_json_response(errors.Error405Data, http_res)
+            raise errors.Error405(response_data, http_res)
+        if utils.match_response(http_res, "409", "application/json"):
+            response_data = unmarshal_json_response(errors.Error409Data, http_res)
+            raise errors.Error409(response_data, http_res)
+        if utils.match_response(http_res, "422", "application/json"):
+            response_data = unmarshal_json_response(
+                errors.HTTPValidationErrorData, http_res
+            )
+            raise errors.HTTPValidationError(response_data, http_res)
+        if utils.match_response(http_res, "425", "application/json"):
+            response_data = unmarshal_json_response(errors.Error425Data, http_res)
+            raise errors.Error425(response_data, http_res)
+        if utils.match_response(http_res, "429", "application/json"):
+            response_data = unmarshal_json_response(errors.Error429Data, http_res)
+            raise errors.Error429(response_data, http_res)
+        if utils.match_response(http_res, "500", "application/json"):
+            response_data = unmarshal_json_response(errors.Error500Data, http_res)
+            raise errors.Error500(response_data, http_res)
+        if utils.match_response(http_res, "502", "application/json"):
+            response_data = unmarshal_json_response(errors.Error502Data, http_res)
+            raise errors.Error502(response_data, http_res)
+        if utils.match_response(http_res, "504", "application/json"):
+            response_data = unmarshal_json_response(errors.Error504Data, http_res)
+            raise errors.Error504(response_data, http_res)
+        if utils.match_response(http_res, "4XX", "*"):
+            http_res_text = utils.stream_to_text(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+        if utils.match_response(http_res, "5XX", "*"):
+            http_res_text = utils.stream_to_text(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+
+        raise errors.APIError("Unexpected response received", http_res)
+
+    async def cancel_async(
+        self,
+        *,
+        transaction_id: str,
+        merchant_account_id: Optional[str] = None,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.TransactionCancel:
+        r"""Cancel transaction
+
+        Cancels a pending transaction. If the transaction was successfully authorized, or was already captured, the cancel will not be processed.
+
+        :param transaction_id: The ID of the transaction
+        :param merchant_account_id: The ID of the merchant account to use for this request.
+        :param retries: Override the default retry configuration for this method
+        :param server_url: Override the default server URL for this method
+        :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
+        :param http_headers: Additional headers to set or replace on requests.
+        """
+        base_url = None
+        url_variables = None
+        if timeout_ms is None:
+            timeout_ms = self.sdk_configuration.timeout_ms
+
+        if server_url is not None:
+            base_url = server_url
+        else:
+            base_url = self._get_url(base_url, url_variables)
+
+        request = models.CancelTransactionRequest(
+            transaction_id=transaction_id,
+            merchant_account_id=merchant_account_id,
+        )
+
+        req = self._build_request_async(
+            method="POST",
+            path="/transactions/{transaction_id}/cancel",
+            base_url=base_url,
+            url_variables=url_variables,
+            request=request,
+            request_body_required=False,
+            request_has_path_params=True,
+            request_has_query_params=True,
+            user_agent_header="user-agent",
+            accept_header_value="application/json",
+            http_headers=http_headers,
+            _globals=models.CancelTransactionGlobals(
+                merchant_account_id=self.sdk_configuration.globals.merchant_account_id,
+            ),
+            security=self.sdk_configuration.security,
+            allow_empty_value=None,
+            timeout_ms=timeout_ms,
+        )
+
+        if retries == UNSET:
+            if self.sdk_configuration.retry_config is not UNSET:
+                retries = self.sdk_configuration.retry_config
+
+        retry_config = None
+        if isinstance(retries, utils.RetryConfig):
+            retry_config = (retries, ["429", "500", "502", "503", "504"])
+
+        http_res = await self.do_request_async(
+            hook_ctx=HookContext(
+                config=self.sdk_configuration,
+                base_url=base_url or "",
+                operation_id="cancel_transaction",
+                oauth2_scopes=None,
+                security_source=get_security_from_env(
+                    self.sdk_configuration.security, models.Security
+                ),
+            ),
+            request=req,
+            error_status_codes=[
+                "400",
+                "401",
+                "403",
+                "404",
+                "405",
+                "409",
+                "422",
+                "425",
+                "429",
+                "4XX",
+                "500",
+                "502",
+                "504",
+                "5XX",
+            ],
+            retry_config=retry_config,
+        )
+
+        response_data: Any = None
+        if utils.match_response(http_res, "200", "application/json"):
+            return unmarshal_json_response(models.TransactionCancel, http_res)
+        if utils.match_response(http_res, "400", "application/json"):
+            response_data = unmarshal_json_response(errors.Error400Data, http_res)
+            raise errors.Error400(response_data, http_res)
+        if utils.match_response(http_res, "401", "application/json"):
+            response_data = unmarshal_json_response(errors.Error401Data, http_res)
+            raise errors.Error401(response_data, http_res)
+        if utils.match_response(http_res, "403", "application/json"):
+            response_data = unmarshal_json_response(errors.Error403Data, http_res)
+            raise errors.Error403(response_data, http_res)
+        if utils.match_response(http_res, "404", "application/json"):
+            response_data = unmarshal_json_response(errors.Error404Data, http_res)
+            raise errors.Error404(response_data, http_res)
+        if utils.match_response(http_res, "405", "application/json"):
+            response_data = unmarshal_json_response(errors.Error405Data, http_res)
+            raise errors.Error405(response_data, http_res)
+        if utils.match_response(http_res, "409", "application/json"):
+            response_data = unmarshal_json_response(errors.Error409Data, http_res)
+            raise errors.Error409(response_data, http_res)
+        if utils.match_response(http_res, "422", "application/json"):
+            response_data = unmarshal_json_response(
+                errors.HTTPValidationErrorData, http_res
+            )
+            raise errors.HTTPValidationError(response_data, http_res)
+        if utils.match_response(http_res, "425", "application/json"):
+            response_data = unmarshal_json_response(errors.Error425Data, http_res)
+            raise errors.Error425(response_data, http_res)
+        if utils.match_response(http_res, "429", "application/json"):
+            response_data = unmarshal_json_response(errors.Error429Data, http_res)
+            raise errors.Error429(response_data, http_res)
+        if utils.match_response(http_res, "500", "application/json"):
+            response_data = unmarshal_json_response(errors.Error500Data, http_res)
+            raise errors.Error500(response_data, http_res)
+        if utils.match_response(http_res, "502", "application/json"):
+            response_data = unmarshal_json_response(errors.Error502Data, http_res)
+            raise errors.Error502(response_data, http_res)
+        if utils.match_response(http_res, "504", "application/json"):
+            response_data = unmarshal_json_response(errors.Error504Data, http_res)
+            raise errors.Error504(response_data, http_res)
+        if utils.match_response(http_res, "4XX", "*"):
+            http_res_text = await utils.stream_to_text_async(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+        if utils.match_response(http_res, "5XX", "*"):
+            http_res_text = await utils.stream_to_text_async(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+
+        raise errors.APIError("Unexpected response received", http_res)
+
     def sync(
         self,
         *,
@@ -2592,6 +3003,7 @@ class Transactions(BaseSDK):
                 merchant_account_id=self.sdk_configuration.globals.merchant_account_id,
             ),
             security=self.sdk_configuration.security,
+            allow_empty_value=None,
             timeout_ms=timeout_ms,
         )
 
@@ -2608,7 +3020,7 @@ class Transactions(BaseSDK):
                 config=self.sdk_configuration,
                 base_url=base_url or "",
                 operation_id="sync_transaction",
-                oauth2_scopes=[],
+                oauth2_scopes=None,
                 security_source=get_security_from_env(
                     self.sdk_configuration.security, models.Security
                 ),
@@ -2735,6 +3147,7 @@ class Transactions(BaseSDK):
                 merchant_account_id=self.sdk_configuration.globals.merchant_account_id,
             ),
             security=self.sdk_configuration.security,
+            allow_empty_value=None,
             timeout_ms=timeout_ms,
         )
 
@@ -2751,7 +3164,7 @@ class Transactions(BaseSDK):
                 config=self.sdk_configuration,
                 base_url=base_url or "",
                 operation_id="sync_transaction",
-                oauth2_scopes=[],
+                oauth2_scopes=None,
                 security_source=get_security_from_env(
                     self.sdk_configuration.security, models.Security
                 ),