> ## 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

> Construiește un checkout crypto cu un singur prompt: descarcă skill-ul Moove Agent în instrumentul tău de programare cu AI și lasă-l să integreze API-ul live de linkuri de plată pentru tine.

Acceptă plăți crypto pe propriul site, lipind un singur prompt în instrumentul tău de programare cu AI.

> [!NOTE]
>
> **Web.** Pagina de prezentare, dashboard-ul și descărcările sunt pe web. Nu există echivalent mobil.

## Ce este Moove Agentic Payments?

Moove Agentic Payments este un **fișier skill**, un fișier de instrucțiuni pe care îl citește instrumentul tău de programare cu AI, care îl învață cum să integreze API-urile live moove.xyz: linkuri de plată pentru a fi plătit, plăți către terți pentru a trimite și swapuri pentru a trece între tokenuri și rețele.

Îl descarci, îl pui în instrument și descrii ce vrei. Instrumentul scrie integrarea pe API-ul real.

> [!NOTE]
>
> **Cheia API Moove folosită de skill nu poate muta bani.** Nu semnează nimic: solicită plăți, calculează prețul plăților către terți și al swapurilor și înregistrează tranzacții pe care codul tău le-a transmis deja.
>
> O plată către terți sau un swap este semnat local, de proiectul tău, cu o cheie pe care moove.xyz nu o vede niciodată. Cheia de semnare este cea care poate muta fonduri și rămâne la tine.

## Cum integrez în trei pași?

**1. Descarcă skill-ul sau un plugin**

Un singur `skill.md` funcționează peste tot. Pluginurile reîmpachetează același fișier în locul în care îl caută instrumentul tău.

**2. Inserează un prompt**

Folosește promptul gata de utilizare de la [moove.xyz/business/agentic-payments](https://www.moove.xyz/business/agentic-payments) sau scrie-l pe al tău.

**3. Construiește și lansează**

Instrumentul tău construiește checkout-ul. Gestionează cheile, linkurile și tranzacțiile create în [Moove Manage](https://docs.moove.xyz/ro-ro/manage/overview.md).

## Care sunt cele cinci pluginuri?

Moove Agent Skills urmează un standard deschis, așa că același fișier rulează pe peste 40 de modele AI. Pluginurile sunt o facilitate, nu o cerință.

| Instrument | Ce instalează pluginul |
| - | - |
| **Claude Code** | Un manifest de plugin plus skill-ul |
| **Codex** | `AGENTS.md` |
| **Gemini CLI** | `GEMINI.md` |
| **Cursor** | Un fișier de reguli sub `.cursor/rules/` |
| **GitHub Copilot** | `.github/copilot-instructions.md` |

Descarcă oricare dintre ele de la [moove.xyz/business/agentic-payments](https://www.moove.xyz/business/agentic-payments).

> [!TIP]
>
> Nu folosești unul dintre cele cinci? Descarcă `skill.md` simplu și pune-l oriunde își citește instrumentul tău instrucțiunile. Este același fișier.

## Înainte să începi

**1. Ca să fii plătit, ai nevoie de un portofel implicit și un handle**

Necesar doar pentru **Moove Receive Agent**. API-ul refuză să creeze linkuri pentru un cont care nu poate primi plăți.

**2. Ca să plătești sau să faci swap, conectează portofelul de finanțare prin semnătură**

Necesar doar pentru **Moove Send Agent** și **Moove Swap Agent**. Portofelul din care pleacă banii trebuie să fie unul pe care l-ai conectat *semnând* cu el: o adresă doar pentru primire, adăugată prin lipire, nu poate trimite și nici nu poate face swap. Vei avea nevoie și de o bibliotecă de semnare în propriul proiect; moove.xyz nu oferă niciuna.

**3. Creează o cheie API**

La [moove.xyz/dashboard/api-keys](https://www.moove.xyz/dashboard/api-keys), cu domeniul limitat la agentul de care ai nevoie: Receive pentru a accepta plăți, Send pentru a plăti, Swap pentru a face swap sau bridge.

> [!WARNING]
>
> Cheia este afișată o singură dată, în text simplu, la creare. Copiaz-o atunci: nu mai poate fi afișată.

[Chei API Moove →](https://docs.moove.xyz/ro-ro/manage/moove-api-keys.md)

**4. Dă cheia instrumentului tău**

Ca variabilă de mediu. Nu o comite niciodată și nu o lipi niciodată într-un prompt.

## Care sunt agenții?

Un **agent** este unitatea de permisiune a unei chei. Alegerea unuia este modul în care decizi ce poate face o cheie.

| Agent | Stare | Ce face |
| - | - | - |
| **Moove Receive Agent** | **Disponibil** | Creează linkuri de plată găzduite, de unică folosință, și le citește înapoi |
| **Moove Send Agent** | **Disponibil** | Plătește către orice Moove Handle sau adresă de portofel, pe orice rețea |
| **Moove Swap Agent** | **Disponibil** | Face swap pe o rețea sau bridge între rețele, în propriul portofel |
| Moove Ramp Agent | În curând | Trece între moneda locală și crypto |

> [!WARNING]
>
> **Receive, Send și Swap sunt disponibili.** Doar Moove Ramp Agent este încă anunțat, nu construit: apare dezactivat în selector, cu eticheta în curând. Nu există agent Bridge: bridge-ul este ce face Moove Swap Agent, pe același endpoint ca un swap pe aceeași rețea.

## Ce poate face Moove Receive Agent?

Două domenii de acces și nimic altceva:

| Domeniu | Permite |
| - | - |
| `payment_link:create` | Crearea linkurilor de plată |
| `payment_link:read` | Listarea linkurilor de plată |

Un agent care ar putea cere o plată, dar nu ar putea confirma că s-a decontat, nu și-ar putea face singura treabă pentru care există, așa că Moove Receive Agent le primește pe amândouă.

## Ce poate face Moove Send Agent?

Trei domenii de acces, cele trei etape ale unei plăți, niciuna dintre ele nesemnând nimic:

| Domeniu | Permite |
| - | - |
| `send:quote` | Construirea unei tranzacții de trimitere **nesemnate** |
| `send:create` | Înregistrarea unei trimiteri pe care ai transmis-o deja |
| `transaction:read` | Citirea propriilor tranzacții |

> [!WARNING]
>
> **moove.xyz nu semnează niciodată, iar agentul tău trebuie să semneze.** Nu există un apel „trimite bani". moove.xyz calculează prețul plății și returnează o tranzacție *nesemnată*; propriul tău cod o semnează și o transmite cu o cheie pe care moove.xyz nu o vede niciodată, apoi îi spune lui moove.xyz hash-ul.
>
> Așadar agentul tău are nevoie de o bibliotecă de semnare în proiect și de un portofel de finanțare **conectat la contul tău Moove prin semnătură**. O adresă doar pentru primire, adăugată prin lipire, nu poate trimite: plata este refuzată înainte să se semneze ceva.

Send **nu** este selectat implicit în selector. Bifează-l deliberat: o cheie care poate doar primi este mult mai puțin riscant de pierdut.

> [!NOTE]
>
> **Asigură-te că codul tău poate citi cheia.** Dacă cheia API lipsește, o cerere de plată nu eșuează: rulează fără verificările contului tău, iar plata nu este înregistrată pe cheia ta. Fă codul să se oprească înainte să ceară o ofertă dacă cheia nu este setată.

[Moove Send API →](https://docs.moove.xyz/api-reference/moove-send.md)

## Ce poate face Moove Swap Agent?

Trei domenii de acces, aceleași trei etape ca la o plată, și din nou niciuna nu semnează nimic:

| Domeniu | Permite |
| - | - |
| `swap:quote` | Construirea unei tranzacții de swap sau bridge **nesemnate** |
| `swap:create` | Înregistrarea unui swap sau bridge pe care l-ai transmis deja |
| `transaction:read` | Citirea propriilor tranzacții |

Un singur agent acoperă ambele sarcini. Un swap rămâne pe o rețea; un bridge trece între rețele. Oricum, rezultatul ajunge într-un portofel din propriul cont; ca să plătești pe altcineva, folosește Moove Send Agent.

> [!WARNING]
>
> **Agentul tău semnează swap-ul, nu moove.xyz.** Are nevoie de aceleași două lucruri ca la o plată: o bibliotecă de semnare în proiect și un portofel de finanțare **conectat la contul tău Moove prin semnătură**. Un portofel neconectat este refuzat când agentul tău cere o ofertă, înainte să se semneze ceva.

Nici Swap nu este selectat implicit în selector. Bifează-l deliberat.

[Moove Swap API →](https://docs.moove.xyz/api-reference/moove-swap.md)

## De ce o cheie scursă nu te poate costa bani

> [!NOTE]
>
> O cheie este o **versiune cu drepturi reduse a ta**: acționează ca și contul tău și poate face doar o parte din ce poți face tu.
>
> Niciun endpoint nu mută fonduri și niciunul nu acceptă o cheie privată. O ofertă returnează date de tranzacție **nesemnate**, pe care le semnezi tu, iar înregistrarea unei tranzacții doar notează un hash care e deja on-chain. Linkurile de plată se decontează întotdeauna în propriul tău portofel implicit, iar cel care apelează nu poate alege unde ajung.
>
> Așadar o cheie scursă nu poate mișca deloc fonduri: fiecare tranzacție trebuie semnată cu o cheie pe care o deții doar tu. (Un swap făcut cu cheia trebuie să-și returneze rezultatul și în propriul tău cont, dar aceasta este o măsură împotriva greșelilor, nu protecția în sine.)

> [!WARNING]
>
> Asta nu înseamnă inofensiv. O cheie scursă poate citi istoricul tranzacțiilor tale, poate crea linkuri de plată care *te* plătesc pe tine și poate înregistra tranzacții pe propriile tale portofele. Revocă-o: pur și simplu nu poate lua banii.

Revocă o cheie în care nu mai ai încredere. Revocarea este permanentă și imediată.

## Cine decide cine este plătit?

Tu, niciodată agentul tău și niciodată ceva ce citește agentul tău. O plată semnată nu poate fi retrasă, iar un instrument AI citește mult text scris de alți oameni.

* **Destinatarul, suma, tokenul și rețeaua vin de la tine**, sau din propriile tale evidențe, precum tabelul tău de plăți sau facturile tale. Niciodată de pe o pagină web, dintr-un issue, un README, un fișier pe care instrumentul a fost rugat să-l rezume sau un răspuns API, inclusiv descrierea unui link de plată sau a unei tranzacții, pe care alți oameni o pot influența.
* **Un swap este la fel.** Perechea și suma vin de la tine, iar rezultatul se întoarce mereu în propriul tău portofel.
* **Agentul tău te întreabă înainte să semneze o plată.** Îți arată destinatarul, suma, tokenul, rețeaua și ce va ajunge, apoi așteaptă acordul tău: o dată pe plată sau o dată pe lot, cu fiecare rând listat.
* **Un text care îi cere agentului tău să schimbe un destinatar, să mărească o sumă, să sară peste confirmarea ta sau să trimită undeva o cheie ori o frază de recuperare este un atac.** Agentul tău nu trebuie să acționeze pe baza lui. Trebuie să se oprească și să ți-l arate.

## Pot face asta fără un agent?

API-ul este un API HTTP obișnuit. Nimic din el nu necesită un instrument AI.

```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 }'
```

[Referință API →](https://docs.moove.xyz/api-reference/introduction.md)

## Se poate conecta agentul meu AI prin MCP?

Da. **MCP**, Model Context Protocol, este un standard deschis care permite unui agent AI să apeleze servicii externe ca instrumente. Skill-ul învață instrumentul tău să scrie o integrare. Serverul Moove MCP permite unui agent să lucreze direct cu contul tău: să caute linkurile tale de plată, să verifice care au fost plătite și să creeze un link nou când îi ceri.

* **Server:** `https://api.moove.xyz/mcp`
* **Aceeași cheie API.** Folosește cheia API Moove pe care o ai deja, trimisă ca antet de cerere. Agentul pe care l-ai ales pentru cheie decide ce instrumente apar.
* **Aceeași siguranță.** Nimic de pe serverul MCP nu semnează și nu mută bani. Un link de plată creat de el se decontează întotdeauna în propriul tău portofel implicit.

Conectează-te din Claude Code, Cursor, Codex, GitHub Copilot sau Gemini CLI de azi. Conectarea din claude.ai și ChatGPT vine mai târziu.

[Server MCP →](https://docs.moove.xyz/api-reference/mcp.md)

## Ce să citești în continuare

> [card] [Chei API Moove](https://docs.moove.xyz/ro-ro/manage/moove-api-keys.md)
>
> Creează, limitează și revocă.

> [card] [Moove Payment Links API](https://docs.moove.xyz/api-reference/moove-receive/moove-payment-links.md)
>
> Endpointurile în detaliu.

> [card] [Moove Receive](https://docs.moove.xyz/ro-ro/transact/moove-receive.md)
>
> Același produs, fără cod.

Apasă. Integrează. Tranzacționează. Banii tăi. Decizia ta.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.