sequra

n8n community node that lets merchants create seQura payments and send checkout forms to shoppers directly from n8n workflows.

Package Information

Released: 6 mo ago
Downloads: 5 weekly / 138 monthly
Latest Version: 0.1.0
Author: seQura

Documentation

n8n-nodes-sequra

n8n community node that lets merchants create seQura payments and send checkout forms to shoppers directly from n8n workflows.

It is the n8n equivalent of the private seQura Zapier app and talks to the same seQura middleware.

Install

This is a community node. Until published to npm, install it in development mode:

npm install
npm run build

Link into your local n8n

# In this repo
npm link

# In your n8n install (https://docs.n8n.io/integrations/creating-nodes/test/run-node-locally/)
cd ~/.n8n/custom
npm link n8n-nodes-sequra
n8n start

Install as a published community node

Once published, in n8n go to Settings → Community Nodes → Install and enter n8n-nodes-sequra.

Credentials

When creating a seQura API credential in n8n you will be asked for:

Field Description
Environment One of: Live seQura, Live SVEA, Sandbox seQura, Sandbox SVEA
Username Basic Auth username (also used as Merchant ID)
Password Basic Auth password

Credentials can be found in your seQura dashboard. The credential test hits GET /merchants/{username}/payment_methods against the selected environment.

The selected environment also determines the middleware endpoint used to create payments: Live * environments route to https://partner-integration-middleware.sequra.com, and Sandbox * environments route to https://partner-integration-middleware-sandbox.sequra.com.

Operations

Payment → Create

Creates a seQura payment and optionally sends a checkout link to the shopper via SMS or email.

Inputs:

Field Required Notes
Channel Yes Email, SMS, or None (creates payment without sending)
Reference No Unique payment reference
Shopper Email Yes Validated as an email address
Shopper Phone If SMS Required when channel is SMS
Shopper Given Names No
Shopper Surnames No
Total Amount (cents) Yes Integer, e.g. 12345 = 123.45 EUR
Currency No Defaults to EUR
Payment Method / Product No Dynamically loaded from your account. Defaults to tbs (any available)
Items No Repeatable collection — name, quantity, unit price (cents)
Notification URL No Webhook URL for IPN callbacks

Outputs:

Field Description
uuid Unique identifier for the payment
payment_url Full URL returned in the Location header
payment_link Embedded form URL ({base_url}/orders/{uuid}/embedded_form?product={product})

Recommended workflow designs

A) Send checkout form to shopper

  1. Trigger: CRM deal closed (HubSpot, Pipedrive, …)
  2. seQura → Create Payment (with Notification URL pointing to an n8n Webhook node)
  3. Log payment_link and uuid back to the CRM record

B) Handle payment confirmation (IPN)

  1. Trigger: Webhook node (the URL you passed as Notification URL)
  2. Filter / Switch on payment status
  3. Update CRM record to "Paid"

Development

npm install
npm run build     # compiles TS + copies icons into dist/
npm run dev       # tsc --watch
npm test          # jest
npm run lint

The n8n block in package.json points n8n at dist/credentials/SequraApi.credentials.js and dist/nodes/Sequra/Sequra.node.js, so you must npm run build before npm link.

Discussion