# headless-checkout-integration

> Claude/Codex skill by [@xsolla](https://omgskills.com/library/xsolla/index.md) · 8 stars · Updated 2026-10-23

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

```sh
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-integration
```

## From 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.

## Links

- HTML page: https://omgskills.com/library/xsolla/xsolla-ai-kit/skills/headless-checkout-integration/
- GitHub: https://github.com/xsolla/xsolla-ai-kit
- Author: [@xsolla](https://omgskills.com/library/xsolla/index.md)

## More from this repo

- [merchant-setup](https://omgskills.com/library/xsolla/xsolla-ai-kit/skills/merchant-setup/index.md) — Guide for setting up a new Xsolla merchant account and obtaining API credentials.
   - [@xsolla](https://omgskills.com/library/xsolla/index.md) · 8 stars