Introduction
The Mangopay .NET SDK makes working with the Mangopay API easier in a .NET environment. This SDK is open-source and available on GitHub. Mangopay .NET SDKPrerequisitesTo run the Mangopay .NET SDK, you’ll need:
- A
ClientId
and an API key – if you don’t have these, contact Sales to get access to the Mangopay Dashboard - .NET Standard 2.0 or .NET 6.0
- Common.Logging library (version 3.4.1 or higher)
- Newtonsoft.Json (version 13.0.1 or higher)
- RestSharp (version 107.3.0 or higher)
- NETStandard.Library (version 2.0.3 or higher)
Getting started
1. Install the Mangopay package
Installation from the .NET Package Manager Console2. Initialize and configure the SDK
Key | Type | Default value | Description |
---|---|---|---|
ClientId | string | null | Your Mangopay ClientId – can be found in the Dashboard. |
ClientPassword | string | null | Your Mangopay API key – can be found in the Dashboard. |
BaseUrl | string | https://api.sandbox.mangopay.com/v2.01/ | The API sandbox URL. Set to the sandbox environment by default. To enable production environment, set it to https://api.mangopay.com |
Timeout | integer | 0 | Time to wait in milliseconds while trying to establish a connection before terminating the attempt and generating an error. |
LoggerFactoryAdapter | ILoggerFactoryAdapter | NoOpLoggerFactoryAdapter() | Logger adapter implementation. Disabled by default. |
UKHeaderFlag | boolean | false | Platforms that have contracted with Mangopay’s UK entity (MANGOPAY U.K. LIMITED) must include the following header in all requests. If you’re using an SDK, you need to set it to true . |
SDK usage
In the Mangopay documentation, you’ll find detailed information of all endpoints paired with its corresponding .NET SDK method implementation example. Be sure to customize the provided code to suit your specific requirements.Idempotency support
To make a request with idempotency support, addidempotencyKey
parameter to your function.
For more information, see the Idempotency article.
Call - Create user with idempotency key
Call - View API Response
Output
Pagination
For endpoints that support pagination, you can use thePagination
object.
In the object, you need to specify the page and items per page to return.
As a result, the answer will be paginated, and the total number of items and the total number of pages will be provided.
For example, with the GET List all Users endpoint
:
Rate limiting status
Rate limiting in Mangopay restricts the frequency of API requests a client can make over a defined period, automatically updating the limit with each request and blocking additional requests if the limit is exceeded until it resets. For more information, see the rate limiting article.Call - View a user
Output