Add PhoneVerificationAssociation resource

Author: gmorales96

cuenca/__init__.py

@@ -46,6 +46,7 @@
     'UserTOSAgreement',
     'PostalCodes',
     'ExistPhone',
+    'PhoneVerificationAssociation',
 ]
 
 from . import http
@@ -75,6 +76,7 @@
     LimitedWallet,
     LoginToken,
     Otp,
+    PhoneVerificationAssociation,
     Platform,
     PostalCodes,
     Questionnaires,

cuenca/resources/__init__.py

@@ -24,6 +24,7 @@
     'LoginToken',
     'Otp',
     'Platform',
+    'PhoneVerificationAssociation',
     'Questionnaires',
     'Saving',
     'ServiceProvider',
@@ -69,6 +70,7 @@
 from .limited_wallets import LimitedWallet
 from .login_tokens import LoginToken
 from .otps import Otp
+from .phone_verification_association import PhoneVerificationAssociation
 from .platforms import Platform
 from .postal_codes import PostalCodes
 from .questionnaires import Questionnaires
@@ -134,6 +136,7 @@
     JwtToken,
     TermsOfService,
     UserTOSAgreement,
+    PhoneVerificationAssociation,
 ]
 for resource_cls in resource_classes:
     RESOURCES[resource_cls._resource] = resource_cls  # type: ignore

cuenca/resources/phone_verification_association.py

@@ -0,0 +1,26 @@
+import datetime as dt
+from typing import ClassVar
+
+from cuenca_validations.types.requests import (
+    PhoneVerificationAssociationRequest,
+)
+
+from ..http import Session, session as global_session
+from .base import Creatable
+
+
+class PhoneVerificationAssociation(Creatable):
+    _resource: ClassVar = 'phone_verification_association'
+
+    verification_id: str
+    user_id: str
+    created_at: dt.datetime
+
+    @classmethod
+    def create(
+        cls, verification_id: str, session: Session = global_session
+    ) -> 'PhoneVerificationAssociation':
+        req = PhoneVerificationAssociationRequest(
+            verification_id=verification_id
+        )
+        return cls._create(session=session, **req.model_dump())

cuenca/version.py

@@ -1,3 +1,3 @@
-__version__ = '2.1.7'
+__version__ = '2.1.8.dev1'
 CLIENT_VERSION = __version__
 API_VERSION = '2020-03-19'

requirements.txt

@@ -1,3 +1,3 @@
 requests==2.32.3
-cuenca-validations==2.1.11
+cuenca-validations==2.1.12.dev1
 pydantic-extra-types==2.10.2

tests/resources/cassettes/test_phone_verification_association_create.yaml

@@ -0,0 +1,46 @@
+interactions:
+- request:
+    body: '{"verification_id": "VEeCjasQQWQM-Hr-odTGoKoQ"}'
+    headers:
+      Authorization:
+      - DUMMY
+      Content-Length:
+      - '47'
+      Content-Type:
+      - application/json
+      User-Agent:
+      - cuenca-python/2.1.7
+      X-Cuenca-Api-Version:
+      - '2020-03-19'
+    method: POST
+    uri: https://sandbox.cuenca.com/phone_verification_association
+  response:
+    body:
+      string: '{"id":"PVuzCh7IsESSyGxyMdjgRY3A","verification_id":"VEeCjasQQWQM-Hr-odTGoKoQ","user_id":"USS2gTzkh_Sm2ZPZGtfNOK_Q","created_at":"2025-07-21T17:07:04.776955"}'
+    headers:
+      Connection:
+      - keep-alive
+      Content-Length:
+      - '157'
+      Content-Type:
+      - application/json
+      Date:
+      - Mon, 21 Jul 2025 17:07:04 GMT
+      X-Request-Time:
+      - 'value: 0.487'
+      x-amz-apigw-id:
+      - OEcE3FGUCYcEvbw=
+      x-amzn-Remapped-Connection:
+      - keep-alive
+      x-amzn-Remapped-Content-Length:
+      - '157'
+      x-amzn-Remapped-Date:
+      - Mon, 21 Jul 2025 17:07:04 GMT
+      x-amzn-Remapped-Server:
+      - nginx/1.28.0
+      x-amzn-RequestId:
+      - f10e5016-1ce3-429d-9d00-027a4d018c71
+    status:
+      code: 201
+      message: Created
+version: 1

tests/resources/test_phone_verification_association.py

@@ -0,0 +1,13 @@
+import pytest
+
+from cuenca import PhoneVerificationAssociation
+
+
+@pytest.mark.vcr
+def test_phone_verification_association_create():
+
+    phone_verification_association = PhoneVerificationAssociation.create(
+        verification_id='VEeCjasQQWQM-Hr-odTGoKoQ',
+    )
+    assert phone_verification_association.verification_id
+    assert phone_verification_association.user_id