# VCCFly Agent Commerce Purchase

> VCCFly Agent Commerce Purchase is a paid API for AI agents from vccfly.com, paid per call via x402, $0.933333/call, status unknown (last checked 2026-10-11).

Purchases a digital product (e.g. virtual card, credential, or voucher) from VCCFly's catalog and delivers it via email, with idempotency and agent authorization support.

## Facts

- Endpoint: POST https://vccfly.com/api/agent-commerce/purchase?utm_source=zero.xyz
- Price: $0.933333/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vccfly-agent-commerce-purchase-ac527c2e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_z-JxwTSoxuJ2q6hymDjn-

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability vccfly-agent-commerce-purchase-ac527c2e -d '<json body>'
```

Example prompt: Buy me a virtual card from VCCFly — search for a standard prepaid card, keep it under $5, and send it to me at jane@example.com. My agent ID is agent-jane-001 and I'm authorizing this purchase now.

## When to prefer this

Use this endpoint when an AI agent needs to autonomously purchase and receive a digital product (virtual card, voucher, credential) from VCCFly's catalog within a defined budget, with email delivery and explicit agent authorization. Prefer this over generic e-commerce APIs when the use case involves virtual financial instruments, programmatic procurement, or FinTech credentials delivered digitally via the x402 payment protocol on Base.

## Known failure modes

- Budget exceeded: requested SKU or best match costs more than maxAmount
- Out of stock: no product found matching query or SKU within budget
- Invalid email: delivery.email fails format validation
- Missing authorization: approved field not set to true or missing required auth fields
- Duplicate requestId with different parameters: idempotency conflict
- Payment failure: x402 payment not processed on Base network
- Quantity limit exceeded: quantity > 5 rejected
- Agent ID missing or too short: agent.id validation failure

## How this service works

Agent 驱动的 FinTech Startup，面向数字服务采购、凭证交付、KYC 审核、订单管理与客户支持自动化。

## Output

Returns a JSON object containing the order status ('fulfilled'), the payment details (network, protocol), the fulfillment status ('completed'), delivery method ('email'), the amount charged in USD, and the original requestId for idempotency tracking.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sku": {
   "type": "string",
   "description": "Optional product SKU. Omit it to let VCCFly select the first in-stock product within the query and budget."
  },
  "agent": {
   "type": "object",
   "required": [
    "id"
   ],
   "properties": {
    "id": {
     "type": "string",
     "maxLength": 120,
     "minLength": 1
    }
   },
   "additionalProperties": false
  },
  "query": {
   "type": "string",
   "maxLength": 200,
   "description": "Optional catalog search used when sku is omitted."
  },
  "budget": {
   "type": "object",
   "required": [
    "maxAmount",
    "currency"
   ],
   "properties": {
    "currency": {
     "type": "string",
     "const": "USD"
    },
    "maxAmount": {
     "type": "number",
     "description": "Maximum authorized total in USD.",
     "exclusiveMinimum": 0
    }
   },
   "additionalProperties": false
  },
  "payment": {
   "type": "object",
   "properties": {
    "network": {
     "enum": [
      "eip155:5042",
      "eip155:8453"
     ],
     "type": "string",
     "description": "Optional x402 settlement network. Arc Mainnet is the default; use eip155:8453 to select Base Mainnet."
    }
   },
   "additionalProperties": false
  },
  "delivery": {
   "type": "object",
   "required": [
    "email"
   ],
   "properties": {
    "email": {
     "type": "string",
     "format": "email"
    }
   },
   "additionalProperties": false
  },
  "quantity": {
   "type": "integer",
   "default": 1,
   "maximum": 5,
   "minimum": 1
  },
  "projectId": {
   "type": "string",
   "maxLength": 120,
   "minLength": 3,
   "description": "Optional pre-provisioned project budget and policy context."
  },
  "requestId": {
   "type": "string",
   "maxLength": 128,
   "minLength": 16,
   "description": "Caller-generated idempotency key. Reuse it only when retrying the identical purchase."
  },
  "authorization": {
   "type": "object",
   "required": [
    "approved",
    "approvedBy",
    "approvedAt"
   ],
   "properties": {
    "approved": {
     "type": "boolean",
     "const": true
    },
    "approvedAt": {
     "type": "string",
     "format": "date-time"
    },
    "approvedBy": {
     "type": "string"
    }
   },
   "additionalProperties": false
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "order": {
   "amount": {
    "value": 0.933333,
    "currency": "USD"
   },
   "status": "fulfilled",
   "payment": {
    "network": "eip155:8453",
    "protocol": "x402-v2"
   },
   "requestId": "x402scan-probe-00000001",
   "fulfillment": {
    "status": "completed",
    "delivery": "email"
   }
  },
  "idempotent": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vccfly-agent-commerce-purchase-ac527c2e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from vccfly.com](https://www.zero.xyz/host/vccfly.com/llms.txt)