mangopay4-python-sdk 3.54.1__tar.gz → 3.55.0__tar.gz

{mangopay4_python_sdk-3.54.1 → mangopay4_python_sdk-3.55.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mangopay4-python-sdk
-Version: 3.54.1
+Version: 3.55.0
 Summary: A client library written in python to work with mangopay v2 api
 Home-page: https://github.com/Mangopay/mangopay2-python-sdk
 Author: Mangopay (www.mangopay.com)

mangopay4_python_sdk-3.55.0/README.md

@@ -0,0 +1,127 @@
+Mangopay Python SDK
+=================================================
+
+MangopaySDK is a Python client library to work with
+[Mangopay REST API](http://docs.mangopay.com/api-references/).
+
+
+Installation
+------------
+
+mangopaysdk requires: 
+
+* [requests](https://pypi.python.org/pypi/requests)
+* [blinker](https://pypi.python.org/pypi/blinker)
+
+To install the package:
+
+```
+    pip install mangopay4-python-sdk
+```
+
+By installing this package with [pip](https://pypi.python.org/pypi/pip), all dependencies will be installed for you.
+
+
+Documentation
+-------------
+
+For documentation and examples of usage for the Mangopay API please refer to: [API references](https://docs.mangopay.com/api-references/)
+
+See [docs](https://github.com/Mangopay/mangopay2-python-sdk/blob/master/docs/usage.rst) to find examples.
+
+mTLS certificates
+-----------------
+
+### Set the base URL for mTLS
+
+Using mTLS authentication requires your integration to call a base URL with a different hostname from the standard API:
+
+* Sandbox: `https://api-mtls.sandbox.mangopay.com`
+* Production: `https://api-mtls.mangopay.com`
+
+If using mTLS, your integration should use the `api-mtls` URLs for all API calls, including OAuth token generation.
+
+**Caution:** Ensure you set the mTLS base URL, as shown in the configuration examples below. If you don’t, the mTLS certificate will not be transferred to Mangopay. When mTLS is enforced, your integration will result in an error.
+
+### Configure the SDK’s mTLS properties
+
+The Python SDK allows you to load the `.pem` and `.key` file paths in the global configuration or in the per-request handler.
+
+    | Property (global / per-request) | Type   | Description                          |
+    | ------------------------------- | ------ | ------------------------------------ |
+    | `mtls_cert` / `cert`            | string | Path to the certificate `.pem` file. |
+    | `mtls_private_key` / `key`      | string | Path to the private `.key` file.     |
+
+**Caution:** The per-request properties `cert` and `key` take precedence if set and the global ones are ignored (`mangopay.mtls_cert` and `mangopay.mtls_private_key`).
+
+The certificate files must be accessible at runtime; the SDK does not validate their content at initialization time.
+
+When both are provided, the SDK sets `session.cert = (cert, key)` on the underlying `requests.Session`. If a combined certificate is provided (bundling the key), the SDK sets `session.cert = cert`.
+
+#### Global configuration
+
+The global properties allow you to set the certificate and key before making any API calls. The certificate is used for all requests made through the default handler.
+
+```python  theme={null}
+    import mangopay
+
+    mangopay.client_id = 'your-mangopay-client-id'
+    mangopay.apikey = 'your-mangopay-api-key'
+    mangopay.api_sandbox_url = 'https://api-mtls.sandbox.mangopay.com/v2.01/'
+    sandbox = True
+    # mangopay.api_url = 'https://api-mtls.mangopay.com/v2.01/'
+    mangopay.mtls_cert = '/path/to/certificate.pem'
+    mangopay.mtls_private_key = '/path/to/private.key'
+```
+
+#### Per-request handler
+
+**Caution:** The per-request values take precedence over the global values.
+
+Each `APIRequest` instance maintains its own `requests.Session`, so mTLS certificates are scoped to that instance and do not leak between handlers.
+
+```python  theme={null}
+    from mangopay.api import APIRequest
+
+    handler = APIRequest(
+        client_id='your-mangopay-client-id',
+        apikey='your-mangopay-api-key',
+        api_sandbox_url = 'https://api-mtls.sandbox.mangopay.com/v2.01/' # mTlS base URL
+    	sandbox = True
+    	# mangopay.api_url = 'https://api-mtls.mangopay.com/v2.01/'
+        cert='/path/to/certificate.pem',
+        key='/path/to/private.key'
+    )
+```
+
+Then pass the handler when making API calls:
+
+```python  theme={null}
+    from mangopay.resources import NaturalUser, Wallet
+
+    user = NaturalUser.get(user_id, handler=handler)
+    wallet = Wallet.get(wallet_id, handler=handler)
+```
+
+License
+-------------------------------------------------
+MangopaySDK is distributed under MIT license, see LICENSE file.
+
+Contact
+-------------------------------------------------
+Report bugs or suggest features using [issue tracker at GitHub](https://github.com/Mangopay/mangopay2-python-sdk/issues).
+
+
+Account creation
+-------------------------------------------------
+You can get yourself a free sandbox account or sign up for a production account by [registering on the Mangopay site](https://www.mangopay.com/start/) (note that validation of your production account involves several steps, so think about doing it in advance of when you actually want to go live).
+
+Inspiration
+-----------
+
+The data model of python-mangopay is highly inspired by [peewee](https://github.com/coleifer/peewee).
+
+Credits
+-----------
+
+The inital basis of this SDK was generously coded and donated by [Ulule](https://www.ulule.com/)

{mangopay4_python_sdk-3.54.1 → mangopay4_python_sdk-3.55.0}/mangopay/__init__.py

@@ -6,6 +6,8 @@ temp_dir = None
 api_version = 2.01
 sandbox = True
 uk_header_flag = False
+mtls_cert = None  # Path to client certificate file for mTLS
+mtls_private_key = None  # Path to client private key file for mTLS
 
 package_version = None
 try:

{mangopay4_python_sdk-3.54.1 → mangopay4_python_sdk-3.55.0}/mangopay/api.py

@@ -30,14 +30,14 @@ except ImportError:
 
 logger = logging.getLogger('mangopay')
 
-requests_session = requests.Session()
 rate_limits = None
 
 
 class APIRequest(object):
 
     def __init__(self, client_id=None, apikey=None, api_url=None, api_sandbox_url=None, sandbox=None,
-                 timeout=30.0, storage_strategy=None, proxies=None, uk_header_flag=False):
+                 timeout=30.0, storage_strategy=None, proxies=None, uk_header_flag=False,
+                 cert=None, key=None):
         global rate_limits
         rate_limits = None
         if (sandbox is None and mangopay.sandbox) or sandbox:
@@ -52,6 +52,15 @@ class APIRequest(object):
         self.proxies = proxies
         self.uk_header_flag = uk_header_flag or mangopay.uk_header_flag
 
+        self._session = requests.Session()
+
+        _cert = cert or mangopay.mtls_cert
+        _key = key or mangopay.mtls_private_key
+        if _cert and _key:
+            self._session.cert = (_cert, _key)
+        elif _cert:
+            self._session.cert = _cert
+
     def set_rate_limit(self, rate_limit):
         global rate_limits
         rate_limits = rate_limit
@@ -124,11 +133,11 @@ class APIRequest(object):
         request_started.send(url=url, data=data, headers=headers, method=method)
 
         try:
-            result = requests_session.request(method, url,
-                                              data=data,
-                                              headers=headers,
-                                              timeout=self.timeout,
-                                              proxies=self.proxies)
+            result = self._session.request(method, url,
+                                           data=data,
+                                           headers=headers,
+                                           timeout=self.timeout,
+                                           proxies=self.proxies)
         except ConnectionError as e:
             msg = '{}'.format(e)
 
@@ -225,11 +234,11 @@ class APIRequest(object):
         request_started.send(url=url, data=None, headers=headers, method=method)
 
         try:
-            result = requests_session.request(method, url,
-                                              files=files,
-                                              headers=headers,
-                                              timeout=self.timeout,
-                                              proxies=self.proxies)
+            result = self._session.request(method, url,
+                                           files=files,
+                                           headers=headers,
+                                           timeout=self.timeout,
+                                           proxies=self.proxies)
         except ConnectionError as e:
             msg = f'{type(e).__name__}: {e}' if str(e) else type(e).__name__
             reraise_as(APIError(msg))

{mangopay4_python_sdk-3.54.1 → mangopay4_python_sdk-3.55.0}/mangopay4_python_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mangopay4-python-sdk
-Version: 3.54.1
+Version: 3.55.0
 Summary: A client library written in python to work with mangopay v2 api
 Home-page: https://github.com/Mangopay/mangopay2-python-sdk
 Author: Mangopay (www.mangopay.com)

{mangopay4_python_sdk-3.54.1 → mangopay4_python_sdk-3.55.0}/setup.py

@@ -10,7 +10,7 @@ with open(path.join(here, 'DESCRIPTION.md'), encoding='utf-8') as f:
 
 setup(
     name='mangopay4-python-sdk',
-    version='3.54.1',
+    version='3.55.0',
     description='A client library written in python to work with mangopay v2 api',
     long_description='This SDK is a client library for interacting with the Mangopay API.',
     url='https://github.com/Mangopay/mangopay2-python-sdk',

{mangopay4_python_sdk-3.54.1 → mangopay4_python_sdk-3.55.0}/tests/test_base.py

@@ -342,29 +342,38 @@ class BaseTestLive(unittest.TestCase):
                                                     postal_code='11222', country='FR')
         return user
 
+    @staticmethod
+    def get_user_legal_sca_owner_instance(bypass_sca=True):
+        user = LegalUserSca()
+        user.name = 'Alex Smith'
+        user.email = 'alex.smith.services@example.com'
+        user.legal_person_type = "SOLETRADER"
+        user.terms_and_conditions_accepted = True
+        if bypass_sca:
+            email = 'alex.smith.services+accept@example.com'
+        else:
+            email = 'alex.smith.services@example.com'
+        user.legal_representative = LegalRepresentative(first_name='Alex', last_name='Smith',
+                                                        email=email,
+                                                        phone_number='0611111111',
+                                                        phone_number_country='FR',
+                                                        birthday=652117514,
+                                                        nationality='FR',
+                                                        country_of_residence='FR')
+        user.headquarters_address = Address(address_line_1='AddressLine1', address_line_2='AddressLine2',
+                                            city='City', region='Region',
+                                            postal_code='11222', country='FR')
+        user.legal_representative_address = Address(address_line_1='AddressLine1', address_line_2='AddressLine2',
+                                                    city='City', region='Region',
+                                                    postal_code='11222', country='FR')
+        user.company_number = '123456789'
+        user.user_category = 'OWNER'
+        return user
+
     @staticmethod
     def get_user_legal_sca_owner(recreate=False):
         if BaseTestLive._user_legal_sca_owner is None or recreate:
-            user = LegalUserSca()
-            user.name = 'Alex Smith'
-            user.email = 'alex.smith.services@example.com'
-            user.legal_person_type = "SOLETRADER"
-            user.terms_and_conditions_accepted = True
-            user.legal_representative = LegalRepresentative(first_name='Alex', last_name='Smith',
-                                                             email='alex.smith.services@example.com',
-                                                             phone_number='0611111111',
-                                                             phone_number_country='FR',
-                                                             birthday=652117514,
-                                                             nationality='FR',
-                                                             country_of_residence='FR')
-            user.headquarters_address = Address(address_line_1='AddressLine1', address_line_2='AddressLine2',
-                                                 city='City', region='Region',
-                                                 postal_code='11222', country='FR')
-            user.legal_representative_address = Address(address_line_1='AddressLine1', address_line_2='AddressLine2',
-                                                         city='City', region='Region',
-                                                         postal_code='11222', country='FR')
-            user.company_number = '123456789'
-            user.user_category = 'OWNER'
+            user = BaseTestLive.get_user_legal_sca_owner_instance(False)
             BaseTestLive._user_legal_sca_owner = LegalUserSca(**user.save())
         return BaseTestLive._user_legal_sca_owner
 
@@ -453,12 +462,15 @@ class BaseTestLive(unittest.TestCase):
         return BaseTestLive._john
 
     @staticmethod
-    def get_john_instance():
+    def get_john_instance(bypass_sca=True):
         user = NaturalUser()
         user.first_name = 'John'
         user.last_name = 'Doe'
         user.birthday = 188352000
-        user.email = "john.doe@sample.org"
+        if bypass_sca:
+            user.email = "john.doe+accept@sample.org"
+        else:
+            user.email = "john.doe@sample.org"
         user.address = Address(address_line_1='AddressLine1', address_line_2='AddressLine2',
                                city='City', region='Region',
                                postal_code='11222', country='FR')
@@ -493,25 +505,33 @@ class BaseTestLive(unittest.TestCase):
                                postal_code='11222', country='FR')
         return user
 
+    @staticmethod
+    def get_john_sca_owner_instance(bypass_sca=True):
+        user = NaturalUserSca()
+        user.first_name = 'John SCA'
+        user.last_name = 'Doe SCA Review'
+        user.birthday = 188352000
+        if bypass_sca:
+            user.email = "john.doe.sca+accept@sample.org"
+        else:
+            user.email = "john.doe.sca@sample.org"
+        user.address = Address(address_line_1='AddressLine1', address_line_2='AddressLine2',
+                               city='City', region='Region',
+                               postal_code='11222', country='FR')
+        user.nationality = 'FR'
+        user.country_of_residence = 'FR'
+        user.occupation = 'programmer'
+        user.income_range = '1'
+        user.terms_and_conditions_accepted = True
+        user.user_category = 'OWNER'
+        user.phone_number = '+33611111111'
+        user.phone_number_country = 'FR'
+        return user
+
     @staticmethod
     def get_john_sca_owner(recreate=False):
         if BaseTestLive._john_sca_owner is None or recreate:
-            user = NaturalUserSca()
-            user.first_name = 'John SCA'
-            user.last_name = 'Doe SCA Review'
-            user.birthday = 188352000
-            user.email = "john.doe.sca@sample.org"
-            user.address = Address(address_line_1='AddressLine1', address_line_2='AddressLine2',
-                                   city='City', region='Region',
-                                   postal_code='11222', country='FR')
-            user.nationality = 'FR'
-            user.country_of_residence = 'FR'
-            user.occupation = 'programmer'
-            user.income_range = '1'
-            user.terms_and_conditions_accepted = True
-            user.user_category = 'OWNER'
-            user.phone_number = '+33611111111'
-            user.phone_number_country = 'FR'
+            user = BaseTestLive.get_john_sca_owner_instance(False)
             BaseTestLive._john_sca_owner = NaturalUserSca(**user.save())
         return BaseTestLive._john_sca_owner
 
@@ -605,8 +625,10 @@ class BaseTestLive(unittest.TestCase):
 
     @staticmethod
     def get_johns_transfer_sca(sca_context, amount):
-        valid_john_sca_id = 'user_m_01JRG5WE99JYRCEBHZ8EKBRE8Y'
-        valid_matrix_sca_id = 'user_m_01JRG4ZWZ85RNZDKKTSFRMG6ZW'
+        john_sca_dto = BaseTestLive.get_john_sca_owner_instance(True)
+        matrix_sca_dto = BaseTestLive.get_user_legal_sca_owner_instance(True)
+        valid_john_sca_id = NaturalUserSca(**john_sca_dto.save()).id
+        valid_matrix_sca_id = LegalUserSca(**matrix_sca_dto.save()).id
         john_sca = NaturalUserSca.get(valid_john_sca_id)
         matrix_sca = LegalUserSca.get(valid_matrix_sca_id)
 

{mangopay4_python_sdk-3.54.1 → mangopay4_python_sdk-3.55.0}/tests/test_conversion.py

@@ -1,5 +1,5 @@
 from mangopay.resources import ConversionQuote, QuotedConversion, InstantConversion, ClientWalletsQuotedConversion, \
-    ClientWalletsInstantConversion
+    ClientWalletsInstantConversion, NaturalUser
 from mangopay.utils import Money, CustomFees, UserMargin
 from tests.resources import ConversionRate, Conversion, Wallet
 from tests.test_base import BaseTestLive

{mangopay4_python_sdk-3.54.1 → mangopay4_python_sdk-3.55.0}/tests/test_payins.py

@@ -2228,6 +2228,7 @@ class PayInsTestLive(BaseTestLive):
         self.assertIsNotNone(mit_card_info)
         self.assertIsInstance(mit_card_info, CardInfo)
 
+    @unittest.skip("Endpoint removed")
     def test_PayIns_Payconiq_Web_Create(self):
         user = BaseTestLive.get_john(True)
 

{mangopay4_python_sdk-3.54.1 → mangopay4_python_sdk-3.55.0}/tests/test_users.py

@@ -955,7 +955,8 @@ class PayInsTestLive(BaseTestLive):
         self.assertEqual('CLOSED', closed.user_status)
 
     def test_users_GetTransactionsSca(self):
-        user = BaseTestLive.get_john()
+        user_dto = BaseTestLive.get_john_instance(False)
+        user = NaturalUser(**user_dto.save())
         with self.assertRaises(APIError):
             Transaction.all(**{"user_id": user.id, "ScaContext": 'USER_PRESENT'})
         try:

{mangopay4_python_sdk-3.54.1 → mangopay4_python_sdk-3.55.0}/tests/test_wallets.py

@@ -337,7 +337,9 @@ class WalletsTestLive(BaseTestLive):
         self.assertEqual(wallet.id, fetched.id)
 
     def test_Wallets_getSca(self):
-        wallet = BaseTestLive.get_johns_wallet()
+        user_dto = BaseTestLive.get_john_instance(False)
+        user = NaturalUser(**user_dto.save())
+        wallet = BaseTestLive.create_new_wallet(user)
         with self.assertRaises(APIError):
             Wallet.get(wallet.id, ScaContext='USER_PRESENT')
         try:

mangopay4_python_sdk-3.54.1/README.md

@@ -1,53 +0,0 @@
-Mangopay Python SDK
-=================================================
-
-MangopaySDK is a Python client library to work with
-[Mangopay REST API](http://docs.mangopay.com/api-references/).
-
-
-Installation
-------------
-
-mangopaysdk requires: 
-
-* [requests](https://pypi.python.org/pypi/requests)
-* [blinker](https://pypi.python.org/pypi/blinker)
-
-To install the package:
-
-```
-    pip install mangopay4-python-sdk
-```
-
-By installing this package with [pip](https://pypi.python.org/pypi/pip), all dependencies will be installed for you.
-
-
-Documentation
--------------
-
-For documentation and examples of usage for the Mangopay API please refer to: [API references](https://docs.mangopay.com/api-references/)
-
-See [docs](https://github.com/Mangopay/mangopay2-python-sdk/blob/master/docs/usage.rst) to find examples.
-
-License
--------------------------------------------------
-MangopaySDK is distributed under MIT license, see LICENSE file.
-
-Contact
--------------------------------------------------
-Report bugs or suggest features using [issue tracker at GitHub](https://github.com/Mangopay/mangopay2-python-sdk/issues).
-
-
-Account creation
--------------------------------------------------
-You can get yourself a free sandbox account or sign up for a production account by [registering on the Mangopay site](https://www.mangopay.com/start/) (note that validation of your production account involves several steps, so think about doing it in advance of when you actually want to go live).
-
-Inspiration
------------
-
-The data model of python-mangopay is highly inspired by [peewee](https://github.com/coleifer/peewee).
-
-Credits
------------
-
-The inital basis of this SDK was generously coded and donated by [Ulule](https://www.ulule.com/)