Merge pull request #770 from Mangopay/rel/3.49.0

iulian-masar-mangopay · web-flow · commit e9b5a47ced8f · 2026-01-30T12:21:44.000+02:00
[release] 3.49.0
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,3 +1,11 @@
+## [3.49.0] - 2026-01-27
+### Added
+- Support for new [GET View the SCA status of a User](https://docs.mangopay.com/api-reference/users/view-user-sca-status) endpoint ([API release note](https://docs.mangopay.com/release-notes/api/2026-01-15)) (#766)
+- Support for new [event types](https://docs.mangopay.com/webhooks/event-types#mangopay-sca-email-and-phone-number-verification) `SCA_CONTACT_INFORMATION_UPDATE_CONSENT_GIVEN`, `SCA_CONTACT_INFORMATION_UPDATE_CONSENT_REVOKED`, `SCA_TRANSFER_CONSENT_GIVEN`, `SCA_TRANSFER_CONSENT_REVOKED`, `SCA_RECIPIENT_REGISTRATION_CONSENT_GIVEN`, `SCA_RECIPIENT_REGISTRATION_CONSENT_REVOKED`, `SCA_VIEW_ACCOUNT_INFORMATION_CONSENT_GIVEN`, `SCA_VIEW_ACCOUNT_INFORMATION_CONSENT_REVOKED`, `SCA_EMAIL_VERIFIED`, `SCA_PHONE_NUMBER_VERIFIED` (#765) (thank you @williamdes)
+- Support for new `RecipientId` property on [payouts](https://docs.mangopay.com/api-reference/payouts/create-payout) ([API release note](https://docs.mangopay.com/release-notes/api/2026-01-27)) (#759)
+
+Release PR: #770
+
 ## [3.48.0] - 2025-11-28
 ### Changed
 - Migrated to V4 naming convention
diff --git a/MangoPay/ApiUsers.php b/MangoPay/ApiUsers.php
@@ -602,4 +602,14 @@ public function Close($user)
 
         $this->DeleteObject($methodKey, $user);
     }
+
+    /**
+     * Get SCA status
+     * @param string $userId User identifier
+     * @return ScaStatus ScaStatus object returned from API
+     */
+    public function GetScaStatus($userId)
+    {
+        return $this->GetObject('users_get_sca_status', 'MangoPay\ScaStatus', $userId);
+    }
 }
diff --git a/MangoPay/ConsentScope.php b/MangoPay/ConsentScope.php
@@ -0,0 +1,26 @@
+<?php
+
+namespace MangoPay;
+
+class ConsentScope extends Libraries\Dto
+{
+    /**
+     * @var string|null
+     */
+    public $ContactInformationUpdate;
+
+    /**
+     * @var string|null
+     */
+    public $RecipientRegistration;
+
+    /**
+     * @var string|null
+     */
+    public $Transfer;
+
+    /**
+     * @var string|null
+     */
+    public $ViewAccountInformation;
+}
diff --git a/MangoPay/EventType.php b/MangoPay/EventType.php
@@ -65,6 +65,8 @@ class EventType
     const UboDeclarationIncomplete = "UBO_DECLARATION_INCOMPLETE";
     const UserKycRegular = "USER_KYC_REGULAR";
     const UserKycLight = "USER_KYC_LIGHT";
+    const UserKycRenewalRequired = "USER_KYC_RENEWAL_REQUIRED";
+    const UserKycRenewed = "USER_KYC_RENEWED";
     const UserInflowsBlocked = "USER_INFLOWS_BLOCKED";
     const UserInflowsUnblocked = "USER_INFLOWS_UNBLOCKED";
     const UserOutflowsBlocked = "USER_OUTFLOWS_BLOCKED";
@@ -124,6 +126,16 @@ class EventType
     const ScaEnrollmentSucceeded = "SCA_ENROLLMENT_SUCCEEDED";
     const ScaEnrollmentFailed = "SCA_ENROLLMENT_FAILED";
     const ScaEnrollmentExpired = "SCA_ENROLLMENT_EXPIRED";
+    const ScaContactInformationUpdateConsentGiven = "SCA_CONTACT_INFORMATION_UPDATE_CONSENT_GIVEN";
+    const ScaContactInformationUpdateConsentRevoked = "SCA_CONTACT_INFORMATION_UPDATE_CONSENT_REVOKED";
+    const ScaTransferConsentGiven = "SCA_TRANSFER_CONSENT_GIVEN";
+    const ScaTransferConsentRevoked = "SCA_TRANSFER_CONSENT_REVOKED";
+    const ScaRecipientRegistrationConsentGiven = "SCA_RECIPIENT_REGISTRATION_CONSENT_GIVEN";
+    const ScaRecipientRegistrationConsentRevoked = "SCA_RECIPIENT_REGISTRATION_CONSENT_REVOKED";
+    const ScaViewAccountInformationConsentGiven = "SCA_VIEW_ACCOUNT_INFORMATION_CONSENT_GIVEN";
+    const ScaViewAccountInformationConsentRevoked = "SCA_VIEW_ACCOUNT_INFORMATION_CONSENT_REVOKED";
+    const ScaEmailVerified = "SCA_EMAIL_VERIFIED";
+    const ScaPhoneNumberVerified = "SCA_PHONE_NUMBER_VERIFIED";
 
     const UserCategoryUpdatedToOwner = "USER_CATEGORY_UPDATED_TO_OWNER";
     const UserCategoryUpdatedToPayer = "USER_CATEGORY_UPDATED_TO_PAYER";
diff --git a/MangoPay/Libraries/ApiBase.php b/MangoPay/Libraries/ApiBase.php
@@ -172,6 +172,7 @@ protected function getLogger()
         'users_categorizelegals_sca' => ['/sca/users/legal/%s/category', RequestType::PUT],
         'users_close_natural' => ['/users/natural/%s', RequestType::DELETE],
         'users_close_legal' => ['/users/legal/%s', RequestType::DELETE],
+        'users_get_sca_status' => ['/sca/users/%s/sca-status', RequestType::GET],
 
         'validate_the_format_of_user_data' => ['/users/data-formats/validation', RequestType::POST],
 
diff --git a/MangoPay/Libraries/RestTool.php b/MangoPay/Libraries/RestTool.php
@@ -12,7 +12,7 @@
  */
 class RestTool
 {
-    const VERSION = '3.48.0';
+    const VERSION = '3.49.0';
 
     /**
      * Root/parent instance that holds the OAuthToken and Configuration instance
diff --git a/MangoPay/PayOutPaymentDetailsBankWire.php b/MangoPay/PayOutPaymentDetailsBankWire.php
@@ -8,11 +8,19 @@
 class PayOutPaymentDetailsBankWire extends Libraries\Dto implements PayOutPaymentDetails
 {
     /**
-     * Bank account Id
-     * @var string
+     * Bank account identifier
+     * Null if $RecipientId is provided
+     * @var string|null
      */
     public $BankAccountId;
 
+    /**
+     * Recipient identifier
+     * Null if $BankAccountId is provided
+     * @var string|null
+     */
+    public $RecipientId;
+
     /**
      * A custom reference you wish to appear on the user’s bank statement
      * @var string
diff --git a/MangoPay/ScaStatus.php b/MangoPay/ScaStatus.php
@@ -0,0 +1,31 @@
+<?php
+
+namespace MangoPay;
+
+class ScaStatus extends Libraries\Dto
+{
+    /**
+     * @var string
+     */
+    public $UserStatus;
+
+    /**
+     * @var bool
+     */
+    public $IsEnrolled;
+
+    /**
+     * @var int|null
+     */
+    public $LastEnrollmentDate;
+
+    /**
+     * @var int|null
+     */
+    public $LastConsentCollectionDate;
+
+    /**
+     * @var ConsentScope|null
+     */
+    public $ConsentScope;
+}
diff --git a/tests/Cases/Base.php b/tests/Cases/Base.php
@@ -11,6 +11,7 @@
 use MangoPay\BrowserInfo;
 use MangoPay\CreateDeposit;
 use MangoPay\CurrencyIso;
+use MangoPay\IndividualRecipient;
 use MangoPay\LegalPersonType;
 use MangoPay\LegalRepresentative;
 use MangoPay\Libraries\Exception;
@@ -21,6 +22,7 @@
 use MangoPay\PayInIntentExternalData;
 use MangoPay\PayInIntentLineItem;
 use MangoPay\PayInIntentSeller;
+use MangoPay\Recipient;
 use MangoPay\ShippingPreference;
 use MangoPay\Tests\Mocks\MockStorageStrategy;
 use MangoPay\Ubo;
@@ -824,29 +826,36 @@ protected function getJohnsPayOutForCardDirect()
             $payIn = $this->getNewPayInCardDirect();
             $account = $this->getJohnsAccount();
 
-            $payOut = new \MangoPay\PayOut();
-            $payOut->Tag = 'DefaultTag';
-            $payOut->AuthorId = $payIn->AuthorId;
-            $payOut->CreditedUserId = $payIn->AuthorId;
-            $payOut->DebitedFunds = new \MangoPay\Money();
-            $payOut->DebitedFunds->Currency = 'EUR';
-            $payOut->DebitedFunds->Amount = 10;
-            $payOut->Fees = new \MangoPay\Money();
-            $payOut->Fees->Currency = 'EUR';
-            $payOut->Fees->Amount = 5;
-
-            $payOut->DebitedWalletId = $payIn->CreditedWalletId;
-            $payOut->MeanOfPaymentDetails = new \MangoPay\PayOutPaymentDetailsBankWire();
+            $payOut = $this->getNewPayOutDto($payIn->AuthorId, $payIn->CreditedWalletId);
             $payOut->MeanOfPaymentDetails->BankAccountId = $account->Id;
-            $payOut->MeanOfPaymentDetails->BankWireRef = 'Johns payment';
-            $payOut->MeanOfPaymentDetails->PayoutModeRequested = 'STANDARD';
 
             self::$JohnsPayOutForCardDirect = $this->_api->PayOuts->Create($payOut);
         }
 
         return self::$JohnsPayOutForCardDirect;
     }
 
+    protected function getNewPayOutDto($authorId, $walletId)
+    {
+        $payOut = new \MangoPay\PayOut();
+        $payOut->Tag = 'DefaultTag';
+        $payOut->AuthorId = $authorId;
+        $payOut->CreditedUserId = $authorId;
+        $payOut->DebitedFunds = new \MangoPay\Money();
+        $payOut->DebitedFunds->Currency = 'EUR';
+        $payOut->DebitedFunds->Amount = 10;
+        $payOut->Fees = new \MangoPay\Money();
+        $payOut->Fees->Currency = 'EUR';
+        $payOut->Fees->Amount = 5;
+
+        $payOut->DebitedWalletId = $walletId;
+        $payOut->MeanOfPaymentDetails = new \MangoPay\PayOutPaymentDetailsBankWire();
+        $payOut->MeanOfPaymentDetails->BankWireRef = 'Johns payment';
+        $payOut->MeanOfPaymentDetails->PayoutModeRequested = 'STANDARD';
+
+        return $payOut;
+    }
+
     /**
      * Creates Pay-In Card Direct object
      * @return \MangoPay\PayIn
@@ -2275,4 +2284,29 @@ protected function getNewPayInIntentAuthorization()
 
         return $this->_api->PayIns->CreatePayInIntentAuthorization($toCreate);
     }
+
+    protected function getNewRecipientObject()
+    {
+        $localBankTransfer = [];
+        $gbpDetails = [];
+        $gbpDetails["SortCode"] = "010039";
+        $gbpDetails["AccountNumber"] = "11696419";
+        $localBankTransfer["GBP"] = $gbpDetails;
+
+        $individualRecipient = new IndividualRecipient();
+        $individualRecipient->FirstName = "Payout";
+        $individualRecipient->LastName = "Team";
+        $individualRecipient->Address = $this->getNewAddress();
+
+        $recipient = new Recipient();
+        $recipient->DisplayName = "My GB account";
+        $recipient->PayoutMethodType = "LocalBankTransfer";
+        $recipient->RecipientType = "Individual";
+        $recipient->Currency = CurrencyIso::GBP;
+        $recipient->IndividualRecipient = $individualRecipient;
+        $recipient->LocalBankTransfer = $localBankTransfer;
+        $recipient->Country = "GB";
+
+        return $recipient;
+    }
 }
diff --git a/tests/Cases/EventsTest.php b/tests/Cases/EventsTest.php
@@ -43,6 +43,7 @@ public function test_GetEventList_PayinNormalSucceeded()
         $pagination = new \MangoPay\Pagination();
         $pagination->ItemsPerPage = 100;// Increase the chance to find a result
 
+        sleep(10);
         $result = $this->_api->Events->GetAll($pagination, $filter);
 
         $this->assertTrue(count($result) > 0);
@@ -58,7 +59,7 @@ public function test_GetEventList_PayoutNormalCreated()
         $filter->EventType = \MangoPay\EventType::PayoutNormalCreated;
         $pagination = new \MangoPay\Pagination();
 
-        sleep(5);
+        sleep(10);
         $result = $this->_api->Events->GetAll($pagination, $filter);
 
         $this->assertTrue(count($result) > 0);
diff --git a/tests/Cases/PayInsTest.php b/tests/Cases/PayInsTest.php
@@ -363,6 +363,7 @@ public function test_PayIns_Create_PaypalWebV2()
 
     public function test_PayIns_Create_PayconiqWeb()
     {
+        $this->markTestSkipped("endpoint removed");
         $payIn = $this->getJohnsPayInPayconiqWeb();
 
         $this->assertNotNull($payIn->Id);
diff --git a/tests/Cases/PayOutsTest.php b/tests/Cases/PayOutsTest.php
@@ -21,6 +21,31 @@ public function test_PayOut_Create()
         $this->assertInstanceOf('\MangoPay\PayOutPaymentDetailsBankWire', $payOut->MeanOfPaymentDetails);
     }
 
+    public function test_PayOut_Create_WithRecipientId()
+    {
+        $john = $this->getJohn();
+        $wallet = $this->getJohnsWallet();
+
+        $recipientDto = $this->getNewRecipientObject();
+        $localBankTransfer = [];
+        $details = [];
+        $details["IBAN"] = "DE75512108001245126199";
+        $localBankTransfer["EUR"] = $details;
+        $recipientDto->LocalBankTransfer = $localBankTransfer;
+        $recipientDto->Country = "DE";
+        $recipientDto->Currency = CurrencyIso::EUR;
+        $recipient = $this->_api->Recipients->Create($recipientDto, $john->Id);
+
+        $payOutDto = $this->getNewPayOutDto($john->Id, $wallet->Id);
+        $payOutDto->RecipientId = $recipient->Id;
+        $payOut = $this->_api->PayOuts->Create($payOutDto);
+
+        $this->assertNotNull($payOut->Id);
+        $this->assertNotNull($payOut->MeanOfPaymentDetails->RecipientId);
+        $this->assertSame(\MangoPay\PayOutPaymentType::BankWire, $payOut->PaymentType);
+        $this->assertInstanceOf('\MangoPay\PayOutPaymentDetailsBankWire', $payOut->MeanOfPaymentDetails);
+    }
+
     public function test_PayOut_CheckEligibility()
     {
         $payOut = $this->getJohnsPayOutForCardDirect();
diff --git a/tests/Cases/RecipientsTest.php b/tests/Cases/RecipientsTest.php
@@ -214,35 +214,10 @@ private function getNewRecipient()
     {
         if (self::$recipient == null) {
             $john = $this->getJohnSca(UserCategory::Owner, false);
-            $recipient = $this->getNewRecipientObject($john->Id);
+            $recipient = $this->getNewRecipientObject();
 
             self::$recipient = $this->_api->Recipients->Create($recipient, $john->Id);
         }
         return self::$recipient;
     }
-
-    private function getNewRecipientObject($userId)
-    {
-        $localBankTransfer = [];
-        $gbpDetails = [];
-        $gbpDetails["SortCode"] = "010039";
-        $gbpDetails["AccountNumber"] = "11696419";
-        $localBankTransfer["GBP"] = $gbpDetails;
-
-        $individualRecipient = new IndividualRecipient();
-        $individualRecipient->FirstName = "Payout";
-        $individualRecipient->LastName = "Team";
-        $individualRecipient->Address = $this->getNewAddress();
-
-        $recipient = new Recipient();
-        $recipient->DisplayName = "My GB account";
-        $recipient->PayoutMethodType = "LocalBankTransfer";
-        $recipient->RecipientType = "Individual";
-        $recipient->Currency = CurrencyIso::GBP;
-        $recipient->IndividualRecipient = $individualRecipient;
-        $recipient->LocalBankTransfer = $localBankTransfer;
-        $recipient->Country = "GB";
-
-        return $recipient;
-    }
 }
diff --git a/tests/Cases/UsersTest.php b/tests/Cases/UsersTest.php
@@ -949,7 +949,7 @@ public function test_manage_user_consent()
     public function test_Users_close_natural()
     {
         $john = $this->_api->Users->Create($this->buildJohn());
-        $this->assertSame('ACTIVE', $john->UserStatus);
+        $this->assertSame('PENDING_USER_ACTION', $john->UserStatus);
         $this->_api->Users->Close($john);
         $closed = $this->_api->Users->Get($john->Id);
         $this->assertSame('CLOSED', $closed->UserStatus);
@@ -959,9 +959,20 @@ public function test_Users_close_legal()
     {
         $john = $this->_api->Users->Create($this->buildJohn());
         $matrix = $this->_api->Users->Create($this->buildMatrix($john));
-        $this->assertSame('ACTIVE', $matrix->UserStatus);
+        $this->assertSame('PENDING_USER_ACTION', $matrix->UserStatus);
         $this->_api->Users->Close($matrix);
         $closed = $this->_api->Users->Get($matrix->Id);
         $this->assertSame('CLOSED', $closed->UserStatus);
     }
+
+    public function test_Users_get_sca_status()
+    {
+        $activeUserId = "user_m_01JKZW095BFB2TRQMCZ8GE7M8D";
+        $scaStatus = $this->_api->Users->GetScaStatus($activeUserId);
+
+        $this->assertNotNull($scaStatus);
+        $this->assertNotNull($scaStatus->ConsentScope->ContactInformationUpdate);
+        $this->assertEquals("ACTIVE", $scaStatus->UserStatus);
+        $this->assertEquals(true, $scaStatus->IsEnrolled);
+    }
 }

Original file line number	Diff line number	Diff line change
`@@ -602,4 +602,14 @@ public function Close($user)`
`602`	`602`
`603`	`603`	`$this->DeleteObject($methodKey, $user);`
`604`	`604`	`}`
	`605`	`+`
	`606`	`+ /**`
	`607`	`+ * Get SCA status`
	`608`	`+ * @param string $userId User identifier`
	`609`	`+ * @return ScaStatus ScaStatus object returned from API`
	`610`	`+ */`
	`611`	`+ public function GetScaStatus($userId)`
	`612`	`+ {`
	`613`	`+ return $this->GetObject('users_get_sca_status', 'MangoPay\ScaStatus', $userId);`
	`614`	`+ }`
`605`	`615`	`}`
Original file line number	Diff line number	Diff line change
`@@ -12,7 +12,7 @@`
`12`	`12`	`*/`
`13`	`13`	`class RestTool`
`14`	`14`	`{`
`15`		`- const VERSION = '3.48.0';`
	`15`	`+ const VERSION = '3.49.0';`
`16`	`16`
`17`	`17`	`/**`
`18`	`18`	`* Root/parent instance that holds the OAuthToken and Configuration instance`