Claude MarketplacesSubmit
vtex avatar

Payment Provider Framework

vtex/skills

If you're building a payment connector as a VTEX IO app, this walks you through wiring PaymentProviderService, setting up configuration.json with payment methods and feature flags, and handling the TypeScript 3.9.7 constraints that builder-hub enforces. It covers SecureExternalClient for card flows with Secure Proxy, the retry semantics for Gateway callbacks, and safe dependency resolutions so your build doesn't explode with hundreds of type errors from modern syntax in transitive packages. The skill explicitly splits out protocol contracts, idempotency, async flows, and PCI rules into separate skills, keeping this focused on the IO runtime plumbing. Useful when you need the cookbook for vtex link, affiliation testing, and homologation artifacts rather than hunting through fragmented docs.

skills.sh installs
1K
GitHub stars
47
last updated
Aug 21, 2026
View on GitHub

Install

$ npx -y skills add vtex/skills --skill payment-provider-framework --agent claude-code

Installs into .claude/skills of the current project.

Files

Payment Provider Framework (VTEX IO)

When this skill applies

Use this skill when:

  • Creating or maintaining a payment connector implemented as a VTEX IO app (not a standalone HTTP service you host yourself)
  • Wiring @vtex/payment-provider, PaymentProvider, and PaymentProviderService in node/index.ts
  • Configuring the paymentProvider builder, configuration.json (payment methods, customFields, feature flags)
  • Implementing this.retry(request) for Gateway retry semantics on IO
  • Extending SecureExternalClient and passing secureProxy on requests for card flows on IO
  • Testing via payment affiliation, workspaces, beta/stable releases, the VTEX App Store, and VTEX homologation
SKILL.md on GitHub

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Details

Repository
github.com/vtex/skills
Categories
Backend & APIs, Debugging, Finance & Trading
First seen
Jun 3, 2026

More from vtex/skills

All 40

Recommended

More Backend & APIs
1orchestra-research avatarllama-cpporchestra-research/ai-research-skillsRuns LLM inference on CPU, Apple Silicon, and consumer GPUs without NVIDIA hardware. Use for edge deployment, M1/M2/M3 Macs, AMD/Intel GPUs, or when CUDA is una1Kskills.sh installs
2kostja94 avatarsignup-login-page-generatorkostja94/marketing-skillsWhen the user wants to create, optimize, or audit signup and login pages. Also use when the user mentions "signup page," "login page," "registration page," "aut1Kskills.sh installs
3joeseesun avatarqiaomu-opencli-oneshotjoeseesun/qiaomu-opencli-skillsUse when quickly generating a single OpenCLI command from a specific URL and goal description. 4-step process — open page, capture API, write TS adapter, test. 1Kskills.sh installs
4samuraigpt avatarmuapi-platformsamuraigpt/generative-media-skillsSetup and utility scripts for muapi.ai — configure API keys, test connectivity, and poll for async generation results1Kskills.sh installs
5modelcontextprotocol avatarconvert-web-appmodelcontextprotocol/ext-appsThis skill should be used when the user asks to "add MCP App support to my web app", "turn my web app into a hybrid MCP App", "make my web page work as an MCP A1Kskills.sh installs
6orchestra-research avatarnemo-evaluator-sdkorchestra-research/ai-research-skillsEvaluates LLMs across 100+ benchmarks from 18+ harnesses (MMLU, HumanEval, GSM8K, safety, VLM) with multi-backend execution. Use when needing scalable evaluatio1Kskills.sh installs