Skip to content
Last updated

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

# 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 CLI:

npx skills add SimPaypl/simpay-ai-skill

Repository: 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.