About pluggy-payments
pluggy-payments is a Pluggy payment implementation guide for developers. It organizes code examples and rules by priority across PIX, Smart Transfers, payment lifecycles, Boletos, and scheduled payments.
Key features
- 01Prioritized payment implementation rules
- 02PIX initiation guidance
- 03Smart Transfer preauthorization
- 04Payment intent lifecycle guidance
- 05Boleto and scheduled payment guidance
Use cases
- 01Implementing PIX payments
- 02Creating and managing Boletos
- 03Setting up Smart Transfers
- 04Handling payment status and scheduled payments
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/pluggy-paymentsin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
AGENTS.mdmetadata.jsonrules/boleto-management.mdpayment-lifecycle.mdpix-initiation.mdpix-sandbox.mdschedule-payments.mdsmart-preauthorization.mdDetails
From the project READMEPluggy Payments
Comprehensive guide for implementing payment initiation through Pluggy. Contains rules across 5 categories, prioritized by impact.
When to Apply
Reference these guidelines when:
- Initiating PIX payments
- Creating and managing Boletos
- Setting up Smart Transfers with preauthorization
- Managing payment intents lifecycle
- Handling scheduled payments (PIX Agendado)
- Implementing PIX Automático
Rule Categories by Priority
| Priority | Category | Impact | Prefix |
|---|---|---|---|
| 1 | PIX Integration | CRITICAL | pix- |
| 2 | Smart Transfers | HIGH | smart- |
| 3 | Payment Lifecycle | HIGH | payment- |
| 4 | Boleto Management | MEDIUM | boleto- |
| 5 | Scheduled Payments | MEDIUM | schedule- |
How to Use
Read individual rule files for detailed explanations and code examples:
rules/pix-initiation.md
rules/smart-preauthorization.md
rules/payment-lifecycle.md
Each rule file contains:
- Brief explanation of why it matters
- Incorrect code example with explanation
- Correct code example with explanation
- Additional context and references
- Pluggy-specific notes
Payment Flow Overview
1. Create Payment Request (with recipient details)
2. Create Payment Intent (for specific Item/account)
3. User authorizes in Connect Widget
4. Monitor payment status via webhook
5. Handle success/failure
Full Compiled Document
For the complete guide with all rules expanded: AGENTS.md
Comments
Markdown supported