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

# Moove Agentic Payments

> Build a crypto checkout with one prompt — download the Moove Agent skill into your AI coding tool and let it integrate the live payment-link API for you.

Take crypto payments on your own website — by pasting one prompt into your AI coding tool.

<Info>
  **Web.** The marketing page, the dashboard and the downloads are web. There is no mobile equivalent.
</Info>

## What Is Moove Agentic Payments?

Moove Agentic Payments is a **skill file** — an instruction file your AI coding tool reads — that teaches the tool how to integrate the live moove.xyz payment-link API.

You download it, drop it into your tool, and describe what you want. The tool writes the integration against the real API.

<Note>
  The skill never moves money. It reads documentation and writes code. Every payment still settles on-chain to the wallet on the API key's account, and the key itself cannot redirect funds anywhere else.
</Note>

## How Do I Integrate In Three Steps?

<Steps>
  <Step title="Download the skill or a plugin">
    One `skill.md` works everywhere. Plugins repackage the same file into the location your specific tool looks for it.
  </Step>

  <Step title="Insert a prompt">
    Use the ready-to-use prompt from [moove.xyz/agentic-payments](https://www.moove.xyz/agentic-payments), or write your own.
  </Step>

  <Step title="Build and deploy">
    Your tool builds the checkout. Manage the keys, links and transactions it creates in [Moove Manage](/manage/overview).
  </Step>
</Steps>

## What Are The Five Plugins?

Moove Agent Skills follow an open standard, so the same file runs across 40+ AI models. The plugins are a convenience, not a requirement.

| Tool               | What the plugin installs           |
| ------------------ | ---------------------------------- |
| **Claude Code**    | A plugin manifest plus the skill   |
| **Codex**          | `AGENTS.md`                        |
| **Gemini CLI**     | `GEMINI.md`                        |
| **Cursor**         | A rule file under `.cursor/rules/` |
| **GitHub Copilot** | `.github/copilot-instructions.md`  |

Download any of them from [moove.xyz/agentic-payments](https://www.moove.xyz/agentic-payments).

<Tip>
  Not using one of the five? Download the plain `skill.md` and put it wherever your tool reads instructions from. It is the same file.
</Tip>

## Before You Start

<Steps>
  <Step title="Have a Moove account with a default wallet and a handle">
    The API refuses to create links for an account that cannot receive payments.
  </Step>

  <Step title="Create an API key">
    At [moove.xyz/dashboard/api-keys](https://www.moove.xyz/dashboard/api-keys), scoped to the **Moove Receive Agent**.

    <Warning>
      The key is shown once, in plaintext, at creation. Copy it then — it cannot be shown again.
    </Warning>

    [Moove API Keys →](/manage/moove-api-keys)
  </Step>

  <Step title="Give your tool the key">
    As an environment variable. Never commit it, and never paste it into a prompt.
  </Step>
</Steps>

## What Are The Agents?

An **agent** is the unit of permission on a key. Picking one is how you decide what a key can do.

| Agent                   | Status      | What it does                                             |
| ----------------------- | ----------- | -------------------------------------------------------- |
| **Moove Receive Agent** | **Live**    | Creates one-off hosted payment links and reads them back |
| Moove Send Agent        | Coming soon | Pay out to any handle, address or alias                  |
| Moove Swap Agent        | Coming soon | Swap and bridge with routing handled                     |
| Moove Ramp Agent        | Coming soon | Move between local currency and crypto                   |

<Warning>
  **Only the Moove Receive Agent exists.** The other three are announced, not built — they appear in the picker disabled and labelled coming soon. A key can only ever hold Moove Receive scopes today.
</Warning>

## What Can The Moove Receive Agent Do?

Two scopes, and nothing else:

| Scope                 | Grants                 |
| --------------------- | ---------------------- |
| `payment_link:create` | Creating payment links |
| `payment_link:read`   | Listing payment links  |

An agent that could request a payment but never confirm it settled could not complete the one job it exists for, so the Moove Receive Agent gets both.

## Why A Leaked Key Cannot Cost You Money

<Note>
  A key is a **down-scope of you**: it acts as your account and can only do a subset of what you can do.

  No endpoint moves funds. Payment links always settle to the key owner's own default wallet, and the caller cannot specify a destination. A leaked key can create payment requests that pay *you* — it cannot redirect money to anyone else.
</Note>

Revoke a key you no longer trust. Revocation is permanent and immediate.

## Can I Do It Without An Agent?

The API is a plain HTTP API. Nothing about it requires an AI tool.

```bash theme={null}
curl -sS -X POST "https://api.moove.xyz/v1/payment-link" \
  -H "X-API-Key: $MOOVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "toAmount": "49.99", "description": "INV-2026-0142", "maxUsage": 1 }'
```

[API Reference →](/api-reference/introduction)

## What To Read Next

<CardGroup cols={3}>
  <Card title="Moove API Keys" icon="key" href="/manage/moove-api-keys">
    Create, scope and revoke.
  </Card>

  <Card title="Moove Payment Links API" icon="link" href="/api-reference/moove-receive/moove-payment-links">
    The endpoints in full.
  </Card>

  <Card title="Moove Receive" icon="hand-coins" href="/transact/moove-receive">
    The same product, no code.
  </Card>
</CardGroup>

Click. Integrate. Transact. Your Money. Your Move.