CartAI

1) Pilih mode integrasi CartAI Anda: Pilih cara Anda ingin menggunakan CartAI berdasarkan permukaan produk Anda: (a) API (kontrol penuh di aplikasi Anda), (b) MCP Server (pasang alat CartAI ke "host" MCP seperti Claude Desktop/Code/Cursor/VS Code), atau (c) Hosted Cart (komponen "checkout" "drop-in"/iframe untuk permukaan yang tidak pernah memiliki "checkout").

2) Dapatkan akses dan kunci API: Buat akses ke CartAI dan dapatkan kunci API untuk permintaan terautentikasi. Anda akan menggunakan kunci ini sebagai token "Bearer" di "header" Otorisasi saat memanggil "endpoint" CartAI.

3) Tentukan alur kerja transaksional yang ingin Anda selesaikan: Identifikasi transaksi persis yang Anda ingin CartAI selesaikan (misalnya, "checkout" e-commerce, pendaftaran langganan, pembayaran faktur, pengiriman pesanan). Kumpulkan URL target dan input yang diperlukan (pilihan varian, detail pengiriman, detail pembayaran, persyaratan login jika berlaku).

4) Siapkan bidang identitas pelanggan: Buat objek pelanggan yang akan Anda berikan ke CartAI (misalnya, email dan nama). Ini digunakan untuk mengaitkan alur kerja dengan konteks pembeli/pelanggan.

5) Siapkan profil pengiriman dan pembayaran: Buat profil terstruktur untuk alamat pengiriman dan metode pembayaran. Dalam contoh, ini direferensikan sebagai file seperti "./buyer.json" (profil pengiriman) dan "./card.json" (profil pembayaran). CartAI mendukung penerimaan/penyimpanan kartu yang sesuai dengan PCI dan penanganan pembayaran yang di-token.

6) Buat "payload" tugas "checkout": Definisikan satu atau lebih tugas. Setiap tugas meliputi: (a) target: URL properti web untuk bertransaksi, (b) varian: opsi produk apa pun (misalnya, warna), (c) pengiriman: referensi profil pengiriman, dan (d) pembayaran: referensi profil pembayaran. Tugas-tugas dapat disusun dan dibentuk sesuai alur (beberapa mungkin tidak memerlukan pengiriman atau pembayaran).

7) Mulai dalam mode "sandbox" (disarankan): Atur options.sandbox = true saat pengujian. Ini memungkinkan Anda memvalidasi struktur "payload" dan perilaku alur kerja sebelum beralih ke produksi.

8) Panggil CartAI Checkout API: Kirim permintaan POST ke https://api.cartai.ai/checkout dengan "header" Content-Type: application/json dan Authorization: Bearer <YOUR_CARTAI_KEY>. Sertakan pelanggan, tugas, dan opsi Anda dalam "body" JSON.

9) Contoh permintaan (dari situs resmi CartAI): POST https://api.cartai.ai/checkout dengan "body" JSON seperti: { customer: { email: "[email protected]", name: "Jane Doe" }, tasks: [{ target: "bestbuy.com/site/sony-wh-1000xm5/6505727.p", variant: { color: "black" }, shipping: { profile: "./buyer.json" }, payment: { profile: "./card.json" } }], options: { sandbox: true } }

10) Tangkap respons "async" (taskId + status): CartAI menjalankan eksekusi secara "asynchronous". Respons langsung mengembalikan "taskId" (misalnya, "task_abc123") dan status (misalnya, "queued"). Simpan "taskId" untuk pelacakan.

11) Lacak eksekusi hingga selesai melalui "webhook": Dengarkan peristiwa "webhook" untuk transisi status hingga alur kerja selesai. CartAI menyediakan "webhook" untuk setiap transisi status sehingga Anda dapat memperbarui UI Anda, memicu tindakan "downstream", dan mengonfirmasi kapan transaksi telah diselesaikan.

12) Tangani percobaan ulang dengan aman (desain "idempotent"): Jika sistem Anda perlu mencoba ulang permintaan (kegagalan jaringan, "timeout"), gunakan pendekatan CartAI yang "idempotent" dan aman untuk dicoba ulang agar Anda tidak secara tidak sengaja menduplikasi transaksi.

13) Pindah dari "sandbox" ke produksi: Setelah alur kerja Anda berhasil diselesaikan di "sandbox", beralihlah ke pengaturan produksi (nonaktifkan "sandbox") dan pastikan penanganan "webhook", pencatatan, dan alur dukungan pelanggan Anda siap untuk pesanan/pembayaran nyata.

14) (Alternatif) Gunakan CartAI melalui MCP Server di "host" AI: Jika Anda ingin agen menjalankan "checkout" langsung dari lingkungan yang kompatibel dengan MCP, instal dan hubungkan server CartAI MCP. Ini mengekspos CartAI Catalog, Payments, dan Checkout API sebagai alat di dalam "host" seperti Claude Desktop/Code, Cursor, atau VS Code, memungkinkan pencarian produk, perkiraan biaya, otorisasi pembayaran, dan "checkout" otonom dengan pelacakan status.

15) (Alternatif) Gunakan Hosted Cart untuk "checkout" "drop-in": Jika Anda menambahkan "checkout" ke permukaan yang tidak pernah memilikinya (misalnya, halaman editorial, "feed" rekomendasi), sematkan CartAI Hosted Cart sebagai komponen/iframe "drop-in". Ini mencakup pemilihan varian, pengumpulan alamat, pembayaran, dan konfirmasi, didukung oleh "primitive" transaksi CartAI yang sama.

how_does_it_work

:

CartAI menjalankan transaksi sebagai alur kerja yang dapat diprogram dan disusun yang beradaptasi dengan bentuk setiap "checkout". Pengembang (atau agen AI yang kompatibel dengan MCP) mengirimkan tugas yang menentukan URL target dan input yang diperlukan—seperti pemilihan varian produk, detail pengiriman, dan profil pembayaran—kemudian agen CartAI menavigasi situs, mengisi formulir, menangani langkah-langkah kondisional (misalnya, persyaratan login atau alur 3DS), dan melanjutkan hingga konfirmasi. Eksekusi bersifat "asynchronous" dan dapat dilacak melalui status tugas dan "webhook", memungkinkan pemantauan dan percobaan ulang tingkat produksi. Untuk memastikan transaksi benar-benar diselesaikan, CartAI mengintegrasikan tiga kemampuan inti: (1) "primitive" langkah yang dapat disusun dengan percabangan kondisional ditambah eksekusi yang "idempotent" dan aman untuk dicoba ulang; (2) penerimaan kartu yang sesuai dengan PCI dan "stack vaulting" yang di-token yang dirancang untuk protokol pembayaran "agentic"; dan (3) mitigasi bot kooperatif menggunakan identitas agen yang ditandatangani dan integrasi kepercayaan (misalnya, Web Bot Auth dan Skyfire KYA) sehingga otomatisasi "diizinkan" daripada ditandai oleh sistem anti-bot umum. Tim dapat mengadopsi CartAI melalui API, memasangnya ke alat AI melalui server CartAI MCP, atau menyematkan komponen Hosted Cart "drop-in" untuk "checkout" "turnkey".

short_description

:

CartAI adalah API yang mengutamakan pengembang dan platform "checkout" "agentic" yang secara andal menavigasi properti web apa pun untuk menyelesaikan transaksi secara "end-to-end", menggabungkan alur kerja browser yang dapat disusun dengan "stack" pembayaran yang sesuai dengan PCI dan mitigasi bot kooperatif.