3.11.1

Fixed

Tests has been fixed due to API evolution.

3.11.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.

3.10.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.

3.9.0

Added

Instant payment eligibility check

With the function
PayOut::InstantPayoutEligibility::Reachability.create(params)
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.

3.8.0

Added

You can now change the status to "ENDED" for a recurring payment.

Fixed

• "Status" is now available in the response when you request a recurring payment registration.

3.7.0

Added

Payconiq

As requested by numerous clients, we are now providing Payconiq as a new mean-of-payment. To request access, please contact MANGOPAY.

Flags for KYC documents

We provide more information regarding refused KYC documents. Therefore it will be easier for you to adapt your app behavior and help your end user.

You are now able to see the exact explanation thanks to a new parameter called “Flags”.

It has been added to

$this->_api->KycDocuments->Get($kycDocument->Id);

It will display one or several error codes that provide the reason(s) why your document validation has failed. These error codes description are available here.

Fixed

Idempotency key is not required anymore for UBO declarations

3.6.0

Added

• You can now update and view a Recurring PayIn Registration object. To know more about this feature, please consult the documentation here.
• To improve recurring payments, we have added new parameters for CIT : DebitedFunds & Fees. To know more about this feature, please consult the documentation here

3.5.0

Added

We have added a new feature recurring payments dedicated to clients needing to charge a card repeatedly, such as subscriptions or payments installments.

You can start testing in sandbox, to help you define your workflow. This release provides the first elements of the full feature.

• Create a Recurring PayIn Registration object, containing all the information to define the recurring payment
• Initiate your recurring payment flow with an authenticated transaction (CIT) using the Card Recurring PayIn endpoint
• Continue your recurring payment flow with an non-authenticated transaction (MIT) using the Card Recurring PayIn endpoint

This feature is not yet available in production and you need to contact the Support team to request access.

Accepted PRs

• Add support for refund creation
• Allow to fetch UBO Declaration without User ID

3.4.0

Added

Instant payment

Mangopay has introduced few months ago the instant payment mode. It allows payouts (transfer from wallet to user bank account) to be processed within 25 seconds, rather than the 48 hours for a standard payout.

We have added a new feature in the Ruby SDK. You can now verify the mode applied to an instant payment.

bankwire = MangoPay::PayOut::BankWire.get_bankwire(payout['Id'])
# where payout['Id'] is the id of an existing payout

Please note that this feature must be authorized and activated by MANGOPAY. More information here.

Accepted PRs

• Add support to create refunds for PayIn, Transfer and PayOut transactions.
• ResponseError object improvment

3.3.0

Fixed

IBAN for testing purposes

⚠️ IBAN provided for testing purpose should never be used outside of a testing environement!

More information about how to test payments, click here.

Others

• Adding missing json require in log requests filter spec. Thank you @Vin0uz
• Extend fetch_wallet and create_payout API. Thank you @peterb

Added

Some of you use a lot the PreAuthorization feature of our API. To make your life easier, we have added three new events :

• PREAUTHORIZATION_CREATED
• PREAUTHORIZATION_SUCCEEDED
• PREAUTHORIZATION_FAILED

The goal is to help you monitor a PreAuthorization with a webhook.

Example: If a PreAuthorization is desynchronized, when the status is updated, you will be able to know it.