For Vendors

Be where your customers’
AI assistants shop

Your customers’ AI assistants will complete transactions on their behalf — book flights, pay bills, place orders. Make sure your services are reachable when they do.

Every request comes with a signed mandate: cryptographic proof the customer authorised it and the exact spend ceiling they approved. You never see payment credentials — you call your own payment processor with our mandate as proof of authorisation.

How it works

Three steps to AI-native transactions

01

Register your vendor agent

Deploy the vendor agent template, publish your DID to the Aroha Hub, and describe your capabilities in a machine-readable manifest.

02

Get discovered

Personal AI assistants query the Hub for vendors matching the task. Your manifest surfaces in their discovery results automatically.

03

Customers transact

The agent presents the action to the customer, who approves it. A signed mandate is issued and delivered to your endpoint with the request.

Capabilities

What customers can do through their agent

Book a flight

Select seat, confirm baggage, pay — all within the agent conversation

Pay a utility bill

Agent retrieves outstanding balance and submits payment in one step

💳

Check account balance

Read-only mandate returns balance data without exposing credentials

📦

Place an order

Cart, delivery address, and checkout completed autonomously

📍

Get order status

Agent polls your status endpoint and surfaces it in plain language

Value props

What you get as an Aroha vendor

Signed mandate proof

Every request arrives with a cryptographic mandate — proof the customer authorised the action and the exact amount they approved.

Spend ceiling enforcement

The protocol enforces spend limits on your behalf. Requests that exceed the customer-set ceiling are rejected before they reach your system.

Full audit trail

Every mandate, every action, and every resource consumed is logged in a tamper-evident trail — ready for compliance or dispute resolution.

No new payment infrastructure

You keep your existing payment processor. Our mandate is proof of authorisation — you pass it through to the processor you already use.

Reputation building

Vendors listed on the Aroha Hub accumulate verified transaction history. Trustworthy vendors appear higher in agent discovery results.

Security & trust

Built for regulated industries

Mandate verification

Your agent SDK verifies the mandate signature against the Aroha identity service before processing any request.

Cryptographic proof

Ed25519 signatures on every mandate. No mandate — no action. Forgery is computationally infeasible.

Spend limits

Customers set a spend ceiling when they authorise the mandate. The protocol enforces it; you never need to check manually.

No credentials shared

The customer's card, login, or bank details never leave their agent environment. You receive only the mandate.

Who’s integrating

Sectors already on the Aroha Hub

Banks & financial services

Balance enquiries, bill payments, and account management — all mandate-verified.

Airlines & travel

Flight booking, seat selection, and ancillary purchases initiated by travel agents.

Utilities & telecoms

Bill payment, usage queries, and plan upgrades triggered by home-management agents.

E-commerce & merchants

Cart checkout, order placement, and returns initiated by personal shopping agents.

Get started

A vendor agent in under 50 lines

The vendor agent template handles DID registration, mandate verification, and audit logging. You only write the business logic.

import { serve, verifyMandate } from "@aroha-sdk/vendor-agent";

serve({
  name: "acme-bookings",
  didDocument: process.env.VENDOR_DID_DOCUMENT!,

  async onRequest(req) {
    // 1. Verify the customer's signed mandate
    const mandate = await verifyMandate(req.mandate, {
      expectedVendor: "did:aroha:acme-bookings",
      maxAmount:      req.mandate.spendCeiling,
    });

    if (!mandate.valid) {
      return { error: "Invalid or expired mandate" };
    }

    // 2. Perform the action (your existing business logic)
    const booking = await createBooking({
      flightId:   req.body.flightId,
      passenger:  mandate.subject,   // customer DID, not raw PII
      amount:     mandate.spendCeiling,
    });

    // 3. Return a structured result — logged in the audit trail
    return {
      bookingRef: booking.ref,
      amount:     booking.totalCharged,
      currency:   "USD",
    };
  },
});

Two ways to get started

Quick — weekend setup

npm install + template

Clone the vendor agent template, add your business logic, and deploy. Most teams are live within two days.

npm install @aroha-sdk/vendor-agent
Read the quickstart →

Full — enterprise integration

Guided onboarding

We work with your engineering and compliance teams to integrate into your existing payment stack, identity system, and audit infrastructure.

Contact us

Ready to be AI-native?

Join the vendors already reachable by every personal AI assistant on the Aroha network.