Azomland Docs

01 Quickstart

The fastest way to start is the public Markdown starter. Give it to your agent and it handles the first registration and Quick Sell request when eligible.

$ curl https://azomland.com/start/go.md

The starter tells your agent what to collect, where to submit, and how to request Quick Sell links through Azomland's public agent gateway.

02 How it works

Azomland is an agent commerce operating layer. We sit between your agent, the operator, and external licensed infrastructure partners through a risk and identity layer called KYA™.

KYA™ reviews agents across six dimensions before increasing access or enabling broader capabilities:

03 The starter skill

The public starter is the agent's instruction set for registering, requesting Quick Sell, and reporting the context KYA needs.

# Azomland KYA™ Application Skill

You are an AI agent starting commerce via Azomland.

## What you need to collect
- operator_email: email of the human operator
- agent_name: name of this agent
- framework: which framework you run on
- project_url: public project, repo, or company URL
- description: what you sell

## Where to submit
POST https://go.azomland.com/start

04 Operator dashboard — built by your agent

Azomland does not ship a traditional dashboard. Your agent builds it. The follow-up skill teaches the agent to read its earnings, reserves and payment links through scoped endpoints, and render them wherever the operator already works — a website page, a WhatsApp summary, a Notion table.

$ curl https://azomland.com/start/admin.md

The skill covers:

05 Access tiers

Every agent starts with Quick Sell. KYA™ score, real activity, operator verification, jurisdiction, and risk review determine whether the agent can scale.

Commercial terms, reserves, settlement timing, and access conditions are verified on the official website or in the operator agreement. This documentation explains the integration flow and does not define pricing.

06 API Reference

The stable public endpoint for agent applications and web form submissions.

Request body

Send as application/json.

Example request

curl -X POST https://go.azomland.com/start \
  -H "Content-Type: application/json" \
  -d '{
    "operator_email": "[email protected]",
    "agent_name": "myagent-v1",
    "framework": "LangChain",
    "project_url": "https://github.com/you/myagent",
    "description": "An agent that manages e-commerce operations autonomously"
  }'

Responses

201 Response body

On success the response includes a scoped starter Agent Kit so the agent can create Quick Sell links immediately. The token is short-lived and capped.

{
  "success": true,
  "application_id": "app_...",
  "agent_kit": {
    "quick_sell": {
      "access_token": "azk_...",
      "token_type": "Bearer",
      "expires_at": "2026-06-10T18:00:00Z",
      "scopes": ["quick_sell:create_link", "quick_sell:list_links", "..."],
      "max_amount_cents": 5000,
      "currency": "usd",
      "payment_links_url": "https://go.azomland.com/quick-sell/payment-links",
      "pay_base_url": "https://pay.azomland.com"
    }
  }
}

Error codes

07 Quick Sell Agent API

Once your agent holds a scoped token, these endpoints cover the full Quick Sell loop: create links, list them, and read earnings. All require the bearer token from the start flow.

Authorization: Bearer azk_...

Create a payment link

{
  "product_name": "Setup call",
  "amount_cents": 2000,
  "currency": "usd",
  "description": "Agent-created Quick Sell link"
}

Returns the Azomland checkout URL (pay.azomland.com/p/...). Share that URL — never an underlying provider URL. Requires scope quick_sell:create_link.

List payment links

Every link with url, active, amount_cents and product_name. Requires scope quick_sell:list_links.

Read earnings

Settlement totals, reserve state and cap usage — the data behind the operator dashboard. Requires scope quick_sell:read_payments.

{
  "application_id": "app_...",
  "currency": "usd",
  "summary": {
    "payments_count": 3,
    "gross_cents": 6000,
    "provider_fee_cents": 218,
    "azomland_fee_cents": 72,
    "reserve_held_cents": 2855,
    "reserve_released_cents": 2855,
    "available_cents": 5710
  },
  "quick_sell_limit": {
    "max_cents": 5000,
    "used_cents": 4000,
    "remaining_cents": 1000
  },
  "payments": [ "..." ]
}

Token errors