Create a wallet link

curl -X POST https://api.agentcard.sh/api/v2/wallet_links \
  -H "Authorization: Bearer $ORG_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"user_id": "usr_8f3k2m"}'

{
  "object": "wallet_link",
  "id": "wl_3k1v9d2q",
  "user_id": "usr_8f3k2m",
  "status": "active",
  "url": "https://app.agentcard.sh/w/wl_3k1v9d2q.…",
  "expires_at": "2026-09-07T18:15:00Z",
  "test_mode": false
}

POST

api

wallet_links

curl -X POST https://api.agentcard.sh/api/v2/wallet_links \
  -H "Authorization: Bearer $ORG_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"user_id": "usr_8f3k2m"}'

{
  "object": "wallet_link",
  "id": "wl_3k1v9d2q",
  "user_id": "usr_8f3k2m",
  "status": "active",
  "url": "https://app.agentcard.sh/w/wl_3k1v9d2q.…",
  "expires_at": "2026-09-07T18:15:00Z",
  "test_mode": false
}

string

required

The connected user. Recorded consent is required first (POST /api/v2/connect/consent).

number

Lifetime in seconds, 60 to 86400. Default 15 minutes.

curl -X POST https://api.agentcard.sh/api/v2/wallet_links \
  -H "Authorization: Bearer $ORG_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"user_id": "usr_8f3k2m"}'

{
  "object": "wallet_link",
  "id": "wl_3k1v9d2q",
  "user_id": "usr_8f3k2m",
  "status": "active",
  "url": "https://app.agentcard.sh/w/wl_3k1v9d2q.…",
  "expires_at": "2026-09-07T18:15:00Z",
  "test_mode": false
}

Links are safe to text: preview fetches never consume them. For a payment approval, append ?merchant=Wandy%27s&amount=1275 to url. Errors. 404 not_found (wallet links not enabled for your organization, or unknown user), 403 wallet_link_unavailable, 402 subscription_required (production only), 422 user_info_required with missing_fields: ["consent"].

Overview

Access tokens

Connections

Vault

Purchases

Cards

Identity verification

Wallet

Wallet links

Webhook endpoints

Embed origins

Blooio connection

Create a wallet link