> ## 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 Receive
> Create a payment link and get paid in the crypto you want, whatever your customer pays in, on whatever chain they hold it.
Get paid in any crypto on any chain — with one link.
**Payment links are web only.** Create them in the Moove Widget at [moove.xyz](https://www.moove.xyz), and track them in the dashboard — see [Moove Payment Links](/manage/moove-payment-links).
In the **Moove App**, the **Receive** tab shares your Moove Handle, your Moove Profile and a QR code instead. Anyone can pay you from those for any amount.
## How Do I Create A Payment Link?
In the Moove Widget at [moove.xyz](https://www.moove.xyz).
Under **You're receiving**, denominated in your [settlement token](/concepts/settlement-and-auto-routing) — the token you chose to be paid in.
Optional, and shown to the payer on the checkout page. Turn on **Advanced view** under the settings icon to show the field.
Copy it and put it in an invoice, a DM, a bio, an email — anywhere.
Links created in Moove Widget are **single-use and never expire**. They complete as soon as they are paid once, so a link cannot be reused or forwarded.
To set a different usage cap or an expiry date, create the link through the [API](/api-reference/moove-receive/moove-payment-links) instead.
## What Does Your Customer See?
They open the link, connect any wallet, and pay in whatever they hold on whatever chain.
They do not need a Moove account. They do not need to know what token you want. Any swap or bridge required runs inside their payment, and it lands in your wallet in your token.
## What Are The Link Settings?
| Setting | What it does | Where you can set it |
| --------------- | -------------------------------------------------------------------------------------------------- | ---------------------------------------------- |
| **Amount** | What you are asking for, in your settlement token | Moove Widget and API |
| **Description** | Shown to the payer on the checkout page. Up to 160 characters in Moove Widget, 500 through the API | Moove Widget and API |
| **Usage cap** | How many payments the link accepts before it completes | **API only** — Moove Widget always sets 1 |
| **Expiry** | After this, the link stops accepting payments | **API only** — Moove Widget links never expire |
Moove Widget is built for the common case: one invoice, one payment. If you need a link that takes several payments, or one that expires on a date, that is what the API is for.
## What Are The Link Statuses?
| Status | Meaning |
| ------------- | --------------------------------- |
| **Active** | Accepting payments |
| **Completed** | Hit its usage cap |
| **Inactive** | You deactivated it, or it expired |
Track and deactivate links from the web dashboard.
[Moove Payment Links →](/manage/moove-payment-links)
## How Do I Get Paid In The Moove App?
The Moove App has no payment-link screen. Its **Receive** tab gives you three ways to be paid, all of which let the payer choose the amount:
| Method | How to share it |
| ---------------------- | ------------------------------------------- |
| **Your Moove Handle** | Tap to copy `@yourname` |
| **Your Moove Profile** | Tap to copy your `moove.xyz/@yourname` link |
| **QR code** | Tap **Share QR code** to send or show it |
Whatever they pay in, it settles to you in your settlement token — the same routing a payment link uses.
For a fixed amount on mobile, create the link on the web and share it from your phone. The link itself works anywhere.
## Payment Link Or Moove Profile?
| | Payment link | [Moove Profile](/brand/moove-profile) |
| ------------------- | --------------------------------- | ------------------------------------- |
| Who sets the amount | You | The payer |
| Best for | Invoices, checkouts, fixed prices | Tips, donations, bio links |
| Reusable | Up to the usage cap | Always |
| Expires | If you set an expiry | Never |
## Perpetual & Custom Links
**Coming soon.** Perpetual links (reusable indefinitely with their own identity) and custom links (branded per campaign) are announced but not built. Everything on this page describes what ships today.
## How Do I Do It In Code?
The same payment link is one API call, which is how you take payments on your own website.
```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 }'
```
Send the payer to the `url` in the response.
[Moove Payment Links API →](/api-reference/moove-receive/moove-payment-links) · [Moove Agentic Payments →](/transact/moove-agentic-payments)
## What Does Moove Receive Cost?
A payment that needs no swap or bridge is free. Anything cross-token or cross-chain carries a protocol fee, and on a payment link **the payer covers it** — you receive exactly the amount you asked for.
This is the practical reason to invoice with a payment link rather than your Moove Profile: on a Profile the payer names the amount, so the fee comes out of what reaches you.
Figures on the [Pricing](/product-prices/how-product-and-prices-work) page.
## What To Read Next
Track and deactivate.
Create links in code.
Be paid without a link.
One link, any crypto, any chain. Your Money. Your Move.