headless-checkout-proxy

Proxy VTEX Checkout API calls through a BFF with server-side validation.

39|9|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/vtex/ai-skills --skill headless-checkout-proxy-vtex
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: headless-checkout-proxy
Source: https://github.com/vtex/ai-skills/tree/main/tracks/headless/skills/headless-checkout-proxy
Command: npx skills add https://github.com/vtex/ai-skills --skill headless-checkout-proxy-vtex

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Proxy VTEX Checkout API calls through a BFF to secure session cookies, minimize exposure of sensitive data, and enforce server-side validation in headless storefronts.

Core Features & Use Cases

  • Proxy Checkout API calls through a server-side BFF to manage orderFormId, cookies, and sensitive data.
  • Validate inputs server-side before forwarding to VTEX and coordinate a 3-step order flow (place → pay → process) within a 5-minute window.
  • Centralize cart, checkout, and payment flows for headless storefronts using a secure, auditable backend.

Quick Start

Install and enable this skill in your headless VTEX project to start proxying checkout through the BFF and manage carts securely.

Frequently Asked Questions about headless-checkout-proxy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I secure VTEX checkout sessions in a headless storefront?

To secure VTEX checkout sessions in a headless storefront, proxy Checkout API calls through a Backend-for-Frontend (BFF). This manages orderFormId and session cookies server-side, preventing direct client access to sensitive endpoints and minimizing data exposure.

What is the best way to manage VTEX orderFormId and cookies during headless checkout?

The best way to manage VTEX orderFormId and cookies during headless checkout is routing requests through a server-side BFF proxy. This centralizes cart creation and item management, ensuring sensitive data and session cookies are handled securely on the backend.

How does the place-pay-process order flow work in a VTEX headless checkout?

The place-pay-process order flow in a VTEX headless checkout coordinates a 3-step sequence within a 5-minute window. The BFF proxy validates inputs server-side and manages the progression from order placement through payment to final processing.

Can I use a BFF proxy for VTEX cart creation and item management?

Yes, you can use a BFF proxy for VTEX cart creation and item management. It centralizes cart and checkout flows for headless storefronts, applying server-side validation before forwarding requests to VTEX and ensuring auditable backend operations.

Why should I prevent direct client access to VTEX checkout endpoints?

You should prevent direct client access to VTEX checkout endpoints to secure session cookies and minimize the exposure of sensitive data. Proxying through a BFF enforces server-side validation, ensuring inputs are checked and auditable before reaching the VTEX API.

Are there limitations when proxying VTEX checkout calls through a BFF?

A key limitation when proxying VTEX checkout calls through a BFF is the strict 5-minute window required for the place-pay-process flow. Additionally, the BFF must handle server-side validation and proper cookie management to maintain session integrity.