Description
n8n-nodes-selectwin
Official Selectwin community node for n8n — operate the Selectwin
payments API (PIX, card, boleto, customers, products, payment links, subscriptions) and
react to webhooks, without writing code.
> Status: early / work in progress (0.1.0). Two nodes: Selectwin (API operations)
> and Selectwin Trigger (signed webhook events).
What it is
- Selectwin node — declarative API node covering the curated day-to-day surface of the
- Selectwin Trigger node — registers a webhook on the API for the events you pick,
- Zero runtime dependencies. Auth is your SelectKey; every POST carries an automatic
API: create charges, manage customers/products/payment links, read balance, receivables
and withdrawals.
verifies every delivery’s signature (constant-time, replay-proof) and emits the full
event envelope into your workflow.
X-Idempotency-Key.
Install
n8n GUI (community nodes)
1. In n8n go to Settings → Community Nodes → Install.
2. Enter n8n-nodes-selectwin and confirm.
Manual (self-hosted)
cd ~/.n8n/nodes # your n8n custom/community nodes folder
npm install n8n-nodes-selectwin
Restart n8n afterwards.
Credentials
Create a Selectwin API credential:
| Field | Value |
|——-|——-|
| API Key | your SelectKey — sktest… (sandbox) or sklive… (production) |
| Base URL | https://api.selectwin.io (default; leave as is) |
The environment is decided by the key prefix, not the URL. The credential test calls
GET /v1/balance. Requests authenticate with the selectkey header.
The Selectwin node
| Resource | Operations |
|———-|————|
| Transaction | Create (PIX / boleto / saved card, customer by ID or inline), Get, Get Many (status/method/customer filters), Refund, Capture |
| Customer | Create, Get, Get Many, Update, Delete |
| Product | Create, Get, Get Many, Update, Delete |
| Variant | Get, Get Many, Get Many by Product |
| Payment Link | Create (the response’s accessFullUrl is the shareable URL), Get, Get Many, Update, Delete |
| Checkout Session | Create (JSON body pass-through), Get, Get Many |
| Subscription | Get, Get Many, Cancel, Pause, Resume |
| Coupon | Validate, Get, Get Many |
| Balance | Get, Get History |
| Receivable | Get, Get Many |
| Withdrawal | Get, Get Many |
List operations page with Limit/Offset; the API answers with a
{ data[], hasMore, total, page } envelope.
IDs are safe to map from upstream data (a form, a webhook): every ID that goes into a URL is encoded, so it can
never reach another endpoint, and an empty ID, . or .. stops the item with Invalid ID instead of being sent.
The JSON fields (Additional Fields, Metadata) ignore proto, constructor and prototype keys.
The Selectwin Trigger
Pick one or more events from the full API catalog (transaction.approved,
transaction.refunded, subscription.canceled, checkout.session.completed, …). On
activation the node registers the webhook via POST /v1/webhooks and stores the returned
secret; on deactivation it deletes it.
Every delivery is verified before your workflow runs:
x-selectwin-signature-v1: t=,v1=.", secret)> —preferred, replay-proof (default tolerance 300 s, configurable under Options);
x-selectwin-signature: sha256= — legacy fallback.Verification runs over the raw received bytes with constant-time comparison. Invalid or
unsigned deliveries are rejected with 401 and never reach your workflow.
Custom API Call
The Selectwin API credential is also usable as a predefined credential type in n8n’s
built-in HTTP Request node — an escape hatch to reach any endpoint of the API that the
curated node does not cover yet.
Development
npm install
npm run typecheck # tsc --noEmit
npm test # vitest (webhook signature verification)
npm run build # tsc + copy node icons into dist/
