# SiXPay Merchant Integration Bundle

This folder is the external-facing merchant integration bundle.

## How to use it

1. Start with [SKILL.md](SKILL.md).
2. For an existing one-time order system, read [Checkout Session Contract](references/checkout-session.md), then load [sdk-ui/SKILL.md](sdk-ui/SKILL.md) and [webhook/SKILL.md](webhook/SKILL.md).
3. For recurring subscriptions, load [sdk-ui/SKILL.md](sdk-ui/SKILL.md), [Subscription SDK UI Reference](references/subscription-sdk-ui.md), and [webhook/SKILL.md](webhook/SKILL.md).
4. Load [sdk/SKILL.md](sdk/SKILL.md) only for custom UI/orchestration or server SDK usage.
5. For a merchant using a coding agent, start with [AI Agent Prompts](references/agent-prompts.md), then load the referenced checkout or subscription materials.

## Bundle contents

- `sdk/`: headless `@sigworld/sdk`
- `sdk-ui/`: public checkout UI
- `references/subscription-sdk-ui.md`: hosted recurring subscription UI
- `webhook/`: merchant webhook integration
- `references/public-sdk/`: public merchant docs
- `references/checkout-session.md`: Checkout API Key, merchant-server session, and browser credential contract
- `references/agent-prompts.md`: paste-ready Checkout and Subscription prompts for coding agents
- `references/webhook/`: webhook payload, consumer, and signature docs

## Public note

This published bundle intentionally includes only merchant-facing integration material. Internal repository notes are not part of the public skill surface.