mangopay4-python-sdk 3.59.0__tar.gz → 4.0.0__tar.gz

mangopay4_python_sdk-4.0.0/PKG-INFO

@@ -0,0 +1,182 @@
+Metadata-Version: 2.4
+Name: mangopay4-python-sdk
+Version: 4.0.0
+Summary: A client library written in python to work with mangopay v2 api
+License-Expression: MIT
+License-File: LICENSE
+Keywords: mangopay,api,development,emoney,sdk
+Author: Mangopay (www.mangopay.com)
+Author-email: support@mangopay.com
+Requires-Python: >=3.10,<3.15
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Provides-Extra: dev
+Provides-Extra: test
+Requires-Dist: blinker (>=1.9.0,<2)
+Requires-Dist: coverage (==7.14.0) ; extra == "dev"
+Requires-Dist: coverage (==7.14.0) ; extra == "test"
+Requires-Dist: exam (==0.10.6) ; extra == "dev"
+Requires-Dist: exam (==0.10.6) ; extra == "test"
+Requires-Dist: httplib2 (==0.31.2) ; extra == "dev"
+Requires-Dist: httplib2 (==0.31.2) ; extra == "test"
+Requires-Dist: ndg-httpsclient (==0.5.1) ; extra == "dev"
+Requires-Dist: ndg-httpsclient (==0.5.1) ; extra == "test"
+Requires-Dist: pyasn1 (==0.6.3) ; extra == "dev"
+Requires-Dist: pyasn1 (==0.6.3) ; extra == "test"
+Requires-Dist: pynose (==1.5.5) ; extra == "dev"
+Requires-Dist: pynose (==1.5.5) ; extra == "test"
+Requires-Dist: pyopenssl (==26.1.0) ; extra == "dev"
+Requires-Dist: pyopenssl (==26.1.0) ; extra == "test"
+Requires-Dist: pytz (>=2026.2)
+Requires-Dist: requests (>=2.34.2,<3)
+Requires-Dist: responses (==0.26.0) ; extra == "dev"
+Requires-Dist: responses (==0.26.0) ; extra == "test"
+Requires-Dist: simplejson (>=3.20.2,<4)
+Requires-Dist: six (>=1.17.0,<2)
+Description-Content-Type: text/markdown
+
+Mangopay Python SDK
+=================================================
+
+MangopaySDK is a Python client library to work with
+[Mangopay REST API](http://docs.mangopay.com/api-references/).
+
+
+Installation
+------------
+
+mangopaysdk requires Python >=3.10,<3.15 and the following runtime dependencies:
+
+* [requests](https://pypi.python.org/pypi/requests)
+* [simplejson](https://pypi.python.org/pypi/simplejson)
+* [blinker](https://pypi.python.org/pypi/blinker)
+* [six](https://pypi.python.org/pypi/six)
+* [pytz](https://pypi.python.org/pypi/pytz)
+
+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.
+
+### Development install
+
+The project is managed with [Poetry](https://python-poetry.org/). To set up a local development environment:
+
+```
+    poetry install --extras dev
+```
+
+This installs the runtime dependencies as well as the `dev` extras (test runner, coverage, mocking, TLS helpers) defined in `pyproject.toml`. The resolved versions are pinned in `poetry.lock`.
+
+To run the test suite (same command used in CI):
+
+```
+    poetry run coverage run -m unittest discover
+    poetry run coverage xml
+```
+
+
+Documentation
+-------------
+
+For documentation and examples of usage for the Mangopay API please refer to: [API references](https://docs.mangopay.com/api-references/)
+
+See the `docs/` directory 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.
+
+
+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.59.0 → mangopay4_python_sdk-4.0.0}/README.md

@@ -8,10 +8,13 @@ MangopaySDK is a Python client library to work with
 Installation
 ------------
 
-mangopaysdk requires: 
+mangopaysdk requires Python >=3.10,<3.15 and the following runtime dependencies:
 
 * [requests](https://pypi.python.org/pypi/requests)
+* [simplejson](https://pypi.python.org/pypi/simplejson)
 * [blinker](https://pypi.python.org/pypi/blinker)
+* [six](https://pypi.python.org/pypi/six)
+* [pytz](https://pypi.python.org/pypi/pytz)
 
 To install the package:
 
@@ -21,13 +24,30 @@ To install the package:
 
 By installing this package with [pip](https://pypi.python.org/pypi/pip), all dependencies will be installed for you.
 
+### Development install
+
+The project is managed with [Poetry](https://python-poetry.org/). To set up a local development environment:
+
+```
+    poetry install --extras dev
+```
+
+This installs the runtime dependencies as well as the `dev` extras (test runner, coverage, mocking, TLS helpers) defined in `pyproject.toml`. The resolved versions are pinned in `poetry.lock`.
+
+To run the test suite (same command used in CI):
+
+```
+    poetry run coverage run -m unittest discover
+    poetry run coverage xml
+```
+
 
 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.
+See the `docs/` directory to find examples.
 
 mTLS certificates
 -----------------
@@ -107,14 +127,6 @@ 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
 -----------

{mangopay4_python_sdk-3.59.0 → mangopay4_python_sdk-4.0.0}/mangopay/fields.py

@@ -16,7 +16,7 @@ from .utils import timestamp_from_datetime, timestamp_from_date, Money, DebitedB
     CompanyNumberValidation, ReportFilter, PayInIntentExternalData, PayInIntentBuyer, SupportedBank, \
     VerificationOfPayee, PayInIntentRefund, PayInIntentCapture, PayInIntentDispute, CustomFees, MarginsResponse, \
     UserMargin, ConsentScope, AuthenticationResult, FlowDescriptor, SettlementFooterError, SettlementLineError, \
-    SettlementLineErrorDetail
+    SettlementLineErrorDetail, AccountFunding, AccountFundingSender, KycInformation
 
 
 class FieldDescriptor(object):
@@ -840,6 +840,26 @@ class ScopeBlockedField(Field):
         return value
 
 
+class KycInformationField(Field):
+    def python_value(self, value):
+        if value is not None:
+            return KycInformation(last_kyc_date=value['LastKycDate'],
+                                  kyc_renewal_deadline=value['KycRenewalDeadline'])
+
+        return value
+
+    def api_value(self, value):
+        value = super(KycInformationField, self).api_value(value)
+
+        if isinstance(value, KycInformation):
+            value = {
+                'LastKycDate': value.last_kyc_date,
+                'KycRenewalDeadline': value.kyc_renewal_deadline,
+            }
+
+        return value
+
+
 class ShippingField(Field):
     def python_value(self, value):
         if value is not None:
@@ -1599,4 +1619,34 @@ class SettlementLinesErrorsField(Field):
 
         return value
 
+
+class AccountFundingField(Field):
+    def python_value(self, value):
+        if isinstance(value, dict):
+            return AccountFunding(sender=self._to_sender(value.get('Sender', None)),
+                                  purpose=value.get('Purpose', None),
+                                  type=value.get('Type', None))
+
+        return value
+
+    @staticmethod
+    def _to_sender(value):
+        if isinstance(value, dict):
+            return AccountFundingSender(first_name=value.get('FirstName', None),
+                                        last_name=value.get('LastName', None),
+                                        address=value.get('Address', None),
+                                        email=value.get('Email', None),
+                                        birthday=value.get('Birthday', None),
+                                        nationality=value.get('Nationality', None),
+                                        occupation=value.get('Occupation', None),
+                                        birth_country=value.get('BirthCountry', None))
+
+        return value
+
+    def api_value(self, value):
+        value = super(AccountFundingField, self).api_value(value)
+
+        if isinstance(value, AccountFunding):
+            return value.to_api_json()
+
         return value

{mangopay4_python_sdk-3.59.0 → mangopay4_python_sdk-4.0.0}/mangopay/resources.py

@@ -22,7 +22,8 @@ from .fields import (PrimaryKeyField, EmailField, CharField,
                      PayInIntentExternalDataField, PayInIntentBuyerField, SupportedBanksField, VerificationOfPayeeField,
                      PayInIntentRefundField, PayInIntentCaptureField, PayInIntentDisputeField, CustomFeesField,
                      UserMarginField, MarginsResponseField, ConsentScopeField, AuthenticationResultField,
-                     FlowDescriptorField, SettlementFooterErrorsField, SettlementLinesErrorsField)
+                     FlowDescriptorField, SettlementFooterErrorsField, SettlementLinesErrorsField,
+                     AccountFundingField, KycInformationField)
 from .query import InsertQuery, UpdateQuery, SelectQuery, ActionQuery, DeleteQuery
 
 
@@ -1341,6 +1342,7 @@ class DirectPayIn(PayIn):
     preferred_card_network = CharField(api_name='PreferredCardNetwork')
     card_info = CardInfoField(api_name='CardInfo')
     payment_category = CharField(api_name='PaymentCategory')
+    account_funding = AccountFundingField(api_name='AccountFunding')
 
     class Meta:
         verbose_name = 'payin'
@@ -3036,6 +3038,7 @@ class Ubo(BaseModel):
 class UserBlockStatus(BaseModel):
     scope_blocked = ScopeBlockedField(api_name='ScopeBlocked', required=True)
     action_code = CharField(api_name='ActionCode', required=True)
+    kyc_information = KycInformationField(api_name='KycInformation')
 
     class Meta:
         verbose_name = 'userblockstatus'

{mangopay4_python_sdk-3.59.0 → mangopay4_python_sdk-4.0.0}/mangopay/utils.py

@@ -570,6 +570,53 @@ class Shipping(object):
             (self.first_name, self.last_name, self.address)
 
 
+@add_camelcase_aliases
+class AccountFundingSender(object):
+    def __init__(self, first_name=None, last_name=None, address=None, email=None, birthday=None,
+                 nationality=None, occupation=None, birth_country=None):
+        self.first_name = first_name
+        self.last_name = last_name
+        self.address = address
+        self.email = email
+        self.birthday = birthday
+        self.nationality = nationality
+        self.occupation = occupation
+        self.birth_country = birth_country
+
+    def __str__(self):
+        return 'AccountFundingSender: %s %s' % (self.first_name, self.last_name)
+
+    def to_api_json(self):
+        return {
+            'FirstName': self.first_name,
+            'LastName': self.last_name,
+            'Address': self.address,
+            'Email': self.email,
+            'Birthday': self.birthday,
+            'Nationality': self.nationality,
+            'Occupation': self.occupation,
+            'BirthCountry': self.birth_country
+        }
+
+
+@add_camelcase_aliases
+class AccountFunding(object):
+    def __init__(self, sender=None, purpose=None, type=None):
+        self.sender = sender
+        self.purpose = purpose
+        self.type = type
+
+    def __str__(self):
+        return 'AccountFunding: %s, %s' % (self.purpose, self.type)
+
+    def to_api_json(self):
+        return {
+            'Sender': self.sender,
+            'Purpose': self.purpose,
+            'Type': self.type
+        }
+
+
 @add_camelcase_aliases
 class CurrentState(object):
     def __init__(self, payins_linked=None, cumulated_debited_amount=None, cumulated_debited_fees=None,
@@ -607,6 +654,29 @@ class ScopeBlocked(object):
         }
 
 
+@add_camelcase_aliases
+class KycInformation(object):
+    def __init__(self, last_kyc_date=None, kyc_renewal_deadline=None):
+        self.last_kyc_date = last_kyc_date
+        self.kyc_renewal_deadline = kyc_renewal_deadline
+
+    def __str__(self):
+        return 'KycInformation: %s, %s' % (self.last_kyc_date, self.kyc_renewal_deadline)
+
+    def __eq__(self, other):
+        if isinstance(other, KycInformation):
+            stat = ((self.last_kyc_date == other.last_kyc_date) and
+                    (self.kyc_renewal_deadline == other.kyc_renewal_deadline))
+            return stat
+        return False
+
+    def to_api_json(self):
+        return {
+            "LastKycDate": self.last_kyc_date,
+            "KycRenewalDeadline": self.kyc_renewal_deadline,
+        }
+
+
 # This code belongs to https://github.com/carljm/django-model-utils
 class Choices(object):
     """

mangopay4_python_sdk-4.0.0/pyproject.toml

@@ -0,0 +1,57 @@
+[build-system]
+requires = ["poetry-core>=2.0.0,<3.0.0"]
+build-backend = "poetry.core.masonry.api"
+
+[project]
+name = "mangopay4-python-sdk"
+version = "4.0.0"
+description = "A client library written in python to work with mangopay v2 api"
+readme = "README.md"
+license = "MIT"
+authors = [
+    { name = "Mangopay (www.mangopay.com)", email = "support@mangopay.com" },
+]
+requires-python = ">=3.10,<3.15"
+keywords = ["mangopay", "api", "development", "emoney", "sdk"]
+classifiers = [
+    "Intended Audience :: Developers",
+    "Topic :: Software Development :: Build Tools",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14"
+]
+dependencies = [
+    "requests>=2.34.2,<3",
+    "simplejson>=3.20.2,<4",
+    "blinker>=1.9.0,<2",
+    "six>=1.17.0,<2",
+    "pytz>=2026.2",
+]
+
+[project.optional-dependencies]
+dev = [
+    "responses==0.26.0",
+    "pynose==1.5.5",
+    "coverage==7.14.0",
+    "exam==0.10.6",
+    "httplib2==0.31.2",
+    "pyopenssl==26.1.0",
+    "ndg-httpsclient==0.5.1",
+    "pyasn1==0.6.3",
+]
+test = [
+    "responses==0.26.0",
+    "pynose==1.5.5",
+    "coverage==7.14.0",
+    "exam==0.10.6",
+    "httplib2==0.31.2",
+    "pyopenssl==26.1.0",
+    "ndg-httpsclient==0.5.1",
+    "pyasn1==0.6.3",
+]
+
+[tool.poetry]
+packages = [{ include = "mangopay" }]
+

mangopay4_python_sdk-3.59.0/DESCRIPTION.md

@@ -1 +0,0 @@
-This SDK is a client library for interacting with the Mangopay API.

mangopay4_python_sdk-3.59.0/MANIFEST.in

@@ -1,8 +0,0 @@
-include LICENSE
-include MANIFEST.in
-include README.md
-include DESCRIPTION.md
-include Makefile
-
-recursive-include mangopay *
-recursive-include tests *

mangopay4_python_sdk-3.59.0/Makefile

@@ -1,8 +0,0 @@
-install:
-	pip install -r requirements/base.txt
-
-test:
-	nosetests -s tests --with-coverage --cover-erase --cover-package=tests
-
-release:
-	python setup.py sdist register upload -s

mangopay4_python_sdk-3.59.0/PKG-INFO

@@ -1,53 +0,0 @@
-Metadata-Version: 2.4
-Name: mangopay4-python-sdk
-Version: 3.59.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)
-Author-email: support@mangopay.com
-License: MIT
-Keywords: mangopay api development emoney sdk
-Classifier: Intended Audience :: Developers
-Classifier: Topic :: Software Development :: Build Tools
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-License-File: LICENSE
-Requires-Dist: requests
-Requires-Dist: simplejson
-Requires-Dist: blinker
-Requires-Dist: six
-Requires-Dist: pytz
-Provides-Extra: dev
-Requires-Dist: responses; extra == "dev"
-Requires-Dist: nose; extra == "dev"
-Requires-Dist: coverage; extra == "dev"
-Requires-Dist: httplib2; extra == "dev"
-Requires-Dist: pyopenssl; extra == "dev"
-Requires-Dist: ndg-httpsclient; extra == "dev"
-Requires-Dist: pyasn1; extra == "dev"
-Requires-Dist: exam; extra == "dev"
-Provides-Extra: test
-Requires-Dist: responses; extra == "test"
-Requires-Dist: nose; extra == "test"
-Requires-Dist: coverage; extra == "test"
-Requires-Dist: httplib2; extra == "test"
-Requires-Dist: pyopenssl; extra == "test"
-Requires-Dist: ndg-httpsclient; extra == "test"
-Requires-Dist: pyasn1; extra == "test"
-Requires-Dist: exam; extra == "test"
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: home-page
-Dynamic: keywords
-Dynamic: license
-Dynamic: license-file
-Dynamic: provides-extra
-Dynamic: requires-dist
-Dynamic: summary
-
-This SDK is a client library for interacting with the Mangopay API.

mangopay4_python_sdk-3.59.0/mangopay4_python_sdk.egg-info/PKG-INFO

@@ -1,53 +0,0 @@
-Metadata-Version: 2.4
-Name: mangopay4-python-sdk
-Version: 3.59.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)
-Author-email: support@mangopay.com
-License: MIT
-Keywords: mangopay api development emoney sdk
-Classifier: Intended Audience :: Developers
-Classifier: Topic :: Software Development :: Build Tools
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-License-File: LICENSE
-Requires-Dist: requests
-Requires-Dist: simplejson
-Requires-Dist: blinker
-Requires-Dist: six
-Requires-Dist: pytz
-Provides-Extra: dev
-Requires-Dist: responses; extra == "dev"
-Requires-Dist: nose; extra == "dev"
-Requires-Dist: coverage; extra == "dev"
-Requires-Dist: httplib2; extra == "dev"
-Requires-Dist: pyopenssl; extra == "dev"
-Requires-Dist: ndg-httpsclient; extra == "dev"
-Requires-Dist: pyasn1; extra == "dev"
-Requires-Dist: exam; extra == "dev"
-Provides-Extra: test
-Requires-Dist: responses; extra == "test"
-Requires-Dist: nose; extra == "test"
-Requires-Dist: coverage; extra == "test"
-Requires-Dist: httplib2; extra == "test"
-Requires-Dist: pyopenssl; extra == "test"
-Requires-Dist: ndg-httpsclient; extra == "test"
-Requires-Dist: pyasn1; extra == "test"
-Requires-Dist: exam; extra == "test"
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: home-page
-Dynamic: keywords
-Dynamic: license
-Dynamic: license-file
-Dynamic: provides-extra
-Dynamic: requires-dist
-Dynamic: summary
-
-This SDK is a client library for interacting with the Mangopay API.