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

> Zbuduj kasę na krypto jednym promptem: pobierz skill Moove Agent do swojego narzędzia AI do kodowania i pozwól mu zintegrować działające API linków do płatności.

Przyjmuj płatności w krypto na własnej stronie, wklejając jeden prompt do swojego narzędzia AI do kodowania.

> [!NOTE]
>
> **Web.** Strona marketingowa, panel i pliki do pobrania są w sieci. Nie ma odpowiednika mobilnego.

## Czym jest Moove Agentic Payments?

Moove Agentic Payments to **plik skill**, czyli plik instrukcji, który czyta twoje narzędzie AI do kodowania. Uczy je, jak zintegrować działające API moove.xyz: linki do płatności do odbierania pieniędzy, wypłaty do wysyłania i swapy do przechodzenia między tokenami i sieciami.

Pobierasz go, wrzucasz do narzędzia i opisujesz, czego chcesz. Narzędzie pisze integrację z prawdziwym API.

> [!NOTE]
>
> **Klucz API Moove używany przez skill nie może przenosić pieniędzy.** Niczego nie podpisuje: zleca płatności, wycenia wypłaty i swapy oraz zapisuje transakcje, które twój własny kod już rozesłał.
>
> Wypłata lub swap jest podpisywana lokalnie, przez twój projekt, kluczem, którego moove.xyz nigdy nie widzi. To ten klucz podpisu może przenosić środki i zostaje u ciebie.

## Jak zintegrować w trzech krokach?

**1. Pobierz skill lub wtyczkę**

Jeden plik `skill.md` działa wszędzie. Wtyczki pakują ten sam plik w miejsce, w którym szuka go twoje konkretne narzędzie.

**2. Wstaw prompt**

Użyj gotowego promptu z [moove.xyz/business/agentic-payments](https://www.moove.xyz/business/agentic-payments) albo napisz własny.

**3. Zbuduj i wdróż**

Twoje narzędzie buduje kasę. Kluczami, linkami i transakcjami, które tworzy, zarządzasz w [Moove Manage](https://docs.moove.xyz/pl-pl/manage/overview.md).

## Jakie jest pięć wtyczek?

Moove Agent Skills opierają się na otwartym standardzie, więc ten sam plik działa w ponad 40 modelach AI. Wtyczki to wygoda, nie wymóg.

| Narzędzie | Co instaluje wtyczka |
| - | - |
| **Claude Code** | Manifest wtyczki plus skill |
| **Codex** | `AGENTS.md` |
| **Gemini CLI** | `GEMINI.md` |
| **Cursor** | Plik reguł w `.cursor/rules/` |
| **GitHub Copilot** | `.github/copilot-instructions.md` |

Pobierz dowolną z nich z [moove.xyz/business/agentic-payments](https://www.moove.xyz/business/agentic-payments).

> [!TIP]
>
> Nie używasz żadnego z pięciu? Pobierz zwykły `skill.md` i umieść go tam, skąd twoje narzędzie czyta instrukcje. To ten sam plik.

## Zanim zaczniesz

**1. Aby odbierać płatności, miej domyślny portfel i handle**

Potrzebne tylko dla **Moove Receive Agent**. API odmawia tworzenia linków dla konta, które nie może przyjmować płatności.

**2. Aby wypłacać lub wymieniać, połącz portfel finansujący podpisem**

Potrzebne tylko dla **Moove Send Agent** i **Moove Swap Agent**. Portfel, z którego wychodzą pieniądze, musi być takim, który połączyłeś, *podpisując* nim. Adres tylko do odbioru, który dodałeś przez wklejenie, nie może wysyłać ani wymieniać. Potrzebna będzie też biblioteka do podpisywania we własnym projekcie; moove.xyz żadnej nie dostarcza.

**3. Utwórz klucz API**

Pod adresem [moove.xyz/dashboard/api-keys](https://www.moove.xyz/dashboard/api-keys), z zakresem ograniczonym do potrzebnego agenta: Receive do przyjmowania płatności, Send do wypłat, Swap do swapów lub bridge'y.

> [!WARNING]
>
> Klucz jest pokazywany raz, otwartym tekstem, przy tworzeniu. Skopiuj go wtedy, bo nie da się go pokazać ponownie.

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

**4. Daj kluczowi dostęp swojemu narzędziu**

Jako zmienną środowiskową. Nigdy nie commituj go do repozytorium i nigdy nie wklejaj do promptu.

## Jacy są agenci?

**Agent** to jednostka uprawnień na kluczu. Wybór agenta decyduje o tym, co klucz może robić.

| Agent | Status | Co robi |
| - | - | - |
| **Moove Receive Agent** | **Działa** | Tworzy jednorazowe hostowane linki do płatności i odczytuje je |
| **Moove Send Agent** | **Działa** | Wypłaca na dowolny Moove Handle lub adres portfela, w dowolnej sieci |
| **Moove Swap Agent** | **Działa** | Wymienia w jednej sieci lub robi bridge między sieciami, do twojego własnego portfela |
| Moove Ramp Agent | Wkrótce | Przechodzenie między lokalną walutą a krypto |

> [!WARNING]
>
> **Receive, Send i Swap już działają.** Tylko Moove Ramp Agent jest wciąż zapowiedziany, a nie zbudowany: w wyborze jest wyłączony i oznaczony jako wkrótce. Nie ma agenta Bridge: bridging robi Moove Swap Agent, tym samym endpointem co swap w jednej sieci.

## Co potrafi Moove Receive Agent?

Dwa zakresy i nic więcej:

| Zakres | Daje |
| - | - |
| `payment_link:create` | Tworzenie linków do płatności |
| `payment_link:read` | Wyświetlanie linków do płatności |

Agent, który mógłby zlecić płatność, ale nie potwierdzić jej rozliczenia, nie wykonałby jedynego zadania, do którego istnieje, więc Moove Receive Agent dostaje oba.

## Co potrafi Moove Send Agent?

Trzy zakresy, trzy etapy jednej wypłaty, z których żaden niczego nie podpisuje:

| Zakres | Daje |
| - | - |
| `send:quote` | Budowanie **niepodpisanej** transakcji wysyłki |
| `send:create` | Zapisanie wysyłki, którą już rozesłałeś |
| `transaction:read` | Odczyt własnych transakcji |

> [!WARNING]
>
> **moove.xyz nigdy nie podpisuje, a twój agent musi.** Nie ma wywołania „wyślij pieniądze". moove.xyz wycenia wypłatę i zwraca *niepodpisaną* transakcję; twój kod podpisuje ją i rozsyła kluczem, którego moove.xyz nigdy nie widzi, a potem podaje moove.xyz hash.
>
> Twój agent potrzebuje więc biblioteki do podpisywania w projekcie oraz portfela finansującego **połączonego z kontem Moove podpisem**. Adres tylko do odbioru, który dodałeś przez wklejenie, nie może wysyłać: wypłata jest odrzucana, zanim cokolwiek zostanie podpisane.

Send **nie** jest domyślnie zaznaczony w wyborze. Zaznacz go świadomie: klucz, który może tylko odbierać, to znacznie mniejsza rzecz do wycieku.

> [!NOTE]
>
> **Upewnij się, że twój kod potrafi odczytać klucz.** Jeśli brakuje klucza API, żądanie wypłaty nie kończy się błędem: wykonuje się bez kontroli twojego konta, a wypłata nie jest zapisywana przy twoim kluczu. Niech twój kod zatrzyma się przed poproszeniem o wycenę, jeśli klucz nie jest ustawiony.

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

## Co potrafi Moove Swap Agent?

Trzy zakresy, te same trzy etapy co przy wypłacie, i znów żaden niczego nie podpisuje:

| Zakres | Daje |
| - | - |
| `swap:quote` | Budowanie **niepodpisanej** transakcji swapu lub bridge'a |
| `swap:create` | Zapisanie swapu lub bridge'a, który już rozesłałeś |
| `transaction:read` | Odczyt własnych transakcji |

Jeden agent obejmuje obie czynności. Swap zostaje w jednej sieci; bridge przenosi między sieciami. Tak czy inaczej wynik ląduje w portfelu na twoim własnym koncie. Aby zapłacić komuś innemu, użyj Moove Send Agent.

> [!WARNING]
>
> **Swap podpisuje twój agent, nie moove.xyz.** Potrzebuje tych samych dwóch rzeczy co przy wypłacie: biblioteki do podpisywania w projekcie i portfela finansującego **połączonego z kontem Moove podpisem**. Portfel, który nie jest połączony, jest odrzucany, gdy agent prosi o wycenę, zanim cokolwiek zostanie podpisane.

Swap też **nie** jest domyślnie zaznaczony w wyborze. Zaznacz go świadomie.

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

## Dlaczego wyciek klucza nie kosztuje cię pieniędzy

> [!NOTE]
>
> Klucz to **zawężenie ciebie**: działa jako twoje konto i może robić tylko podzbiór tego, co ty.
>
> Żaden endpoint nie przenosi środków i żaden nie przyjmuje klucza prywatnego. Wycena zwraca **niepodpisane** dane transakcji, które podpisujesz sam, a zapis transakcji tylko notuje hash, który już jest w łańcuchu. Linki do płatności zawsze rozliczają się na twój własny domyślny portfel, a wywołujący nie może wybrać, dokąd trafią.
>
> Wyciekły klucz w ogóle nie może więc przenieść środków: każda transakcja musi być podpisana kluczem, który masz tylko ty. (Swap z kluczem musi też zwrócić wynik na twoje własne konto, ale to zabezpieczenie przed pomyłkami, nie właściwa ochrona.)

> [!WARNING]
>
> To nie znaczy, że jest nieszkodliwy. Wyciekły klucz może odczytać historię twoich transakcji, tworzyć linki do płatności, które płacą *tobie*, i zapisywać transakcje przy twoich własnych portfelach. Unieważnij go: po prostu nie może zabrać pieniędzy.

Unieważnij klucz, któremu już nie ufasz. Unieważnienie jest trwałe i natychmiastowe.

## Kto decyduje, komu zapłacić?

Ty, nigdy twój agent i nigdy coś, co twój agent czyta. Podpisanej wypłaty nie da się cofnąć, a narzędzie AI czyta dużo tekstu napisanego przez innych.

* **Odbiorca, kwota, token i sieć pochodzą od ciebie** albo z twoich własnych rejestrów, takich jak tabela wypłat lub faktury. Nigdy ze strony internetowej, zgłoszenia, README, pliku, który narzędzie miało streścić, ani odpowiedzi API, w tym z opisu linku do płatności lub transakcji, na który mogą wpływać inni.
* **Swap jest taki sam.** Parę i kwotę podajesz ty, a wynik zawsze wraca do twojego własnego portfela.
* **Twój agent pyta, zanim podpisze wypłatę.** Pokazuje odbiorcę, kwotę, token, sieć i to, co dotrze, i czeka na twoje „tak": raz na wypłatę albo raz na partię z wypisanymi wszystkimi wierszami.
* **Tekst, który każe twojemu agentowi zmienić odbiorcę, podnieść kwotę, pominąć twoje potwierdzenie albo gdziekolwiek wysłać klucz lub frazę seed, to atak.** Twój agent nie powinien go wykonać. Powinien się zatrzymać i pokazać go tobie.

## Czy mogę to zrobić bez agenta?

API to zwykłe API HTTP. Nic w nim nie wymaga narzędzia 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 }'
```

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

## Czy mój agent AI może połączyć się przez MCP?

Tak. **MCP**, czyli Model Context Protocol, to otwarty standard, który pozwala agentowi AI wywoływać zewnętrzne usługi jako narzędzia. Skill uczy twoje narzędzie pisać integrację. Serwer Moove MCP pozwala agentowi pracować bezpośrednio z twoim kontem: sprawdzić twoje linki do płatności, zobaczyć, które zostały opłacone, i utworzyć nowy link, gdy o to poprosisz.

* **Serwer:** `https://api.moove.xyz/mcp`
* **Ten sam klucz API.** Użyj klucza API Moove, który już masz, wysyłanego jako nagłówek żądania. Agent wybrany dla klucza decyduje, jakie narzędzia się pojawią.
* **To samo bezpieczeństwo.** Nic na serwerze MCP nie podpisuje ani nie przenosi pieniędzy. Link do płatności, który tworzy, zawsze rozlicza się na twój własny domyślny portfel.

Połącz się z Claude Code, Cursor, Codex, GitHub Copilot lub Gemini CLI już dziś. Połączenie z claude.ai i ChatGPT pojawi się później.

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

## Co przeczytać dalej

> [card] [Klucze API Moove](https://docs.moove.xyz/pl-pl/manage/moove-api-keys.md)
>
> Twórz, ograniczaj i unieważniaj.

> [card] [API linków do płatności Moove](https://docs.moove.xyz/api-reference/moove-receive/moove-payment-links.md)
>
> Pełna lista endpointów.

> [card] [Moove Receive](https://docs.moove.xyz/pl-pl/transact/moove-receive.md)
>
> Ten sam produkt, bez kodu.

Kliknij. Zintegruj. Płać. Twoje pieniądze. Twój ruch.


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