n8n-nodes-blockia-pay

This is an n8n community node that integrates the Blockia Pay service into your n8n workflows.

Blockia Pay is a secure, decentralized payment processing service that enables automated crypto and digital asset transactions using the Blockia Agent SDK.

n8n is a fair-code licensed workflow automation platform that lets you connect APIs, databases, and apps together with visual workflows.

🧹 Installation

Follow the n8n community node installation guide.

After installing n8n locally via npm go to the terminal and write:

cd ~/.n8n/custom
npm install n8n-nodes-blockia-pay
n8n start

If successful, n8n will recognize the new node and display Blockia Pay in the node selection menu.

⚙️ Operations

The Blockia Pay Node currently supports the following operations:

| Operation | Description | | ------------------------- | -------------------------------------------------------------------- | | Get Payment Link Info | Retrieves details of an existing payment request. | | Make Payment | Executes a payment based on the payment requirements. | | Get Balance | Fetches the current balance of the user's wallet. | | Fetch With Payment | Calls the premium API endpoint and handles the payment negotiations. |

Each operation corresponds to a method in the Blockia SDK and returns both structured JSON and a readable response for downstream nodes.

🔑 Agent SDK Parameters

The Blockia Agent SDK requires three configuration parameters to complete the payment process.

Parameters

• apiUrl – The base URL of the Blockia Agent API used for payment operations.
• chainId – The ID of the Ethereum network to interact with (e.g.84532 for Sepolia).
• privateKey – The private key from your Ethereum wallet (e.g., MetaMask) used to sign transactions.

🧪 Compatibility

• Minimum n8n version: 1.114.0
• Tested with: `[email protected]
• Node.js version: >=22

🚀 Usage

1. Open n8n and create a new workflow.
2. Add a new node and search for Blockia Pay.
3. Choose an operation such as “Get Payment Link Info” or “Make Payment”.
4. Provide the required parameters for the Agent SDK.
5. Provide the required and additional fields.
6. Connect it to other nodes (e.g. HTTP Request, Set, IF) to build your payment logic.

Example Workflow

graph LR
A[Start] --> B[Blockia Pay: Fetch Payment Requirements]
B -->|Yes| C[Blockia Pay: Make Payment]
D -->|No| D[Send the error message to Slack]

This workflow automates payment process to make it easier for user experience.

📚 Resources

• n8n Community Nodes Documentation
• Blockia Agent SDK

🕚 Version History

| Version | Date | Changes | | --------- | ---------- | ------------------------------------------------------------ | | 0.1.0 | 2025-10-22 | Initial creation of Blockia Pay node for automatic payments | | 0.2.0 | 2025-10-24 | Added fields and improved it according to the sdk. | | 0.2.1 | 2025-10-24 | Refined README documentation and refactored node parameters. | | 0.3.0 | 2025-10-27 | Adding new operation get balance and refactored code. | | 0.4.0 | 2025-11-5 | Adding new operation fetch with payment. |