sycade/bunqapi

.NET bunq API client by Sycade

Sycade.BunqApi

A .NET bunq API client written in C# by Sycade.

Requirements

To use the .NET bunq API client, you just need an API key (created in the Bunq Android (Sandbox) or iOS app!

Installation

Get the package from nuget or clone the repository and build it yourself.

Example

Create a new Installation and execute a payment

var rsaKeyPair = new RSACng(2048); // Generate a key pair or load one
var useSandbox = true;

var bunq = new BunqApiClient(rsaKeyPair, useSandbox);

// Link your API key to this IP address
var installation = await bunq.Installations.CreateAsync(rsaKeyPair);

var deviceServer = await bunq.DeviceServers.CreateAsync("your-api-key", "My First DeviceServer", installation.Token);
await bunq.Sessions.StartAsync("your-api-key", installation.Token);

// Get all bank accounts for the User
var accounts = (await bunq.MonetaryAccountBanks.GetAllAsync()).ToArray();

// Pay 25 euros from the first account to the second
var paymentId = await accounts[0].CreatePaymentAsync(accounts[1], new Amount(Currency.EUR, 25m), "My First Payment");

Reuse an existing installation

var rsaKeyPair = new RSACng(CngKey.Import(new byte[0], CngKeyBlobFormat.GenericPrivateBlob)); // Load your private key here
var serverPublicKey = new RSACng(CngKey.Import(new byte[0], CngKeyBlobFormat.GenericPublicBlob)); // Load the server public key

var installationToken = new Token(File.ReadAllText("the-installation-token.txt")); // Load your installation token

var useSandbox = true;

var bunq = new BunqApiClient(rsaKeyPair, serverPublicKey, useSandbox);
await bunq.Sessions.StartAsync("your-api-key", installationToken);

// ... Use your session

bunqapi's Issues

Deserialization error upon creating DeviceServer

Hi there (hoi!),

I am trying to use your API client to retrieve just my transactions from bunq, just to test everything quickly.

At the following code I'm getting a serialization error:

var deviceServer = await bunq.DeviceServers.CreateAsync("Bluewalk test", apiKey, installation.Token);

Newtonsoft.Json.JsonSerializationException: 'Cannot deserialize the current JSON array (e.g. [1,2,3]) into type 'Sycade.BunqApi.Model.Error' because the type requires a JSON object (e.g. {"name":"value"}) to deserialize correctly.

To fix this error either change the JSON to a JSON object (e.g. {"name":"value"}) or change the deserialized type to an array or a type that implements a collection interface (e.g. ICollection, IList) like List that can be deserialized from a JSON array. JsonArrayAttribute can also be added to the type to force it to deserialize from a JSON array.

Update 09:17
The error that I'm receiving isn't parsed correctly:

parsedObject["Error"]
{[
{
"error_description": "User credentials are incorrect. Incorrect API key or IP address.",
"error_description_translated": "User credentials are incorrect. Incorrect API key or IP address."
}
]}