Payment Cards

Order a payment card (x402)

Order a prepaid or gift card for an agent. Drives the x402 payment flow server-side using the agent's Ethereum signing key (funded with USDC on Base). Requires cards_enabled on the agent and a Pro or higher plan. An Idempotency-Key header is required. When card_require_approval is true (default), the order is held in awaiting_approval until a human approves via the dashboard, mobile app, or email one-click link; payment runs only after approval.

post/v1/agents/{agent_id}/cards/order

Request

  • Base URL: https://api.1claw.co
  • URL: https://api.1claw.co/v1/agents/{agent_id}/cards/order
  • Auth: HTTP bearer

Path parameters

agent_idstring uuid required

Headers

Idempotency-Keystring required

Request body

kind'prepaid' | 'gift_card' required
amount_usdstring required

USD amount to load onto the card.

laso_server_idstring

Optional Laso gift-card server/brand id (gift cards only).

countrystring

Optional country (prepaid cards; defaults to US).

Example request

{
  "amount_usd": "25.00"
}

Response

Idempotent replay of a prior order

idstring uuid required
agent_idstring uuid nullable
issuer'laso' | 'manual' required
kind'prepaid' | 'gift_card' required
brandstring
last4string
exp_monthinteger
exp_yearinteger
currencystring required
order_amount_usdstring
balancestring
status'ordering' | 'pending' | 'ready' | 'depleted' | 'expired' | 'voided' | 'orphaned_payment' | 'awaiting_approval' | 'rejected' required
storage_mode'reference' | 'full' required
reveal_policyobject required
approval_idstring uuid

Linked approval when status is awaiting_approval

void_afterstring date-time
created_atstring date-time required
updated_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.