Jak agenci AI kupują karty podarunkowe za pomocą stablecoinów

Jak agenci AI kupują karty podarunkowe za pomocą stablecoinów

Większość integracji API zakłada, że w procesie uczestniczy człowiek. Zostały one zbudowane wokół kont, przepływów OAuth, wcześniej wydanych kluczy i interfejsów zakupowych, ponieważ do niedawna oprogramowanie, które potrzebowało coś kupić, nie miało czystego sposobu, aby zrobić to samodzielnie.

To się zmienia. To, co ludzie nazywają handlem agentowym, to wzór, w którym autonomiczne oprogramowanie może odkrywać, wyceniać i kupować towary bez czekania na potwierdzenie każdego kroku przez człowieka. To inny model niż tradycyjna integracja API w jednym fundamentalnym aspekcie: agent nie rejestruje się wcześniej, nie posiada tokena sesji i nie przekierowuje nikogo na ekran płatności.

Karty podarunkowe idealnie się tutaj wpisują. Są cyfrowe, można je wydawać natychmiastowo i nie wymagają wysyłki ani weryfikacji tożsamości po stronie kupującego. Ten artykuł omawia, jak działa infrastruktura i jak ją skonfigurować.
 

Trzy protokoły, które musisz zrozumieć

MCP (Model Context Protocol)

MCP to warstwa, która pozwala modelowi AI wywoływać zewnętrzne narzędzia. Zamiast aby twój kod bezpośrednio łączył się z API, agent wywołuje nazwane narzędzie, serwer MCP tłumaczy to na odpowiednie żądanie, a wynik wraca w formacie, który model może zrozumieć. W przypadku zakupów kart podarunkowych oznacza to, że agent może wywołać searchProducts, getProductPrice, validateOrder i createOrder jako naturalne wywołania narzędzi, a nie surowe wywołania HTTP.

Serwer MCP Cryptorefills jest opublikowany pod adresem api.cryptorefills.com/mcp i jest automatycznie odkrywany za pomocą manifestu /.well-known/mcp.json, dzięki czemu klienci zgodni z MCP, w tym Claude i ChatGPT, mogą łączyć się bez żadnego dodatkowego kodu. Zobacz przewodnik integracji MCP, aby poznać historię budowy.
 

x402 (płatność natywna HTTP)

x402 to otstandaryzowany standard płatności, który reaktywuje długo uśpiony kod statusu HTTP 402. Proces działa w ten sposób: agent wysyła żądanie do zasobu, serwer odpowiada kodem 402 Payment Required oraz ładunkiem zrozumiałym dla maszyny, określającym cenę, akceptowany zasób i docelowy adres. Agent podpisuje autoryzację płatności za pomocą EIP-712 (na łańcuchach EVM) lub odpowiednika na Solanie, a następnie ponawia żądanie z nagłówkiem X-PAYMENT. Nie jest wymagana rejestracja konta, OAuth ani wcześniej dofinansowany klucz API.

W przypadku umiejętności cryptorefills-x402 zasobem jest USDC na Base, a płatność jest bezgazowa za pomocą transferów podpisanych EIP-712.
 

REST API

Dla twórców, którzy chcą bezpośredniej integracji zamiast wywołań narzędzi MCP, REST API Cryptorefills obejmuje pełny cykl życia zamówienia. Przeglądanie katalogu za pomocą /v2/brands i /v5/products/country, wycena na żądanie za pomocą /v4/products/price, walidacja zamówienia za pomocą /v5/orders/validations, tworzenie zamówienia za pomocą /v5/orders oraz śledzenie po utworzeniu za pomocą strumieniowania lub polling.

To właściwa ścieżka, jeśli budujesz niestandardową ramę agenta, mini aplikację Telegram lub zakupy osadzone w portfelu i chcesz mieć pełną kontrolę nad przepływem żądań. Pełna dokumentacja punktów końcowych znajduje się pod adresem api-docs.
 

Krok po kroku: agent AI kupujący kartę podarunkową Amazon o wartości 50 USD za pomocą USDC na Solanie

Oto jak wygląda pełny autonomiczny zakup od początku do końca, korzystając z Claude Desktop z zainstalowanym serwerem MCP Cryptorefills.

Krok 1: Dodaj serwer MCP do Claude Desktop

W swoim claude_desktop_config.json dodaj:
 

{  "mcpServers": {    "cryptorefills": {      "url": "https://api.cryptorefills.com/mcp/http",      "transport": "http",      "headers": {        "User-Agent": "Cryptorefills-MCP/1.0"      }    }  }}

Pole transport: "http" korzysta z HTTP strumieniowego zamiast stdio, co oznacza, że połączenie pozostaje otwarte w trakcie wieloetapowego procesu zakupu, bez uruchamiania nowego procesu dla każdego wywołania narzędzia. Nie jest wymagany klucz API w nagłówku dla operacji katalogowych i wyceny.
 

Krok 2: Agent wywołuje searchProducts

{  "tool": "searchProducts",  "input": {    "query": "Amazon",    "country": "US",    "category": "gift_cards"  }}

Serwer zwraca listę pasujących produktów z ich identyfikatorami, dostępnymi nominałami i obsługiwanymi metodami płatności.
 

Krok 3: Agent wywołuje getProductPrice

{  "tool": "getProductPrice",  "input": {    "product_id": "amazon-us-50",    "currency": "USDC",    "network": "solana"  }}

To zwraca równowartość 50 USD w USDC według bieżących stawek, wraz z okresem ważności oferty. Ceny są pobierane na żądanie, więc agent nigdy nie płaci według przestarzałej stawki.
 

Krok 4: Agent wywołuje validateOrder, a następnie createOrder

Walidacja przebiega najpierw, aby agent mógł wychwycić wszelkie problemy z adresem dostawy lub dostępnością produktu przed potwierdzeniem. Po pomyślnym zakończeniu:
 

{  "tool": "createOrder",  "input": {    "product_id": "amazon-us-50",    "currency": "USDC",    "network": "solana",    "delivery_email": "user@example.com"  }}

Krok 5: Odpowiedź zamówienia

{  "order_id": "cr_ord_9f3a12b",  "status": "awaiting_payment",  "payment": {    "address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA7SjTBRet7vQ9z",    "amount": "50.23",    "currency": "USDC",    "network": "solana",    "expires_at": "2026-04-23T14:35:00Z"  },  "product": {    "name": "Karta podarunkowa Amazon",    "denomination": 50,    "currency": "USD"  }}

Gdy płatność dotrze na adres w okresie ważności, status zamówienia zmienia się na zakończone, a voucher jest dostarczany. Agent może przesyłać aktualizacje statusu za pomocą punktu końcowego /track-order-stream lub wrócić do polling.
 

Do czego agenci faktycznie to wykorzystują

Bots na rynku portfeli. Użytkownik mówi botowi, jaką markę chce. Bot podaje cenę w USDC, wykonuje transakcję i przesyła status dostawy z powrotem, wszystko w interfejsie portfela.

Asystenci mini aplikacji Telegram. Rozmowy zakupowe, w których agent obsługuje wyszukiwanie marki, wybór nominału i walidację płatności, z zabezpieczeniami zapobiegającymi podwójnym zamówieniom.

Agenci nagród DAO. Udział w zarządzaniu on-chain, wkłady społecznościowe lub realizacja zadań są nagradzane voucherami na karty podarunkowe wydawanymi autonomicznie z portfela skarbcowego.

Pomocnicy wydatków skarbcowych. Zespoły wydające z wspólnego skarbcowego stablecoina mogą zautomatyzować kontrolowane, audytowalne zakupy kart podarunkowych bez ręcznych kroków związanych z konwersją fiat.

Aby uzyskać dłuższy przegląd logiki zachęt stojącej za agentami wydającymi nagrody dla ludzi, zobacz Kiedy AI zaczynają kupować karty podarunkowe.
 

Dlaczego nie zbudować własnej warstwy płatności

Wabiąca alternatywa to połączenie procesora płatności, API kart podarunkowych i konwersji fiat samodzielnie. W praktyce oznacza to zarządzanie wcześniej dofinansowanymi saldami z dostawcą zewnętrznym, nawigowanie po ograniczeniach geograficznych dotyczących dostępności kart podarunkowych, absorbowanie opóźnień i złożoności szlaków fiat oraz utrzymywanie własnej synchronizacji katalogu.

Cryptorefills usuwa to wszystko. Nie jest wymagane wcześniejsze dofinansowanie, nie ma konwersji fiat w krytycznej ścieżce, a katalog obejmuje ponad 6600 marek w ponad 180 krajach, dostępnych w momencie, gdy twój agent wywołuje searchProducts. Strona AI agents page zawiera pełny przegląd dostępnych umiejętności i opcji połączenia.
 

Najczęściej zadawane pytania

Czy Claude może kupować karty podarunkowe?

Tak. Claude natywnie obsługuje MCP za pomocą Claude Desktop i Claude Code. Dodaj serwer MCP Cryptorefills do swojej konfiguracji (zobacz fragment powyżej), a Claude może przeszukiwać katalog, uzyskiwać aktualną cenę, walidować i tworzyć zamówienie w jednej rozmowie. Nie jest wymagany oddzielny klucz API ani konto do uzyskania dostępu do katalogu i wyceny.
 

Czym jest x402?

x402 to otwarty standard płatności HTTP, który przekształca kod statusu HTTP 402, aby serwer mógł zadeklarować swoją cenę i akceptowaną metodę płatności. Dla autonomicznych agentów oznacza to dokonywanie zakupów bez wcześniej zarejestrowanych kont lub tokenów OAuth. Umiejętność cryptorefills-x402 implementuje to dla w pełni autonomicznych zakupów.
 

Jak agenci AI wydają pieniądze?

Agent potrzebuje trzech rzeczy: zasilonego portfela (zwykle zawierającego stablecoiny, takie jak USDC lub USDT), sposobu na wywoływanie zewnętrznych usług (wywołania narzędzi MCP lub bezpośrednie wywołania API) oraz mechanizmu płatności, który nie wymaga człowieka w momencie transakcji. x402 obsługuje ostatnią część, wbudowując handshake płatności w HTTP. Bez czegoś takiego jak x402 lub MCP, agent może przygotować zamówienie, ale nie może samodzielnie zakończyć płatności.
 

Czy istnieje serwer MCP dla kart podarunkowych?

Tak. Cryptorefills publikuje serwer MCP, który obsługuje narzędzia do wyszukiwania katalogu, wyceny, walidacji zamówienia, tworzenia zamówienia i śledzenia dostawy. Działa z każdym klientem zgodnym z MCP, w tym Claude i ChatGPT.
 

Rozpocznij

Połącz swojego agenta z ponad 6600 markami kart podarunkowych w ponad 180 krajach. Brak KYC. Brak wcześniejszego dofinansowania.

Dodaj serwer MCP bezpośrednio w Claude Desktop, Claude Code lub dowolnym środowisku uruchomieniowym zgodnym z MCP.
 

npx skills add cryptorefills/agents

Otwórz stronę AI agents, aby zobaczyć wszystkie trzy umiejętności, konfigurację umiejętności x402 oraz pełną listę obsługiwanych sieci płatniczych.