headless-checkout-integration
Integrates Xsolla Headless Checkout — a fully customizable, client-controlled payment UI built on the @xsolla/pay-station-sdk JavaScript SDK, where card data stays isolated in secure iframes and payments run through Xsolla without the standard Pay Station. Use when the developer wants to "integrate Headless Checkout", "add @xsolla/pay-station-sdk", "accept a credit card payment in sandbox", "add a payment method selector", "integrate PayPal / alternative payment methods", "add Google Pay / Apple Pay", "render psdk-card-number / psdk-payment-form", "handle onNextAction / NextAction", "do sandbox 3DS", "show payment status / psdk-status", "add a payment country selector", "change payment country", "getCountryList", "allow_modify", or "filter methods by country" for a custom checkout.
Install
With your agent
Install OMGSkills skill "xsolla/xsolla-ai-kit:skills/headless-checkout-integration" into this agent's normal skills directory: call the OMGSkills MCP get_install_plan tool for your agent and run the script it returns (it installs only the pinned commit and verifies SKILL.md), and stop if MCP or the pin is unavailable. Do not overwrite or change existing skills without asking me.
Manual command
git clone https://github.com/xsolla/xsolla-ai-kit /tmp/xsolla-ai-kit && ln -s /tmp/xsolla-ai-kit/skills/headless-checkout-integration ~/.claude/skills/headless-checkout-integrationFrom README
What this skill does Integrates Headless Checkout into a custom checkout UI via @xsolla/pay-station-sdk, running in sandbox. This is a big integration, so it is built one payment method at a time (see Phases) until every method works. This file is a map and a sequence — the actual how-to lives in references/; load only the reference the current phase needs. Frontend only. It does not cover the production token backend (server-to-server) nor webhook fulfillment — see webhooks-impl for granting items after orderpaid. When to use The developer wants to accept a payment with their own checkout UI (not the hosted Pay Station) and is working in sandbox — standing up the integration from scratch, adding a method selector, adding a payment method (card, PayPal/APM, QR, mobile), adding the Google Pay / Apple Pay wallet buttons, or wiring payment country into the method list. Prerequisites Run merchant- first.