@chez14/n8n-nodes-saweria

@chez14/n8n-nodes-saweria

An n8n community node that lets you receive Saweria donation notifications in your n8n workflows via webhook.

Saweria is an Indonesian donation/tipping platform for content creators and streamers.

n8n is a fair-code licensed workflow automation platform.

Installation

Follow the installation guide in the n8n community nodes documentation.

Operations

The Saweria Webhook trigger node listens for incoming donation events from Saweria. When a donation is received, it emits an item with the following fields:

Field	Type	Description
version	string	Payload format version (e.g. 2022.01)
created_at	string	ISO 8601 timestamp of the donation
id	string	Unique donation UUID
type	string	Event type (donation)
amount_raw	number	Donation amount in IDR (Indonesian Rupiah)
cut	number	Platform fee deducted
donator_name	string	Name provided by the donor
donator_email	string	Email provided by the donor
donator_is_user	boolean	Whether the donor has a Saweria account
message	string	Message from the donor

Credentials

To enable signature verification (recommended), configure the Saweria Webhook API credential with your Alert Widget URL:

1. Log in to saweria.co and go to Overlay → Alert Widget
2. Copy the full Widget URL (e.g. https://saweria.co/widgets/alert?streamKey=abc123)
3. Paste it into the Alert Widget URL field in the n8n credential — the stream key is extracted from the URL automatically

If no credentials are attached to the node, signature verification is skipped and all incoming POST requests are accepted. This is useful for initial testing but not recommended for production.

Note: The credential test only verifies that the Saweria server is reachable. The Streamer Key itself cannot be validated via API — it is a signing secret used only for HMAC verification.

Compatibility

Tested against n8n version 1.x. Requires n8nNodesApiVersion: 1.

Usage

1. Add the Saweria Webhook node to your workflow.
2. (Optional) Attach Saweria Webhook API credentials for signature verification.
3. Copy the webhook URL shown in the node panel.
4. In Saweria, go to Settings → Webhook and paste the URL.
5. Activate the workflow.

Signature Verification

Saweria signs each webhook request using HMAC-SHA256. The signature is computed over the concatenation of:

version + id + amount_raw + donator_name + donator_email

and sent in the Saweria-Callback-Signature header. When credentials are configured, the node verifies this signature and rejects requests that fail validation with HTTP 401.

Resources

• n8n community nodes documentation
• Saweria webhook documentation
• Extended webhook documentation
• Node source code

This node was developed with reference to:

• Official Saweria docs: http://saweria.co/docs/webhook
• Community webhook documentation: https://gitlab.com/chez14/saweria-webhook-documentation

Trademark & Copyright Notice

The Saweria logo used in this package is the copyright of Saweria and was obtained directly from saweria.co. All rights reserved by the respective owner. This package is an independent community integration and is not affiliated with or endorsed by Saweria.