Documentation

Everything you need to integrate and manage AI agent spend control

Getting Started

Quick start guide to set up your first AI agent with spending controls

→Integration Guide
→API Reference
→Authentication

Core Concepts

Understand the key components of the Auctra platform

→Agents & Instruments
→Policy Templates
→Authorization Flow
→Observe vs Enforce Mode

Advanced Topics

Deep dive into advanced features and customization

→Custom Policy Constraints
→Webhook Integration
→Audit Logging
→Performance Optimization

Key Documentation

Authentication & Authorization

Learn how to authenticate with the Auctra API using JWT tokens and manage API credentials.

View Authentication Guide →

Policy Configuration

Create and manage spending policies using templates like merchant-locked, low-risk, or human-review-required.

Coming soon

Webhook Setup

Configure your issuer processor to call Auctra during transaction authorization.

Coming soon

Error Handling

Understand error codes, rate limits, and best practices for handling API failures.

Coming soon

Code Examples

Authorization Check Example

import requests
import jwt
import time

# Generate JWT
payload = {
    "key_id": "api_key_abc123...",
    "iat": int(time.time()),
    "exp": int(time.time()) + 3600
}
token = jwt.encode(payload, "your_shared_secret", algorithm="HS256")

# Make authorization request
response = requests.post(
    "https://api.auctra.io/v1/authorize",
    headers={"Authorization": f"Bearer {token}"},
    json={
        "instrument_id": "inst_xyz789",
        "amount": 4999,
        "currency": "USD",
        "mcc": "5411",
        "merchant_name": "GROCERY STORE",
        "issuing_platform": "MARQETA"
    }
)

decision = response.json()
print(f"Decision: {decision['decision']}")  # APPROVE or DECLINE