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.