Package Exports
- n8n-nodes-pagbank-connect
- n8n-nodes-pagbank-connect/index.js
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (n8n-nodes-pagbank-connect) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
n8n-nodes-pagbank-connect
n8n integration with PagBank Connect for Brazilian payment processing.
Features
- ✅ PIX - Instant payments with QR Code
- ✅ Credit/Debit Card - Secure card processing
- ✅ Payment Links - Custom checkout
- ✅ Recurring Subscriptions - Recurring payments (coming soon)
- ✅ Webhooks - Real-time notifications
- ✅ Sandbox Environment - Safe testing
- ✅ Official Partner - PagBank Integrations is an Official PagBank Partner since 2014.
- ✅ Reduced fees - You pay less fees on PagBank when using our integrations
Installation
npm install n8n-nodes-pagbank-connectConfiguration
1. Get Credentials
Visit PagBank Connect to get your Connect Key for free
If you need a Test Connect Key, click here.
2. Configure in n8n
- Add your Connect key in PagBank Connect credentials
- Click Save and check if the connection was successful.
Available Nodes
PagBank (Main)
- Create Payment Link - Generates checkout links for customers to pay on PagBank
- Create PIX Order - Creates PIX payments
- Create Credit Card Charge - Processes a payment with the provided credit card data
- Check order status - Queries the status of an ORDER with PagBank (must have been generated with this connect key)
- Validate Connect Key - Validates the Connect Key configured in your credentials
PagBank Webhook
- Payment Webhook - Receives notifications. You can filter notifications by payment status, payment methods or denial reason.
Data Format
Monetary Values
All values are in cents:
- R$ 10.00 = 1000
- R$ 1.50 = 150
CPF/CNPJ
- CPF: 11 digits (numbers only)
- CNPJ: 14 digits (numbers only)
Required for most operations, except payment link creation.
Environments
Sandbox (Test)
- The environment will be for testing whenever your Connect Key starts with CONSANDBOX. Get yours here.
- Automatic approval for values < R$ 100
- 5 minute delay for values between R$ 100-200
- Ideal for development and testing
- See Test Cards
Production
- Real payment processing
- Requires PagBank approval
- Use only after complete testing
Webhooks
Configuration
- Configure the webhook URL in n8n
- Add the generated URL in the Notification URL field when creating payments and payment links in other actions
- Configure filters by status and payment method
- Make sure the URL can be accessed from outside without any blocking.
Common Errors
- **40002 - Buyer email same as seller
- **40002 - Invalid CPF/CNPJ
- **40002 - Invalid phone
- **UNAUTHORIZED - Invalid Connect Key
Validations
- CPF/CNPJ are automatically validated
- Phones are formatted
Support
- Official Site: pbintegracoes.com/n8n
- Documentation: PagBank Integrations
- Issues and Support: Open a Ticket
License
MIT License - see LICENSE file for details.
Contributing
- Fork the project on github
- Create a branch for your feature/bugfix
- Commit your changes
- Push to your local branch
- Open a Pull Request to the
developbranch
Roadmap
- More installment options
- Recurring sales
Subject to change based on community requests.