The .NET SDK helps you to communicate with the Ingenico Connect Server API. It's primary features are:
- convenient C# wrapper around the API calls and responses
- marshalls C# request objects to HTTP requests
- unmarshalls HTTP responses to C# response objects or C# exceptions
- handling of all the details concerning authentication
- handling of required meta data
Its use is demonstrated by an example for each possible call. The examples execute a call using the provided API keys.
See the Ingenico Connect Developer Hub for more information on how to use the SDK.
This repository consists out of four main components:
- The source code of the SDK itself:
/connect-sdk-dotnet - The source code of the SDK unit tests:
/connect-sdk-dotnet-tests - The source code of the example integration tests:
/connect-sdk-dotnet-it - The source code of the example calls:
/connect-sdk-dotnet-examples
.NET Framework 4.5 is required. In addition, the following packages are required:
- Microsoft BCL Portability Pack 1.1.10 or higher
- Microsoft BCL Build Components 1.0.21 or higher
- Microsoft HTTP Client Libraries 2.2.29 or higher
- System.Collections.Immutable 1.2.0 or higher
- Json.NET 9.0.1 or higher
- NLog 4.3.7 or higher
To install the latest .NET SDK release, run the following command in the Package Manager Console (Tools -> NuGet Package Manager -> Package Manager Console) in Visual Studio:
PM> Install-Package connect-sdk-dotnet
To install the latest .NET SDK source in a solution, clone the repository, and add the file connect-sdk-dotnet.csproj to the current solution. On the project depending on the Ingenico Connect SDK, add a reference to the connect-sdk-dotnet project.
Note that you will need an IDE that supports version 6.0 of the C# language, such as Visual Studio 2015. Older versions will not be able to compile the SDK code, but they will be able to use the SDK as a dependency, e.g. through NuGet.
This repository uses Visual Studio 2015 or up to build. Open connect-sdk-dotnet.sln in Visual Studio, and click build.