payment-ppp-pos
Installation
SKILL.md
PPP Applied to POS (VTEX Sales App)
When this skill applies
Use this skill when the task is to create, extend, or debug a payment connector that charges a physical card on a POS terminal from VTEX Sales App.
- The user mentions PPP + POS, POS connector, in-store payments, Sales App card payments, payment terminal, or
Venda Direta Credito/Venda Direta Debito - The source of truth is Payment Provider Protocol for Point of Sale (POS)
- The goal is to remove the "implement from scratch" barrier: clone the official PPF example from Payment Provider Framework Getting started, or overlay POS on existing PPP — not generate a generic ecommerce connector
Load companions when the step needs them. Do not dump all three into the first reply.
| Companion | Load when |
|---|---|
| generation.md | The user asked to create a POS connector. Ask the four questions, then implement in the listed order. |
| ppf-scaffold.md | Hosting is VTEX IO / PPF. Copy overlay files onto the official PPF example app. |
| examples.md | You need expected JSON, the state machine table, or IO retry vs standalone notification. |
The hard constraints below override ecommerce PPP and PCI habits. If a generated file violates one, STOP and fix it before writing more files.