Getting started

Quickstart

Configure a service, install its SDK and review a new transaction in the portal.

Finans 0.44.0SDK 0.11.026 October 2026

#1. Select the institution and environment

Sign in to the institution portal and check the institution and environment in the header. Keep test and production environments and credentials separate. Follow the setup sequence to create the application and its services. Confirm that the institution licence is active.

app.py

from pathlib import Path
from sigillum_finans import start

sdk = start(Path("/secure/config.json"))

# Your existing FastAPI / ASGI application
app = sdk.wrap_asgi(app)

# Portal entry point: POST /assist
# Send a new request and review its transaction trace.

Program.cs

using Sigillum.Finans.Sdk;

builder.Services.AddSigillum(
    "/secure/config.json");
builder.Services.AddHttpClient();

var app = builder.Build();
app.UseSigillum();
// Your existing endpoints and app.Run()

PaymentDemo.java

import io.sigillum.finans.Sigillum;
import java.nio.file.Paths;

var sdk = Sigillum.start(
    Paths.get("/secure/config.json"));

server.createContext("/payments/assess",
    sdk.httpHandler(existingHandler));
// Your existing JDK HTTP server

Use the configuration supplied by your institution’s portal.

#2. Define the actual entry point

Select the application’s entry service. For HTTP traffic, specify the actual method and path; for scheduled work, specify the operation name. The examples use POST /assist for Python, POST /loans/evaluate for .NET and POST /payments/assess for Java. Observation starts only from a matching entry point or a valid propagated context.

#3. Download the package and configuration

In Integrations, download the SDK package for the service’s language and its config.json file. The configuration contains the service identity, trust material and signed entry definitions. Keep it out of source control and the public website. Supply its absolute path to the application.

#4. Integrate the SDK

Select a language in the code example. The .NET, Java and Python guides describe installation and supported boundaries. Use the shared ai, source and custom observation families to add meaningful model, tool and source information beyond automatic HTTP observation.

#5. Send a new test request

Send a synthetic request to your application. In Transaction records, select the application and time range. Expand the progress row while the record is being prepared. Once it is ready, inspect Transaction summary, All records and Record integrity.

If no record appears, check SDK status, entry-point matching, the service connection, TLS trust and delivery metrics. See Troubleshooting.

Sigillum Finans · Source-matched product reference