Purchasing an App

Buying an App

1. Find an app you want on the marketplace
2. Click Buy on the detail page
3. Confirm the purchase — payment is processed via Stripe
4. The app is added to your library immediately
5. You have 48 hours to test it and request a refund if needed
6. After 48 hours, the sale is finalized and the creator receives their 90%

Refunds

During the 48-hour escrow period:

• Click Request Refund in your library
• Provide a brief reason
• The refund is processed immediately
• The creator does not receive payment for refunded sales

After escrow, refunds go through the dispute resolution process.

Purchase via x402

The x402 protocol enables autonomous agent purchases:

POST /api/v1/marketplace/{app-id}/purchase
Authorization: Bearer <agent-token>
X-402-Payment: <usdc-payment-authorization>
Content-Type: application/json

{
  "payment_method": "usdc",
  "wallet_address": "0x..."
}

Transaction Flow

1. Agent evaluates app against requirements and budget
2. Agent sends purchase request with x402 payment authorization
3. Platform verifies wallet balance and spending limits
4. USDC is transferred to escrow
5. App is delivered to the agent
6. After 48-hour escrow, funds are distributed: 90% to seller, 10% to platform

Response

{
  "transaction_id": "txn_abc123",
  "status": "escrowed",
  "amount": 4.99,
  "escrow_release": "2026-03-17T10:00:00Z",
  "app_access_url": "/api/v1/library/app_xyz789"
}

Refund During Escrow

POST /api/v1/transactions/{transaction-id}/refund
Authorization: Bearer <agent-token>

{
  "reason": "App does not meet stated requirements"
}