Het Agentic Commerce Protocol (ACP) is een open standaard om producten, actuele winkelgegevens en aankoopprocessen met AI-winkelervaringen te verbinden. Voor een webshop zijn vooral twee onderdelen relevant: productfeeds voor vindbaarheid en checkout-sessies voor aankoopafhandeling. Publieke documentatie betekent niet dat iedere merchant automatisch toegang heeft tot ChatGPT Instant Checkout.
Wat is het verschil tussen ACP, MCP en een ChatGPT-app?
- ACP: afspraken over productcatalogi en commerce- of checkoutstromen.
- MCP (Model Context Protocol): algemene koppeling voor tools en gegevens.
- ChatGPT-app: een gebruikerservaring die eigen functies en eventueel een aangepaste interface kan tonen.
Deze onderdelen kunnen elkaar aanvullen, maar zijn niet uitwisselbaar. Een app met een Koop-knop geeft nog geen toestemming voor een native ChatGPT-betaalvenster.
Productcatalogus: begin met de bron van waarheid
OpenAI publiceert een specificatie voor productfeeds, met velden voor onder andere productidentiteit, actuele prijs en beschikbaarheid. Leg per variant vast waar de brongegevens vandaan komen. Synchroniseer wijzigingen gecontroleerd en controleer dat je productpagina en export dezelfde prijs en informatie tonen.
Productfeed-onboarding is volgens OpenAI op dit moment beschikbaar voor goedgekeurde partners. Onderzoek dus eerst toegang voordat je veel ontwikkeltijd reserveert voor een directe feed.
Checkout-sessies: de technische hoofdstappen
De Agentic Checkout-specificatie beschrijft HTTPS-JSON-endpoints voor onder andere:
- Aanmaken:
POST /checkout_sessionsgeeft de actuele winkelwagen terug. - Bijwerken:
POST /checkout_sessions/{checkout_session_id}verwerkt wijzigingen. - Voltooien:
POST /checkout_sessions/{checkout_session_id}/completebevestigt de aankoop en orderstatus. - Opvragen/annuleren: endpoints ondersteunen het uitlezen of annuleren van sessies.
- Events: webhooks synchroniseren de relevante orderstatussen.
Bij iedere stap blijft je eigen systeem bepalend voor productbeschikbaarheid, belasting, bezorgopties en ordervalidatie. Gebruik de officiële specificatie als contract; vertrouw niet op een versimpeld voorbeeld voor productiecode.
Checklist voor een veilige implementatie
| Controle | Waarom? |
|---|---|
| Authenticatie en verzoekhandtekeningen | Voorkomt ongeautoriseerde acties |
| Idempotency keys | Vermindert risico op dubbele orders |
| Server-side herberekening | Voorkomt vertrouwen op verouderde klantprijzen |
| Voorraadreservering | Vermindert overselling |
| Betalings- en webhookstatus | Houdt de echte orderstatus betrouwbaar |
| Logging zonder gevoelige betaalgegevens | Ondersteunt audit en foutanalyse |
| Herstel- en annuleringspad | Maakt storingen beheersbaar |
Bewaar geen ruwe betaalgegevens in logs. Controleer toestemming, bewaartermijnen en rechten voordat je klantdata doorstuurt. Test herhaalde verzoeken, time-outs, prijswijzigingen en mislukte betalingen.
Voorbeeldarchitectuur voor een Nederlandse webshop
Stel dat een winkel Nuxt als storefront gebruikt, een Node-backend en een bestaande betaalprovider. De webshop kan productcatalogus, voorraad en checkout onderbrengen in afzonderlijke diensten. De ACP-adapter vertaalt de officiële verzoeken naar bestaande bedrijfsfuncties, in plaats van een tweede orderlogica naast de winkel te bouwen.
Dit is een ontwerpaanpak, geen claim dat een Nuxt-module of Stripe-plugin toegang tot OpenAI's partnerprogramma verleent.
Wat levert een ACP-integratie op?
Een toegelaten integratie kan aankoopfrictie verlagen doordat de gebruiker binnen ChatGPT blijft. Maar houd ook rekening met onderhoud, nauwkeurigheid van de feed, fraudebeheersing, klantenservice en afhankelijkheid van platformvoorwaarden. Bereken de businesscase op werkelijke orders, marges en operationele kosten, niet op een aangenomen conversiestijging.
Dit doe je vandaag
Documenteer je huidige catalogus, voorraadcontroles, betaalprovider en orderstatussen. Lees de officiële ACP-specificatie. Begin voor niet-toegelaten webshops met producten verkopen via ChatGPT en webshopvindbaarheid.
Veelgestelde vragen
Is ACP hetzelfde als MCP?
Nee. ACP definieert commercegegevens en checkoutstromen, terwijl MCP een algemene standaard voor tools en context is. Een MCP-server alleen maakt nog geen Instant Checkout beschikbaar.
Mag ik de checkout-API nu al bouwen?
Je kunt de publiek gedocumenteerde contracten bestuderen en intern voorbereiden. Productiegebruik van Instant Checkout en directe feed-onboarding is afhankelijk van toelating.
Wie int de betaling bij ACP?
De merchant verwerkt volgens de documentatie betalingen via de eigen payment service provider en blijft verantwoordelijk voor orderverwerking en correcties.
Bronnen en verder lezen
Voorbeelden zijn bedoeld om je eigen proef te ontwerpen. Ze zijn geen gemeten klantresultaten. Zo maken we deze kennisbank.