Barion .NET library
C# PowerShell JavaScript
Latest commit fe38f73 Sep 1, 2016 @szelpe Added release notes.
Failed to load latest commit information.
.gitattributes Implemented the BarionClient class and 4 operations. Aug 10, 2016

Barion .NET

The Barion .NET library makes it easy to add Barion payment to your .NET application. It is built upon Barion's Web API.

Build status

Supported operations

  • Immediate payment
  • Reservation payment
  • Refund
  • Finish Reservation


  • .NET 4.5 or .NET Standard 1.3 and above
  • Newtonsoft.Json

Release Notes

Release Notes


The easiest way to install is to use NuGet:

Install-Package BarionClient


The heart of the library is the BarionClient class which provides the ExecuteAsync method to execute various operations. Create the operation class you want to use: StartPaymentOperation, GetPaymentStateOperation, RefundOperation or FinishReservationOperation respectively. After setting the operation properties you can use the ExecuteAsync method and pass the opertaion as the parameter.

Note that BarionClient implements IDisposable, use it accordingly.

QuickStart guide


var barionSettings = new BarionSettings
        BaseUrl = new Uri(""),
        POSKey = Guid.Parse("d1bcff3989885d3a98235c1cd768eba2")

using(var barionClient = new BarionClient(barionSettings))
    var startPayment = new StartPaymentOperation();

    // add payment parameters to startPayment

    var result = await barionClient.ExecuteAsync<StartPaymentOperationResult>(startPayment);

        // redirect the user to the payment page

Sample website

You can find a complete sample website under the Samples directory. Check BarionController for a detailed example on how to use the client.

Retry Policies

BarionClient comes with built-in retry policies. By default, if a Barion operation fails due to a transient error, it will retry the operation automatically.

You can choose the retry policy to use from the list below:

  • Exponential retry (default): the delay between each retry grows exponentially, e.g. ~3s -> ~7s -> ~15s -> ~31s. The exponential retry policy is well suited for background operations, which are not time sensitive.
  • Linear retry: the delay between each retry is fixed, e.g. 0.5s -> 0.5s -> 0.5s. The linear retry policy should be used in user interactive operations. If a user is waiting for the result, it's usually better to fail fast than letting the user wait for minutes.
  • No retry: will not retry the failed operations. This option should be used if a retry strategy is implemented on a higher level.
barionClient.RetryPolicy = new LinearRetry(TimeSpan.FromMilliseconds(500), 3);


The default timeout for every operation is 120s. You can change the timeout by settings the Timeout property of the BarionClient:

barionClient.Timeout = TimeSpan.FromSeconds(15);

You can disable the timeout by using InfiniteTimeSpan:

barionClient.Timeout = System.Threading.Timeout.InfiniteTimeSpan;

Extending the API

You can easily add your own operations by creating a new subclass of BarionOperation. E.g. if you want to support the Reject payment operation you need to create a new class:

public class RejectOperation : BarionOperation
    public override HttpMethod Method => HttpMethod.Post;
    public override Uri RelativeUri => new Uri("/v2/Payment/Reject", UriKind.Relative);
    public override Type ResultType => typeof(RejectOperationResult);

    public string UserName { get; set; }
    public string Password { get; set; }
    public Guid PaymentId { get; set; }

And the class which represents the result of the operation:

public class RejectOperationResult : BarionOperationResult
    public Guid PaymentId { get; set; }
    public bool IsSuccess { get; set; }

After this you can use your own operation class the same way as the built in ones.


You're welcome to contribute. To build the source code you'll need Visual Studio 2015.

You can use createPackage.ps1 to create the NuGet package.