# AI Agent Integration (Claude, Codex, and others)

If your development team uses AI coding assistants (Claude Code, OpenAI Codex, Cursor,
and others), you can speed up your SimPay integration by adding a ready-made **Agent
Skill** to your repository — a context file that gives your assistant accurate knowledge
of our API instead of it guessing field names or the authorization scheme.

The skill isn't tied to a single tool — it works with any agent that can load a Markdown
file as context.

## What it includes

- Authorization (API key, base URL, required headers)
- Creating a payment (`directChannel`, an example request/response, the most common
mistakes that trigger antifraud rejection)
- Payment method values, and transaction / refund / subscription statuses
- Refunds
- IPN notifications: payload structure, signature verification (SHA-256, with a PHP
example), retry behavior, dynamic IP validation
- Brief pointers to BLIK Level 0 / One-Click / Recurrent Payments, DirectBilling (DCB),
deferred payments (PayPo, Twisto, BLIK Pay Later), and SMS Premium
- List of official SDKs
- A pre-launch checklist


## Installation


```bash
# Claude Code
git clone https://github.com/SimPaypl/simpay-ai-skill .claude/skills/simpay-api-integration

# Codex / other agents following the same convention
git clone https://github.com/SimPaypl/simpay-ai-skill <your-skills-dir>/simpay-api-integration
```

Or via the [skills.sh](https://skills.sh) CLI:


```bash
npx skills add SimPaypl/simpay-ai-skill
```

Repository: [github.com/SimPaypl/simpay-ai-skill](https://github.com/SimPaypl/simpay-ai-skill)

The skill is maintained by hand against this documentation. If you notice something is
out of date, open an issue or PR in the repository.