cuenca 2.2.0.dev3__py3-none-any.whl → 2.2.2__py3-none-any.whl

cuenca/__init__.py

@@ -1,5 +1,7 @@
 __all__ = [
     '__version__',
+    'Agent',
+    'AgentVerification',
     'ApiKey',
     'Account',
     'Arpc',
@@ -53,6 +55,8 @@ __all__ = [
 from . import http
 from .resources import (
     Account,
+    Agent,
+    AgentVerification,
     ApiKey,
     Arpc,
     BalanceEntry,

cuenca/resources/__init__.py

@@ -1,4 +1,6 @@
 __all__ = [
+    'Agent',
+    'AgentVerification',
     'ApiKey',
     'Account',
     'Arpc',
@@ -47,6 +49,8 @@ __all__ = [
 ]
 
 from .accounts import Account
+from .agent_verifications import AgentVerification
+from .agents import Agent
 from .api_keys import ApiKey
 from .arpc import Arpc
 from .balance_entries import BalanceEntry
@@ -96,6 +100,8 @@ from .whatsapp_transfers import WhatsappTransfer
 
 # avoid circular imports
 resource_classes = [
+    Agent,
+    AgentVerification,
     ApiKey,
     Account,
     Arpc,

cuenca/resources/agent_verifications.py

@@ -0,0 +1,37 @@
+import datetime as dt
+from typing import ClassVar
+
+from cuenca_validations.types.identities import PhoneNumber
+from pydantic import ConfigDict
+
+from ..http import Session, session as global_session
+from .base import Creatable
+
+
+class AgentVerification(Creatable):
+    _resource: ClassVar = 'agent_verifications'
+
+    created_at: dt.datetime
+    user_id: str
+    platform_id: str
+    phone_number: PhoneNumber
+    pairing_code: str
+    deactivated_at: dt.datetime
+
+    model_config = ConfigDict(
+        json_schema_extra={
+            'example': {
+                'id': 'AVjTtPH1mhT65GEgOeomJ4DQ',
+                'created_at': '2026-06-25T22:50:08.495768',
+                'user_id': 'USMP3EPgI4T4CPFyVmXUPi8A',
+                'platform_id': 'PTZbBlk__kQt-wfwzP5nwA9A',
+                'phone_number': '+525512345678',
+                'pairing_code': 'OJC37W',
+                'deactivated_at': '2026-06-25T22:55:08.495779',
+            }
+        }
+    )
+
+    @classmethod
+    def create(cls, session: Session = global_session) -> 'AgentVerification':
+        return cls._create(session=session)

cuenca/resources/agents.py

@@ -0,0 +1,52 @@
+import datetime as dt
+from typing import ClassVar, Optional
+
+from cuenca_validations.types import AgentQuery, AgentRequest, PhoneNumber
+from cuenca_validations.typing import DictStrAny
+from pydantic import ConfigDict, Field
+
+from ..http import Session, session as global_session
+from .base import Creatable, Queryable
+
+
+class Agent(Creatable, Queryable):
+    _resource: ClassVar = 'agents'
+    _query_params: ClassVar = AgentQuery
+
+    created_at: dt.datetime
+    user_id: str
+    platform_id: str
+    agent_verification_id: str
+    session_id: str
+    device_info: DictStrAny = Field(default_factory=dict)
+    deactivated_at: Optional[dt.datetime] = None
+
+    model_config = ConfigDict(
+        json_schema_extra={
+            'example': {
+                'id': 'AG1G6Bm0oGQOCRjTDaeFSsyA',
+                'created_at': '2026-06-27T01:56:42.613781',
+                'user_id': 'USMP3EPgI4T4CPFyVmXUPi8A',
+                'platform_id': 'PTZbBlk__kQt-wfwzP5nwA9A',
+                'agent_verification_id': 'AV7A1FLC7MSnqKcb7oAkiQxA',
+                'session_id': 'SSH0M5yteyRHas-PmfT9pu9w',
+                'device_info': {'client': 'cursor', 'os': 'macOS'},
+            }
+        }
+    )
+
+    @classmethod
+    def create(
+        cls,
+        pairing_code: str,
+        phone_number: PhoneNumber,
+        device_info: Optional[DictStrAny] = None,
+        *,
+        session: Session = global_session,
+    ) -> 'Agent':
+        req = AgentRequest(
+            pairing_code=pairing_code,
+            phone_number=phone_number,
+            device_info=device_info or {},
+        )
+        return cls._create(session=session, **req.model_dump())

cuenca/resources/password_resets.py

@@ -27,8 +27,14 @@ class PasswordReset(Creatable):
                 'id': 'PRNEUInh69SuKXXmK95sROwQ',
                 'platform_id': 'PT-1234567890',
                 'flow_id': '123e4567-e89b-12d3-a456-426614174000',
-                'status': 'created',
+                'status': 'succeeded',
+                'provider_url': (
+                    'https://dashboard.metamap.com/identity/'
+                    'identity-id/verification/verification-id'
+                ),
                 'created_at': '2026-05-06T14:15:22Z',
+                'updated_at': '2026-05-06T14:18:22Z',
+                'deactivated_at': '2026-05-06T14:20:22Z',
             }
         }
     )

cuenca/resources/transfers.py

@@ -2,20 +2,23 @@ import datetime as dt
 from typing import ClassVar, Optional, cast
 
 from cuenca_validations.types import (
+    TransactionStatus,
     TransferNetwork,
     TransferQuery,
     TransferRequest,
+    UpdateTransferRequest,
 )
 from cuenca_validations.typing import DictStrAny
 from requests import HTTPError
 
 from ..exc import CuencaException
+from ..http import Session, session as global_session
 from .accounts import Account
-from .base import Creatable, Transaction
+from .base import Creatable, Transaction, Updateable
 from .resources import retrieve_uri
 
 
-class Transfer(Transaction, Creatable):
+class Transfer(Transaction, Creatable, Updateable):
     _resource: ClassVar = 'transfers'
     _query_params: ClassVar = TransferQuery
 
@@ -71,6 +74,17 @@ class Transfer(Transaction, Creatable):
         )
         return cls._create(**req.model_dump())
 
+    @classmethod
+    def update(
+        cls,
+        transfer_id: str,
+        status: TransactionStatus,
+        *,
+        session: Session = global_session,
+    ) -> 'Transfer':
+        req = UpdateTransferRequest(status=status)
+        return cls._update(transfer_id, session=session, **req.model_dump())
+
     @classmethod
     def create_many(cls, requests: list[TransferRequest]) -> DictStrAny:
         transfers: DictStrAny = dict(submitted=[], errors=[])

cuenca/version.py

@@ -1,3 +1,3 @@
-__version__ = '2.2.0.dev3'
+__version__ = '2.2.2'
 CLIENT_VERSION = __version__
 API_VERSION = '2020-03-19'

{cuenca-2.2.0.dev3.dist-info → cuenca-2.2.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cuenca
-Version: 2.2.0.dev3
+Version: 2.2.2
 Summary: Cuenca API Client
 Home-page: https://github.com/cuenca-mx/cuenca-python
 Author: Cuenca
@@ -16,7 +16,7 @@ Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: requests>=2.32.0
-Requires-Dist: cuenca-validations>=2.1.27
+Requires-Dist: cuenca-validations>=2.1.34
 Requires-Dist: pydantic-extra-types>=2.10.0
 Dynamic: author
 Dynamic: author-email

{cuenca-2.2.0.dev3.dist-info → cuenca-2.2.2.dist-info}/RECORD

@@ -1,12 +1,14 @@
-cuenca/__init__.py,sha256=iRradQitV5UJnzDfw-ktkFFNIdpJq3NVcokoWASFm7Y,2018
+cuenca/__init__.py,sha256=zsTFAP7_uZxDnJfbJGRQrIUICHU4AzIeaHW6bclI2Ag,2090
 cuenca/exc.py,sha256=r_lL03-JS0AsXw71wuNbiwNYLHNDagM56tRxpYyK6Lw,601
 cuenca/jwt.py,sha256=plB2ttHPZnL0xq3gqubw_Jjtj1QYG2E5bk99N3cn5zg,1502
 cuenca/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-cuenca/version.py,sha256=IA6Qcw9aCznvdDQ2PTSvzZaL-p3kfSnadRjljCUHLmM,83
+cuenca/version.py,sha256=SSdgI7ZJEOlT96kX81QbeuZ0FMMjjtVc3XK7kyg-wcs,78
 cuenca/http/__init__.py,sha256=V5TG6Ro9d3VY7umzcbtanmvHlGkv-k71H0tqrdMyH-s,49
 cuenca/http/client.py,sha256=psXJiSgd3SUSJ5jwvhdBWsVMNadenG353BNVXdh7HMY,4168
-cuenca/resources/__init__.py,sha256=zbHBUgSJ4AR9i33k6NI9R2eFeXD-UwVCG0trGgU40U4,3535
+cuenca/resources/__init__.py,sha256=mNwQjWDgH5lSndDpIQ5bmSoOc2kUfFeZgHV6nEX-gWM,3684
 cuenca/resources/accounts.py,sha256=5yfNxAHpxWFosoR4WrPrDGpBCRkaQk98V-w0wCPPXqU,345
+cuenca/resources/agent_verifications.py,sha256=y3sE6gW6ce5IxJOUh8-8EuJ3I5xlYy28lIAkKKQub5k,1098
+cuenca/resources/agents.py,sha256=QW4Zul4mUrJrPYq8h9bMWqcF5HVQXscsqWeo5CbApcQ,1644
 cuenca/resources/api_keys.py,sha256=p65ZUiAu51JhEL_fZDc7_DTR0PMcSa-YQeK9gRFY82s,2618
 cuenca/resources/arpc.py,sha256=a9gGIgpBV8RK2ePSPBxI5c4ET4MtKH6Po_HRiv73B5k,1689
 cuenca/resources/balance_entries.py,sha256=c2p9nXrKpMJ2xlQkTLP_ttycb1RitA979mP46mbZnEc,1073
@@ -32,7 +34,7 @@ cuenca/resources/kyc_validations.py,sha256=Omu4qaP0AFa6PDoU5V9gUQmiY8sxOzEuC7qS0
 cuenca/resources/limited_wallets.py,sha256=Z3pKMRmMFTAaCw-KdzGSWfYFHCpy-ZrBwOmalVfSdRU,1049
 cuenca/resources/login_tokens.py,sha256=vxRWqQznxdEUK0R80k0qC0BkTSZwZgUsC2neX8TTd8Q,799
 cuenca/resources/otps.py,sha256=dZEwns98N8uUtRBFCu6Qs6ySHARU9v3zTF6T5rpF43M,711
-cuenca/resources/password_resets.py,sha256=slzvroZVaUzETfHfoiDZFQukM2OJrtjtHF4H0yJ_fG0,1338
+cuenca/resources/password_resets.py,sha256=Gsh4wAVWP9vagfTjxItX9AtthK7NQaNJlDYtoVoFlaE,1630
 cuenca/resources/phone_verification_associations.py,sha256=JydlFi57kVH-3qdCRMfj67tZSz6N--ZX5ULBe9Owu0Q,720
 cuenca/resources/platforms.py,sha256=ztGcI-cNnushMRqKqjPaZg_ioS1bpR4vR88osHAyYXw,2560
 cuenca/resources/postal_codes.py,sha256=FOC9P4nZCQVRHMGeG8wHiRtsD083EdHtcKGPuJKj8b8,467
@@ -43,7 +45,7 @@ cuenca/resources/service_providers.py,sha256=x-FNcyiUkdUsNCGudyLGYDbRkD2jPj8-T8U
 cuenca/resources/sessions.py,sha256=lWphgjG9SZl81ik7c9tuAI6OE4JUOF0ZfRBvmf4vwyQ,1764
 cuenca/resources/statements.py,sha256=PqMvhoE9cvBneXjaS7w4JnTzYdDakkCkbdNYrd7b8LI,282
 cuenca/resources/terms_of_service.py,sha256=jaYN7NAxgxR9t0MlExL4bRt9HDunb53Y8bCCZO01mKg,406
-cuenca/resources/transfers.py,sha256=v742SAGUIZfvYHfCNtk0hSm2uyhMGh00RbHIIJiqLzQ,3201
+cuenca/resources/transfers.py,sha256=jCsnjM4EMRiRu_To0lAmpuVZbD_dKKL5gDHXxcg7ZoE,3640
 cuenca/resources/user_credentials.py,sha256=glpxUa5-aYhgJ1ZG1g_c1PAWaQ9eEWP01lauBaccSQQ,1356
 cuenca/resources/user_events.py,sha256=ktZBoG_dhdfOkyuCHBwWd3lxV3CfA74b9CMfhPTgDC4,739
 cuenca/resources/user_lists_validation.py,sha256=UrInfZRUVd4nODBIBOTH8ALEZ3pvdYS2_xfFR7UeNrc,1595
@@ -54,7 +56,7 @@ cuenca/resources/verifications.py,sha256=c90Pyd20EXLA5Wy0C1RABxjjivMB--q6yu6uK-R
 cuenca/resources/wallet_transactions.py,sha256=8ePZI3-GaEd658GPYizAfHK9GVwlkt1r95-mEb7T3Jg,1030
 cuenca/resources/webhooks.py,sha256=bGjuvkSP3GXo4Q6v8iZ40Md8xc4AQrEmAD3r40VJqxM,392
 cuenca/resources/whatsapp_transfers.py,sha256=YSL606FBOMGKjhyKK5TiF0di96zdDKoiVtjiz_Zl_ZI,902
-cuenca-2.2.0.dev3.dist-info/licenses/LICENSE,sha256=aWv5PmUiAcNENEAdghcVQSeU56pXJHWexJYgklK9XLg,1063
+cuenca-2.2.2.dist-info/licenses/LICENSE,sha256=aWv5PmUiAcNENEAdghcVQSeU56pXJHWexJYgklK9XLg,1063
 tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/conftest.py,sha256=0tgOjjZOitOvFcYU6GRJ29ySdFmDAM3FX8ZGKjJj3Ac,1828
 tests/test_cuenca.py,sha256=aeha_utz9YiHQg6eJK2PB7g66pVUYFi9U6pYMGXDKvk,1628
@@ -64,6 +66,7 @@ tests/http/conftest.py,sha256=TnVfv_s0eXC55HSJQotxIqV2Rl2WbgNt5Ow6z-ZOjZE,177
 tests/http/test_client.py,sha256=y0dhBDG4ZKbIvN_TENFGT920mzxwI535imQ99UuqgC0,2594
 tests/resources/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/resources/test_accounts.py,sha256=q7dD3k9Qj4qnl9v3aXmYSw6ShkLKD2W9FViFU_6VFeY,313
+tests/resources/test_agents.py,sha256=pE2_8QpejfTrSz8FNQCtHiFe4bZwdMAMH8CaraGzEuI,672
 tests/resources/test_api_keys.py,sha256=1ipbhYGoho_12MnM9UKr5zHNPUk7s_JCXowv5TkmKwo,2272
 tests/resources/test_arpc.py,sha256=4lRd8fO5vf8rvoh1V8Rw9qjw__fdZCeIh4IEYlU0k5o,489
 tests/resources/test_balance_entries.py,sha256=myoHpr3XSef_smUijS60EXW7YHcmr6m9b6B_BVW-JtY,643
@@ -98,7 +101,7 @@ tests/resources/test_savings.py,sha256=2qlGo9Qy_bqwYfMmjf9OsPIPVWRb6zlkzaMgg5RWE
 tests/resources/test_service_providers.py,sha256=yhjTvRdVaTpwEHLVtvX8OD6bMef2W9wUI8MRwLY-i64,563
 tests/resources/test_sessions.py,sha256=iuRYfn8QVKp_JAbfkvnAuuVnaWSNoDhutpUkMd8SUgQ,1284
 tests/resources/test_statements.py,sha256=e9S_yn5kD6M8IpfpRmIOJ0Y6aggBkYWQxynY6P7Q7nI,370
-tests/resources/test_transfers.py,sha256=bW3igYOdYPDiZtLr8WVIYwfP-dV4sdJ9pbaXFps2ac8,4161
+tests/resources/test_transfers.py,sha256=Xx9eCcE-J2RqWqvVF4LEQjvTd6_-WYP2u8-_p04DFrw,4994
 tests/resources/test_user_credentials.py,sha256=pJkIMIN4yMkj7AlaBMjI-e2O1YIoFWAh4r9C489GT7s,815
 tests/resources/test_user_events.py,sha256=aPTyrEVF7jBD8-UQZeVOLbUmj9sni0JRCYgootmaQ8c,292
 tests/resources/test_user_lists_validation.py,sha256=sZkjCYkySbWtOxM9NVSzZHaoOhXS7N0XD4buD3dke5E,1196
@@ -109,7 +112,7 @@ tests/resources/test_verifications.py,sha256=bBXR-pkmrs-_MekKo9iJS4TDkSyqZ65crsr
 tests/resources/test_wallet_transactions.py,sha256=_L2hjPHT4FwwhxksUoaoVHwFFYOGWfF4ScCbk0kb7Hw,3945
 tests/resources/test_webhooks.py,sha256=nYCqAnlNJcMJKRHhgoHOWTQnFLWQHHvFyY8GVCxGTD8,328
 tests/resources/test_whatsapp_transfers.py,sha256=4Dmrsbytx7LRrLQo9M8TAL7cGKJufPStkp51UdRCnYU,1030
-cuenca-2.2.0.dev3.dist-info/METADATA,sha256=nWEAevoa0d3g45W3PVIbXiuT_oIR837CArL7oth5j1k,4989
-cuenca-2.2.0.dev3.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-cuenca-2.2.0.dev3.dist-info/top_level.txt,sha256=5h3K7XJTmJniDloPq4sIJHni_xLw-Uoc6ZJ5mcw_lZY,13
-cuenca-2.2.0.dev3.dist-info/RECORD,,
+cuenca-2.2.2.dist-info/METADATA,sha256=Gk8mHDX_2JxLkjYf0_n2JKq5E2RxKfAf3aASZ60KwCU,4984
+cuenca-2.2.2.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+cuenca-2.2.2.dist-info/top_level.txt,sha256=5h3K7XJTmJniDloPq4sIJHni_xLw-Uoc6ZJ5mcw_lZY,13
+cuenca-2.2.2.dist-info/RECORD,,

tests/resources/test_agents.py

@@ -0,0 +1,22 @@
+import pytest
+
+from cuenca.http.client import Session
+from cuenca.resources import Agent, AgentVerification
+
+
+@pytest.mark.vcr
+def test_agent_create():
+    verification = AgentVerification.create()  # Created by user in APP
+    agent_session = Session()
+    agent_session.configure(sandbox=True)
+    agent = Agent.create(
+        pairing_code=verification.pairing_code,
+        phone_number=verification.phone_number,
+        device_info={'client': 'cursor', 'os': 'macOS'},
+        session=agent_session,
+    )
+    assert agent.id
+    assert agent.agent_verification_id == verification.id
+    assert agent.session_id
+    assert agent.user_id
+    assert agent.platform_id

tests/resources/test_transfers.py

@@ -130,3 +130,33 @@ def test_invalid_params():
     with pytest.raises(ValidationError) as e:
         Transfer.one(invalid_param='invalid_param')
     assert 'Extra inputs are not permitted' in str(e)
+
+
+@pytest.mark.vcr
+def test_transfers_update_succeeded():
+    transfer = Transfer.update('TR01', status=TransactionStatus.succeeded)
+    assert transfer.id == 'TR01'
+    assert transfer.status == TransactionStatus.succeeded
+
+
+@pytest.mark.vcr
+def test_transfers_update_failed():
+    transfer = Transfer.update('TR02', status=TransactionStatus.failed)
+    assert transfer.id == 'TR02'
+    assert transfer.status == TransactionStatus.failed
+
+
+@pytest.mark.parametrize(
+    'invalid_status',
+    [
+        TransactionStatus.created,
+        TransactionStatus.submitted,
+        TransactionStatus.in_review,
+        'cancelled',
+        'approve',
+        'reject',
+    ],
+)
+def test_transfers_update_rejects_invalid_status(invalid_status):
+    with pytest.raises(ValidationError):
+        Transfer.update('TR03', status=invalid_status)