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

{mangopay4_python_sdk-3.57.0 → mangopay4_python_sdk-3.59.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mangopay4-python-sdk
-Version: 3.57.0
+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)

{mangopay4_python_sdk-3.57.0 → mangopay4_python_sdk-3.59.0}/mangopay/constants.py

@@ -223,6 +223,17 @@ EVENT_TYPE_CHOICES = Choices(
     ('IDENTITY_VERIFICATION_OUTDATED', 'identity_verification_outdated', 'Identity Verification Outdated'),
     ('IDENTITY_VERIFICATION_TIMEOUT', 'identity_verification_timeout', 'Identity Verification Timeout'),
     ('IDENTITY_VERIFICATION_PENDING', 'identity_verification_pending', 'Identity Verification Pending'),
+    ('IDENTITY_VERIFICATION_EXPIRED', 'identity_verification_expired', 'Identity Verification Expired'),
+    ('IDENTITY_VERIFICATION_PENDING_PSC_ACTION', 'identity_verification_pending_psc_action',
+     'Identity Verification Pending PSC Action'),
+    ('IDENTITY_VERIFICATION_PSC_PENDING', 'identity_verification_psc_pending',
+     'Identity Verification PSC Pending'),
+    ('IDENTITY_VERIFICATION_PSC_VALIDATED', 'identity_verification_psc_validated',
+     'Identity Verification PSC Validated'),
+    ('IDENTITY_VERIFICATION_PSC_REJECTED', 'identity_verification_psc_rejected',
+     'Identity Verification PSC Rejected'),
+    ('IDENTITY_VERIFICATION_PSC_ABANDONED', 'identity_verification_psc_abandoned',
+     'Identity Verification PSC Abandoned'),
 
     ('RECIPIENT_ACTIVE', 'recipient_active', 'Recipient Active'),
     ('RECIPIENT_CANCELED', 'recipient_canceled', 'Recipient Canceled'),

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

@@ -15,7 +15,8 @@ from .utils import timestamp_from_datetime, timestamp_from_date, Money, DebitedB
     BusinessRecipient, RecipientPropertySchema, IndividualRecipientPropertySchema, BusinessRecipientPropertySchema, \
     CompanyNumberValidation, ReportFilter, PayInIntentExternalData, PayInIntentBuyer, SupportedBank, \
     VerificationOfPayee, PayInIntentRefund, PayInIntentCapture, PayInIntentDispute, CustomFees, MarginsResponse, \
-    UserMargin, ConsentScope, AuthenticationResult, FlowDescriptor
+    UserMargin, ConsentScope, AuthenticationResult, FlowDescriptor, SettlementFooterError, SettlementLineError, \
+    SettlementLineErrorDetail
 
 
 class FieldDescriptor(object):
@@ -1544,4 +1545,58 @@ class FlowDescriptorField(Field):
                 result['Beneficiaries'] = value.beneficiaries
             return result
 
+        return value
+
+
+class SettlementFooterErrorsField(Field):
+    def python_value(self, value):
+        if isinstance(value, list):
+            return [SettlementFooterError(footer_name=item.get('FooterName', None),
+                                          code=item.get('Code', None),
+                                          description=item.get('Description', None))
+                    if isinstance(item, dict) else item
+                    for item in value]
+
+        return value
+
+    def api_value(self, value):
+        value = super(SettlementFooterErrorsField, self).api_value(value)
+
+        if isinstance(value, list):
+            return [item.to_api_json() if isinstance(item, SettlementFooterError) else item
+                    for item in value]
+
+        return value
+
+
+class SettlementLinesErrorsField(Field):
+    def python_value(self, value):
+        if isinstance(value, list):
+            return [self._to_line_error(item) if isinstance(item, dict) else item
+                    for item in value]
+
+        return value
+
+    @staticmethod
+    def _to_line_error(item):
+        details = item.get('Details', None)
+        if isinstance(details, list):
+            details = [SettlementLineErrorDetail(code=detail.get('Code', None),
+                                                 description=detail.get('Description', None))
+                       if isinstance(detail, dict) else detail
+                       for detail in details]
+
+        return SettlementLineError(external_provider_reference=item.get('ExternalProviderReference', None),
+                                   external_transaction_type=item.get('ExternalTransactionType', None),
+                                   details=details)
+
+    def api_value(self, value):
+        value = super(SettlementLinesErrorsField, self).api_value(value)
+
+        if isinstance(value, list):
+            return [item.to_api_json() if isinstance(item, SettlementLineError) else item
+                    for item in value]
+
+        return value
+
         return value

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

@@ -22,7 +22,7 @@ from .fields import (PrimaryKeyField, EmailField, CharField,
                      PayInIntentExternalDataField, PayInIntentBuyerField, SupportedBanksField, VerificationOfPayeeField,
                      PayInIntentRefundField, PayInIntentCaptureField, PayInIntentDisputeField, CustomFeesField,
                      UserMarginField, MarginsResponseField, ConsentScopeField, AuthenticationResultField,
-                     FlowDescriptorField)
+                     FlowDescriptorField, SettlementFooterErrorsField, SettlementLinesErrorsField)
 from .query import InsertQuery, UpdateQuery, SelectQuery, ActionQuery, DeleteQuery
 
 
@@ -214,6 +214,13 @@ class UserConsent(BaseModel):
 
 @python_2_unicode_compatible
 class NaturalUser(User):
+    """
+    .. deprecated::
+        The non-SCA natural user endpoints are deprecated. Use :class:`NaturalUserSca`
+        (create/update via ``/sca/users/natural``) and :meth:`User.get_sca` for
+        retrieval instead. Kept for backward compatibility; will be removed in a
+        future major version.
+    """
     person_type = CharField(api_name='PersonType',
                             choices=constants.USER_TYPE_CHOICES,
                             default=constants.USER_TYPE_CHOICES.natural,
@@ -297,6 +304,13 @@ class NaturalUserSca(User):
 
 @python_2_unicode_compatible
 class LegalUser(User):
+    """
+    .. deprecated::
+        The non-SCA legal user endpoints are deprecated. Use :class:`LegalUserSca`
+        (create/update via ``/sca/users/legal``) and :meth:`User.get_sca` for
+        retrieval instead. Kept for backward compatibility; will be removed in a
+        future major version.
+    """
     person_type = CharField(api_name='PersonType',
                             choices=constants.USER_TYPE_CHOICES,
                             default=constants.USER_TYPE_CHOICES.legal,
@@ -1870,12 +1884,22 @@ class CardPreAuthorizedDepositPayIn(BaseModel):
         return insert.execute()
 
     def create_prior_to_complement(self, idempotency_key=None, **kwargs):
+        """
+        .. deprecated::
+            The capture-with-complement flow is deprecated and will be removed in a
+            future major version. Use :meth:`create_without_complement` instead.
+        """
         insert = InsertQuery(self, idempotency_key, **kwargs)
         insert.identifier = 'CREATE_PRIOR_TO_COMPLEMENT'
         insert.insert_query = self.get_field_dict()
         return insert.execute()
 
     def create_complement(self, idempotency_key=None, **kwargs):
+        """
+        .. deprecated::
+            The complement flow is deprecated and will be removed in a future major
+            version. Use :meth:`create_without_complement` instead.
+        """
         insert = InsertQuery(self, idempotency_key, **kwargs)
         insert.identifier = 'CREATE_COMPLEMENT'
         insert.insert_query = self.get_field_dict()
@@ -1921,12 +1945,22 @@ class PreAuthorizedDepositPayIn(BaseModel):
         return insert.execute()
 
     def create_prior_to_complement(self, idempotency_key=None, **kwargs):
+        """
+        .. deprecated::
+            The capture-with-complement flow is deprecated and will be removed in a
+            future major version. Use :meth:`create_without_complement` instead.
+        """
         insert = InsertQuery(self, idempotency_key, **kwargs)
         insert.identifier = 'CREATE_PRIOR_TO_COMPLEMENT'
         insert.insert_query = self.get_field_dict()
         return insert.execute()
 
     def create_complement(self, idempotency_key=None, **kwargs):
+        """
+        .. deprecated::
+            The complement flow is deprecated and will be removed in a future major
+            version. Use :meth:`create_without_complement` instead.
+        """
         insert = InsertQuery(self, idempotency_key, **kwargs)
         insert.identifier = 'CREATE_COMPLEMENT'
         insert.insert_query = self.get_field_dict()
@@ -3268,6 +3302,7 @@ class IdentityVerification(BaseModel):
     last_update = DateTimeField(api_name='UpdateDate')
     user_id = CharField(api_name='UserId')
     checks = ListField(api_name='Checks')
+    pscs = ListField(api_name='PSCs')
 
     class Meta:
         verbose_name = 'identity_verification'
@@ -3293,6 +3328,40 @@ class IdentityVerification(BaseModel):
         return select.all(*args, **kwargs)
 
 
+class Psc(BaseModel):
+    first_name = CharField(api_name='FirstName')
+    last_name = CharField(api_name='LastName')
+    email = CharField(api_name='Email')
+    date_of_birth = DateField(api_name='DateOfBirth')
+    country = CharField(api_name='Country')
+    nationality = CharField(api_name='Nationality')
+    psc_type = CharField(api_name='PscType')
+    status = CharField(api_name='Status')
+    validation_date = DateTimeField(api_name='ValidationDate')
+    hosted_url = CharField(api_name='HostedUrl')
+    data = ListField(api_name='Data')
+    last_update = DateTimeField(api_name='LastUpdate')
+
+    class Meta:
+        verbose_name = 'psc'
+        verbose_name_plural = 'pscs'
+
+        url = {
+            'RETRY': '/identity-verifications/%(identity_verification_id)s/pscs/%(psc_id)s/retry'
+        }
+
+    @classmethod
+    def retry(cls, identity_verification_id, psc_id, **kwargs):
+        """Request the retry of a PSC session.
+
+        The keyword arguments can be empty or contain the values to be updated.
+        """
+        path_params = {'identity_verification_id': identity_verification_id, 'psc_id': psc_id}
+        update = UpdateQuery(Psc, None, path_params, **kwargs)
+        update.identifier = 'RETRY'
+        return update.execute()
+
+
 class RecipientSchema(BaseModel):
     display_name = RecipientPropertySchemaField(api_name='DisplayName')
     payout_method_type = RecipientPropertySchemaField(api_name='PayoutMethodType')
@@ -3391,6 +3460,7 @@ class PayInIntent(BaseModel):
             'REVERSE_REFUND': '/payins/intents/%(intent_id)s/refunds/%(refund_id)s/reverse',
             'CREATE_DISPUTE': '/payins/intents/%(intent_id)s/captures/%(capture_id)s/disputes',
             'UPDATE_DISPUTE_OUTCOME': '/payins/intents/%(intent_id)s/captures/%(capture_id)s/disputes/%(dispute_id)s/decision',
+            'GET_EXTERNAL_PROVIDERS_LIST': '/payins/intents/external-providers',
         }
 
     def create_authorization(self, idempotency_key=None, **kwargs):
@@ -3447,6 +3517,12 @@ class PayInIntent(BaseModel):
         update.identifier = 'UPDATE_DISPUTE_OUTCOME'
         return update.execute(is_v3=True)
 
+    @classmethod
+    def get_external_providers_list(cls, *args, **kwargs):
+        select = SelectQuery(PayInIntent, *args, **kwargs)
+        select.identifier = 'GET_EXTERNAL_PROVIDERS_LIST'
+        return select.get("", is_v3=True, strict_dict_parsing=False, *args, **kwargs)
+
 
 class Settlement(BaseModel):
     settlement_id = CharField(api_name='SettlementId')
@@ -3498,8 +3574,8 @@ class Settlement(BaseModel):
 
 
 class SettlementValidation(BaseModel):
-    footer_errors = ListField(api_name='FooterErrors')
-    lines_errors = ListField(api_name='LinesErrors')
+    footer_errors = SettlementFooterErrorsField(api_name='FooterErrors')
+    lines_errors = SettlementLinesErrorsField(api_name='LinesErrors')
 
     class Meta:
         verbose_name = 'settlement_validation'

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

@@ -1521,7 +1521,7 @@ class PayInIntentSeller(object):
 @add_camelcase_aliases
 class IntentSplit(object):
     def __init__(self, line_item_id=None, wallet_id=None, seller_id=None, split_amount=None, fees_amount=None,
-                 transfer_date=None, description=None, status=None):
+                 transfer_date=None, description=None, status=None, tag=None):
         self.line_item_id = line_item_id
         self.wallet_id = wallet_id
         self.seller_id = seller_id
@@ -1530,11 +1530,12 @@ class IntentSplit(object):
         self.description = description
         self.status = status
         self.transfer_date = transfer_date
+        self.tag = tag
 
     def __str__(self):
-        return 'PayInIntentSplit: %s %s %s %s %s %s %s %s' % \
+        return 'PayInIntentSplit: %s %s %s %s %s %s %s %s %s' % \
             (self.line_item_id, self.wallet_id, self.seller_id, self.split_amount, self.fees_amount, self.description,
-             self.status, self.transfer_date)
+             self.status, self.transfer_date, self.tag)
 
     def to_api_json(self):
         return {
@@ -1545,7 +1546,8 @@ class IntentSplit(object):
             "FeesAmount": self.fees_amount,
             "Description": self.description,
             "Status": self.status,
-            "TransferDate": self.transfer_date
+            "TransferDate": self.transfer_date,
+            "Tag": self.tag
         }
 
 
@@ -1754,4 +1756,60 @@ class FlowDescriptor(object):
         return {
             "FlowId": self.flow_id,
             "Beneficiaries": self.beneficiaries
+        }
+
+
+@add_camelcase_aliases
+class SettlementFooterError(object):
+    def __init__(self, footer_name=None, code=None, description=None):
+        self.footer_name = footer_name
+        self.code = code
+        self.description = description
+
+    def __str__(self):
+        return 'SettlementFooterError: %s %s %s' % (self.footer_name, self.code, self.description)
+
+    def to_api_json(self):
+        return {
+            "FooterName": self.footer_name,
+            "Code": self.code,
+            "Description": self.description
+        }
+
+
+@add_camelcase_aliases
+class SettlementLineErrorDetail(object):
+    def __init__(self, code=None, description=None):
+        self.code = code
+        self.description = description
+
+    def __str__(self):
+        return 'SettlementLineErrorDetail: %s %s' % (self.code, self.description)
+
+    def to_api_json(self):
+        return {
+            "Code": self.code,
+            "Description": self.description
+        }
+
+
+@add_camelcase_aliases
+class SettlementLineError(object):
+    def __init__(self, external_provider_reference=None, external_transaction_type=None, details=None):
+        self.external_provider_reference = external_provider_reference
+        self.external_transaction_type = external_transaction_type
+        self.details = details
+
+    def __str__(self):
+        return 'SettlementLineError: %s %s' % (self.external_provider_reference, self.external_transaction_type)
+
+    def to_api_json(self):
+        details = self.details
+        if isinstance(details, list):
+            details = [d.to_api_json() if isinstance(d, SettlementLineErrorDetail) else d for d in details]
+
+        return {
+            "ExternalProviderReference": self.external_provider_reference,
+            "ExternalTransactionType": self.external_transaction_type,
+            "Details": details
         }

{mangopay4_python_sdk-3.57.0 → mangopay4_python_sdk-3.59.0}/mangopay4_python_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mangopay4-python-sdk
-Version: 3.57.0
+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)

{mangopay4_python_sdk-3.57.0 → mangopay4_python_sdk-3.59.0}/mangopay4_python_sdk.egg-info/SOURCES.txt

@@ -91,4 +91,5 @@ tests/fixtures/user_wallet.json
 tests/images/image.jpg
 tests/resources/TestKycPageFile.png
 tests/resources/settlement_sample.csv
-tests/resources/settlement_sample_bad.csv
+tests/resources/settlement_sample_bad_footer.csv
+tests/resources/settlement_sample_bad_line.csv

{mangopay4_python_sdk-3.57.0 → mangopay4_python_sdk-3.59.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.57.0',
+    version='3.59.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.57.0/tests/resources/settlement_sample_bad.csv → mangopay4_python_sdk-3.59.0/tests/resources/settlement_sample_bad_footer.csv

@@ -5,4 +5,4 @@ SettlementDate,19-06-2025,,,,,,,
 ExternalProviderName,Paypal,,,,,,,
 TotalSettlementFeesAmount,0,,,,,,,
 TotalNetSettlementAmount,99999,,,,,,,
-SettlementCurrency,EUR,,,,,,
+SettlementCurrency,EURR,,,,,,

mangopay4_python_sdk-3.59.0/tests/resources/settlement_sample_bad_line.csv

@@ -0,0 +1,8 @@
+ExternalProviderReference,ExternalPaymentMethod,ExternalTransactionType,ExternalTransactionStatus,ExternalProcessingDate,Amount,Currency,ExternalInitialReference,ExternalProviderFees
+6TU984332A894613W,PAYPAL,PAYMENT,SETTLED,191-06-2025,1000,EUR,,0
+,,,,,,,,
+SettlementDate,19-06-2025,,,,,,,
+ExternalProviderName,Paypal,,,,,,,
+TotalSettlementFeesAmount,0,,,,,,,
+TotalNetSettlementAmount,99999,,,,,,,
+SettlementCurrency,EUR,,,,,,

{mangopay4_python_sdk-3.57.0 → mangopay4_python_sdk-3.59.0}/tests/test_base.py

@@ -873,6 +873,7 @@ class BaseTestLive(unittest.TestCase):
         intent_authorization.external_data = external_data
         intent_authorization.line_items = line_items
         intent_authorization.buyer = buyer
+        intent_authorization.tag = 'Intent tag'
         return PayInIntent(**intent_authorization.create_authorization())
 
     @staticmethod
@@ -908,11 +909,13 @@ class BaseTestLive(unittest.TestCase):
         intent_authorization.external_data = external_data
         intent_authorization.line_items = line_items
         intent_authorization.buyer = buyer
+        intent_authorization.tag = 'Intent tag'
 
         intent = PayInIntent(**intent_authorization.create_authorization())
 
         full_capture = PayInIntent()
         full_capture.external_data = external_data
+        full_capture.tag = 'Intent tag'
 
         return PayInIntent(**full_capture.create_capture(intent.id))
 
@@ -928,7 +931,8 @@ class BaseTestLive(unittest.TestCase):
         external_data.external_provider_payment_method = 'PAYPAL'
 
         refund_dto = {
-            'external_data': external_data
+            'external_data': external_data,
+            'tag': 'Intent tag'
         }
         return PayInIntent(**PayInIntent.create_refund(full_capture.id, **refund_dto))
 

{mangopay4_python_sdk-3.57.0 → mangopay4_python_sdk-3.59.0}/tests/test_identity_verification.py

@@ -1,9 +1,14 @@
-from mangopay.resources import IdentityVerification
+import unittest
+import uuid
+
+from mangopay.resources import IdentityVerification, Psc
 from tests.test_base import BaseTestLive
 
 
 class IdentityVerificationTest(BaseTestLive):
     _identity_verification = None
+    _idv_id_with_pscs = 'idnver_01KZXBHDH1DWC887PW6T46NVTV'
+    _psc_id = 'psc_x_01KZXBT5F8FGGSK9JXGCYMNWRP'
 
     def test_create_identity_verification(self):
         self.create_new_identity_verification()
@@ -30,6 +35,38 @@ class IdentityVerificationTest(BaseTestLive):
         self.assertIsInstance(fetched.data, list)
         self.assertTrue(len(fetched.data) > 0)
 
+    def test_get_identity_verification_with_pscs(self):
+        fetched = IdentityVerification.get(IdentityVerificationTest._idv_id_with_pscs)
+
+        self.assertIsNotNone(fetched)
+        self.assertIsNotNone(fetched.pscs)
+        self.assertTrue(len(fetched.pscs) > 0)
+        self.assertTrue(len(fetched.pscs[0]['Data']) > 0)
+
+    @unittest.skip("PSC must be manually invalidated before testing")
+    def test_retry_psc_without_update_params(self):
+        psc = Psc(**Psc.retry(IdentityVerificationTest._idv_id_with_pscs, IdentityVerificationTest._psc_id))
+
+        self.assertIsNotNone(psc)
+        self.assertIsNotNone(psc.hosted_url)
+        self.assertEqual('PENDING_VALIDATION', psc.status)
+
+    @unittest.skip("PSC must be manually invalidated before testing")
+    def test_retry_psc_with_update_params(self):
+        first_name = str(uuid.uuid4())
+        last_name = str(uuid.uuid4())
+
+        psc = Psc(**Psc.retry(IdentityVerificationTest._idv_id_with_pscs,
+                              IdentityVerificationTest._psc_id,
+                              first_name=first_name,
+                              last_name=last_name))
+
+        self.assertIsNotNone(psc)
+        self.assertIsNotNone(psc.hosted_url)
+        self.assertEqual('PENDING_VALIDATION', psc.status)
+        self.assertEqual(first_name, psc.first_name)
+        self.assertEqual(last_name, psc.last_name)
+
     @staticmethod
     def create_new_identity_verification():
         if IdentityVerificationTest._identity_verification is None:

{mangopay4_python_sdk-3.57.0 → mangopay4_python_sdk-3.59.0}/tests/test_payins.py

@@ -738,6 +738,7 @@ def create_new_splits(intent):
     split = IntentSplit()
     split.line_item_id = intent.line_items[0]['Id']
     split.split_amount = 10
+    split.tag = 'custom tag'
 
     intent_splits = PayInIntentSplits()
     intent_splits.splits = [split]
@@ -2343,16 +2344,19 @@ class PayInsTestLive(BaseTestLive):
         self.assertEqual('AUTHORIZED', created.status)
         self.assertIsNotNone(created.unfunded_amount)
         self.assertIsNotNone(created.line_items[0]['UnfundedSellerAmount'])
+        self.assertEqual('Intent tag', created.tag)
 
     def test_create_pay_in_intent_full_capture(self):
         created = BaseTestLive.create_new_pay_in_intent_full_capture()
 
         self.assertIsNotNone(created)
         self.assertEqual('CAPTURED', created.status)
+        self.assertEqual('Intent tag', created.tag)
 
     def test_create_full_pay_in_intent_refund(self):
         refund = BaseTestLive.create_new_full_pay_in_intent_refund()
         self.assertEqual('REFUNDED', refund.status)
+        self.assertEqual('Intent tag', refund.tag)
 
     def test_create_partial_pay_in_intent_refund(self):
         full_capture = BaseTestLive.create_new_pay_in_intent_full_capture()
@@ -2367,6 +2371,7 @@ class PayInsTestLive(BaseTestLive):
         refund_dto = {
             'external_data': external_data,
             'amount': 1000,
+            'tag': 'Intent tag',
             'line_items': [
                 {
                     'id': full_capture.line_items[0]['Id'],
@@ -2376,6 +2381,7 @@ class PayInsTestLive(BaseTestLive):
         }
         refund = PayInIntent(**PayInIntent.create_refund(full_capture.id, **refund_dto))
         self.assertEqual('REFUNDED', refund.status)
+        self.assertEqual('Intent tag', refund.tag)
 
     def test_fully_reverse_pay_in_intent_refund(self):
         refund = BaseTestLive.create_new_full_pay_in_intent_refund()
@@ -2426,9 +2432,9 @@ class PayInsTestLive(BaseTestLive):
         external_data = PayInIntentExternalData()
         external_data.external_processing_date = '01-10-2026'
         external_data.external_provider_reference = ''.join(random.choices(string.ascii_letters + string.digits, k=10))
-        external_data.external_merchant_reference = 'Order-xyz-35e8490e-2ec9-4c82-978e-c712a3f5ba16'
+        # external_data.external_merchant_reference = 'Order-xyz-35e8490e-2ec9-4c82-978e-c712a3f5ba16'
         external_data.external_provider_name = 'Stripe'
-        external_data.external_provider_payment_method = 'PAYPAL'
+        # external_data.external_provider_payment_method = 'PAYPAL'
 
         line_item = PayInIntentLineItem()
         line_item.id = intent.line_items[0]['Id']
@@ -2452,6 +2458,7 @@ class PayInsTestLive(BaseTestLive):
         fetched = PayInIntent.get(intent.id)
         self.assertIsNotNone(fetched)
         self.assertEqual(fetched.status, intent.status)
+        self.assertEqual(intent.tag, fetched.tag)
 
     def test_cancel_pay_in_intent(self):
         intent = BaseTestLive.create_new_pay_in_intent_authorization()
@@ -2464,12 +2471,19 @@ class PayInsTestLive(BaseTestLive):
         cancelled = PayInIntent(**PayInIntent.cancel(intent.id, **cancel_details))
         self.assertEqual(cancelled.status, 'CANCELLED')
 
+    def test_get_external_providers_list(self):
+        providers = PayInIntent.get_external_providers_list()
+        self.assertIsNotNone(providers)
+        self.assertTrue(len(providers) > 0)
+        self.assertIn('Mangopay', providers)
+
     def test_create_pay_in_intent_splits(self):
         intent = BaseTestLive.create_new_pay_in_intent_authorization()
         created_splits = create_new_splits(intent)
 
         self.assertIsNotNone(created_splits)
         self.assertEqual('CREATED', created_splits.splits[0]['Status'])
+        self.assertIsNotNone(created_splits.splits[0]['Tag'])
 
     def test_execute_split(self):
         intent = BaseTestLive.create_new_pay_in_intent_authorization()
@@ -2494,6 +2508,7 @@ class PayInsTestLive(BaseTestLive):
         created_splits = create_new_splits(intent)
         fetched = PayInIntentSplit.get(intent.id, created_splits.splits[0]['Id'])
         self.assertEqual('CREATED', fetched.status)
+        self.assertIsNotNone(fetched.tag)
 
     def test_update_split(self):
         intent = BaseTestLive.create_new_pay_in_intent_authorization()
@@ -2503,10 +2518,12 @@ class PayInsTestLive(BaseTestLive):
             created_splits.splits[0]['Id'],
             **{
                 'description': 'updated description',
-                'line_item_id': created_splits.splits[0]['LineItemId']
+                'line_item_id': created_splits.splits[0]['LineItemId'],
+                'tag': 'updated tag'
             }
         )
         self.assertEqual('updated description', updated['description'])
+        self.assertEqual('updated tag', updated['tag'])
 
     def test_create_client_bank_wire_direct_payin(self):
         pay_in = ClientBankWireDirectPayIn()
@@ -2519,6 +2536,7 @@ class PayInsTestLive(BaseTestLive):
         self.assertEqual('BANK_WIRE', created.payment_type)
         self.assertEqual('DIRECT', created.execution_type)
 
+    @unittest.skip("can't be tested. API returning 500")
     def test_paypal_data_collection(self):
         data = {
             "sender_account_id": "A12345N343",
@@ -2574,10 +2592,12 @@ class PayInsTestLive(BaseTestLive):
         external_data.external_provider_payment_method = 'PAYPAL'
 
         create_dto = {
-            'external_data': external_data
+            'external_data': external_data,
+            'tag': 'Intent tag'
         }
         dispute = PayInIntent(**PayInIntent.create_dispute(full_capture.id, full_capture.capture.id, **create_dto))
         self.assertEqual('DISPUTED', dispute.status)
+        self.assertEqual('Intent tag', dispute.tag)
 
     def test_create_partial_pay_in_intent_dispute(self):
         full_capture = BaseTestLive.create_new_pay_in_intent_full_capture()
@@ -2592,6 +2612,7 @@ class PayInsTestLive(BaseTestLive):
         create_dto = {
             'external_data': external_data,
             'amount': 1000,
+            'tag': 'Intent tag',
             'line_items': [
                 {
                     'id': full_capture.line_items[0]['Id'],
@@ -2601,6 +2622,7 @@ class PayInsTestLive(BaseTestLive):
         }
         dispute = PayInIntent(**PayInIntent.create_dispute(full_capture.id, full_capture.capture.id, **create_dto))
         self.assertEqual('DISPUTED', dispute.status)
+        self.assertEqual('Intent tag', dispute.tag)
 
     def test_update_intent_dispute_outcome(self):
         full_capture = BaseTestLive.create_new_pay_in_intent_full_capture()

mangopay4_python_sdk-3.59.0/tests/test_settlements.py

@@ -0,0 +1,159 @@
+# -*- coding: utf-8 -*-
+import os
+import time
+
+import requests
+import responses
+
+from mangopay.resources import Settlement, SettlementValidation
+from mangopay.utils import SettlementFooterError, SettlementLineError, SettlementLineErrorDetail
+from tests import settings
+from tests.test_base import BaseTest, BaseTestLive
+
+
+class SettlementTestLive(BaseTestLive):
+    _settlement = None
+
+    def test_generate_upload_url(self):
+        settlement = self.create_new_settlement()
+        self.assertIsNotNone(settlement.settlement_id)
+        self.assertIsNotNone(settlement.upload_url)
+
+    def test_get_settlement(self):
+        settlement = self.create_new_settlement()
+        fetched = Settlement.get(settlement.settlement_id)
+        self.assertEqual('PENDING_UPLOAD', fetched.status)
+
+    def test_generate_new_upload_url(self):
+        settlement = self.create_new_settlement()
+        new_settlement = Settlement(id=settlement.settlement_id, file_name='updated_settlement_sample.csv')
+        result = Settlement(**new_settlement.generate_new_upload_url())
+        self.assertIsNotNone(result.settlement_id)
+        self.assertIsNotNone(result.upload_url)
+
+    def test_upload_file(self):
+        settlement, response = self.upload_settlement_file('settlement_sample.csv')
+        self.assertEqual(200, response.status_code)
+
+    def test_get_validations_footer_errors(self):
+        settlement, response = self.upload_settlement_file('settlement_sample_bad_footer.csv')
+        time.sleep(20)
+        validations = SettlementValidation.get(settlement.settlement_id, page=0, per_page=10)
+        self.assertIsNotNone(validations)
+        self.assertIsNotNone(validations.footer_errors)
+
+        footer_error = validations.footer_errors[0]
+        self.assertIsNotNone(footer_error.footer_name)
+        self.assertIsNotNone(footer_error.code)
+        self.assertIsNotNone(footer_error.description)
+
+    def test_get_validations_line_errors(self):
+        settlement, response = self.upload_settlement_file('settlement_sample_bad_line.csv')
+        time.sleep(20)
+        validations = SettlementValidation.get(settlement.settlement_id, page=0, per_page=10)
+        self.assertIsNotNone(validations)
+        self.assertIsNotNone(validations.lines_errors)
+
+        line_error = validations.lines_errors[0]
+        self.assertIsNotNone(line_error.external_provider_reference)
+        self.assertIsNotNone(line_error.external_transaction_type)
+        self.assertIsNotNone(line_error.details)
+
+        line_error_detail = line_error.details[0]
+        self.assertIsNotNone(line_error_detail.code)
+        self.assertIsNotNone(line_error_detail.description)
+
+    def test_cancel_settlement(self):
+        settlement, response = self.upload_settlement_file('settlement_sample_bad_line.csv')
+        cancelled = Settlement.cancel(settlement.settlement_id)
+        self.assertIsNotNone(cancelled)
+        self.assertEqual("CANCELLED", cancelled['status'])
+
+    @staticmethod
+    def create_new_settlement():
+        if SettlementTestLive._settlement is None:
+            settlement = Settlement(file_name='settlement_sample.csv')
+            SettlementTestLive._settlement = Settlement(**settlement.generate_upload_url())
+        return SettlementTestLive._settlement
+
+    def upload_settlement_file(self, file_name):
+        settlement = Settlement(file_name=file_name)
+        settlement = Settlement(**settlement.generate_upload_url())
+        file_path = os.path.join(os.path.dirname(__file__), 'resources', file_name)
+        with open(file_path, 'rb') as f:
+            data = f.read()
+
+        headers = {'Content-Type': 'text/csv'}
+        response = requests.put(settlement.upload_url, data=data, headers=headers)
+        return settlement, response
+
+
+class SettlementValidationTest(BaseTest):
+    @responses.activate
+    def test_get_validations_dto(self):
+        settlement_id = "settlement_12345"
+        v3_url = settings.MANGOPAY_API_SANDBOX_URL.replace('v2.01', 'V3.0')
+        self.register_mock({
+            'method': responses.GET,
+            'url': v3_url + settings.MANGOPAY_CLIENT_ID +
+                   '/payins/intents/settlements/' + settlement_id + '/validations',
+            'body': {
+                "FooterErrors": [
+                    {
+                        "FooterName": "DeclaredIntentAmount",
+                        "Code": "TOTAL_NET_MISCALCULATED",
+                        "Description": "Declared intent amount does not match actual settlement amount"
+                    }
+                ],
+                "LinesErrors": [
+                    {
+                        "ExternalProviderReference": "d3f7a1b2-4c5e-6789-abcd-ef0123456789",
+                        "ExternalTransactionType": "REFUND",
+                        "Details": [
+                            {
+                                "Code": "MATCH_REF_NOT_FOUND",
+                                "Description": "ExternalProviderReference not found for any existing Intent in the system"
+                            },
+                            {
+                                "Code": "FORMAT_DATE_INVALID",
+                                "Description": "ExternalProcessingDate format is invalid. Expected DD-MM-YYYY"
+                            }
+                        ]
+                    }
+                ]
+            },
+            'status': 200
+        })
+
+        validations = SettlementValidation.get(settlement_id, page=1, per_page=10)
+
+        self.assertIsNotNone(validations)
+        self.assertIsNotNone(validations.footer_errors)
+        self.assertIsNotNone(validations.lines_errors)
+
+        self.assertEqual(1, len(validations.footer_errors))
+        footer_error = validations.footer_errors[0]
+        self.assertIsInstance(footer_error, SettlementFooterError)
+        self.assertEqual("DeclaredIntentAmount", footer_error.footer_name)
+        self.assertEqual("TOTAL_NET_MISCALCULATED", footer_error.code)
+        self.assertEqual("Declared intent amount does not match actual settlement amount",
+                         footer_error.description)
+
+        self.assertEqual(1, len(validations.lines_errors))
+        line_error = validations.lines_errors[0]
+        self.assertIsInstance(line_error, SettlementLineError)
+        self.assertEqual("d3f7a1b2-4c5e-6789-abcd-ef0123456789", line_error.external_provider_reference)
+        self.assertEqual("REFUND", line_error.external_transaction_type)
+        self.assertIsNotNone(line_error.details)
+        self.assertEqual(2, len(line_error.details))
+
+        first_detail = line_error.details[0]
+        self.assertIsInstance(first_detail, SettlementLineErrorDetail)
+        self.assertEqual("MATCH_REF_NOT_FOUND", first_detail.code)
+        self.assertEqual("ExternalProviderReference not found for any existing Intent in the system",
+                         first_detail.description)
+
+        second_detail = line_error.details[1]
+        self.assertEqual("FORMAT_DATE_INVALID", second_detail.code)
+        self.assertEqual("ExternalProcessingDate format is invalid. Expected DD-MM-YYYY",
+                         second_detail.description)

mangopay4_python_sdk-3.57.0/tests/test_settlements.py

@@ -1,60 +0,0 @@
-# -*- coding: utf-8 -*-
-import os
-import requests
-
-from mangopay.resources import Settlement, SettlementValidation
-from tests.test_base import BaseTestLive
-
-
-class SettlementTestLive(BaseTestLive):
-    _settlement = None
-
-    def test_generate_upload_url(self):
-        settlement = self.create_new_settlement()
-        self.assertIsNotNone(settlement.settlement_id)
-        self.assertIsNotNone(settlement.upload_url)
-
-    def test_get_settlement(self):
-        settlement = self.create_new_settlement()
-        fetched = Settlement.get(settlement.settlement_id)
-        self.assertEqual('PENDING_UPLOAD', fetched.status)
-
-    def test_generate_new_upload_url(self):
-        settlement = self.create_new_settlement()
-        new_settlement = Settlement(id=settlement.settlement_id, file_name='updated_settlement_sample.csv')
-        result = Settlement(**new_settlement.generate_new_upload_url())
-        self.assertIsNotNone(result.settlement_id)
-        self.assertIsNotNone(result.upload_url)
-
-    def test_upload_file(self):
-        settlement, response = self.upload_settlement_file('settlement_sample.csv')
-        self.assertEqual(200, response.status_code)
-
-    def test_get_validaitons(self):
-        settlement, response = self.upload_settlement_file('settlement_sample_bad.csv')
-        validations = SettlementValidation.get(settlement.settlement_id, page=1, per_page=10)
-        self.assertIsNotNone(validations)
-
-    def test_cancel_settlement(self):
-        settlement, response = self.upload_settlement_file('settlement_sample_bad.csv')
-        cancelled = Settlement.cancel(settlement.settlement_id)
-        self.assertIsNotNone(cancelled)
-        self.assertEqual("CANCELLED", cancelled['status'])
-
-    @staticmethod
-    def create_new_settlement():
-        if SettlementTestLive._settlement is None:
-            settlement = Settlement(file_name='settlement_sample.csv')
-            SettlementTestLive._settlement = Settlement(**settlement.generate_upload_url())
-        return SettlementTestLive._settlement
-
-    def upload_settlement_file(self, file_name):
-        settlement = Settlement(file_name=file_name)
-        settlement = Settlement(**settlement.generate_upload_url())
-        file_path = os.path.join(os.path.dirname(__file__), 'resources', file_name)
-        with open(file_path, 'rb') as f:
-            data = f.read()
-
-        headers = {'Content-Type': 'text/csv'}
-        response = requests.put(settlement.upload_url, data=data, headers=headers)
-        return settlement, response