AI导哈

测试与安全

payment-provider-framework

vtex/skills

Apply when designing or implementing a Payment Connector in VTEX IO. Covers PPF implementation, TypeScript 3.9.7 builder-hub constraints and safe dependency resolutions, configuration.json schema validation, PaymentProviderService clients wiring, Secure Proxy scope (authorize-only), ExternalClient vs SecureExternalClient patterns, IOContext access, PPF response helpers, PSP integration checklist, and vtex link debugging. Use for any implementation of a Payment Connector hosted in VTEX IO.

  • 993 次安装
  • 47 星标
  • 收录于

安装命令

npx skills add https://github.com/vtex/skills --skill payment-provider-framework

SKILL.md

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

Do not use this skill for:

  • PPP HTTP contracts, response field-by-field requirements, and the nine endpoints in the abstract — use payment-provider-protocol
  • Idempotency and duplicate paymentId handling — use payment-idempotency
  • Async undefined status, callbackUrl notification vs retry (IO vs non-IO) — use payment-async-flow
  • PCI rules, logging, and token semantics beyond IO wiring — use payment-pci-security
  • POS / Sales App card-present overlay (Venda Direta methods, Payment Apps, terminal serial) — use payment-ppp-pos together with this skill

相关 Skills

vtex-io-react-appsvtex/skillsApply when building React components under react/ or configuring store blocks in store/ for VTEX IO apps. Covers interfaces.json, contentSchemas.json for Site Editor, VTEX Styleguide for admin apps, and css-handles for storefront styling. Use for creating custom storefront components, admin panels, pixel apps, or any frontend development within the VTEX IO react builder ecosystem.前端开发1595vtex-io-service-appsvtex/skillsApply when building backend service apps under node/ in a VTEX IO project or configuring service.json routes. Covers the Service class, middleware functions, ctx.clients pattern, JanusClient, ExternalClient, MasterDataClient, and IOClients registration. Use for implementing backend APIs, event handlers, or integrations that must use @vtex/api clients instead of raw HTTP libraries.后端与数据库1255vtex-io-masterdatavtex/skillsApply when working with MasterData v2 entities, schemas, or MasterDataClient in VTEX IO apps, or when anyone designing or implementing a solution must scrutinize whether Master Data is the correct storage. The skill prompts hard questions: native Catalog or other VTEX stores, OMS, or an external database may be better; do not default to MD because it is convenient. Covers JSON Schema, CRUD, triggers, search and scroll, schema lifecycle, purchase-path avoidance, single source of truth, and BFF handoffs. Use for justified custom persistence while avoiding the 60-schema limit.智能体工作流1244vtex-io-graphql-apivtex/skillsApply when working with GraphQL schema files in graphql/ or implementing resolvers in node/resolvers/ for VTEX IO apps. Covers schema.graphql definitions, @cacheControl and @auth directives, custom type definitions, and resolver registration in the Service class. Use for exposing data through GraphQL queries and mutations with proper cache control and authentication enforcement.后端与数据库1238vtex-io-storefront-reactvtex/skillsApply when building VTEX IO storefront components under react/ for Store Framework experiences. Covers storefront component structure, css-handles, storefront context hooks, browser-safe data fetching, and how components should behave when used as theme blocks. Use for custom storefront UI, product widgets, banners, forms, or reviewing shopper-facing React code in VTEX IO apps.前端开发1200vtex-io-app-settingsvtex/skillsApply when defining, validating, or consuming VTEX IO app settings. Covers settingsSchema, app-level configuration boundaries, and how backend or frontend code should depend on settings safely. Use for merchant-configurable behavior, settings forms, or reviewing whether settings belong in app configuration rather than hardcoded logic or custom data entities.前端开发1183