Przejdź do treści
Ostatnia aktualizacja

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

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

npx skills add SimPaypl/simpay-ai-skill

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