# pluggy-payments

Скилл для инициализации платежей через Pluggy: PIX, Boleto, Smart Transfers и отложенные списания. Пригодится, когда в проекте нужно провести оплату от создания запроса до вебхука.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 386 установок · ★ 7
- Автор: pluggy
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/pluggyai/agent-skills/tree/HEAD/skills/pluggy-payments/SKILL.md
- Обновлён: 2026-05-29
- HTML: https://affpapa.org/nevibecode/skills/pluggy-payments

## Что делает

Пять категорий правил с приоритетами: интеграция PIX, Smart Transfers, жизненный цикл платежа, управление Boleto и отложенные платежи. У каждой категории свой префикс — `pix-`, `smart-`, `payment-`, `boleto-`, `schedule-`. Файлы правил лежат в `rules/`, например `rules/pix-initiation.md` и `rules/smart-preauthorization.md`.

Внутри каждого файла — короткое объяснение, пример неправильного кода с разбором, правильный пример и заметки по Pluggy. Полный свод правил собран в `AGENTS.md`. Схема потока такая: создать payment request с данными получателя, затем payment intent для конкретного Item, авторизация в Connect Widget, отслеживание статуса по вебхуку, обработка успеха или ошибки.

Скилл не содержит самих вызовов API — он задаёт порядок шагов и типовые ошибки. Если у вас уже есть рабочая интеграция с Pluggy и свой поток платежей, ценность будет в основном в разделах про Smart Transfers и PIX Automático.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pluggyai/agent-skills --skill pluggy-payments -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/pluggy-payments/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/pluggy-payments/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pluggyai/agent-skills --skill pluggy-payments -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/pluggy-payments/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pluggyai/agent-skills --skill pluggy-payments -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/pluggy-payments/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install pluggyai/agent-skills pluggy-payments
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/pluggy-payments/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pluggyai/agent-skills --skill pluggy-payments -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/pluggyai/agent-skills --path skills/pluggy-payments
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/pluggy-payments/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add pluggyai/agent-skills --skill pluggy-payments -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/pluggyai/agent-skills/tree/HEAD/skills/pluggy-payments/SKILL.md

## Когда брать
- провести PIX-платёж от создания запроса до подтверждения
- настроить Smart Transfer с предварительной авторизацией
- разобраться с жизненным циклом payment intent
- выпустить и обслуживать Boleto
- запланировать отложенный платёж через PIX Agendado

## Примеры запросов агенту
- помоги реализовать PIX-платёж через Pluggy: от payment request до вебхука
- покажи, как настроить Smart Transfer с предварительной авторизацией
- нужен разбор жизненного цикла payment intent — какие шаги и где ломается

## Похожие
- [payment-async-flow](https://affpapa.org/nevibecode/skills/payment-async-flow.md) — скилл · 1000 установок
- [stripe-payments](https://affpapa.org/nevibecode/skills/jezweb-stripe-payments.md) — скилл · 1100 установок
- [x402-payments](https://affpapa.org/nevibecode/skills/x402-payments.md) — скилл · 462 установки
- [payments](https://affpapa.org/nevibecode/skills/payments.md) — скилл · 5 установок
- [Yolfi Payments MCP](https://affpapa.org/nevibecode/mcp/yolfi-payments-mcp.md) — MCP-сервер · ★ 177
- [okx-agent-payments-protocol](https://affpapa.org/nevibecode/skills/okx-agent-payments-protocol.md) — скилл · 13700 установок

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md