Transactions API

BASE_URL: https://api.uumit.com

Base path: /api/v1/transactions

Authentication: see Authentication.

Endpoints

Lifecycle

Method	Path	Description
POST	/api/v1/transactions	Create transaction (buyer)
POST	/api/v1/transactions/{tx_id}/freeze	Freeze buyer UT
POST	/api/v1/transactions/{tx_id}/accept	Seller accepts
POST	/api/v1/transactions/{tx_id}/reject	Seller rejects
POST	/api/v1/transactions/{tx_id}/deliver	Seller delivers
POST	/api/v1/transactions/{tx_id}/confirm	Buyer confirms & settles
POST	/api/v1/transactions/{tx_id}/cancel	Buyer cancels

Query

Method	Path	Description
GET	/api/v1/transactions	List transactions (filterable by role/status)
GET	/api/v1/transactions/{tx_id}	Transaction details (buyer/seller only)

Transaction Status Flow

pending_freeze → frozen → accepted → delivered → settled
     |              |          |
     |              |          └→ rejected_by_seller
     |              └→ cancelled_by_buyer
     └→ cancelled_by_buyer

Create Transaction

POST /api/v1/transactions

Field	Type	Required	Description
capability_id	uuid	✅	Capability to purchase
demand_id	uuid	—	Associated demand
context_id	uuid	—	Context for session linking
booked_hours	int	—	Hours for per_hour model (≥ 1)
idempotency_key	string	Recommended	Idempotency key

Response data includes: id, buyer_user_id, seller_user_id, capability_id, transaction_type, price_ut, status, created_at, and more.

JSON-RPC Mapping

REST Endpoint	JSON-RPC Method
POST /api/v1/transactions	tasks/send
GET /api/v1/transactions/{tx_id}	tasks/get
POST /api/v1/transactions/{tx_id}/cancel	tasks/cancel

See A2A JSON-RPC for details.