DEV Community

CigalPay
CigalPay

Posted on Originally published at cigalpay.com

How to Accept Crypto Payments in n8n (No Code)

In short

  • The CigalPay community node (n8n-nodes-cigalpay) adds crypto payments to n8n: one node creates checkouts and reads payments, and the CigalPay Trigger starts a workflow when a payment is confirmed.
  • You price in USD or EUR; customers pay in Bitcoin, USDT, Ethereum, Solana or another coin on the CigalPay payment page.
  • The trigger checks each notification's signature before the workflow runs. Before delivering, compare the checkout ID and the amount with the order you created.

n8n connects your forms, shop, CRM, email and chat without code. With the CigalPay node, the same workflows can take crypto payments: send a customer a payment link, then deliver, email a receipt or update a sheet once the payment is confirmed. This guide installs the node, creates a first checkout and builds the workflow that runs when a customer pays.

What the CigalPay node does

Node What it does
CigalPay Create a checkout and get its payment link; get a payment, the payments of an order or the active payments; refund a payment; list the coins accepted directly or converted at payment.
CigalPay Trigger Starts a workflow when CigalPay sends a signed payment notification: paid payments only, every status change, or the statuses you choose.

The CigalPay node also works as a tool for n8n's AI Agent, so an assistant can answer "which coins can I pay with?" or look up the status of an order.

1. Install the node

  1. In a workflow, open the nodes panel (press N or click +) and search for CigalPay. It shows n8n's verified badge.
  2. Select it and click Install node. On self-hosted n8n you can also install it from Settings → Community Nodes → Install with the package name n8n-nodes-cigalpay.
  3. Add a CigalPay node to a workflow and create a CigalPay API credential with your Account ID, API key and notification signing secret, from your CigalPay dashboard, Settings → API credentials. Saving it tests the connection.

n8n Cloud and self-hosted CigalPay is a verified node: n8n reviewed and approved it, and it is available on n8n Cloud and in self-hosted n8n. Installing it takes an owner or admin of the instance. On n8n Cloud, if CigalPay doesn't show up, check that verified community nodes are enabled in the Admin Panel.

2. Create a checkout

Add the CigalPay node with the action Create a checkout. Set the price in USD or EUR (up to 5,000), your own order ID, a description, the page the customer returns to, and the Notification URL: the production URL of the CigalPay Trigger from the next step. The node returns a chargeLink: send it by email or chat, or redirect the customer to it.

On the payment page, the customer picks a coin and sends the exact amount shown. The price is locked for 30 minutes.

3. Run a workflow when the payment arrives

  1. Add a CigalPay Trigger with the same credential, and choose Paid payments only.
  2. Activate the workflow and copy the trigger's Production URL into the checkout's Notification URL.
  3. Connect what should happen next: send the download link, email the receipt, add a row to Google Sheets, post in Slack or Telegram.

Each notification carries the payment's status, your order ID as extraId, the coin paid, and the checkout's checkoutId, checkoutAmount and checkoutCurrency. The trigger checks the x-cigalpay-sig signature and refuses anything unsigned or forged with a 401, before the workflow runs. To try it without paying, send a sample from the dashboard: Settings → API credentials → Test notification.

Check the order before delivering

Your Account ID is not secret: anyone can create a checkout with it and one of your order references, pay a small amount, and get a genuinely signed notification. Add an If node after the trigger and deliver only when:

  • checkoutId is the ID the Create a checkout node returned for this order,
  • checkoutAmount and checkoutCurrency match the price you set,
  • the order hasn't been delivered yet: CigalPay notifies both CONFIRMED and FINISHED, so a workflow without this check would deliver twice.

Our security checklist covers the other checks a payment workflow needs.

A ready-made workflow: sell digital products

The example workflow on GitHub does all of the above with n8n's built-in nodes. An n8n form takes the order, the workflow creates the checkout, saves the order in a Data Table and sends the customer to the payment page. When the payment is confirmed, it checks the checkout ID, currency and amount, emails the download link once and marks the order as delivered; a payment that doesn't match is sent to you instead. Import it with ⋯ → Import from File and follow the yellow note on the canvas.

Good to know

  • Up to 5,000 USD or EUR per payment.
  • One-time payments: there are no automatic renewals, so send a new checkout for each period.
  • Payments that are underpaid or overpaid arrive with their own status (PARTIALLY_PAID): choose "Selected statuses" in the trigger to handle them.

FAQ

Can n8n accept crypto payments?

Yes. Add the CigalPay node, verified by n8n, from the nodes panel: it creates checkouts priced in USD or EUR, and the CigalPay Trigger starts a workflow when the customer's crypto payment is confirmed.

Do I need to write code?

No. The checkout, the payment notification and the signature check are handled by the nodes. You connect them to n8n's other nodes, such as forms, email, Google Sheets or Slack.

Does it work on n8n Cloud?

Yes. CigalPay is a verified community node: search for CigalPay in the nodes panel and click Install node. If it doesn't show up, check that verified community nodes are enabled in your Admin Panel.

Which coins can customers pay with?

Bitcoin, USDT on Tron, Ethereum, Solana, Litecoin, Dogecoin, Dash, Bitcoin Cash, Polygon and TRX, plus other coins converted automatically at payment.

Originally published on cigalpay.com.

Top comments (0)