3.46.0

Added

Endpoints for new Reporting Service feature:

• POST Create a Report
• GET View a Report
• GET List all Reports

Webhook event types for new Reporting Service:

• REPORT_GENERATED
• REPORT_FAILED

Support for GET List Disputes for a PayIn endpoint.

3.45.1

Added

• Support for RecipientScope query parameter on GET List Recipients for a User
• POST Validate the format of User data

Fixed

• Status enum value on Identity Verification object changed from OUTDATED to OUT_OF_DATE

3.45.0

Added

Event types for user account webhooks, relevant to SCA enrollment in user endpoints and account closure:

• USER_ACCOUNT_VALIDATION_ASKED
• USER_ACCOUNT_ACTIVATED
• USER_ACCOUNT_CLOSED

Event types for instant and quoted FX conversions:

• INSTANT_CONVERSION_CREATED
• INSTANT_CONVERSION_SUCCEEDED
• INSTANT_CONVERSION_FAILED
• QUOTED_CONVERSION_CREATED
• QUOTED_CONVERSION_SUCCEEDED
• QUOTED_CONVERSION_FAILED

Support for 30-day deposit preauthorization features:

• POST Create a Deposit Preauthorized PayIn prior to complement
• POST Create a Deposit Preauthorized PayIn complement
• NO_SHOW_REQUESTED on updateDeposit method for PUT Cancel a Deposit Preauthorization or request a no-show
• GET View a PayIn (Deposit Preauthorized Card
• GET List Transactions for a Deposit Preauthorization

Fixed

• Regression on User-Agent header SDK version number

3.44.0

Added and refined

Hosted KYC/KYB endpoints

The following endpoints have been refined following the beta phase, and are now generally available:

• POST Create an IDV Session (no changes)
• GET View an IDV Session (includes Checks in response)
• GET List IDV Sessions for a User (new endpoint)

The previously available endpoint GET View Checks for an IDV Session has been removed (as Checks were integrated into the GET by ID).

See the guide for more details.

Recipients

The Country property has been added to Recipients, as a required query parameter on GET View the schema for a Recipient and as a required body parameter on POST Validate data for a Recipient and POST Create a Recipient.

Added

• GET List Deposit Preauthorizations for a Card
• GET List Deposit Preauthorizations for a User

3.43.0

Added

SCA on wallet access endpoints

ScaContext query parameter added on wallet access endpoints for the introduction of SCA:

• GET View a Wallet
• GET List Wallets for a User
• GET List Transactions for a User
• GET List Transactions for a Wallet

If SCA is required, Mangopay responds with a 401 response code. The PendingUserAction RedirectUrl is in the dedicated WWW-Authenticate response header.

See the tests for examples on handling this error.

BLIK with code

Support for BLIK with code endpoint

3.42.0

ℹ️ Note – Minimum language requirement changed to Python 3.9
Since 3.41.0, the SDK requires Python 3.9 as a minimum version. This is due to dependencies in the SDK's deployment pipeline on GitHub Actions and Ubuntu runners, which no longer support lower than Python 3.9. We recommend using Python 3.13.

---

Added

Recipients

• GET View payout methods
• GET View the schema for a Recipient
• POST Validate data for a Recipient
• POST Create a Recipient
• GET View a Recipient
• GET List Recipients for a user
• PUT Deactivate a Recipient
• Webhook event types:
  • RECIPIENT_ACTIVE
  • RECIPIENT_CANCELED
  • RECIPIENT_DEACTIVATED

SCA on Owner-initiated transfers

• On POST Create a Transfer
  • ScaContext body parameter
  • PendingUserAction response field containing RedirectUrl

Endpoints to close a user account

• DELETE Close a Natural User
• DELETE Close a Legal User

3.41.0

Changed

• ⚠️ Caution – Minimum language requirement changed to Python 3.9 ⚠️

The SDK has been upgraded to require Python 3.9 as a minimum version. This is due to dependencies in the SDK's deployment pipeline on GitHub Actions and Ubuntu runners, which no longer support lower than Python 3.9. Older versions of Python reached end-of-life in 2024 or before.

Failure to upgrade your Python language version to 3.9 before updating to this version of the SDK will result in errors. For more information on the differences between Python 3.9 and earlier, see the Python docs.

The SDK supports Python 3.13 down to 3.9. We recommend using Python 3.13.

Added

• POST Create a TWINT PayIn
• POST Create a Pay by Bank PayIn, including related PAYIN_NORMAL_PROCESSING_STATUS_PENDING_SUCCEEDED webhook event type
• PayPal recurring payments, thanks to the PaymentType value PAYPAL on Recurring PayIn Registrations and new endpoints (POST Create a Recurring PayPal PayIn (CIT) and POST Create a Recurring PayPal PayIn (MIT)

3.40.1

Changed

• User-Agent Header value standardized on format: User-Agent: Mangopay-SDK/SDKVersion (Language/LanguageVersion)

Fixed

• Fixed tests for categorize SCA users endpoint

3.40.0

Added

New endpoints for strong customer authentication (SCA) on Owner users:

• POST Create a Natural User (SCA)
• PUT Update a Natural User (SCA)
• POST Create a Legal User (SCA)
• PUT Update a Legal User (SCA)
• PUT Categorize a Natural User (SCA)
• PUT Categorize a Legal User (SCA)
• POST Enroll a User in SCA

Added

New endpoint for Payconiq:

• POST Create a Payconiq PayIn

3.39.1

Fixed

Rate limiting headers interpreted dynamically based on X-RateLimit-Reset time and for a variable number of bucket values.