KYC Verifications 🥇 (#263)

* KYC Verifications: First Approach

* Curp added

* KYCVerifications done and tested

* Casette

* Receiving address. New pre release

* fix

* kyc verifications

Co-authored-by: AlexViquez <alexviquez22@gmail.com>

Author: andreshndz

cuenca/__init__.py

@@ -17,6 +17,7 @@
     'FileBatch',
     'Identity',
     'IdentityEvent',
+    'KYCVerification',
     'LimitedWallet',
     'LoginToken',
     'Saving',
@@ -57,6 +58,7 @@
     FileBatch,
     Identity,
     IdentityEvent,
+    KYCVerification,
     LimitedWallet,
     LoginToken,
     Saving,

cuenca/resources/__init__.py

@@ -16,6 +16,7 @@
     'FileBatch',
     'Identity',
     'IdentityEvent',
+    'KYCVerification',
     'LimitedWallet',
     'LoginToken',
     'Saving',
@@ -49,6 +50,7 @@
 from .files import File
 from .identities import Identity
 from .identity_events import IdentityEvent
+from .kyc_verifications import KYCVerification
 from .limited_wallets import LimitedWallet
 from .login_tokens import LoginToken
 from .resources import RESOURCES
@@ -85,6 +87,7 @@
     FileBatch,
     Identity,
     IdentityEvent,
+    KYCVerification,
     LimitedWallet,
     LoginToken,
     Saving,

cuenca/resources/kyc_verifications.py

@@ -0,0 +1,25 @@
+import datetime as dt
+from typing import ClassVar, Optional, cast
+
+from cuenca_validations.types import Address, CurpField, Rfc
+from pydantic.dataclasses import dataclass
+
+from ..http import Session, session as global_session
+from .base import Creatable, Retrievable
+
+
+@dataclass
+class KYCVerification(Creatable, Retrievable):
+    _resource: ClassVar = 'kyc_verifications'
+
+    platform_id: str
+    created_at: dt.datetime
+    deactivated_at: Optional[dt.datetime]
+    verification_id: Optional[str]
+    curp: Optional[CurpField] = None
+    rfc: Optional[Rfc] = None
+    address: Optional[Address] = None
+
+    @classmethod
+    def create(cls, session: Session = global_session) -> 'KYCVerification':
+        return cast('KYCVerification', cls._create(session=session))

cuenca/resources/users.py

@@ -82,6 +82,7 @@ def update(
         proof_of_address: Optional[KYCFileUpdateRequest] = None,
         proof_of_life: Optional[KYCFileUpdateRequest] = None,
         terms_of_service: Optional[TOSUpdateRequest] = None,
+        verification_id: Optional[str] = None,
         *,
         session: Session = global_session,
     ):
@@ -95,6 +96,7 @@ def update(
             proof_of_address=proof_of_address,
             proof_of_life=proof_of_life,
             terms_of_service=terms_of_service,
+            verification_id=verification_id,
         )
         return cast(
             'User',

cuenca/version.py

@@ -1,3 +1,3 @@
-__version__ = '0.9.2'
+__version__ = '0.9.3'
 CLIENT_VERSION = __version__
 API_VERSION = '2020-03-19'

tests/resources/cassettes/test_kyc_verification_create.yaml

@@ -0,0 +1,50 @@
+interactions:
+- request:
+    body: '{}'
+    headers:
+      Accept:
+      - '*/*'
+      Accept-Encoding:
+      - gzip, deflate
+      Authorization:
+      - DUMMY
+      Connection:
+      - keep-alive
+      Content-Length:
+      - '2'
+      Content-Type:
+      - application/json
+      User-Agent:
+      - cuenca-python/0.9.2
+      X-Cuenca-Api-Version:
+      - '2020-03-19'
+    method: POST
+    uri: https://sandbox.cuenca.com/kyc_verifications
+  response:
+    body:
+      string: '{"id":"KYCY01","identity_id":null,"platform_id":"PT01","created_at":"2022-05-04T21:49:28.696688","updated_at":"2022-05-04T21:49:28.697159","deactivated_at":null,"verification_id":null,"curp":null,"rfc":null,"address":null}'
+    headers:
+      Connection:
+      - keep-alive
+      Content-Length:
+      - '246'
+      Content-Type:
+      - application/json
+      Date:
+      - Wed, 04 May 2022 21:49:28 GMT
+      x-amz-apigw-id:
+      - Rns0XHhNCYcFwdg=
+      x-amzn-Remapped-Connection:
+      - keep-alive
+      x-amzn-Remapped-Content-Length:
+      - '246'
+      x-amzn-Remapped-Date:
+      - Wed, 04 May 2022 21:49:28 GMT
+      x-amzn-Remapped-Server:
+      - nginx/1.20.2
+      x-amzn-RequestId:
+      - d2c3bb25-34c1-4858-9de2-d1b4e60d2c81
+    status:
+      code: 201
+      message: Created
+version: 1

tests/resources/cassettes/test_kyc_verification_retrieve.yaml

@@ -0,0 +1,46 @@
+interactions:
+- request:
+    body: null
+    headers:
+      Accept:
+      - '*/*'
+      Accept-Encoding:
+      - gzip, deflate
+      Authorization:
+      - DUMMY
+      Connection:
+      - keep-alive
+      User-Agent:
+      - cuenca-python/0.9.2
+      X-Cuenca-Api-Version:
+      - '2020-03-19'
+    method: GET
+    uri: https://sandbox.cuenca.com/kyc_verifications/KYC01
+  response:
+    body:
+      string: '{"id":"KYC01","identity_id":null,"platform_id":"PT01","created_at":"2022-05-04T21:27:15.954000","updated_at":"2022-05-04T21:27:15.954000","deactivated_at":null,"verification_id":null,"curp":null,"rfc":null,"address":null}'
+    headers:
+      Connection:
+      - keep-alive
+      Content-Length:
+      - '246'
+      Content-Type:
+      - application/json
+      Date:
+      - Wed, 04 May 2022 21:49:29 GMT
+      x-amz-apigw-id:
+      - Rns0cHpJiYcF_OQ=
+      x-amzn-Remapped-Connection:
+      - keep-alive
+      x-amzn-Remapped-Content-Length:
+      - '246'
+      x-amzn-Remapped-Date:
+      - Wed, 04 May 2022 21:49:29 GMT
+      x-amzn-Remapped-Server:
+      - nginx/1.20.2
+      x-amzn-RequestId:
+      - 071182a0-b23e-47f0-bb92-68fdc35ec070
+    status:
+      code: 200
+      message: OK
+version: 1

tests/resources/test_kyc_verifications.py

@@ -0,0 +1,15 @@
+import pytest
+
+from cuenca import KYCVerification
+
+
+@pytest.mark.vcr
+def test_kyc_verification_create():
+    kyc_verification: KYCVerification = KYCVerification.create()
+    assert kyc_verification.id
+
+
+@pytest.mark.vcr
+def test_kyc_verification_retrieve():
+    kyc_verification: KYCVerification = KYCVerification.retrieve('KYC01')
+    assert kyc_verification.id