BasisTheoryClient 6.0.0__tar.gz → 7.2.1__tar.gz

{basistheoryclient-6.0.0 → basistheoryclient-7.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: BasisTheoryClient
-Version: 6.0.0
+Version: 7.2.1
 Summary: 
 License: Apache-2.0
 License-File: LICENSE

{basistheoryclient-6.0.0 → basistheoryclient-7.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ dynamic = ["version"]
 
 [tool.poetry]
 name = "BasisTheoryClient"
-version = "6.0.0"
+version = "7.2.1"
 description = ""
 readme = "README.md"
 authors = []

{basistheoryclient-6.0.0 → basistheoryclient-7.2.1}/src/basis_theory/__init__.py

@@ -30,14 +30,13 @@ if typing.TYPE_CHECKING:
         ApplePayMerchantCertificates,
         ApplePayMethodToken,
         ApplePayToken,
-        ApplePayTokenizeRequest,
-        ApplePayTokenizeResponse,
         Application,
         ApplicationKey,
         ApplicationPaginatedList,
         ApplicationTemplate,
         AssuranceDetails,
         AsyncReactResponse,
+        AsyncReactorPendingResult,
         AuthenticateThreeDsSessionRequest,
         Authentication,
         AuthenticationResponse,
@@ -75,6 +74,8 @@ if typing.TYPE_CHECKING:
         CreateTokenRequest,
         Credentials,
         CredentialsCard,
+        CredentialsMpp,
+        CredentialsSpt,
         CursorPagination,
         DeliveryMethod,
         DeviceContext,
@@ -92,6 +93,8 @@ if typing.TYPE_CHECKING:
         EnrollmentStatus,
         EnrollmentType,
         EventTypes,
+        FunctionSourceDetection,
+        FunctionSourceValidation,
         GetApplications,
         GetLogs,
         GetPermissions,
@@ -106,11 +109,10 @@ if typing.TYPE_CHECKING:
         GooglePayMerchantCertificates,
         GooglePayMethodToken,
         GooglePayToken,
-        GooglePayTokenizeRequest,
-        GooglePayTokenizeResponse,
         Header,
         InstanceDetails,
         Instruction,
+        InstructionCredentialType,
         InstructionList,
         InstructionListPagination,
         InstructionStatus,
@@ -131,6 +133,7 @@ if typing.TYPE_CHECKING:
         MppCredentialsResponse,
         MppSource,
         MppSourceType,
+        MppStripeChallenge,
         NetworkStatusDetail,
         NetworkToken,
         NetworkTokenAccount,
@@ -157,12 +160,14 @@ if typing.TYPE_CHECKING:
         ReactorFormulaPaginatedList,
         ReactorFormulaRequestParameter,
         ReactorPaginatedList,
+        ReactorRuntime,
         Recurring,
         RecurringFrequency,
         RequestedProxy,
         RequestedReactor,
         Role,
         Runtime,
+        RuntimeLogOptions,
         SecurityContactEmailResponse,
         ServiceStatus,
         ShippingAddress,
@@ -214,6 +219,7 @@ if typing.TYPE_CHECKING:
         UpdatePrivacy,
         UpdateReactorFormulaRequest,
         User,
+        ValidateFunctionSourceRequest,
         ValidationProblemDetails,
         VerificationResponse,
         VerificationResponseBrand,
@@ -294,8 +300,6 @@ _dynamic_imports: typing.Dict[str, str] = {
     "ApplePayMerchantCertificates": ".types",
     "ApplePayMethodToken": ".types",
     "ApplePayToken": ".types",
-    "ApplePayTokenizeRequest": ".types",
-    "ApplePayTokenizeResponse": ".types",
     "Application": ".types",
     "ApplicationKey": ".types",
     "ApplicationPaginatedList": ".types",
@@ -303,6 +307,7 @@ _dynamic_imports: typing.Dict[str, str] = {
     "AssuranceDetails": ".types",
     "AsyncBasisTheory": ".client",
     "AsyncReactResponse": ".types",
+    "AsyncReactorPendingResult": ".types",
     "AuthenticateThreeDsSessionRequest": ".types",
     "Authentication": ".types",
     "AuthenticationResponse": ".types",
@@ -344,6 +349,8 @@ _dynamic_imports: typing.Dict[str, str] = {
     "CreateTokenRequest": ".types",
     "Credentials": ".types",
     "CredentialsCard": ".types",
+    "CredentialsMpp": ".types",
+    "CredentialsSpt": ".types",
     "CursorPagination": ".types",
     "DefaultAioHttpClient": "._default_clients",
     "DefaultAsyncHttpxClient": "._default_clients",
@@ -364,6 +371,8 @@ _dynamic_imports: typing.Dict[str, str] = {
     "EnrollmentType": ".types",
     "EventTypes": ".types",
     "ForbiddenError": ".errors",
+    "FunctionSourceDetection": ".types",
+    "FunctionSourceValidation": ".types",
     "GetApplications": ".types",
     "GetLogs": ".types",
     "GetPermissions": ".types",
@@ -378,11 +387,10 @@ _dynamic_imports: typing.Dict[str, str] = {
     "GooglePayMerchantCertificates": ".types",
     "GooglePayMethodToken": ".types",
     "GooglePayToken": ".types",
-    "GooglePayTokenizeRequest": ".types",
-    "GooglePayTokenizeResponse": ".types",
     "Header": ".types",
     "InstanceDetails": ".types",
     "Instruction": ".types",
+    "InstructionCredentialType": ".types",
     "InstructionList": ".types",
     "InstructionListPagination": ".types",
     "InstructionStatus": ".types",
@@ -404,6 +412,7 @@ _dynamic_imports: typing.Dict[str, str] = {
     "MppCredentialsResponse": ".types",
     "MppSource": ".types",
     "MppSourceType": ".types",
+    "MppStripeChallenge": ".types",
     "NetworkStatusDetail": ".types",
     "NetworkToken": ".types",
     "NetworkTokenAccount": ".types",
@@ -431,12 +440,14 @@ _dynamic_imports: typing.Dict[str, str] = {
     "ReactorFormulaPaginatedList": ".types",
     "ReactorFormulaRequestParameter": ".types",
     "ReactorPaginatedList": ".types",
+    "ReactorRuntime": ".types",
     "Recurring": ".types",
     "RecurringFrequency": ".types",
     "RequestedProxy": ".types",
     "RequestedReactor": ".types",
     "Role": ".types",
     "Runtime": ".types",
+    "RuntimeLogOptions": ".types",
     "SecurityContactEmailResponse": ".types",
     "ServiceStatus": ".types",
     "ServiceUnavailableError": ".errors",
@@ -491,6 +502,7 @@ _dynamic_imports: typing.Dict[str, str] = {
     "UpdatePrivacy": ".types",
     "UpdateReactorFormulaRequest": ".types",
     "User": ".types",
+    "ValidateFunctionSourceRequest": ".types",
     "ValidationProblemDetails": ".types",
     "VerificationResponse": ".types",
     "VerificationResponseBrand": ".types",
@@ -579,8 +591,6 @@ __all__ = [
     "ApplePayMerchantCertificates",
     "ApplePayMethodToken",
     "ApplePayToken",
-    "ApplePayTokenizeRequest",
-    "ApplePayTokenizeResponse",
     "Application",
     "ApplicationKey",
     "ApplicationPaginatedList",
@@ -588,6 +598,7 @@ __all__ = [
     "AssuranceDetails",
     "AsyncBasisTheory",
     "AsyncReactResponse",
+    "AsyncReactorPendingResult",
     "AuthenticateThreeDsSessionRequest",
     "Authentication",
     "AuthenticationResponse",
@@ -629,6 +640,8 @@ __all__ = [
     "CreateTokenRequest",
     "Credentials",
     "CredentialsCard",
+    "CredentialsMpp",
+    "CredentialsSpt",
     "CursorPagination",
     "DefaultAioHttpClient",
     "DefaultAsyncHttpxClient",
@@ -649,6 +662,8 @@ __all__ = [
     "EnrollmentType",
     "EventTypes",
     "ForbiddenError",
+    "FunctionSourceDetection",
+    "FunctionSourceValidation",
     "GetApplications",
     "GetLogs",
     "GetPermissions",
@@ -663,11 +678,10 @@ __all__ = [
     "GooglePayMerchantCertificates",
     "GooglePayMethodToken",
     "GooglePayToken",
-    "GooglePayTokenizeRequest",
-    "GooglePayTokenizeResponse",
     "Header",
     "InstanceDetails",
     "Instruction",
+    "InstructionCredentialType",
     "InstructionList",
     "InstructionListPagination",
     "InstructionStatus",
@@ -689,6 +703,7 @@ __all__ = [
     "MppCredentialsResponse",
     "MppSource",
     "MppSourceType",
+    "MppStripeChallenge",
     "NetworkStatusDetail",
     "NetworkToken",
     "NetworkTokenAccount",
@@ -716,12 +731,14 @@ __all__ = [
     "ReactorFormulaPaginatedList",
     "ReactorFormulaRequestParameter",
     "ReactorPaginatedList",
+    "ReactorRuntime",
     "Recurring",
     "RecurringFrequency",
     "RequestedProxy",
     "RequestedReactor",
     "Role",
     "Runtime",
+    "RuntimeLogOptions",
     "SecurityContactEmailResponse",
     "ServiceStatus",
     "ServiceUnavailableError",
@@ -776,6 +793,7 @@ __all__ = [
     "UpdatePrivacy",
     "UpdateReactorFormulaRequest",
     "User",
+    "ValidateFunctionSourceRequest",
     "ValidationProblemDetails",
     "VerificationResponse",
     "VerificationResponseBrand",

{basistheoryclient-6.0.0 → basistheoryclient-7.2.1}/src/basis_theory/account_updater/jobs/client.py

@@ -104,7 +104,9 @@ class JobsClient:
     def create(
         self,
         *,
+        bt_merchant_id: typing.Optional[str] = None,
         deduplicate_tokens: typing.Optional[bool] = OMIT,
+        configuration_merchant_id: typing.Optional[str] = OMIT,
         merchant_id: typing.Optional[str] = OMIT,
         result_version: typing.Optional[CreateAccountUpdaterJobRequestResultVersion] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
@@ -114,11 +116,17 @@ class JobsClient:
 
         Parameters
         ----------
+        bt_merchant_id : typing.Optional[str]
+            Tenant merchant the job acts as. Tokens in the file are read within this merchant's scope and new tokens are associated with it. Responds 404 if the merchant does not exist in the tenant.
+
         deduplicate_tokens : typing.Optional[bool]
             Whether deduplication should be enabled when creating new tokens. Uses the value of the Deduplicate Tokens setting on the tenant if not set.
 
+        configuration_merchant_id : typing.Optional[str]
+            Tenant merchant whose provider configuration is used for this job. Selects configuration only; it does not scope token access or associate tokens with the merchant. Takes precedence over merchant_id; defaults to the BT-MERCHANT-ID header merchant, then the tenant-level configuration.
+
         merchant_id : typing.Optional[str]
-            Tenant merchant identifier
+            Deprecated: use configuration_merchant_id instead. Legacy alias kept for backward compatibility with lower precedence. Selects configuration only.
 
         result_version : typing.Optional[CreateAccountUpdaterJobRequestResultVersion]
             Version of the result CSV format. Version '1' returns base columns. Version '1.1' adds new_fingerprint and new_brand columns. Version '1.2' adds the new_last4 column on top of 1.1.
@@ -142,7 +150,9 @@ class JobsClient:
         client.account_updater.jobs.create()
         """
         _response = self._raw_client.create(
+            bt_merchant_id=bt_merchant_id,
             deduplicate_tokens=deduplicate_tokens,
+            configuration_merchant_id=configuration_merchant_id,
             merchant_id=merchant_id,
             result_version=result_version,
             request_options=request_options,
@@ -257,7 +267,9 @@ class AsyncJobsClient:
     async def create(
         self,
         *,
+        bt_merchant_id: typing.Optional[str] = None,
         deduplicate_tokens: typing.Optional[bool] = OMIT,
+        configuration_merchant_id: typing.Optional[str] = OMIT,
         merchant_id: typing.Optional[str] = OMIT,
         result_version: typing.Optional[CreateAccountUpdaterJobRequestResultVersion] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
@@ -267,11 +279,17 @@ class AsyncJobsClient:
 
         Parameters
         ----------
+        bt_merchant_id : typing.Optional[str]
+            Tenant merchant the job acts as. Tokens in the file are read within this merchant's scope and new tokens are associated with it. Responds 404 if the merchant does not exist in the tenant.
+
         deduplicate_tokens : typing.Optional[bool]
             Whether deduplication should be enabled when creating new tokens. Uses the value of the Deduplicate Tokens setting on the tenant if not set.
 
+        configuration_merchant_id : typing.Optional[str]
+            Tenant merchant whose provider configuration is used for this job. Selects configuration only; it does not scope token access or associate tokens with the merchant. Takes precedence over merchant_id; defaults to the BT-MERCHANT-ID header merchant, then the tenant-level configuration.
+
         merchant_id : typing.Optional[str]
-            Tenant merchant identifier
+            Deprecated: use configuration_merchant_id instead. Legacy alias kept for backward compatibility with lower precedence. Selects configuration only.
 
         result_version : typing.Optional[CreateAccountUpdaterJobRequestResultVersion]
             Version of the result CSV format. Version '1' returns base columns. Version '1.1' adds new_fingerprint and new_brand columns. Version '1.2' adds the new_last4 column on top of 1.1.
@@ -303,7 +321,9 @@ class AsyncJobsClient:
         asyncio.run(main())
         """
         _response = await self._raw_client.create(
+            bt_merchant_id=bt_merchant_id,
             deduplicate_tokens=deduplicate_tokens,
+            configuration_merchant_id=configuration_merchant_id,
             merchant_id=merchant_id,
             result_version=result_version,
             request_options=request_options,

{basistheoryclient-6.0.0 → basistheoryclient-7.2.1}/src/basis_theory/account_updater/jobs/raw_client.py

@@ -182,7 +182,9 @@ class RawJobsClient:
     def create(
         self,
         *,
+        bt_merchant_id: typing.Optional[str] = None,
         deduplicate_tokens: typing.Optional[bool] = OMIT,
+        configuration_merchant_id: typing.Optional[str] = OMIT,
         merchant_id: typing.Optional[str] = OMIT,
         result_version: typing.Optional[CreateAccountUpdaterJobRequestResultVersion] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
@@ -192,11 +194,17 @@ class RawJobsClient:
 
         Parameters
         ----------
+        bt_merchant_id : typing.Optional[str]
+            Tenant merchant the job acts as. Tokens in the file are read within this merchant's scope and new tokens are associated with it. Responds 404 if the merchant does not exist in the tenant.
+
         deduplicate_tokens : typing.Optional[bool]
             Whether deduplication should be enabled when creating new tokens. Uses the value of the Deduplicate Tokens setting on the tenant if not set.
 
+        configuration_merchant_id : typing.Optional[str]
+            Tenant merchant whose provider configuration is used for this job. Selects configuration only; it does not scope token access or associate tokens with the merchant. Takes precedence over merchant_id; defaults to the BT-MERCHANT-ID header merchant, then the tenant-level configuration.
+
         merchant_id : typing.Optional[str]
-            Tenant merchant identifier
+            Deprecated: use configuration_merchant_id instead. Legacy alias kept for backward compatibility with lower precedence. Selects configuration only.
 
         result_version : typing.Optional[CreateAccountUpdaterJobRequestResultVersion]
             Version of the result CSV format. Version '1' returns base columns. Version '1.1' adds new_fingerprint and new_brand columns. Version '1.2' adds the new_last4 column on top of 1.1.
@@ -214,11 +222,13 @@ class RawJobsClient:
             method="POST",
             json={
                 "deduplicate_tokens": deduplicate_tokens,
+                "configuration_merchant_id": configuration_merchant_id,
                 "merchant_id": merchant_id,
                 "result_version": result_version,
             },
             headers={
                 "content-type": "application/json",
+                "BT-MERCHANT-ID": str(bt_merchant_id) if bt_merchant_id is not None else None,
             },
             request_options=request_options,
             omit=OMIT,
@@ -255,6 +265,17 @@ class RawJobsClient:
                         ),
                     ),
                 )
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
             if _response.status_code == 422:
                 raise UnprocessableEntityError(
                     headers=dict(_response.headers),
@@ -434,7 +455,9 @@ class AsyncRawJobsClient:
     async def create(
         self,
         *,
+        bt_merchant_id: typing.Optional[str] = None,
         deduplicate_tokens: typing.Optional[bool] = OMIT,
+        configuration_merchant_id: typing.Optional[str] = OMIT,
         merchant_id: typing.Optional[str] = OMIT,
         result_version: typing.Optional[CreateAccountUpdaterJobRequestResultVersion] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
@@ -444,11 +467,17 @@ class AsyncRawJobsClient:
 
         Parameters
         ----------
+        bt_merchant_id : typing.Optional[str]
+            Tenant merchant the job acts as. Tokens in the file are read within this merchant's scope and new tokens are associated with it. Responds 404 if the merchant does not exist in the tenant.
+
         deduplicate_tokens : typing.Optional[bool]
             Whether deduplication should be enabled when creating new tokens. Uses the value of the Deduplicate Tokens setting on the tenant if not set.
 
+        configuration_merchant_id : typing.Optional[str]
+            Tenant merchant whose provider configuration is used for this job. Selects configuration only; it does not scope token access or associate tokens with the merchant. Takes precedence over merchant_id; defaults to the BT-MERCHANT-ID header merchant, then the tenant-level configuration.
+
         merchant_id : typing.Optional[str]
-            Tenant merchant identifier
+            Deprecated: use configuration_merchant_id instead. Legacy alias kept for backward compatibility with lower precedence. Selects configuration only.
 
         result_version : typing.Optional[CreateAccountUpdaterJobRequestResultVersion]
             Version of the result CSV format. Version '1' returns base columns. Version '1.1' adds new_fingerprint and new_brand columns. Version '1.2' adds the new_last4 column on top of 1.1.
@@ -466,11 +495,13 @@ class AsyncRawJobsClient:
             method="POST",
             json={
                 "deduplicate_tokens": deduplicate_tokens,
+                "configuration_merchant_id": configuration_merchant_id,
                 "merchant_id": merchant_id,
                 "result_version": result_version,
             },
             headers={
                 "content-type": "application/json",
+                "BT-MERCHANT-ID": str(bt_merchant_id) if bt_merchant_id is not None else None,
             },
             request_options=request_options,
             omit=OMIT,
@@ -507,6 +538,17 @@ class AsyncRawJobsClient:
                         ),
                     ),
                 )
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
             if _response.status_code == 422:
                 raise UnprocessableEntityError(
                     headers=dict(_response.headers),

{basistheoryclient-6.0.0 → basistheoryclient-7.2.1}/src/basis_theory/account_updater/real_time/client.py

@@ -30,9 +30,11 @@ class RealTimeClient:
         self,
         *,
         token_id: str,
+        bt_merchant_id: typing.Optional[str] = None,
         expiration_year: typing.Optional[int] = OMIT,
         expiration_month: typing.Optional[int] = OMIT,
         deduplicate_token: typing.Optional[bool] = OMIT,
+        configuration_merchant_id: typing.Optional[str] = OMIT,
         merchant_id: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AccountUpdaterRealTimeResponse:
@@ -44,6 +46,9 @@ class RealTimeClient:
         token_id : str
             Card Token identifier
 
+        bt_merchant_id : typing.Optional[str]
+            Tenant merchant the request acts as. The card token is read within this merchant's scope and the updated token is associated with it. Responds 404 if the merchant does not exist in the tenant.
+
         expiration_year : typing.Optional[int]
             The 4-digit expiration year of the account number. Not required if the card token already stores this value.
 
@@ -53,8 +58,11 @@ class RealTimeClient:
         deduplicate_token : typing.Optional[bool]
             Whether deduplication should be enabled when creating the new token. Uses the value of the Deduplicate Tokens setting on the tenant if not set.
 
+        configuration_merchant_id : typing.Optional[str]
+            Tenant merchant whose provider configuration is used for this request. Selects configuration only; it does not scope token access or associate the new token with the merchant. Takes precedence over merchant_id; defaults to the BT-MERCHANT-ID header merchant, then the tenant-level configuration.
+
         merchant_id : typing.Optional[str]
-            Tenant merchant identifier
+            Deprecated: use configuration_merchant_id instead. Legacy alias kept for backward compatibility with lower precedence. Selects configuration only.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -78,9 +86,11 @@ class RealTimeClient:
         """
         _response = self._raw_client.invoke(
             token_id=token_id,
+            bt_merchant_id=bt_merchant_id,
             expiration_year=expiration_year,
             expiration_month=expiration_month,
             deduplicate_token=deduplicate_token,
+            configuration_merchant_id=configuration_merchant_id,
             merchant_id=merchant_id,
             request_options=request_options,
         )
@@ -106,9 +116,11 @@ class AsyncRealTimeClient:
         self,
         *,
         token_id: str,
+        bt_merchant_id: typing.Optional[str] = None,
         expiration_year: typing.Optional[int] = OMIT,
         expiration_month: typing.Optional[int] = OMIT,
         deduplicate_token: typing.Optional[bool] = OMIT,
+        configuration_merchant_id: typing.Optional[str] = OMIT,
         merchant_id: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AccountUpdaterRealTimeResponse:
@@ -120,6 +132,9 @@ class AsyncRealTimeClient:
         token_id : str
             Card Token identifier
 
+        bt_merchant_id : typing.Optional[str]
+            Tenant merchant the request acts as. The card token is read within this merchant's scope and the updated token is associated with it. Responds 404 if the merchant does not exist in the tenant.
+
         expiration_year : typing.Optional[int]
             The 4-digit expiration year of the account number. Not required if the card token already stores this value.
 
@@ -129,8 +144,11 @@ class AsyncRealTimeClient:
         deduplicate_token : typing.Optional[bool]
             Whether deduplication should be enabled when creating the new token. Uses the value of the Deduplicate Tokens setting on the tenant if not set.
 
+        configuration_merchant_id : typing.Optional[str]
+            Tenant merchant whose provider configuration is used for this request. Selects configuration only; it does not scope token access or associate the new token with the merchant. Takes precedence over merchant_id; defaults to the BT-MERCHANT-ID header merchant, then the tenant-level configuration.
+
         merchant_id : typing.Optional[str]
-            Tenant merchant identifier
+            Deprecated: use configuration_merchant_id instead. Legacy alias kept for backward compatibility with lower precedence. Selects configuration only.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -162,9 +180,11 @@ class AsyncRealTimeClient:
         """
         _response = await self._raw_client.invoke(
             token_id=token_id,
+            bt_merchant_id=bt_merchant_id,
             expiration_year=expiration_year,
             expiration_month=expiration_month,
             deduplicate_token=deduplicate_token,
+            configuration_merchant_id=configuration_merchant_id,
             merchant_id=merchant_id,
             request_options=request_options,
         )

{basistheoryclient-6.0.0 → basistheoryclient-7.2.1}/src/basis_theory/account_updater/real_time/raw_client.py

@@ -11,6 +11,7 @@ from ...core.pydantic_utilities import parse_obj_as
 from ...core.request_options import RequestOptions
 from ...errors.bad_request_error import BadRequestError
 from ...errors.forbidden_error import ForbiddenError
+from ...errors.not_found_error import NotFoundError
 from ...errors.unauthorized_error import UnauthorizedError
 from ...errors.unprocessable_entity_error import UnprocessableEntityError
 from ...types.account_updater_real_time_response import AccountUpdaterRealTimeResponse
@@ -30,9 +31,11 @@ class RawRealTimeClient:
         self,
         *,
         token_id: str,
+        bt_merchant_id: typing.Optional[str] = None,
         expiration_year: typing.Optional[int] = OMIT,
         expiration_month: typing.Optional[int] = OMIT,
         deduplicate_token: typing.Optional[bool] = OMIT,
+        configuration_merchant_id: typing.Optional[str] = OMIT,
         merchant_id: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[AccountUpdaterRealTimeResponse]:
@@ -44,6 +47,9 @@ class RawRealTimeClient:
         token_id : str
             Card Token identifier
 
+        bt_merchant_id : typing.Optional[str]
+            Tenant merchant the request acts as. The card token is read within this merchant's scope and the updated token is associated with it. Responds 404 if the merchant does not exist in the tenant.
+
         expiration_year : typing.Optional[int]
             The 4-digit expiration year of the account number. Not required if the card token already stores this value.
 
@@ -53,8 +59,11 @@ class RawRealTimeClient:
         deduplicate_token : typing.Optional[bool]
             Whether deduplication should be enabled when creating the new token. Uses the value of the Deduplicate Tokens setting on the tenant if not set.
 
+        configuration_merchant_id : typing.Optional[str]
+            Tenant merchant whose provider configuration is used for this request. Selects configuration only; it does not scope token access or associate the new token with the merchant. Takes precedence over merchant_id; defaults to the BT-MERCHANT-ID header merchant, then the tenant-level configuration.
+
         merchant_id : typing.Optional[str]
-            Tenant merchant identifier
+            Deprecated: use configuration_merchant_id instead. Legacy alias kept for backward compatibility with lower precedence. Selects configuration only.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -72,10 +81,12 @@ class RawRealTimeClient:
                 "expiration_year": expiration_year,
                 "expiration_month": expiration_month,
                 "deduplicate_token": deduplicate_token,
+                "configuration_merchant_id": configuration_merchant_id,
                 "merchant_id": merchant_id,
             },
             headers={
                 "content-type": "application/json",
+                "BT-MERCHANT-ID": str(bt_merchant_id) if bt_merchant_id is not None else None,
             },
             request_options=request_options,
             omit=OMIT,
@@ -123,6 +134,17 @@ class RawRealTimeClient:
                         ),
                     ),
                 )
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
             if _response.status_code == 422:
                 raise UnprocessableEntityError(
                     headers=dict(_response.headers),
@@ -152,9 +174,11 @@ class AsyncRawRealTimeClient:
         self,
         *,
         token_id: str,
+        bt_merchant_id: typing.Optional[str] = None,
         expiration_year: typing.Optional[int] = OMIT,
         expiration_month: typing.Optional[int] = OMIT,
         deduplicate_token: typing.Optional[bool] = OMIT,
+        configuration_merchant_id: typing.Optional[str] = OMIT,
         merchant_id: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[AccountUpdaterRealTimeResponse]:
@@ -166,6 +190,9 @@ class AsyncRawRealTimeClient:
         token_id : str
             Card Token identifier
 
+        bt_merchant_id : typing.Optional[str]
+            Tenant merchant the request acts as. The card token is read within this merchant's scope and the updated token is associated with it. Responds 404 if the merchant does not exist in the tenant.
+
         expiration_year : typing.Optional[int]
             The 4-digit expiration year of the account number. Not required if the card token already stores this value.
 
@@ -175,8 +202,11 @@ class AsyncRawRealTimeClient:
         deduplicate_token : typing.Optional[bool]
             Whether deduplication should be enabled when creating the new token. Uses the value of the Deduplicate Tokens setting on the tenant if not set.
 
+        configuration_merchant_id : typing.Optional[str]
+            Tenant merchant whose provider configuration is used for this request. Selects configuration only; it does not scope token access or associate the new token with the merchant. Takes precedence over merchant_id; defaults to the BT-MERCHANT-ID header merchant, then the tenant-level configuration.
+
         merchant_id : typing.Optional[str]
-            Tenant merchant identifier
+            Deprecated: use configuration_merchant_id instead. Legacy alias kept for backward compatibility with lower precedence. Selects configuration only.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -194,10 +224,12 @@ class AsyncRawRealTimeClient:
                 "expiration_year": expiration_year,
                 "expiration_month": expiration_month,
                 "deduplicate_token": deduplicate_token,
+                "configuration_merchant_id": configuration_merchant_id,
                 "merchant_id": merchant_id,
             },
             headers={
                 "content-type": "application/json",
+                "BT-MERCHANT-ID": str(bt_merchant_id) if bt_merchant_id is not None else None,
             },
             request_options=request_options,
             omit=OMIT,
@@ -245,6 +277,17 @@ class AsyncRawRealTimeClient:
                         ),
                     ),
                 )
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
             if _response.status_code == 422:
                 raise UnprocessableEntityError(
                     headers=dict(_response.headers),