Skip to main content
skill CX Codex

payment-ppp-pos — Claude Code skill: what it does, how to install

payment-ppp-pos guides creation and debugging of VTEX Payment Provider Protocol connectors for physical POS terminals in VTEX Sales App.

no license 252 installs ★ 47 updated 2026-10-14

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add vtex/skills --skill payment-ppp-pos -a claude-code
Open on GitHub

What payment-ppp-pos does

This skill guides the implementation of POS integrations under the VTEX Payment Provider Protocol. It covers manifest methods like Venda Direta Credito and Venda Direta Debito, asynchronous authorization flows, and the two-phase Payment App challenge.

State transitions drive the authorize() logic. The gateway never receives customer card information for in-store transactions, so card structures stay null and Secure Proxy remains untouched. The flow yields an undefined status while awaiting confirmation from vtex.terminal-connector-app and vtex.challenge-wait-for-confirmation.

Runtime targets change callback behavior: standalone endpoints expect final details posted to callbackUrl, while VTEX IO deployments trigger retries using empty payloads.

What it helps with

  • build a POS connector for VTEX Sales App via Payment Provider Protocol
  • support Venda Direta Credito and Venda Direta Debito methods
  • wire the two-phase challenge using official terminal apps
  • format completion payloads containing cardBrand, firstDigits, and lastDigits

Example prompts for the agent

  • Generate the authorize state machine for a VTEX Sales App POS connector
  • Configure vtex.terminal-connector-app and vtex.challenge-wait-for-confirmation in our PPF app
  • Review our callbackUrl notification handling for standalone PPP POS

How to install payment-ppp-pos

1Skills CLI (Vercel)

npx skills add vtex/skills --skill payment-ppp-pos -a claude-code

2Manually: put the files in place

~/.claude/skills/payment-ppp-pos/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/payment-ppp-pos/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about payment-ppp-pos

How to install payment-ppp-pos in Claude Code?

Run npx skills add vtex/skills --skill payment-ppp-pos -a claude-code. The file will be placed at ~/.claude/skills/payment-ppp-pos/SKILL.md.

What does payment-ppp-pos do?

It provides architectural rules and code patterns for building VTEX PPP connectors tailored to card-present POS operations.

Why are card details null during Create Payment?

POS transactions handle the physical card outside the gateway, leaving card inputs null and avoiding Secure Proxy calls entirely.

Similar skills

All skills for Backend and APIs →

From the same set46

The whole set →
headless-caching-strategy headless-caching-strategy sets caching rules and TTL values for headless VTEX storefronts. Keeps public endpoints fast while preventing accidental caching of sensitive shopper data. CX Codex +1 1,100installs headless-intelligent-search headless-intelligent-search is a Claude Code skill for adding VTEX Intelligent Search to a headless storefront, including facets, autocomplete and analytics. CX Codex +1 1,100installs payment-idempotency payment-idempotency — a skill for Claude Code and five other platforms that sets idempotency rules in payment connector code. It kicks in when the VTEX gateway retries requests, keeping duplicate charges out of the picture. CX Codex +1 1,100installs sales-app-extensibility sales-app-extensibility guides the creation, styling, and deployment of VTEX Sales App extensions. Works through a seven-stage sequence from project checks to final delivery. CX Codex +1 927installs vtex-io-storefront-theme-versioning vtex-io-storefront-theme-versioning guides coding agents through publishing, updating, or rolling back VTEX IO storefront themes without losing merchant Site Editor data across major versions. CX Codex +1 861installs vtex-io-rootpath vtex-io-rootpath — a skill for VTEX IO apps in multi-binding stores: shows how to build URLs with the binding's path prefix. Useful when links 404 or point to the wrong locale. CX Codex +1 817installs vtex-io-rbac vtex-io-rbac — a skill for Claude Code and other coding agents that explains how to lock down VTEX IO routes. It covers role-based policies in policies.json, resource rules inside service.json, and the GraphQL @auth directive. CX Codex +1 816installs masterdata-storage-strategy masterdata-storage-strategy guides data architecture decisions in VTEX, helping configure Master Data JSON schemas with indexing, security, and caching rules before creating entities. CX Codex +1 797installs

Project sponsors

Companies that keep this analytics open