SlothApi

A netstandard2.0 library for sending requests to Sloth API

Installation

dotnet add package SlothApi

Using via DI in AspNetCore

Initialization

services.AddSlothApiClient(options => 
{
    // only v2 is supported
    options.BaseUrl = "https://sloth-api-production.azurewebsites.net/v2/";
    options.ApiKey = "[your api key here]";
})

services.AddScoped<MyClass>();

Usage

using SlothApi.Models;
using SlothApi.Services;

public class MyClass
{
    private readonly ISlothApiClient _slothApiClient;
    public MyClass(ISlothApiClient slothApiClient)
    {
        this._slothApiClient = slothApiClient;
    }

    public async Task MoveMoney(decimal amount)
    {
        var model = new CreateTransactionViewModel(source: "[a source]", sourceType: "[a source type (ie: Income)]")
        {
            MerchantTrackingNumber = "[a tracking number]",
            MerchantTrackingUrl = "[a url]",
            AutoApprove = false,
            ValidateFinancialSegmentStrings = true,
            ProcessorTrackingNumber = "[a tracking number]",
            KfsTrackingNumber = "[a tracking number]",
            Description = "[a description]",
            Transfers = new List<CreateTransferViewModel>
            {
                // Must be at leaset one Debit and one Credit. Debits and credits must balance.
                new CreateTransferViewModel(
                    financialSegmentString: "[a financial segment string]", 
                    amount: 100.00M, 
                    description: "Moving some money", 
                    direction: Transfer.CreditDebit.Debit),
                new CreateTransferViewModel(
                    financialSegmentString: "[a financial segment string]", 
                    amount: 100.00M, 
                    description: "Moving some money", 
                    direction: Transfer.CreditDebit.Credit)
            },
            Metadata = new List<MetadataEntry>
            {
                new MetadataEntry
                {
                    Name = "[a name]",
                    Value = "[a value]"
                }
            }
        };

        ApiResult result = await _slothApiClient.CreateTransaction(model);
        if (!result.Success)
        {
            throw new Exception($"Api call did not succeed. Returned status: {result.StatusCode} Returned message: {result.Message}");
        }
    }
}

Manual instantiation

ISlothApiClient client = new SlothApiClient(new SlothApiClientOptions()
{
    // only v2 is supported
    options.BaseUrl = "https://sloth-api-production.azurewebsites.net/v2/";
    options.ApiKey = "[your api key here]";
});