Panduan Agentic Checkout

TL;DR — Agentic checkout adalah “belikan untuk saya” (terjemahan) “press buy untuk me” bagian dari AI shopping. Ketika sebuah AI assistant menemukan sebuah product dan menyelesaikan purchase untuk Anda, itu akhir transaction langkah adalah agentic checkout. di OpenAI’s delegated-payment flow, agent menggunakan sebuah token pembayaran terbatas alih-alih sebuah mentah card angka, dan untuk apa pun risky (sebuah login, sebuah extra verification) ini berhenti dan hands control back untuk sebuah human. ini adalah satu piece dari bigger protocols (ACP dan UCP), tidak sebuah hal pada -nya own.

Apa agentic checkout adalah

sebagian besar dari “AI shopping” (terjemahan) “AI shopping” adalah penemuan: Anda tanyakan sebuah assistant untuk temukan Anda sesuatu, dan ini membaca merchants’ product feeds dan suggests options. Agentic checkout adalah langkah setelah itu — bagian di mana agent sebenarnya membuat order: picks sebuah shipping option, berfungsi out tax dan shipping cost, melewati along payment, dan finalizes purchase.

key kata adalah langkah. Agentic checkout tidak sebuah terpisah product atau company. ini adalah transaction-completion kemampuan dibangun ke dua big agentic-commerce standards — Agentic Commerce Protocol (ACP) dari OpenAI dan Stripe, dan Universal Commerce Protocol (UCP) dari Google dan Shopify. jika Anda ingin overview dari itu, sibling tulis-ups pada setiap cover them; ini halaman zooms semua cara di pada checkout mechanics.

three hal orang mendapatkan wrong

• “Itu AI buys dengan zero human involvement.” (terjemahan) “ AI buys dengan zero human involvement.” Tidak benar-benar. Keduanya protocols memiliki sebuah dibangun-di “berhenti dan ask a human” (terjemahan) “berhenti dan tanyakan sebuah human” langkah — untuk sebuah login, sebuah extra card verification, atau sebuah konfirmasi. Truly hands-off checkout tidak bagaimana specs adalah dibangun.
• “Itu AI sees my credit card.” (terjemahan) “ AI sees my credit card.” Tidak. Payment adalah lulus sebagai sebuah scoped token — sebuah stand-di itu’s locked untuk satu merchant, satu amount, satu time window, dan dapat hanya menjadi digunakan setelah. mentah card angka tidak pernah reaches agent.
• “Ini adalah sudah wajar — paling stores memiliki it.” (terjemahan) “ini adalah sudah wajar — sebagian besar stores memiliki ini.” juga Tidak. sebagai dari pertengahan 2026 ini adalah early: hanya tentang sebuah dozen Shopify stores memiliki hilang langsung dengan ChatGPT checkout sebelum OpenAI scaled back fully di-chat versi di March 2026.

Siapa’s responsible jika sesuatu goes wrong?

store Anda bought dari adalah masih store — apa called merchant dari record. mereka tangani order, refunds, dan disputes, hanya like sebuah wajar online purchase. genuinely messy bagian, yang tidak seorang pun memiliki fully solved namun, adalah apa happens dengan sebuah disputed charge ketika “shopper” (terjemahan) “shopper” adalah sebuah AI agent. Lebih pada itu di Advanced tab.

ingin sebenarnya mesin status, bagaimana token pembayaran adalah scoped, di mana sebuah human memiliki untuk langkah di, dan apa merchants harus test sebelum mengubah ini pada? Switch untuk Advanced.

TL;DR — Agentic checkout adalah transaction-completion kemampuan dari agentic commerce — buat, perbarui, menyelesaikan/cancel sebuah sesi checkout, delegate payment, konfirmasi order. ini adalah satu membangun block dari ACP dan satu dari UCP, tidak sebuah standalone protocol. teknis spine adalah sebuah mesin status: ACP walks sebuah session melalui not_ready_for_payment → ready_for_payment → (requires_escalation / authentication_required ketika needed) → completed, mirroring UCP’s incomplete → requires_escalation → ready_for_complete. escalation status adalah deliberate human-di—loop seam. Delegasi pembayaran menggunakan scoped tokens — dikunci ke merchant, dibatasi jumlah, dibatasi waktu, single-gunakan — so agent tidak pernah holds sebuah mentah card. Konfirmasi pesanan adalah sebuah push: merchants POST HMAC-signed, penuh-object webhooks. merchant tetap merchant-dari-record, so settlement/refunds/chargebacks sit dengan merchant dan -nya PSP — tetapi chargeback evidentiary kerangka kerja adalah genuinely unresolved sebagai dari pertengahan 2026. bangun dan test untuk idempotency-safe retries, webhook signature verification, dan escalation paths sebelum Anda flip ini pada.

Cakupan: ini adalah transaction langkah, tidak seluruh protocol

Agentic checkout adalah satu kemampuan. di ACP ini adalah secara harfiah Agentic Checkout block (satu dari five, alongside Product Feed, Delegate Payment, Delegate Authentication, dan Orders/Webhooks). di UCP ini adalah checkout kemampuan di dalam sebuah lebih luas, kemampuan-negotiated spec. sibling artikel pada ACP dan UCP cover sekitarnya protocol dan business context — feed quality, /.well-known/ucp profile, March 2026 pivot’s penemuan implications. ini halaman tetap pada mechanics dari completing transaction: session lifecycle, payment delegation, di mana sebuah human intervenes, konfirmasi pesanan, dan liability.

Satu framing untuk carry di dari ACP sibling dan tidak re-argue: agents transact terhadap feeds dan APIs, tidak Anda di-crawl HTML. So checkout reliability — tidak halaman copy — adalah apa menjadi dioptimalkan di sini.

sesi checkout mesin status

single sebagian besar differentiating hal untuk memahami tentang agentic checkout, dan hal sebagian besar tulis-ups skip, adalah itu sebuah checkout adalah sebuah session dengan sebuah status, dan itu status moves melalui sebuah didefinisikan machine.

ACP’s Checkout reference lists penuh status enum: incomplete, not_ready_for_payment, requires_escalation, authentication_required, ready_for_payment, pending_approval, complete_in_progress, completed, canceled, in_progress, dan expired. happy path adalah pendek — not_ready_for_payment → ready_for_payment → in_progress → completed, dengan canceled sebagai lainnya terminal state. Per ACP’s lifecycle concepts, providing sebuah diperlukan fulfillment option adalah apa transitions sebuah session dari not_ready_for_payment untuk ready_for_payment; sebuah failed payment dapat drop ini back untuk ready_for_payment untuk sebuah retry.

interesting status adalah ones itu tidak happy path:

• requires_escalation / authentication_required — agent dapat’t proceed alone; sesuatu perlu sebuah human atau sebuah extra verification (see berikutnya bagian).
• pending_approval — menunggu pada sebuah approval, e.g. sebuah B2B purchase-order sign-off.
• expired — session timed out (CheckoutSession carries expires_at).

ini adalah yang sama underlying design sebagai UCP’s checkout, yang berjalan incomplete → requires_escalation → ready_for_complete, di mana requires_escalation hands control back untuk sebuah human melalui sebuah continue_url (covered pada UCP sibling). Dua terpisah protocols, satu convergent pattern: sebuah checkout dapat’t selalu finish tanpa stopping untuk tanyakan sebuah human sesuatu. itu’s tidak sebuah limitation bolted pada — ini adalah core shape dari design.

sebuah practical note untuk anyone membangun terhadap ACP: sebuah malformed permintaan mengembalikan sebuah HTTP-tingkat error object (type dari invalid_request, request_not_idempotent, processing_error, atau service_unavailable). tetapi sebuah business-logic masalah di dalam sebuah jika tidak-valid session muncul back sebagai sebuah MessageError object di session’s messages[] array, tidak sebuah HTTP error. Anda memiliki untuk tangani keduanya, dan mereka’re easy untuk conflate di early integration berfungsi.

Bagaimana delegasi pembayaran berfungsi

seluruh poin dari payment-delegation layer adalah itu mentah card data tidak pernah reaches agent. alih-alih handing agent sebuah card angka, buyer’s payment detail adalah turned ke sebuah scoped token.

Per OpenAI’s Delegated Payment spec, delegated payment payload adalah dikirim untuk merchant’s PSP atau vault secara langsung, dan PSP atau vault mengembalikan sebuah token pembayaran scoped untuk delegated payment di luar dari PCI cakupan. itu token adalah bounded pada four axes:

• reason — saat ini "one_time": single-gunakan.
• max_amount — caps charge untuk checkout total; token dapat’t menjadi digunakan untuk overcharge.
• expires_at (RFC 3339) — token memiliki sebuah hard expiry.
• merchant_id + checkout_session_id — bound untuk satu merchant dan satu session.

So sebuah delegated token adalah dikunci ke merchant, dibatasi jumlah, dibatasi waktu, dan single-gunakan. itu’s mechanism itu lets sebuah agent “spend money” (terjemahan) “spend money” tanpa ever menjadi trusted dengan sebuah reusable card credential. pada ACP side, Stripe’s Shared Payment Token adalah described sebagai pertama Delegated Payment Spec–compatible implementation, dengan lebih PSPs coming. UCP menggunakan sebuah parallel decoupled model itu separates payment instruments dari handlers (covered pada UCP sibling).

PCI cakupan adalah sebuah nyata decision di sini. OpenAI’s spec adalah jelas itu secara langsung integrating dengan Delegated Payment Spec involves secara langsung menangani cardholder data dan dapat memengaruhi Anda PCI cakupan, dan direct integration memerlukan PCI DSS tingkat 1 status. untuk sebagian besar merchants tokenized path (network tokens / sebuah PSP itu menangani delegation) adalah cara untuk pertahankan cardholder data out dari Anda environment. Choosing antara “tangani CHD secara langsung” (terjemahan) “tangani CHD secara langsung” dan “let itu PSP tokenize” (terjemahan) “let PSP tokenize” adalah pertama architecture decision — Decision tab walks ini.

Di mana sebuah human masih memiliki untuk langkah di

“The shopper still authorizes it” (terjemahan) “ shopper masih authorizes ini” adalah benar tetapi vague. protocol-tingkat triggers adalah spesifik, dan naming them adalah bagaimana Anda design handoff alih-alih hitting sebuah silent dead end:

• 3-D Secure / langkah-up. ACP models ini dengan InterventionCapabilities (didukung jenis sertakan 3ds dan address_verification), sebuah enforcement tingkat (always / conditional / optional), dan sebuah display_context (native / webview / modal / redirect). outcome dari sebuah langkah-up muncul back sebagai sebuah AuthenticationResult dengan nilai like authenticated, denied, rejected, abandoned, canceled, atau not_supported.
• requires_escalation / authentication_required status. ini adalah session statuses itu say “I need a human or an extra check before I can move on.” (terjemahan) “I perlu sebuah human atau sebuah extra periksa sebelum I dapat move pada.”
• B2B approval_required. PaymentData object carries B2B fields (purchase_order_number, payment_terms, due_date, approval_required) — agentic checkout tidak hanya DTC.
• UCP’s continue_url handoff. UCP’s requires_escalation surfaces sebuah continue_url buyer finishes themselves (login, konfirmasi, age periksa). sama seam, berbeda protocol.

takeaway: sebuah transaction itu escalates cleanly adalah far better daripada satu itu silently dead-ends. Design escalation paths sebagai pertama-class alur, tidak error cases.

Konfirmasi pesanan adalah sebuah push, tidak sebuah pull

Di sini’s sebuah piece competing explainers largely skip. setelah sebuah purchase, agent platform tidak sit di sana polling Anda API untuk order status. ** merchant pushes signed webhooks.**

Per ACP’s webhook reference, merchants POST order events so agent platform dapat stay di sync dengan fulfillment-grade truth. Dua event jenis carry ini: order_create untuk baru orders dan order_update untuk state perubahan. Order status nilai referenced sertakan created, manual_review, confirmed, canceled, shipped, dan fulfilled. Three detail penting untuk anyone implementing ini:

• permintaan harus menjadi signed dengan sebuah HMAC signature di Merchant-Signature header. Unsigned atau badly-signed permintaan mendapatkan sebuah 401.
• ** data field harus berisi penuh Order object**, tidak incremental deltas. Anda kirim seluruh state setiap time.
• kode respons untuk tangani: 200 success, 401 tidak valid signature, 429 rate-limited.

So “how does the platform know the order went through?” (terjemahan) “bagaimana melakukan platform know order went melalui?” memiliki sebuah concrete jawaban: Anda tell ini, dengan sebuah signed, penuh-object POST, dan Anda tangani platform’s 429 back-pressure.

Fraud, chargebacks, dan liability — apa settled dan apa tidak

ini adalah paling honest dan sebagian besar differentiating bagian, so I’ll menjadi plain tentang di mana line antara “settled” (terjemahan) “settled” dan “open” (terjemahan) “open” sebenarnya adalah.

apa settled: merchant dari record. OpenAI’s own payment spec status itu OpenAI adalah tidak merchant dari record — di bawah ACP, merchants bring mereka own PSP, dan settlement, refunds, chargebacks, dan compliance tetap dengan merchant dan mereka PSP. Rye’s Arjun Bhargava corroborates ini independently: keduanya protocols pertahankan merchant sebagai merchant dari record, responsible untuk fulfillment, chargebacks, dan disputes. ini adalah consistent dengan merchant-dari-record framing pada keduanya sibling halaman — carry ini forward, jangan re-derive ini.

apa tidak settled: chargeback evidentiary kerangka kerja. Merchant-dari-record tells Anda siapa eats sebuah dispute oleh default. ini melakukan tidak tell Anda bagaimana Anda win satu ketika “customer” (terjemahan) “customer” adalah mediated oleh sebuah AI agent. Tradisional chargeback defense leans pada human-generated evidence trails (IP, device, browsing perilaku, sebuah human clicking “buy” (terjemahan) “buy”). Agent-generated authorization logs adalah sebuah berbeda jenis dari evidence, dan card-network dispute aturan tidak ditulis untuk them. Chargeflow’s fraud specialist Ben Herut frames ini sebagai perdagangan agen bringing sebuah baru layer dari fraud dan confusion itu legacy sistem dapat’t interpret, dan Chargeflow’s analysis adalah blunter masih: tidak ada bersih jawaban namun — card networks, issuers, dan platform providers adalah semua berfungsi melalui ini pertanyaan.

** emerging kerangka kerja adalah emerging, tidak finished.** Visa’s Trusted Agent Protocol adalah described sebagai sebuah standards-based kerangka kerja enabling merchants untuk verify agent identity dan intent di nyata time, preventing impersonation tanpa degrading pengguna experience. Mastercard’s Agent Pay (announced April 2025) menggunakan “Agentic Tokens,” (terjemahan) “Agentic Tokens,” sebuah extension dari -nya Digital Enablement Service. Per ketiga-party reporting (Fintech Wrap Up / Finextra), Mastercard’s liability adalah mengatakan untuk ikuti yang sama aturan sebagai standard tokenized transactions — issuer carrying fraud liability ketika token adalah validly issued dan honored di authorization — tetapi I’d treat itu spesifik allocation sebagai reported, tidak confirmed until ini adalah di Mastercard’s own docs. dan note itu Visa’s consumer-facing zero-liability jaminan melindungi cardholders dari tidak terotorisasi charges; ini melakukan tidak resolve merchant-side dispute pertanyaan, yang adalah sebenarnya open satu. jangan conflate dua.

Apa merchants perlu untuk implement dan test

Existing konten memberikan strategic prep advice (bersih feeds, loyalty programs). Di sini’s operational layer — apa untuk sebenarnya bangun dan verify sebelum flipping ini pada:

• Decide Anda PCI posture. Tokenized/network-token path vs. direct CHD menangani (tingkat 1). sebagian besar merchants ingin PSP untuk hold delegation.
• membuat retries idempotency-safe. ACP memiliki sebuah request_not_idempotent error jenis untuk sebuah alasan. sebuah agent (atau sebuah flaky network) akan retry sebuah buat/menyelesaikan panggil; kirim sebuah idempotency key dan membuat repeated panggilan dengan yang sama key safe, so Anda jangan double-charge atau double-buat sebuah order.
• Verify webhook signatures. Validate Merchant-Signature HMAC pada setiap inbound order webhook, reject pada mismatch, dan konfirmasi Anda kembalikan 200/429 correctly di bawah muat.
• Simulate escalation paths di sandbox. Force requires_escalation / authentication_required, jalankan sebuah 3DS langkah-up, dan konfirmasi Anda AuthenticationResult menangani covers denied/rejected/abandoned, tidak hanya authenticated.
• Reconcile feed/checkout price parity. jika agent sees satu price di feed dan checkout mengembalikan lainnya, trust erodes fast — ACP sibling membuat ini poin tentang feeds; ini bites hardest di checkout.
• Stand up agent-order attribution. sebuah selesai agentic checkout dapat land dengan Tidak GA4 session. Track ini di order/OMS tingkat, tidak oleh menunggu untuk sebuah situs web visit.

Testing SOP dan Cheat Sheet tabs turn ini ke sebuah concrete lulus.

Di mana ini stands di pertengahan 2026

Ground yourself di adoption reality, tidak pitch deck. Shopify’s president Harley Finkelstein indicated hanya tentang sebuah dozen Shopify merchants adalah actively menggunakan AI checkout alat — negligible terhadap Shopify’s overall merchant base — dan OpenAI itself scaled fully-di-chat versi dari Instant Checkout back untuk penemuan-plus-redirect di March 2026 setelah berjalan ke onboarding, accuracy, dan multi-item-cart difficulties. Semrush’s Leigh McKenzie put friction well: nyata-time catalog normalization di seluruh tens dari millions dari SKUs adalah sebuah decade-scale masalah, dan consumers masih default untuk checkout alur mereka trust — Apple Pay, Google Wallet, Amazon satu-click.

None dari itu berarti agentic checkout adalah vaporware. protocol kemampuan — buat/perbarui/menyelesaikan sebuah session programmatically, dengan delegated payment dan signed order webhooks — adalah nyata, specified, dan worth membangun terhadap. ini hanya tidak “already normal,” (terjemahan) “sudah wajar,” dan apakah akhir langkah closes di-chat atau pada Anda situs adalah sebuah implementation detail itu memiliki sudah changed setelah dan dapat perubahan again.

AI summary

sebuah condensed take pada Advanced versi:

• Agentic checkout = transaction-completion langkah dari perdagangan agen: sebuah agent membuat, memperbarui, menyelesaikan, atau cancels sebuah sesi checkout pada sebuah shopper’s behalf. ini adalah satu membangun block dari ACP dan satu dari UCP — tidak sebuah standalone protocol.
• ini adalah sebuah mesin status. ACP: not_ready_for_payment → ready_for_payment → (requires_escalation/authentication_required) → completed, dengan canceled, expired, pending_approval off happy path. Mirrors UCP’s incomplete → requires_escalation → ready_for_complete.
• ** escalation status adalah human-di—loop seam** — login, 3DS langkah-up, address periksa, B2B approval_required, UCP continue_url. Fully autonomous zero-human checkout adalah tidak bagaimana specs adalah dibangun.
• Payment = scoped tokens: dikunci ke merchant (merchant_id + checkout_session_id), dibatasi jumlah (max_amount), dibatasi waktu (expires_at), single-gunakan (reason: one_time). agent tidak pernah holds sebuah mentah card. Direct CHD menangani memengaruhi PCI cakupan (tingkat 1); sebagian besar merchants gunakan PSP/tokenized path.
• Konfirmasi pesanan adalah sebuah push: merchants POST HMAC-signed (Merchant-Signature), penuh-object webhooks (order_create/order_update), tangani 200/401/429.
• Liability: merchant tetap merchant-dari-record (settlement/refunds/chargebacks dengan merchant + PSP, per OpenAI’s spec) — tetapi chargeback evidentiary pertanyaan (disputing sebuah purchase sebuah AI agent dibuat) adalah unresolved sebagai dari pertengahan 2026. Visa TAP / Mastercard Agent Pay adalah emerging kerangka kerja, tidak finished ones.
• Test: idempotency-safe retries (request_not_idempotent), webhook signature verification, simulated escalation/3DS paths, feed/checkout price parity, agent-order attribution (Tidak GA4 session).
• Adoption adalah early: ~sebuah dozen langsung Shopify merchants sebelum OpenAI’s March 2026 pivot untuk penemuan-plus-redirect.

Dokumentasi resmi

Utama-sumber documentation untuk checkout mechanics.

ACP — checkout, lifecycle, webhooks

• ACP Checkout API reference — checkout-session endpoints, penuh status enum, CheckoutSession fields, error/MessageError objects, RiskSignals, AuthenticationResult, dan InterventionCapabilities.
• ACP Checkout lifecycle / concepts — state transitions (fulfillment-option → ready_for_payment; failed payment retry).
• ACP Order webhooks — order_create/order_update, Merchant-Signature HMAC requirement, penuh-object payloads, kode respons.
• ACP spec pada GitHub — OpenAPI/JSON Schema dan date-based versi.

OpenAI / Stripe — delegasi pembayaran

• OpenAI Delegated Payment spec — scoped token flow, allowance object (max_amount, expires_at, merchant_id, checkout_session_id, reason), PCI-cakupan note, merchant-dari-record language.
• OpenAI Commerce docs — merchant integration overview.
• Stripe — Perdagangan agen (ACP) — Shared Token pembayaran, pertama Delegated-Payment-compatible implementation.
• Stripe — ACP protocol specification — membangun checkout endpoints.

UCP (parallel checkout machine)

• Google untuk Developers — UCP guide — merchant-dari-record dan eligibility framing pada Google/Shopify side.

Platform / payment-network

• Shopify — Agentic Storefronts requirements — Supplemental istilah dan (sebagai dari research) Google AI Mode/Gemini early-access status.
• Visa — Perdagangan agen: Threats dan Risks — Trusted Agent Protocol framing.

Kutipan dari sumber

Pernyataan langsung tentang cara kerja agentic checkout dan pertanyaan yang masih terbuka. Tautan mendalam mengarah ke bagian yang mendukung kutipan pada halaman sumber.

ACP / OpenAI — spesifikasi

• “Merchant maintains full control over inventory, pricing, tax calculations, and payment processing.” (terjemahan) “Merchant mempertahankan kendali penuh atas inventaris, harga, perhitungan pajak, dan pemrosesan pembayaran.” — ACP Checkout API reference. Lompat ke kutipan
• Enum status checkout, secara verbatim: “incomplete not_ready_for_payment requires_escalation authentication_required ready_for_payment pending_approval complete_in_progress completed canceled in_progress expired.” (terjemahan) “Status-status ini menunjukkan keadaan checkout, termasuk belum siap membayar, perlu eskalasi, autentikasi diperlukan, siap membayar, selesai, dibatalkan, dan kedaluwarsa.” — ACP Checkout API reference. Lompat ke kutipan
• “OpenAI is not the merchant of record.” (terjemahan) “OpenAI bukan merchant of record.” Dalam ACP, merchant membawa PSP sendiri; settlement, refund, chargeback, dan kepatuhan tetap berada pada merchant dan PSP-nya. — OpenAI Delegated Payment spec. Lompat ke kutipan
• Dalam alur token, PSP atau vault mengembalikan “payment token scoped to the delegated payment” (terjemahan) “token pembayaran yang dibatasi untuk pembayaran yang didelegasikan”, di luar cakupan PCI. — OpenAI Delegated Payment spec. Lompat ke kutipan

Suara industri — pertanyaan tanggung jawab

• “Agentic commerce brings efficiency, but also a new layer of fraud and confusion that legacy systems cannot interpret.” (terjemahan) “Perdagangan agen membawa efisiensi, tetapi juga lapisan baru penipuan dan kebingungan yang tidak dapat ditafsirkan oleh sistem lama.” — Ben Herut, ahli strategi fraud dan chargeback, Chargeflow. Baca liputannya
• Apakah aturannya sudah mapan? Menurut analisis Chargeflow, “there are no clean answers yet” (terjemahan) “belum ada jawaban yang jelas”; jaringan kartu, penerbit kartu, dan penyedia platform masih mengurai pertanyaan ini. Baca liputannya
• “Both protocols keep the merchant as the merchant of record — responsible for fulfillment, chargebacks, and disputes.” (terjemahan) “Kedua protokol mempertahankan merchant sebagai merchant of record—bertanggung jawab atas pemenuhan pesanan, chargeback, dan sengketa.” — Arjun Bhargava, Co-founder & CEO, Rye. Baca liputannya

Jaringan pembayaran — kerangka kerja yang berkembang

• Dalam pendekatan Visa, Trusted Agent Protocol adalah “a standards-based framework enabling merchants to verify agent identity and intent in real time, preventing impersonation without degrading user experience.” (terjemahan) “kerangka kerja berbasis standar yang memungkinkan merchant memverifikasi identitas dan maksud agen secara real time, mencegah penyamaran tanpa menurunkan pengalaman pengguna.” — Visa, Perdagangan Agen: Ancaman dan Risiko. Lompat ke kutipan

Realitas adopsi

• Mengapa checkout yang sepenuhnya otonom lebih lambat daripada hype? “Real-time catalog normalization across tens of millions of SKUs is a decade-scale problem Google already solved with Merchant Center, and consumers still default to checkout flows they trust—Apple Pay, Google Wallet, and Amazon one-click.” (terjemahan) “Normalisasi katalog real time di seluruh puluhan juta SKU adalah masalah berskala satu dekade yang sudah diselesaikan Google melalui Merchant Center, dan konsumen tetap memilih alur checkout yang mereka percaya—Apple Pay, Google Wallet, dan sekali klik Amazon.” — Leigh McKenzie, Director of Online Visibility, Semrush, melalui Search Engine Land. Baca liputannya

Yang payment-integration path seharusnya Anda take?

pertama nyata architecture decision di agentic checkout adalah bagaimana payment mendapatkan delegated — karena ini secara langsung determines Anda PCI cakupan dan bagaimana banyak Anda memiliki untuk bangun. Walk ini:

Pre-launch sesi pengujian untuk agentic checkout

Jalankan ini di sandbox/test mode sebelum enabling agentic checkout di production. ini adalah operational layer strategic “bersih Anda feed” (terjemahan) “bersih Anda feed” advice skips.

1. buat sesi checkout dan walk happy path. POST /checkout_sessions, konfirmasi Anda mendapatkan sebuah 201 dan sebuah session di not_ready_for_payment (atau incomplete). tambahkan sebuah fulfillment option; konfirmasi status transitions untuk ready_for_payment.
2. Verify totals adalah authoritative. Konfirmasi session’s totals[] (subtotal / tax / fulfillment / discounts / total) match apa Anda backend computes — dan itu price equals apa di Anda feed. sebuah feed/checkout price mismatch adalah sebuah trust killer.
3. Menyelesaikan session. POST /checkout_sessions/{id}/complete; konfirmasi payment memproses dan sebuah order adalah dibuat, dan status lands pada completed.
4. Cancel sebuah session. POST /checkout_sessions/{id}/cancel; konfirmasi inventory adalah dirilis so Anda tidak leak held stock.
5. Force escalation paths. Simulate requires_escalation / authentication_required. Jalankan sebuah 3DS langkah-up dan konfirmasi Anda AuthenticationResult menangani covers failure outcomes (denied, rejected, abandoned, canceled, not_supported) — tidak hanya authenticated.
6. Test idempotency. kirim yang sama buat/menyelesaikan permintaan twice dengan yang sama idempotency key; konfirmasi Anda mendapatkan satu order, tidak dua, dan itu sebuah genuinely non-idempotent retry surfaces request_not_idempotent alih-alih double-charging.
7. Test business-logic errors vs. HTTP errors. Trigger sebuah di-session masalah (e.g. sebuah out-dari-stock line item) dan konfirmasi ini muncul back sebagai sebuah MessageError di messages[], dan itu sebuah malformed permintaan muncul back sebagai sebuah HTTP-tingkat error object — Anda client harus tangani keduanya.
8. Verify webhook signatures. kirim valid order_create webhook dan konfirmasi Anda validate Merchant-Signature HMAC dan kembalikan 200. kirim tampered satu dan konfirmasi Anda reject dengan 401. Konfirmasi Anda emit penuh Order object, tidak sebuah delta.
9. Test webhook back-pressure. Konfirmasi Anda sender menangani sebuah 429 dari platform dengan sebuah retry/backoff alih-alih dropping event.
10. Konfirmasi attribution capture. Verify selesai order adalah tagged sebagai agent-originated di OMS tingkat, since Tidak GA4 session akan exist untuk ini.

umum mistakes (dan apa untuk melakukan alih-alih)

Assuming “agentic checkout” (terjemahan) “agentic checkout” berarti fully autonomous, zero-human purchasing. Mengapa ini adalah wrong: setiap credible implementation mempertahankan sebuah authorization/escalation seam — requires_escalation, authentication_required, 3DS langkah-up, B2B approval_required. Penuh autonomy tanpa sebuah human-di—loop authorization adalah neither bagaimana specs adalah dibangun nor bagaimana card networks saat ini treat ini transactions. melakukan alih-alih: design escalation paths (continue_url, 3DS, approval) sebagai pertama-class alur so sebuah transaction itu perlu sebuah human escalates cleanly alih-alih dead-ending.

Treating ini sebagai sudah-wajar karena headlines adalah loud. Mengapa ini adalah wrong: hanya tentang sebuah dozen Shopify merchants memiliki hilang langsung dengan ChatGPT checkout sebelum OpenAI scaled di-chat versi back di March 2026. melakukan alih-alih: bangun terhadap protocol kemampuan (ini adalah nyata dan specified), tetapi plan dan staf sebagai jika Anda’re sebuah early adopter, tidak sebuah laggard catching up.

Believing fraud liability adalah fully solved karena “merchant-of-record” (terjemahan) “merchant-dari-record” adalah settled. Mengapa ini adalah wrong: merchant-dari-record adalah confirmed untuk settlement/refunds/compliance, tetapi chargeback evidentiary kerangka kerja — proving sebuah disputed transaction adalah properly authorized ketika buyer adalah sebuah AI agent — adalah explicitly described oleh industry fraud specialists sebagai unresolved. melakukan alih-alih: capture agent authorization logs dan risk sinyal now, treat Visa TAP/Mastercard Agent Pay sebagai emerging (tidak finished) kerangka kerja, dan jangan assume Anda existing chargeback-defense evidence transfers.

Assuming agent skips Anda situs web, so pada-situs checkout tidak penting. Mengapa ini adalah wrong: “always skips the merchant’s site” (terjemahan) “selalu skips merchant’s situs” adalah original ChatGPT Instant Checkout pitch, tetapi ACP’s flagship implementation itself moved untuk penemuan-plus-redirect di March 2026. protocol kemampuan adalah implementation-agnostic. melakukan alih-alih: pertahankan own hosted checkout solid dan mendukung programmatic session flow — Anda dapat menjadi closing either di-chat atau pada-situs depending pada surface.

Thinking agent menangani customer’s card angka. Mengapa ini adalah wrong: mentah card data tidak pernah reaches agent oleh design — scoped/delegated tokens (Shared Token pembayaran, UCP’s decoupled instrument/handler model) adalah seluruh poin dari payment-delegation layer. melakukan alih-alih: route delegation melalui Anda PSP so sebuah dikunci ke merchant, dibatasi jumlah, single-gunakan token melakukan berfungsi — dan pertahankan PCI cakupan kecil.

Non-idempotent retry menangani. Mengapa ini adalah wrong: agents dan networks retry. ACP memiliki sebuah request_not_idempotent error jenis precisely karena naive retries double-charge atau double-buat orders. melakukan alih-alih: memerlukan idempotency keys pada buat/menyelesaikan dan membuat repeated sama-key panggilan safe.

Agentic checkout — cheat sheet

ACP sesi checkout status enum

UCP’s parallel machine: incomplete → requires_escalation (human melalui continue_url) → ready_for_complete.

Checkout endpoints (ACP)

• POST /checkout_sessions — buat (201)
• GET /checkout_sessions/{id} — retrieve
• POST /checkout_sessions/{id} — perbarui
• POST /checkout_sessions/{id}/complete — proses payment + buat order
• POST /checkout_sessions/{id}/cancel — cancel + rilis inventory

Token pembayaran terbatas — four bounds

• merchant_id + checkout_session_id → merchant- dan session-locked
• max_amount → dibatasi jumlah
• expires_at (RFC 3339) → dibatasi waktu
• reason: "one_time" → single-gunakan

Order webhooks (ACP)

• Events: order_create, order_update
• Signed: Merchant-Signature HMAC header (diperlukan)
• Payload: penuh Order object, tidak deltas
• respons: 200 ok · 401 buruk signature · 429 rate-limited
• Order statuses: created · manual_review · confirmed · canceled · shipped · fulfilled

Human-intervention triggers

• requires_escalation / authentication_required status
• InterventionCapabilities (3ds, address_verification; enforcement always/conditional/optional)
• AuthenticationResult outcomes (authenticated/denied/rejected/abandoned/…)
• B2B approval_required; UCP continue_url

Liability di sebuah glance

• Merchant = merchant-dari-record → settlement/refunds/chargebacks dengan merchant + PSP ✅ settled
• Chargeback evidence aturan untuk agent buyers ⚠️ unresolved (pertengahan 2026)
• Visa TAP / Mastercard Agent Pay → emerging kerangka kerja, tidak finished

Snippets untuk berfungsi dengan agentic checkout

ini adalah untuk inspecting dan testing Anda own integration — tidak untuk driving langsung purchases. gunakan sandbox/test credentials.

Verify sebuah webhook signature (Node.js, HMAC)

Reject apa pun milik siapa Merchant-Signature tidak match. Bandingkan di constant time.

import crypto from "node:crypto";

// secret = your shared webhook signing secret; rawBody = the exact bytes received
function verifyMerchantSignature(rawBody, signatureHeader, secret) {
  const expected = crypto
    .createHmac("sha256", secret)
    .update(rawBody)          // sign the raw body, not the parsed JSON
    .digest("hex");
  const a = Buffer.from(expected);
  const b = Buffer.from(signatureHeader || "");
  return a.length === b.length && crypto.timingSafeEqual(a, b);
}
// In your handler: if (!verify) return res.status(401).end();  // else 200

Poll sebuah sesi checkout’s status (shell)

Watch sebuah sandbox session walk mesin status sementara Anda test.

# Retrieve a session and print just its status field (needs jq)
SESSION_ID="cs_test_123"
curl -s "https://api.example.com/checkout_sessions/$SESSION_ID" \
  -H "Authorization: Bearer $ACP_TEST_KEY" \
  | jq -r '.status'          # e.g. not_ready_for_payment → ready_for_payment → completed

kirim buat panggil dengan sebuah idempotency key (Python)

Prove itu sebuah retry dengan yang sama key yields satu order, tidak dua.

import uuid, requests

key = str(uuid.uuid4())  # reuse this SAME key on retry
headers = {
    "Authorization": f"Bearer {ACP_TEST_KEY}",
    "Idempotency-Key": key,
    "Content-Type": "application/json",
}
payload = {"line_items": [{"id": "sku_1", "quantity": 1}]}
r1 = requests.post(f"{BASE}/checkout_sessions", json=payload, headers=headers)
r2 = requests.post(f"{BASE}/checkout_sessions", json=payload, headers=headers)  # retry
print(r1.json().get("id") == r2.json().get("id"))  # expect True — same session, no dupe

Console snippet — scan sebuah dirender halaman untuk sebuah .well-known UCP profile

Quick DevTools Console periksa dari apakah sebuah merchant exposes UCP penemuan (paste di browser console pada merchant’s origin):

fetch("/.well-known/ucp")
  .then(r => (console.log("status:", r.status), r.ok ? r.json() : null))
  .then(p => console.log("capabilities:", p && p.capabilities));

Bookmarklet — jump untuk checkout status enum di ACP docs

Drop ini di sebuah bookmark untuk open ACP Checkout reference di status list:

javascript:location.href='https://www.agenticcommerce.dev/docs/reference/checkout#:~:text=incomplete';

umum agentic checkout failures

sebuah retry membuat dua orders atau charges

Symptom: yang sama sesi checkout produces duplicate orders setelah sebuah timeout atau network retry. mungkin penyebab: buat atau menyelesaikan panggilan adalah tidak keyed dan replay-safe. Perbaiki: memerlukan sebuah idempotency key, mengembalikan original hasil untuk sebuah sama-key retry, dan konfirmasi dua identical sandbox panggilan produce satu session dan satu order.

Checkout tidak pernah becomes ready untuk payment

Symptom: sebuah session tetap not_ready_for_payment atau incomplete. mungkin penyebab: sebuah diperlukan fulfillment pilihan, address field, atau business aturan adalah unresolved. Perbaiki: inspect session’s diperlukan fields dan messages[], supply missing pilihan, dan konfirmasi state advances untuk ready_for_payment atau ready_for_complete.

sebuah valid permintaan muncul untuk succeed tetapi cart cannot menyelesaikan

Symptom: HTTP permintaan succeeds sementara session berisi sebuah out-dari-stock atau lainnya business error. mungkin penyebab: client hanya menangani HTTP errors dan ignores MessageError entries. Perbaiki: proses keduanya transport errors dan session messages, lalu konfirmasi pengguna atau agent sees actionable failure.

Human verification silently dead-ends

Symptom: checkout enters requires_escalation atau authentication_required dan tidak pernah mengembalikan. mungkin penyebab: 3DS, login, approval, atau continue_url handoff adalah treated sebagai sebuah exceptional error alih-alih sebuah didukung state. Perbaiki: persist session melalui handoff, tangani setiap authentication outcome, dan konfirmasi keduanya successful dan abandoned alur resolve cleanly.

Order status berhenti updating setelah payment

Symptom: merchant memiliki order tetapi agent surface tetap pending atau stale. mungkin penyebab: sebuah webhook signature fails, hanya sebuah delta adalah dikirim, atau 429 respons adalah dropped. Perbaiki: sign tepat payload, kirim penuh Order object, retry rate-limited events dengan backoff, dan konfirmasi receiver accepts event.

Mental models untuk agentic checkout

Checkout adalah sebuah mesin status, tidak sebuah single API panggil

setiap respons seharusnya move session untuk sebuah known state atau expose sebuah known alasan ini cannot move. Design clients sekitar transitions, terminal status, retries, dan escalations alih-alih hanya mengandalkan satu “buy” (terjemahan) “beli”.

Authority tetap dengan merchant

agent expresses intent, tetapi merchant tetap authoritative untuk price, inventory, tax, fulfillment, status pesanan, dan merchant-dari-record obligations. Treat agent’s requested cart sebagai input dan merchant-dikembalikan cart sebagai truth.

Delegation narrows permission

sebuah token pembayaran terbatas adalah safe karena ini adalah dikunci ke merchant, session-bound, dibatasi jumlah, dibatasi waktu, dan single-gunakan. Evaluate setiap delegated kemampuan oleh asking apa ini dapat melakukan, untuk whom, untuk bagaimana banyak, dan untuk bagaimana panjang.

Escalation adalah sebuah successful branch

Human intervention adalah tidak sebuah failed autonomous checkout. sebuah bersih 3DS, login, address, atau B2B approval handoff adalah protocol berfungsi sebagai designed.

Pengiriman adalah asynchronous setelah completion

Payment completion melakukan tidak end integration. Signed, penuh-object webhooks carry order truth setelah checkout, so signature verification, replay safety, dan retry menangani adalah bagian dari checkout reliability.

Metrics untuk agentic checkout

Checkout completion oleh terminal state

• Metric: sessions selesai, canceled, atau expired sebagai sebuah share dari initiated sessions.
• Apa ini tells Anda: di mana status checkout machine ends dan bagaimana banyak intent adalah lost sebelum sebuah order ada.
• cara pull ini: aggregate checkout-session state perubahan dari commerce API atau order platform, segmented oleh protocol dan merchant surface.
• Benchmark / realistic range: establish sebuah baseline untuk Anda own product mix dan bandingkan like-untuk-like alur; Tidak universal rate adalah defensible di ini adoption stage.
• Cadence: daily monitoring dengan weekly trend review.

Escalation recovery rate

• Metric: escalated sessions itu kembalikan dan menyelesaikan setelah 3DS, login, address, atau approval intervention.
• Apa ini tells Anda: apakah human handoff adalah sebuah usable path atau sebuah dead end.
• cara pull ini: join escalation events untuk kemudian state transitions menggunakan sesi checkout ID.
• Benchmark / realistic range: baseline setiap intervention jenis secara terpisah karena authentication dan B2B approval memiliki berbeda friction.
• Cadence: weekly dan setelah apa pun handoff-flow perubahan.

Duplicate-order dan webhook failure rate

• Metric: duplicate orders dari sama-key retries plus rejected atau exhausted webhook deliveries.
• Apa ini tells Anda: apakah idempotency dan asynchronous order synchronization adalah safe di bawah failure.
• cara pull ini: bandingkan idempotency keys, order IDs, signature failures, 401s, 429s, retries, dan dead-letter events di application logs.
• Benchmark / realistic range: duplicate orders seharusnya menjadi zero; establish sebuah wajar transient-retry baseline dan investigate sustained deviation.
• Cadence: alert immediately, summarize weekly.

Resources worth Anda time

My related writing

• dua protocols agentic checkout sits di dalam adalah covered secara mendalam pada ini situs — see Agentic Commerce Protocol (ACP) dan Universal Commerce Protocol (UCP) tulis-ups; ini halaman adalah checkout-mechanics deep dive itu sits di bawah keduanya.
• Beginner’s Guide untuk Ecommerce SEO — di mana agent-facing checkout fits ke bigger ecommerce picture.

My speaking

• Bagaimana Penelusuran berfungsi (SlideShare) — my walkthrough dari penemuan, pengindeksan, dan peringkat; berguna background untuk bagaimana sebuah agent-mediated transaction layer sits pada top dari ini. (My standing disclaimer applies: “Ini adalah my understanding dari sistem… tidak going untuk menjadi 100% menyelesaikan atau accurate.” (terjemahan) “ini adalah my understanding dari sistem… tidak going untuk menjadi 100% menyelesaikan atau accurate.”)

dari sekitar industry

• Agentic Commerce Protocol — Checkout reference (OpenAI/Stripe) — authoritative status enum, session fields, dan intervention/authentication objects.
• OpenAI Delegated Payment spec — scoped-token flow dan merchant-dari-record / PCI-cakupan language.
• ACP Order webhooks reference (OpenAI/Stripe) — push-based, HMAC-signed, penuh-object order-sync mechanics.
• Perdagangan agen Chargebacks: Siapa’s Liable Ketika AI Buys? (Chargeflow) — honest “Tidak bersih answers namun” (terjemahan) “Tidak bersih jawaban namun” take pada evidentiary masalah.
• Perdagangan agen: Threats dan Risks (Visa) — Trusted Agent Protocol dan agent-identity framing.
• OpenAI’s big ChatGPT Instant Checkout plan hanya changed (mesin pencari Land) — March 2026 pivot dan adoption-reality quotes.
• Apa adalah Agentic Checkout? (Rye) — sebuah jelas independent definition dan merchant-dari-record corroboration.
• Deep Dive: Mastercard Verifiable Intent vs Visa Trusted Agent Protocol (Fintech Wrap Up / Finextra) — payment-network kerangka kerja compared (treat spesifik liability allocation sebagai reported, tidak confirmed).

Stats worth citing

angka itu frame di mana agentic checkout sebenarnya adalah — treat merchant-reported dan relayed figures sebagai directional, dan verify sebelum leaning pada them.

• tentang sebuah dozen Shopify merchants adalah actively menggunakan AI checkout alat — described sebagai negligible terhadap Shopify’s overall merchant base — per Shopify’s president, relayed melalui mesin pencari Land’s coverage dari March 2026 pivot. Coverage
• March 2026: pivot. OpenAI moved ChatGPT’s Instant Checkout dari penuh di-chat purchase completion untuk penemuan-plus-redirect, setelah onboarding, accuracy, dan multi-item-cart friction. Coverage
• Token cakupan = 4 bounds. sebuah delegated token pembayaran adalah capped pada max_amount, expires_at, merchant_id/checkout_session_id, dan reason: one_time — concrete mechanism itu mempertahankan sebuah mentah card away dari agent. Sumber
• Webhook aturan: objek lengkap, selalu. ACP memerlukan webhook data field untuk carry penuh Order object alih-alih incremental deltas, dan setiap permintaan untuk menjadi HMAC-signed. Sumber

Uji pemahaman Anda: Agentic Checkout

Five quick pertanyaan pada checkout mechanics. Pick sebuah jawaban untuk setiap, lalu periksa.

Log perubahan