mtSDK 0.0.5

Getting Started with Modern Treasury

Introduction

The Modern Treasury REST API. Please see https://docs.moderntreasury.com for more details.

Install the Package

If you are building with .NET CLI tools then you can also use the following command:

dotnet add package mtSDK --version 0.0.5

You can also view the package at: https://www.nuget.org/packages/mtSDK/0.0.5

Initialize the API Client

Note: Documentation for the client can be found here.

The following parameters are configurable for the API Client:

The API client can be initialized as follows:

Code-Based Initialization

using Microsoft.Extensions.Logging;
using ModernTreasury.Standard;
using ModernTreasury.Standard.Authentication;

namespace ConsoleApp;

ModernTreasuryClient client = new ModernTreasuryClient.Builder()
    .BasicAuthCredentials(
        new BasicAuthModel.Builder(
            "BasicAuthUserName",
            "BasicAuthPassword"
        )
        .Build())
    .HttpClientConfig(httpClientConfig =>
        httpClientConfig.Timeout(TimeSpan.FromSeconds(100)))
    .Environment(ModernTreasury.Standard.Environment.Production)
    .LoggingConfig(config => config
        .LogLevel(LogLevel.Information)
        .RequestConfig(reqConfig => reqConfig.Body(true))
        .ResponseConfig(respConfig => respConfig.Headers(true))
    )
    .Build();

Configuration-Based Initialization

using ModernTreasury.Standard;
using Microsoft.Extensions.Configuration;

namespace ConsoleApp;

// Build the IConfiguration using .NET conventions (JSON, environment, etc.)
var configuration = new ConfigurationBuilder()
    .AddJsonFile("config.json")
    .AddEnvironmentVariables() // [optional] read environment variables
    .Build();

// Instantiate your SDK and configure it from IConfiguration
var client = ModernTreasuryClient
    .FromConfiguration(configuration.GetSection("ModernTreasury"));

See the Configuration-Based Initialization section for details.

Environments

The SDK can be configured to use a different environment for making API calls. Available environments are:

Fields

Authorization

This API uses the following authentication schemes.

• basic_auth (Basic Authentication)

List of APIs

• Account Detail
• Balance Report
• Connection
• Counterparty
• Document
• Event
• Expected Payment
• External Account
• Incoming Payment Detail
• Internal Account
• Invoice Line Item
• Invoice
• Ledger Account Category
• Ledger Account Payout
• Ledger Account Statement
• Ledger Account
• Ledger Entry
• Ledger Event Handler
• Ledger Transaction
• Ledgerable Event
• Ledger
• Line Item
• Paper Item
• Payment Order
• Payment Reference
• Ping
• Return
• Reversal
• Routing Detail
• Transaction Line Item
• Transaction
• Validation
• Virtual Account
• Account Collection Flow
• Payment Flow

SDK Infrastructure

Configuration

• Configuration-Based Initialization
• HttpClientConfiguration
• HttpClientConfigurationBuilder
• LogBuilder
• LogRequestBuilder
• LogResponseBuilder
• ProxyConfigurationBuilder

HTTP

• HttpCallback
• HttpContext
• HttpRequest
• HttpResponse
• HttpStringResponse

Utilities

• ApiException
• ApiResponse
• ApiHelper
• CustomDateTimeConverter
• UnixDateTimeConverter