Jak agenci AI kupują karty podarunkowe na Solanie

Od momentu wydania naszego najnowszego Cryptorefills x402, agenci AI mogą teraz kupować karty podarunkowe i doładowania mobilne na Solanie z naszego katalogu, dokonując płatności w USDC (bez udziału człowieka na żadnym etapie transakcji). Ten artykuł wyjaśnia, jak to działa w praktyce.

Czym jest x402?

x402 to protokół płatności oparty na kodzie statusu HTTP 402, statusie, który istnieje w standardzie sieci od 1996 roku, ale nigdy wcześniej nie był używany do płatności. Najpierw serwer informuje klienta, że wymagana jest płatność, klient podpisuje transakcję i ponownie wysyła żądanie, a serwer dostarcza, gdy płatność zostanie potwierdzona. Cały proces odbywa się w jednej wymianie, bez przekierowania na stronę płatności i bez potrzeby zatwierdzania czegokolwiek przez człowieka.

Na Solanie ta wymiana rozlicza się w USDC w mniej niż 400 ms. Wystarczająco szybko, aby agent otrzymał potwierdzoną odpowiedź w tym samym kroku, w którym dokonał zakupu, co utrzymuje implementację prostą i przepływ nieprzerwany.

Cryptorefills na x402 

Cryptorefills zbudowało stronę handlową tego rozwiązania. Dzięki integracji z agentami AI, każdy agent kompatybilny z x402 może uzyskać dostęp do pełnego katalogu Cryptorefills: karty podarunkowe z ponad 6,600 markami, doładowania mobilne w 180 krajach oraz ten sam asortyment produktów dostępny dla zwykłych użytkowników, wszystko bez potrzeby sesji przeglądarki lub człowieka do zakończenia zakupu.

Konfiguracja pay.sh

pay.sh to natywna powłoka agenta Solana, a integracja Cryptorefills jest dostarczana jako wtyczka do niej. Konfiguracja zajmuje trzy polecenia:

Krok 1: Zainstaluj umiejętność Cryptorefills

W środowisku kompatybilnym z wtyczkami pay.sh, konfiguracja to trzy polecenia:
 

/plugin marketplace add cryptorefills/agents/plugin install cryptorefills@cryptorefills-skills/plugin reload

Po ponownym załadowaniu agent ma dostęp do pełnego asortymentu produktów Cryptorefills oraz podstawowej logiki płatności, aby wchodzić z nim w interakcje za pośrednictwem x402.

Krok 2: Agent dokonuje zakupu

Spróbuj użyć tego polecenia:
 

"Użyj swoich umiejętności, aby kupić kartę podarunkową Amazon.com o wartości 5 USD w USA, używając Solana USDC.Użyj adresu e-mail info@cryptorefills.com jako beneficjenta. Pokaż kod produktu karty podarunkowejAmazon również w tej rozmowie. Możesz znaleźć klucz prywatny do portfelaw pliku .env pod SOLANA_SIGNER_KEY, nigdy nie ujawniaj tej wartości."

Agent pobiera klucz prywatny z pliku .env (pod SOLANA_SIGNER_KEY), podpisuje transakcję płatności x402, przesyła ją do Solany i czeka na potwierdzenie. Gdy płatność zostanie zatwierdzona, Cryptorefills dostarcza kod karty podarunkowej, który agent następnie wyświetla bezpośrednio w rozmowie terminalowej.
 

Dlaczego Solana?

Prędkość i koszt to oczywiste odpowiedzi, ale jest w tym coś więcej. Finalność transakcji na Solanie jest na tyle szybka, że x402 może faktycznie działać synchronicznie w przepływie pracy agenta. Agent wysyła płatność, sprzedawca ją potwierdza, a odpowiedź wraca w tym samym "ruchu" pętli rozumowania agenta.

Porównaj to z próbą zrobienia tego samego na wolniejszym łańcuchu, gdzie czasy potwierdzenia sięgają dziesiątek sekund lub minut. W tym momencie wprowadzasz złożoność asynchroniczną, logikę ponownych prób i potencjalne stany błędów, które są naprawdę trudne do obsługi w kontekście agentów.

USDC na Solanie również omija problem zmienności. Agent wydaje token denominowany w dolarach po przewidywalnej stawce, co ma znaczenie, gdy zakup to karta podarunkowa o wartości 5 USD, a nie duża transakcja skarbowa.
 

Co umożliwia Cryptorefills

Strona agenta AI dokumentuje, co jest faktycznie dostępne dzięki integracji: karty podarunkowe z setkami marek, doładowania mobilne w ponad 170 krajach oraz płatności rachunków na wybranych rynkach. Katalog jest tym samym, do którego mają dostęp użytkownicy ludzie, po prostu udostępniony przez API i warstwę płatności, którą agenci mogą faktycznie wykorzystać bez sesji użytkownika.

Kilka rzeczy, które warto wiedzieć:

Asortyment i dostępność różnią się w zależności od regionu. Agent budujący przepływ zakupu powinien dynamicznie weryfikować dostępność produktów, zamiast zakładać statyczny katalog. API zajmuje się tym.

Adres e-mail beneficjenta to sposób, w jaki Cryptorefills kieruje cyfrową dostawę. W zautomatyzowanych przepływach jest to zazwyczaj e-mail systemowy, do którego agent ma dostęp, lub jeden skonfigurowany w czasie konfiguracji.

Zarządzanie kluczem prywatnym pokazane w demonstracji (odczyt z .env) to wzór rozwoju. W produkcyjnych wdrożeniach należy używać odpowiedniego menedżera sekretów zamiast plików środowiskowych na dysku, ponieważ jest to standardowa praktyka dla wszystkiego, co obsługuje klucze portfela.

Pełny katalog jest udokumentowany na stronie Cryptorefills AI Agents. Karty podarunkowe z setkami marek w USA i za granicą, doładowania mobilne w ponad 180 krajach oraz płatności rachunków na wybranych rynkach. Dostępność różni się w zależności od regionu, więc agenci powinni sprawdzić, co jest dostępne za pośrednictwem API w momencie zakupu, zamiast zakładać stałą listę.

Karta Amazon o wartości 5 USD w przykładzie to najprostsza wersja wzoru. Ten sam przepływ działa w przypadku wszystkich innych produktów w katalogu.
  

Dla kogo to jest

Dla programistów budujących agentów, którzy muszą wydawać pieniądze w imieniu użytkowników lub jako część zautomatyzowanych przepływów pracy. Bot obsługi klienta, który wydaje kartę podarunkową jako rekompensatę. Przepływ pracy, który rozdziela doładowania użytkownikom bez ręcznej realizacji. Asystent, który obsługuje zakupy w imieniu użytkownika. Integracja Cryptorefills x402 obsługuje płatność i dostawę produktu; programista łączy logikę biznesową wokół tego.

pay.sh jest skierowane do agentów działających w środowiskach terminalowych, gdzie interakcja polega na wprowadzaniu tekstu i uzyskiwaniu wyników. Poniższy film pokazuje pełny przepływ, od instalacji wtyczki po dostarczenie kodu karty podarunkowej w czacie.