Releases: Mangopay/mangopay2-java-sdk
2.27.0
Added
Verifying some specific legal structures is now more efficient thanks to a new legal entity type: PARTNERSHIP
.
The Legal User LegalPersonType parameter now includes the PARTNERSHIP
value. The following endpoints have been updated accordingly:
Create a Legal User (Payer)
Create a Legal User (Owner)
Update a Legal User
Please note that changing the LegalPersonType to PARTNERSHIP
for an existing user will automatically result in:
- A KYC downgrade to Light (default) verification
- The REGISTRATION_PROOF document being flagged as OUT_OF_DATE.
With this new LegalPersonType, the MANGOPAY team can better handle specific legal structures and speed up the validation process.
2.26.0
Added
New 30-day preauthorization feature
Preauthorizations can now hold funds for up to 30 days, therefore ensuring the solvency of a registered card for the same amount of time.
- The DepositApi service has been added with methods for creating, fetching and canceling a deposit
- The Deposit entity has been created
- The createCardPreAuthorizedDepositPayIn method has been added to the PayIn service
Thanks to 30-day preauthorizations, MANGOPAY can provide a simpler and more flexible payment experience for a wide range of use cases, especially for rentals.
New behavior when MANGOPAY API is down
- Instead of NPE when the API is down, a custom Exception has been added
2.25.2
Fixed
Tests have been fixed due to API evolution.
2.25.1
Fixed
User TermsAndConditionsAccepted
is now nullable
2.25.0
Added
New country authorizations endpoints
Country authorizations can now be viewed by using one of the following endpoints:
View a country's authorizations
View all countries' authorizations
With these calls, it is possible to check which countries have:
- Blocked user creation
- Blocked bank account creation
- Blocked payout creation
Please refer to the Restrictions by country article for more information.
2.24.0
Added
Recurring: €0 deadlines for CIT
Setting free recurring payment deadlines is now possible for CIT (customer-initiated transactions) with the FreeCycles
parameter.
The FreeCycles
parameter allows platforms to define the number of consecutive deadlines that will be free. The following endpoints have been updated to take into account this new parameter:
Create a Recurring PayIn Registration
View a Recurring PayIn Registration
This feature provides new automation capabilities for platforms with offers such as “Get the first month free” or “free trial” subscriptions.
Please refer to the Recurring payments overview documentation for more information.
2.23.0
Added
UserCategory management
Users can now be differentiated depending on their MANGOPAY usage.
This is possible with the new UserCategory parameter, whose value can be set to:
- Payer – For users who are only using MANGOPAY to give money to other users (i.e., only pay).
- Owner – For users who are using MANGOPAY to receive funds (and who are therefore required to accept MANGOPAY’s terms and conditions).
Please note that the following parameters become required as soon as the UserCategory is set to “Owner”:
- HeadquartersAddress
- CompanyNumber (if the LegalPersonType is “Business”)
- TermsAndConditionsAccepted.
The documentation of user-related endpoints has been updated and reorganised to take into account the new parameter:
Create a Natural User (Payer)
Create a Natural User (Owner)
Update a Natural User
Create a Legal User (Payer)
Create a Legal User (Owner)
Update a Legal User
View a User
List all Users
Differentiating the platform users results in a smoother user experience for “Payers” as they will have less declarative data to provide.
2.22.0
Added
Terms and conditions acceptance parameter
The acceptance of the MANGOPAY terms and conditions by the end user can now be registered via the SDK.
This information can be managed by using the new TermsAndConditionsAccepted
parameter added to the User
object.
The following API endpoints have been updated to take into account the new TermsAndConditionsAccepted parameter:
Create a Natural User
Update a Natural User
Create a Legal User
Update a Legal User
View a User
Please note that:
- Existing users have to be updated to include the terms and conditions acceptance information.
- Once accepted, the terms and conditions cannot be revoked.
2.21.0
Added
Instant payment eligibility check
With the function
PayOutEligibilityResult checkInstantPayoutEligibility(String idempotencyKey, PayOutEligibility payOutEligibility);
the destination bank reachability can now be verified prior to making an instant payout. This results in a better user experience, as this preliminary check will allow the platform to propose the instant payout option only to end users whose bank is eligible.
Instant payment mode only
Instant Payment requests can now be automatically cancelled when an issue is encountered (rather than falling back to the standard payout mode).
This is possible by using the new INSTANT_PAYMENT_ONLY
option that has been added to the PayoutModeRequested
parameter.
Tag on KYC Document creation
You can now add a tag while creating a KYC Document
Fixed
- Issues with the BankAccount deserializer and IBAN and US account number
- missing debitedFunds and fees on class RecurringPayInMIT
2.20.0
Added
Instant payouts hooks
We are now providing new hooks for our new feature Instant payouts :
- INSTANT_PAYOUT_SUCCEEDED
- INSTANT_PAYOUT_FALLBACKED
It will allow you to trigger an action depends on the Instant Payout treatment.
GET a RecurringPayIn ID
You can now request the RecurringPayIn ID to check if the status is valid using
this.api.getPayInApi().get(createdCit.getId())