{"uid":"cap_BSaT4z7y_qV3XqJTsdpXX","slug":"x402card-virtual-card-purchase-bf201094","name":"x402card Virtual Card Purchase","description":"Issue and top up wallet-native virtual cards, or buy prepaid Freeland travel eSIMs with native USDC on Base through x402.","url":"https://api.x402card.org/api/card/purchase","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"idempotencyKey":{"type":"string","maxLength":200,"minLength":1,"description":"Stable caller-generated key. Reuse it after an ambiguous response; never generate a replacement to retry payment."}}},"responseSchema":{"type":"json","example":{"ok":true,"next":{"listCards":"https://api.x402card.org/api/cards","authenticateOwner":"https://api.x402card.org/api/auth/challenge"},"owner":"<x402-payer-address>","status":"queued","product":"virtual_card","cardIssueJob":{"id":"<job-id>","status":"queued"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"25","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":"$25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_acNmJ9q6b1SfhsL3igofy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Issues a new wallet-native virtual card by charging $25 USDC on Base via the x402 payment protocol, returning a queued card-issue job.","exampleAgentPrompt":"Issue me a new wallet-native virtual card using my USDC on Base — use idempotency key 'vc-2025-001' so we can safely retry if something goes wrong.","exampleUseCases":[{"title":"Crypto wallet to online spending card","prompt":"I want to create a virtual card funded by my USDC on Base so I can shop online — issue one for me and use idempotency key 'my-first-card-001' in case anything drops."},{"title":"Automating card issuance in an agent workflow","prompt":"In my automated expense workflow, provision a new virtual card for my team member using USDC — use idempotency key 'team-card-july-2025' so the payment won't double if we retry."},{"title":"Stablecoin-funded card for recurring online purchases","prompt":"Set up a fresh virtual card charged to my USDC wallet on Base for my monthly subscriptions — idempotency key 'sub-card-recurring-01' please."}],"resultDescription":"Returns a JSON object confirming the card issuance job was queued, including the job ID, job status ('queued'), the product type ('virtual_card'), the owner's x402 payer address, and follow-up URLs for listing cards and authenticating the owner.","failureModes":["Payment not received or insufficient USDC balance — 402 response requiring payment","Duplicate idempotency key with conflicting request body — may return conflict error","Network or x402 facilitator timeout — ambiguous response; caller should reuse the same idempotency key to retry","Invalid or missing idempotency key — request rejected","Card issuance job fails asynchronously — job status will reflect failure on polling"],"whenToPreferThis":"Choose this endpoint when an agent or user wants to programmatically issue a crypto-funded virtual card using USDC on Base via the x402 payment protocol. It is ideal for DeFi-native workflows, crypto-first expense management, or any scenario where the user wants a spendable virtual card without traditional banking rails. Prefer it over fiat-based virtual card services when the payer holds USDC on Base and wants a wallet-native card with no traditional KYC onboarding friction.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:37:38.601Z","isFirstParty":false}