{"uid":"cap_z-JxwTSoxuJ2q6hymDjn-","slug":"vccfly-agent-commerce-purchase-ac527c2e","name":"VCCFly Agent Commerce Purchase","description":"Agent 驱动的 FinTech Startup，面向数字服务采购、凭证交付、KYC 审核、订单管理与客户支持自动化。","url":"https://vccfly.com/api/agent-commerce/purchase?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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}}},"responseSchema":{"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}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.933333","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.933333/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.933333","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.933333","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ageXRgfUD9kLnuljyQUBV","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.933333","costPer":"request","priority":0,"asset":"0x3600000000000000000000000000000000000000","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Virtual card for online subscription","prompt":"Order a virtual credit card from VCCFly for up to $3, search for a single-use prepaid card, and deliver it to billing@mycompany.com — my agent ID is agent-corp-42, quantity 1, and I approve this purchase."},{"title":"Automated digital voucher for a customer","prompt":"Purchase a VCCFly gift voucher for a customer — search the catalog for 'gift card', stay under $10, send it to customer@email.com, agent ID agent-support-7, quantity 1, and this is approved."},{"title":"Bulk credential delivery for a team","prompt":"Get me 3 prepaid virtual cards from VCCFly, each under $2 total budget $6, email them to ops-team@startup.io, agent ID agent-ops-99, and I authorize this now."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:37:52.397Z","isFirstParty":false,"canonicalSlug":"vccfly-agent-commerce-purchase-ac527c2e"}