> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentcard.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Wallet links

> One texted link that opens a connected user's wallet, as an iMessage App Clip on iOS and a hosted page everywhere else.

A **wallet link** is the one-call integration for messaging agents. You mint a link for a connected user and text it. Tapping it opens the Agentcard wallet, where the user adds a card or approves a payment, then returns to the thread. All wallet UI lives on Agentcard's surface; you implement connect, consent, and this call, and observe the rest over webhooks.

A link allows up to 20 opens inside its lifetime (15 minutes by default). Create a fresh one at the moment it is needed rather than reusing old ones. Append `merchant` and `amount` (in cents) to the URL to open straight onto the approval sheet for a specific charge.

Wallet links are enabled per organization. If the endpoint answers `404` for your organization, ask us to turn it on.

## The wallet link object

| Field        | Type    | Description                                                                  |
| ------------ | ------- | ---------------------------------------------------------------------------- |
| `object`     | string  | `wallet_link`                                                                |
| `id`         | string  | `wl_…`                                                                       |
| `user_id`    | string  | The connected user.                                                          |
| `status`     | string  | `active`                                                                     |
| `url`        | string  | The link to text. Opens the App Clip on iOS, the hosted `/w` page elsewhere. |
| `expires_at` | string  | Default 15 minutes after creation.                                           |
| `test_mode`  | boolean |                                                                              |

```json theme={null}
{ "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 }
```

## Endpoints

| Endpoint                    |                                                            |
| --------------------------- | ---------------------------------------------------------- |
| `POST /api/v2/wallet_links` | [Create a wallet link](/api-reference/wallet-links/create) |

Webhooks: `wallet_link.opened`, `vault.card_stored`, `connected_card.updated`, `connection.created`.