RL.PaymentProviders.Api.SumUp 51.0.0

.Net Client for SumUp payment provider

How to use it

• First of all we need a token to work with SumUp Web Api. This token we can get on SumUp API keys page
• And that's all. If you have a token, you just need insert code as follows and use SumUp client for all your needs:

    using RL.PaymentProviders.Api.SumUp;
	
    [Test]
    public async Task When_getting_transaction_by_transaction_code_Then_return_ok_response_with_transaction_data()
    {
	var api = SumUpApiClient.Create(ApiKey);
	
	var transaction = await api.RetrieveTransactionAsync(transactionCode: "TDZQ9KGV96");
	
	Assert.That(transaction.IsSuccessStatusCode, Is.True);
	Assert.That(transaction.Content, Is.Not.Null);
    }

How to handle api response

Each client's method return folowing structure:

public class SumUpApiResponse
{
   /// <summary>
   /// If IsSuccessStatusCode = true return deserialized object by SumUp request, otherwise return null 
   /// </summary>
   public TContent? Content { get; internal set; }
   /// <summary>
   /// If IsSuccessStatusCode = false return deserialized error object with description by SumUp request, otherwise return null
   /// </summary>
   public SumUpApiError? Error { get; internal set; }
   /// <summary>
   /// Sometimes SumUp api server return an array of errors instead of 1 error 
   /// </summary>
   public SumUpApiError[]? Errors { get; internal set; }
   /// <summary>
   /// Http status code 
   /// </summary>
   public HttpStatusCode? StatusCode { get; internal set; }
   /// <summary>
   /// True if StatusCode = HttpStatusCode.OK
   /// </summary>
   public bool IsSuccessStatusCode  { get; internal set; }
}

So you just need to look into Content, and if it's null than it was an error and you can get it from Error/Errors.

How to log api calls

• Implement your own logger based on IApiLogger
• Create SumUp api client using your api token and logger created previously

using RL.PaymentProviders.Api.Core;

class MyCustomLogger : IApiLogger
{

}

var apiSettings = new SumUpApiSettings{ApiToken = "your api token"};
var myCustomLogger = new MyCustomLogger();
 
var sumUpApi = new SumUpApiClient(apiSettings, myCustomLogger);