Build on Trustinera AI

import TrusterineAI from "@trustinera/ai";

const client = new TrusterineAI({ apiKey: process.env.TIA_API_KEY });

// Categorise a single transaction
const result = await client.categorise.submit({
  amount: 142.50,
  currency: "GBP",
  description: "AMAZON EU SARL",
  date: "2026-03-17",
});

console.log(result.category);        // → "Office Supplies"
console.log(result.confidence);      // → 0.97
console.log(result.explainability);  // → ["Merchant: AMAZON EU", "MCC: 5734"]

// Batch categorise with structured output
const batch = await client.categorise.submitBatch([
  { amount: 142.50,  currency: "GBP", description: "AMAZON EU SARL",     date: "2026-03-17" },
  { amount: 2400.00, currency: "GBP", description: "GOOGLE WORKSPACE",    date: "2026-03-17" },
  { amount: 89.99,   currency: "GBP", description: "MICROSOFT AZURE",     date: "2026-03-17" },
]);

batch.results.forEach(tx => {
  console.log(`${tx.description.padEnd(30)} → ${tx.category} (${(tx.confidence * 100).toFixed(0)}%)`);
});

import express from "express";
import TrustineraAI from "@trustinera/ai";

const app = express();
const client = new TrustineraAI({ apiKey: process.env.TIA_API_KEY });

app.post("/webhooks/trustinera", express.raw({ type: "application/json" }), (req, res) => {
  // Verify the webhook signature
  const sig = req.headers["x-tia-signature"] as string;
  let event;

  try {
    event = client.webhooks.constructEvent(req.body, sig, process.env.TIA_WEBHOOK_SECRET!);
  } catch (err) {
    return res.status(400).send(`Webhook Error: ${(err as Error).message}`);
  }

  switch (event.type) {
    case "transaction.categorised":
      console.log("Categorised:", event.data.transaction_id, event.data.category);
      break;
    case "pipeline.completed":
      console.log("Pipeline done:", event.data.pipeline_id, event.data.record_count);
      break;
    case "fraud.alert.raised":
      console.log("Fraud alert:", event.data.transaction_id, event.data.risk_level);
      break;
  }

  res.json({ received: true });
});

app.listen(3000);

package main

import (
    "context"
    "fmt"
    "os"

    trustinera "github.com/trustinera/trustinera-go"
    "github.com/trustinera/trustinera-go/categorise"
)

func main() {
    client := trustinera.NewClient(os.Getenv("TIA_API_KEY"))

    result, err := client.Categorise.Submit(context.Background(), categorise.SubmitParams{
        Amount:      142.50,
        Currency:    "GBP",
        Description: "AMAZON EU SARL",
        Date:        "2026-03-17",
    })
    if err != nil {
        fmt.Fprintf(os.Stderr, "error: %v\n", err)
        os.Exit(1)
    }

    fmt.Printf("Category:    %s\n", result.Category)
    fmt.Printf("Confidence:  %.2f\n", result.Confidence)
    fmt.Printf("Explain:     %v\n", result.Explainability)
}

use trustinera_ai::{Client, categorise::SubmitRequest};

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    let client = Client::new(std::env::var("TIA_API_KEY")?);

    let result = client
        .categorise()
        .submit(SubmitRequest {
            amount: 142.50,
            currency: "GBP".into(),
            description: "AMAZON EU SARL".into(),
            date: "2026-03-17".into(),
            ..Default::default()
        })
        .await?;

    println!("Category:   {}", result.category);
    println!("Confidence: {:.2}", result.confidence);
    println!("Explain:    {:?}", result.explainability);

    Ok(())
}

require "trustinera_ai"

client = TrustineraAI::Client.new(api_key: ENV["TIA_API_KEY"])

result = client.categorise.submit(
  amount: 142.50,
  currency: "GBP",
  description: "AMAZON EU SARL",
  date: "2026-03-17"
)

puts result.category        # → Office Supplies
puts result.confidence      # → 0.97
puts result.explainability  # → ["Merchant: AMAZON EU", "MCC: 5734"]

# Rails integration example
class TransactionCategorizerJob < ApplicationJob
  def perform(transaction_id)
    tx = Transaction.find(transaction_id)
    result = $tia_client.categorise.submit(
      amount: tx.amount, currency: tx.currency,
      description: tx.description, date: tx.date
    )
    tx.update!(category: result.category, confidence: result.confidence)
  end
end

# Categorise a single transaction
curl -X POST https://api.trustinera.ai/v1/categorise/submit \
  -H "Authorization: Bearer $TIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 142.50,
    "currency": "GBP",
    "description": "AMAZON EU SARL",
    "date": "2026-03-17",
    "reference": "TXN-001"
  }'

# Response:
# {
#   "id": "cat_a1b2c3d4",
#   "category": "Office Supplies",
#   "sub_category": "Software & Subscriptions",
#   "confidence": 0.97,
#   "model_version": "categorise-v4.2",
#   "explainability": ["Merchant: AMAZON EU", "MCC: 5734"],
#   "processed_at": "2026-03-17T14:23:00Z"
# }

# Submit a batch of transactions
curl -X POST https://api.trustinera.ai/v1/categorise/batch \
  -H "Authorization: Bearer $TIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transactions": [
      {"amount": 142.50,  "currency": "GBP", "description": "AMAZON EU SARL",   "date": "2026-03-17"},
      {"amount": 2400.00, "currency": "GBP", "description": "GOOGLE WORKSPACE",  "date": "2026-03-17"},
      {"amount": 89.99,   "currency": "GBP", "description": "MICROSOFT AZURE",   "date": "2026-03-17"}
    ]
  }'

# Score a transaction for fraud risk (Sentrise)
curl -X POST https://api.trustinera.ai/v1/sentrise/score \
  -H "Authorization: Bearer $TIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_id": "TXN-789",
    "amount": 7500.00,
    "currency": "GBP",
    "merchant_name": "ACME OVERSEAS LTD",
    "country": "NG",
    "payment_method": "wire_transfer",
    "account_id": "ACC-111"
  }'

# Response:
# {
#   "risk_level": "HIGH",
#   "risk_score": 0.89,
#   "triggered_rules": ["HIGH_VALUE_WIRE", "HIGH_RISK_COUNTRY"],
#   "recommended_action": "HOLD_FOR_REVIEW",
#   "case_id": "case_xyz999"
# }