headless-checkout-integration

headless-checkout-integration is a skill for Claude Code, Cursor from xsolla/xsolla-ai-kit. It costs 188 tokens per session (2,990 once invoked), scanned A, original, MIT.

An integration guide for adding Xsolla Headless Checkout to a custom payment interface. Xsolla handles payment processing while card details stay inside secure embedded frames.

In plain words
What is it for?
Use it to build a sandbox checkout with cards, PayPal or other alternative methods, QR payments, mobile payments, and Google Pay or Apple Pay buttons.
Why use it?
It provides a staged way to add payment methods without using Xsolla’s standard hosted Pay Station interface.

Skill for Claude CodeCursor

Written for Claude Code and Cursor: shipped in a Claude Code plugin, but also installed under .cursor/.

Part of the xsolla-ai-kit plugin — 8 skills, 1 MCP server shipped together

Good fit Use it to build a sandbox checkout with cards, PayPal or other alternative methods, QR payments, mobile payments, and Google Pay or Apple Pay buttons.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/xsolla/xsolla-ai-kit/headless-checkout-integration
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add xsolla/xsolla-ai-kit --skill headless-checkout-integration
Clone the repo
git clone --depth 1 https://github.com/xsolla/xsolla-ai-kit

Made for: Claude Code, Cursor.

Or install xsolla-ai-kit, the plugin that ships this one along with the rest of its 8 skills, 1 MCP server.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for headless-checkout-integration

README.md
[![agentmods](https://agentmods.dev/badge/skills/xsolla/xsolla-ai-kit/headless-checkout-integration/github.svg)](https://agentmods.dev/skills/xsolla/xsolla-ai-kit/headless-checkout-integration)
Your own site
<a href="https://agentmods.dev/skills/xsolla/xsolla-ai-kit/headless-checkout-integration"><img src="https://agentmods.dev/badge/skills/xsolla/xsolla-ai-kit/headless-checkout-integration/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for headless-checkout-integration

Your own site · 80×15
<a href="https://agentmods.dev/skills/xsolla/xsolla-ai-kit/headless-checkout-integration"><img src="https://agentmods.dev/badge/skills/xsolla/xsolla-ai-kit/headless-checkout-integration.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 188 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,990 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00188 $0.02990
Opus 5 $0.00094 $0.01495
Sonnet 5 $0.00038 $0.00598
Haiku 4.5 $0.00019 $0.00299

Measured 10d ago against content hash 6854f20913f2, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

headless-checkout-integration scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 10d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.cursor/skills/headless-checkout-integration/SKILL.md · 192 lines

How it starts

The opening of the file, as written. The whole thing — 192 lines — stays where its author put it; the contents beside it link to each section on GitHub.

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 order_paid.

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-setup first. The developer must have:

XSOLLA_MERCHANT_ID=<your merchant ID>
XSOLLA_PROJECT_ID=<your project ID>
XSOLLA_PROJECT_API_KEY=<your API key>   # server-side / agent-side only — NEVER ship to the browser

If credentials are missing, stop and complete merchant-setup first. The only secret that ever reaches the browser is the short-lived payment token — never the API key.

The one mental model: form.init() + one onNextAction dispatcher

Every payment method — card, PayPal, QR, mobile, wallets — runs through the same shape: call form.init({ paymentMethodId, returnUrl }), render the server-driven fields, the user submits, and the SDK drives a small state machine by emitting NextActions to your onNextAction handler. React to whatever action arrives — never assume a fixed sequence, and never switch on the payment method id. All flows converge on a final status view.

One dispatcher, keyed on nextAction.type, handles everything. Where each action is documented:

Read the full file on GitHub · 192 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 10d ago First seen · 192 lines · 188 tokens per session scan A 6854f20913f2

Subscribe to this mod's changes

headless-checkout-integration is a skill published in the GitHub repository xsolla/xsolla-ai-kit (3 stars, last pushed today), licensed MIT. It adds 188 tokens to every session and 2,990 once invoked, about $0.0009 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

amazon-reviews-api-skill

This skill helps users automatically extract Amazon product reviews via the Amazon Reviews API. Agent should proactively apply this skill when users express needs like getting reviews for Amazon product with ASIN B07TS6R1SF, analyzing customer feedback for a specific Amazon item, getting ratings and comments for a…

browser-act/skills · 124 tokens

amazon-competitor-analyzer

Scrapes Amazon product data from ASINs using browseract.com automation API and performs surgical competitive analysis. Compares specifications, pricing, review quality, and visual strategies to identify competitor moats and vulnerabilities.

browser-act/skills · 48 tokens

asc-subscription-localization

Bulk-localize subscription, subscription-group, and in-app purchase display names across App Store locales using asc, including API 4.4.1 version-scoped v2 resources. Use when filling or updating subscription/IAP names and descriptions without App Store Connect UI work.

rorkai/app-store-connect-cli-skills · 60 tokens

food-order

Reorder previous Foodora orders, preview cart contents, and track delivery ETA/status with ordercli. Use when the user wants to reorder food, check delivery status, or browse recent Foodora order history. Never confirm an order without explicit user approval.

Bitterbot-AI/bitterbot-desktop · 53 tokens

product-description-generator

E-commerce product description generator for any platform. Generates optimized titles, bullet points, descriptions, and backend keywords using competitor research + keyword scoring + FABE copywriting. Two modes: (A) Create — generate listing from product specs with optional competitor analysis, (B) Optimize — improve…

nexscope-ai/eCommerce-Skills · 126 tokens

amazon-price-tracker

Amazon price monitoring and competitive pricing intelligence. Real-time price tracking, Buy Box analysis, promotion detection, and dynamic pricing strategy optimization. Use when the user asks about price monitoring, competitor pricing, Buy Box tracking, or pricing strategy.

nexscope-ai/Amazon-Skills · 51 tokens