Cara Agen AI Membeli Kartu Hadiah dengan Stablecoin

Bagaimana agen AI membeli kartu hadiah dengan stablecoin

Kebanyakan integrasi API mengasumsikan ada manusia di dalam prosesnya. Mereka dibangun di sekitar akun, alur OAuth, kunci yang telah diterbitkan sebelumnya, dan antarmuka checkout karena hingga baru-baru ini, perangkat lunak yang perlu membeli sesuatu tidak memiliki cara yang bersih untuk melakukannya sendiri.

Itu sedang berubah. Apa yang orang sebut perdagangan agenik adalah pola di mana perangkat lunak otonom dapat menemukan, menentukan harga, dan membeli barang tanpa menunggu konfirmasi manusia di setiap langkah. Ini adalah model yang berbeda dari integrasi API tradisional dalam satu cara mendasar: agen tidak mendaftar sebelumnya, tidak memegang token sesi, dan tidak mengarahkan siapa pun ke layar pembayaran.

Kartu hadiah cocok secara alami di sini. Mereka digital, dapat diterbitkan secara instan, dan tidak memerlukan pengiriman atau verifikasi identitas di pihak pembeli. Artikel ini membahas bagaimana infrastruktur ini bekerja dan bagaimana cara menghubungkannya.
 

Tiga protokol yang perlu Anda pahami

MCP (Model Context Protocol)

MCP adalah lapisan yang memungkinkan model AI memanggil alat eksternal. Alih-alih kode Anda langsung mengakses API, agen memanggil alat bernama, server MCP menerjemahkan itu menjadi permintaan yang tepat, dan hasilnya kembali dalam format yang dapat dipahami model. Untuk pembelian kartu hadiah, ini berarti agen dapat memanggil searchProducts, getProductPrice, validateOrder, dan createOrder sebagai panggilan alat yang alami daripada panggilan HTTP mentah.

Server MCP Cryptorefills diterbitkan di api.cryptorefills.com/mcp dan dapat ditemukan secara otomatis melalui manifest /.well-known/mcp.json, sehingga klien yang kompatibel dengan MCP termasuk Claude dan ChatGPT dapat terhubung tanpa kode tambahan. Lihat panduan integrasi MCP untuk cerita pembangunan di baliknya.
 

x402 (pembayaran berbasis HTTP)

x402 adalah standar pembayaran terbuka yang mengaktifkan kembali kode status HTTP 402 yang telah lama tidak aktif. Alur kerjanya seperti ini: agen membuat permintaan ke sumber daya, server merespons dengan 402 Pembayaran Diperlukan dan muatan yang dapat dibaca mesin yang menentukan harga, aset yang diterima, dan alamat tujuan. Agen menandatangani otorisasi pembayaran menggunakan EIP-712 (di rantai EVM) atau yang setara di Solana, kemudian mencoba kembali permintaan dengan header X-PAYMENT. Tidak ada pembuatan akun, tidak ada OAuth, tidak ada kunci API yang telah dibiayai sebelumnya.

Untuk keterampilan cryptorefills-x402 secara khusus, asetnya adalah USDC di Base dan pembayaran dilakukan tanpa biaya melalui transfer yang ditandatangani EIP-712.
 

REST API

Untuk pembangun yang ingin integrasi langsung daripada panggilan alat MCP, REST API Cryptorefills mencakup seluruh siklus hidup pesanan. Penjelajahan katalog melalui /v2/brands dan /v5/products/country, penentuan harga tepat waktu melalui /v4/products/price, validasi pesanan melalui /v5/orders/validations, pembuatan pesanan melalui /v5/orders, dan pelacakan pasca-pembuatan melalui streaming atau polling.

Ini adalah jalur yang tepat jika Anda membangun kerangka agen kustom, aplikasi mini Telegram, atau checkout yang terintegrasi dalam dompet dan ingin kontrol penuh atas alur permintaan. Dokumentasi lengkap endpoint tersedia di api-docs.
 

Langkah demi langkah: agen AI membeli kartu hadiah Amazon senilai $50 dengan USDC di Solana

Inilah yang terlihat seperti pembelian otonom lengkap dari awal hingga akhir, menggunakan Claude Desktop dengan server MCP Cryptorefills yang terpasang.

Langkah 1: Tambahkan server MCP ke Claude Desktop

Di claude_desktop_config.json Anda, tambahkan:
 

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

Field transport: "http" menggunakan HTTP yang dapat dialirkan daripada stdio, yang berarti koneksi tetap terbuka di seluruh alur pembelian multi-langkah tanpa memunculkan proses baru untuk setiap panggilan alat. Tidak ada kunci API yang diperlukan di header untuk operasi katalog dan penentuan harga.
 

Langkah 2: Agen memanggil searchProducts

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

Server mengembalikan daftar produk yang cocok dengan ID mereka, denominasi yang tersedia, dan jalur pembayaran yang didukung.
 

Langkah 3: Agen memanggil getProductPrice

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

Ini mengembalikan nilai setara USDC dari $50 pada tarif saat ini, bersama dengan jendela validitas kutipan. Penentuan harga diambil tepat waktu sehingga agen tidak pernah membayar berdasarkan tarif yang sudah kadaluarsa.
 

Langkah 4: Agen memanggil validateOrder, kemudian createOrder

Validasi dijalankan terlebih dahulu sehingga agen dapat menangkap masalah alamat pengiriman atau ketersediaan produk sebelum berkomitmen. Jika berhasil:
 

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

Langkah 5: Respons pesanan

{  "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": "Kartu Hadiah Amazon",    "denomination": 50,    "currency": "USD"  }}

Setelah pembayaran diterima di alamat dalam jendela kedaluwarsa, status pesanan berubah menjadi selesai dan voucher dikirim. Agen dapat mengalirkan pembaruan status melalui endpoint /track-order-stream atau kembali ke polling.
 

Apa yang sebenarnya digunakan agen untuk ini

Bot pasar dompet. Seorang pengguna memberi tahu bot merek apa yang mereka inginkan. Bot mengutip harga USDC, mengeksekusi, dan mengalirkan status pengiriman kembali, semuanya dalam antarmuka dompet.

Asisten aplikasi mini Telegram. Alur pembelian percakapan di mana agen menangani pencarian merek, pemilihan denominasi, dan validasi pembayaran, dengan pengaman untuk mencegah pemesanan ganda.

Agen hadiah DAO. Partisipasi tata kelola on-chain, kontribusi komunitas, atau penyelesaian bounty mendapatkan imbalan dengan voucher kartu hadiah yang diterbitkan secara otonom dari dompet kas.

Bantuan pengeluaran kas. Tim yang mengeluarkan dari kas stablecoin bersama dapat mengotomatiskan pengadaan kartu hadiah yang terkontrol dan dapat diaudit tanpa langkah off-ramp fiat manual.

Untuk melihat lebih jauh tentang logika insentif di balik agen yang memberikan imbalan kepada manusia, lihat Ketika AI mulai membeli kartu hadiah.
 

Kenapa tidak membangun lapisan pembayaran Anda sendiri

Alternatif yang menggoda adalah menggabungkan pemroses pembayaran, API kartu hadiah, dan off-ramp fiat sendiri. Dalam praktiknya, itu berarti mengelola saldo yang telah dibiayai sebelumnya dengan penyedia pihak ketiga, menavigasi pembatasan geografis pada ketersediaan kartu hadiah, menyerap latensi dan kompleksitas jalur fiat, dan mempertahankan sinkronisasi katalog Anda sendiri.

Cryptorefills menghilangkan semua itu. Tidak ada pendanaan yang diperlukan, tidak ada konversi fiat dalam jalur kritis, dan katalog mencakup lebih dari 6.600 merek di lebih dari 180 negara, tersedia segera setelah agen Anda memanggil searchProducts. Halaman agen AI memiliki gambaran lengkap tentang keterampilan dan opsi koneksi yang tersedia.
 

Pertanyaan yang sering diajukan

Bisakah Claude membeli kartu hadiah?

Ya. Claude mendukung MCP secara native melalui Claude Desktop dan Claude Code. Tambahkan server MCP Cryptorefills ke konfigurasi Anda (lihat potongan di atas) dan Claude dapat mencari katalog, mendapatkan harga langsung, memvalidasi, dan membuat pesanan dalam satu percakapan. Tidak diperlukan kunci API atau akun terpisah untuk akses katalog dan penentuan harga.
 

Apa itu x402?

x402 adalah standar pembayaran HTTP terbuka yang memanfaatkan kembali kode status HTTP 402 sehingga server dapat menyatakan harganya dan metode pembayaran yang diterima. Untuk agen otonom, ini berarti melakukan pembelian tanpa akun yang terdaftar sebelumnya atau token OAuth. Keterampilan cryptorefills-x402 mengimplementasikan ini untuk pembelian yang sepenuhnya otonom.
 

Bagaimana agen AI menghabiskan uang?

Seorang agen membutuhkan tiga hal: dompet yang dibiayai (biasanya menyimpan stablecoin seperti USDC atau USDT), cara untuk memanggil layanan eksternal (panggilan alat MCP atau panggilan API langsung), dan mekanisme pembayaran yang tidak memerlukan manusia pada saat transaksi. x402 menangani bagian terakhir dengan menyematkan jabat tangan pembayaran di dalam HTTP. Tanpa sesuatu seperti x402 atau MCP, seorang agen dapat menyiapkan pesanan tetapi tidak dapat menyelesaikan pembayaran sendiri.
 

Apakah ada server MCP untuk kartu hadiah?

Ya. Cryptorefills menerbitkan server MCP yang menangani alat untuk pencarian katalog, penentuan harga, validasi pesanan, pembuatan pesanan, dan pelacakan pengiriman. Ini bekerja dengan klien yang kompatibel dengan MCP termasuk Claude dan ChatGPT.
 

Mulai sekarang

Hubungkan agen Anda ke lebih dari 6.600 merek kartu hadiah di lebih dari 180 negara. Tanpa KYC. Tanpa pendanaan sebelumnya.

Tambahkan server MCP langsung di Claude Desktop, Claude Code, atau runtime agen yang kompatibel dengan MCP.
 

npx skills add cryptorefills/agents

Buka halaman agen AI untuk melihat semua tiga keterampilan, konfigurasi keterampilan x402, dan daftar lengkap jaringan pembayaran yang didukung.