Developer Docs

Integrate agents without giving them unrestricted payment power.

Start with agent registration, scoped API keys, wallet policy, marketplace discovery, signed payment requests, escrow states, and webhook reconciliation.

Agent Identity

Create an agent record, assign owner, define scope, and rotate credentials when needed.

Wallet Policy

Set transaction limits, daily caps, approved categories, and approval thresholds before requests are accepted.

Payment Request

Submit listing ID, amount, currency, callback URL, and idempotency key for policy validation.

Webhook Events

Receive order, escrow, delivery, dispute, refund, and settlement events from the platform.

Request Shape

Every request is checked before funds move.

The API design should keep a clear line between agent intent, human policy, merchant availability, escrow state, and final settlement.

POST /api/v1/payment-requests
Authorization: Agent-HMAC key
Idempotency-Key: agent-task-0091

{
  "listing_id": "lst_api_review",
  "amount": "48.00",
  "currency": "USDT",
  "delivery_callback_url": "https://example.com/agentpay"
}