Build in your language.

npm install ./aegven-sdk-0.1.0.tgz

// Run on your integration server with the supplied SDK.
import { Aegven } from '@aegven/sdk';

function required(name: string): string {
  const value = process.env[name];
  if (!value) throw new Error('Missing server configuration: ' + name);
  return value;
}

const aegven = new Aegven({
  baseURL: required('AEGVEN_API_URL'), // Includes /api/v1
  apiKey: required('AEGVEN_API_KEY'),
});

const obligationInput = {
  "obligation_type": "invoice",
  "external_reference": {
    "namespace": "your-system",
    "id": "invoice-1042"
  },
  "debtor": {
    "name": "Example Business",
    "email": "accounts@example.com"
  },
  "amount_minor": "125000",
  "currency": "USD",
  "deadline": "2027-01-15",
  "business_context": {
    "invoice_number": "INV-1042",
    "description": "Business services"
  }
} as const;

// Store this key with the input before the first attempt; reuse both on retries.
const result = await aegven.obligations.register(
  obligationInput,
  required('AEGVEN_IDEMPOTENCY_KEY'),
);

// Older accepted replays can contain only the invoice projection.
const obligationId = result.obligation?.id ?? result.invoice.id;
const request = result.payment_request
  ?? await aegven.paymentRequests.getForObligation(obligationId);
const hostedUrl = request.hosted_url;
// Save the source mapping securely.
// Add hostedUrl to your existing customer communication.
// Treat the URL as confidential; never put it in logs or analytics.

python3 -m venv .venv
.venv/bin/python -m pip install ./aegven_sdk-0.1.0-py3-none-any.whl

import os
from aegven import Aegven, models

client = Aegven(os.environ['AEGVEN_API_URL'], os.environ['AEGVEN_API_KEY'])
request: models.RegisterObligation = {
    'obligation_type': 'invoice',
    'external_reference': {'namespace': 'your-system', 'id': 'invoice-1042'},
    'debtor': {'name': 'Example Business', 'email': 'accounts@example.com'},
    'amount_minor': '125000',
    'currency': 'USD',
    'deadline': '2027-01-15',
    'business_context': {'invoice_number': 'INV-1042', 'description': 'Business services'},
}
# Persist the input and key before the first call. Reuse both on retries.
created = client.register_obligation(request, os.environ['AEGVEN_IDEMPOTENCY_KEY'])
obligation = created.get('obligation')
obligation_id = obligation['id'] if obligation else created['invoice']['id']
payment_request = created.get('payment_request') or client.get_payment_request(obligation_id)
hosted_url = payment_request['hosted_url']
# Save the source mapping and add hosted_url to your existing communication.
# Do not log the link or credential.

dotnet add package Aegven.Sdk --version 0.1.0 --source /path/to/supplied-artifacts

using System;
using Aegven;

static string Required(string name) =>
    Environment.GetEnvironmentVariable(name)
    ?? throw new InvalidOperationException("Missing server configuration: " + name);

using var client = new AegvenClient(Required("AEGVEN_API_URL"), Required("AEGVEN_API_KEY"));
var request = new RegisterObligation
{
    ObligationType = "invoice",
    ExternalReference = new() { Namespace = "your-system", Id = "invoice-1042" },
    Debtor = new() { Name = "Example Business", Email = "accounts@example.com" },
    AmountMinor = "125000", Currency = "USD", Deadline = "2027-01-15",
    BusinessContext = new() { InvoiceNumber = "INV-1042", Description = "Business services" },
};
// Persist the input and key before the first call. Reuse both on retries.
var created = await client.RegisterObligationAsync(request, Required("AEGVEN_IDEMPOTENCY_KEY"));
var obligationId = created.Obligation?.Id ?? created.Invoice.Id;
var paymentRequest = created.PaymentRequest ?? await client.GetPaymentRequestAsync(obligationId);
var hostedUrl = paymentRequest.HostedUrl;
// Save the source mapping and add hostedUrl to your existing communication.
// Do not log the link or credential.

mkdir -p vendor-src
tar -xzf aegven-go-0.1.0.tar.gz -C vendor-src
go mod edit -require=aegven.com/sdk/go@v0.1.0
go mod edit -replace=aegven.com/sdk/go=./vendor-src/aegven-go-0.1.0
go mod tidy

package main

import (
	aegven "aegven.com/sdk/go"
	"context"
	"os"
	"time"
)

func main() {
	client, err := aegven.New(aegven.Options{
		BaseURL: os.Getenv("AEGVEN_API_URL"), APIKey: os.Getenv("AEGVEN_API_KEY"),
	})
	if err != nil {
		panic(err)
	}
	ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)
	defer cancel()
	description := "Business services"
	// Persist the input and key before the first call. Reuse both on retries.
	created, err := client.RegisterObligation(ctx, aegven.RegisterObligation{
		ObligationType:    "invoice",
		ExternalReference: aegven.ExternalReference{Namespace: "your-system", Id: "invoice-1042"},
		Debtor:            aegven.RegisterObligationDebtor{Name: "Example Business", Email: "accounts@example.com"},
		AmountMinor:       "125000", Currency: "USD", Deadline: "2027-01-15",
		BusinessContext: aegven.BusinessContext{InvoiceNumber: "INV-1042", Description: &description},
	}, os.Getenv("AEGVEN_IDEMPOTENCY_KEY"))
	if err != nil {
		panic(err)
	}
	obligationID := created.Invoice.Id
	if created.Obligation != nil {
		obligationID = created.Obligation.Id
	}
	paymentRequest, err := client.GetPaymentRequest(ctx, obligationID)
	if err != nil {
		panic(err)
	}
	_ = paymentRequest // Save HostedUrl securely on the original source record.
	// Do not log the link or credential.
}

// TypeScript / JavaScript
import { verifyWebhook } from '@aegven/sdk/webhooks';
const valid = await verifyWebhook(rawBody, signatureHeader, signingSecret);

# Python
from aegven import verify_webhook
valid = verify_webhook(raw_body, signature_header, signing_secret)

// C# / .NET
var valid = Webhooks.Verify(rawBody, signatureHeader, signingSecret);

// Go
valid := aegven.VerifyWebhook(rawBody, signatureHeader, signingSecret, time.Now(), 5*time.Minute)