# Integracja przez agenta AI (Claude, Codex i inne)

Jeśli Twój zespół programistyczny korzysta z asystentów kodujących opartych o AI
(Claude Code, OpenAI Codex, Cursor i inne), możesz przyspieszyć integrację z SimPay,
dodając do swojego repozytorium gotowy **Agent Skill** — plik z kontekstem, który daje
asystentowi dokładną wiedzę o naszym API zamiast zgadywania nazw pól czy sposobu
autoryzacji.

Skill nie jest przypisany do jednego narzędzia — działa z każdym agentem, który potrafi
wczytać plik Markdown jako kontekst.

## Co zawiera

- Autoryzację (klucz API, adres bazowy, wymagane nagłówki)
- Tworzenie płatności (`directChannel`, przykładowy request/response, najczęstsze błędy
powodujące odrzucenie przez antyfraud)
- Wartości metod płatności oraz statusy transakcji, zwrotów i subskrypcji
- Zwroty
- Powiadomienia IPN: strukturę payloadu, weryfikację sygnatury (SHA-256, z przykładem
w PHP), zachowanie przy ponowieniach, dynamiczną walidację adresu IP
- Skrócone informacje o BLIK Level 0 / One-Click / Płatnościach Powtarzalnych,
DirectBilling (DCB), płatnościach odroczonych (PayPo, Twisto, BLIK Płacę Później)
oraz SMS Premium
- Listę oficjalnych SDK
- Checklistę przed wdrożeniem produkcyjnym


## Instalacja


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

# Codex / inne agenty korzystające z tej samej konwencji
git clone https://github.com/SimPaypl/simpay-ai-skill <katalog-skilli>/simpay-api-integration
```

Albo przez CLI [skills.sh](https://skills.sh):


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

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

Skill jest utrzymywany ręcznie na podstawie tej dokumentacji. Jeśli zauważysz, że coś
jest nieaktualne, zgłoś to przez issue lub PR w repozytorium.