Skip to main content

Create a self-hosted blockchain payment processor with x402 and 1Shot API

Workflow preview

Workflow preview
100%
Create a self-hosted blockchain payment processor with x402 and 1Shot API preview
Open on n8n.io

Important notice

This workflow is provided as-is. Please review and test before using in production.

1. Workflow Overview

This workflow contains community nodes that are only compatible with the self hosted version of n8n. Self Hosted x402 Facilitator In the [x402](https://x402.o...

Best for

  • Crypto Trading automation workflows
  • Multimodal AI automation workflows
  • advanced n8n builders looking for reusable templates

Tools used

n8n-nodes-1shot.oneshot, n8n-nodes-base.webhook, n8n-nodes-base.respondtowebhook, n8n-nodes-1shot.oneshotsynch, n8n-nodes-base.if, n8n-nodes-base.stickynote, n8n-nodes-base.code

Source and attribution

This workflow is cataloged by N8N Workflows and links back to its original n8n.io source page by 1Shot API.

Original n8n.io source

1.1 Workflow description

Title
Create a self-hosted blockchain payment processor with x402 and 1Shot API
Workflow name
Create a self-hosted blockchain payment processor with x402 and 1Shot API

This workflow contains community nodes that are only compatible with the self-hosted version of n8n.

Self-Hosted x402 Facilitator

In the x402 payment protocol, a facilitator is a role which helps sellers settle stablecoin payments onchain without dealing with blockchain complexities. This workflow allows you to run your own fully-featured, specification-compliant facilitator in n8n. You might want to do this if you want to accept payments in tokens not supported by existing facilitators or as your own business!

Details

A facilitator supports three routes: /verify, /settle, and /supported. These routes are all created for you in this workflow with proper error handling and responses.

A seller will first hit /verify with their payment details to ensure the payment information is correct. Next they will hit the /settle endpoint with the same payment information to settle the paymet on the blockchain. The /supported endpoint is used to indicate to sellers which blockchains you choose to support in a programatic fashion.

Setup

  1. Create a 1Shot API account
  2. Create 1Shot API wallets for the networks where you wish to facilitate token payments and load them with sufficient gas tokens.
  3. Using 1Shot Prompts, import the transferWithAuthorization functions for the tokens you will settle payments for.
  4. Import this workflow into n8n and create a credential to link the 1Shot API community node to your 1Shot API business account.
  5. Enter the token and network information into the payment token and network configuration nodes indicated by the sticky nodes.
  6. Turn on your workflow and settle payments!

1.2 Logical Blocks

This catalog entry is organized from the workflow JSON. The node-level section below shows the executable blocks available for review before importing the template.

2. Block-by-Block Analysis

Block 1 - Simulate Payment

Type / Role
n8n-nodes-1shot.oneShot - oneShot
Config choices
Version 1

Block 2 - /verify

Type / Role
n8n-nodes-base.webhook - webhook
Config choices
Version 2

Block 3 - /settle

Type / Role
n8n-nodes-base.webhook - webhook
Config choices
Version 2

Block 4 - Settlement Response

Type / Role
n8n-nodes-base.respondToWebhook - respondToWebhook
Config choices
Version 1.3

Block 5 - Verify Response

Type / Role
n8n-nodes-base.respondToWebhook - respondToWebhook
Config choices
Version 1.3

Block 6 - Response: Bad POST Body (/verify)

Type / Role
n8n-nodes-base.respondToWebhook - respondToWebhook
Config choices
Version 1.3

Block 7 - Response: Bad POST Body (/settle)

Type / Role
n8n-nodes-base.respondToWebhook - respondToWebhook
Config choices
Version 1.3

Block 8 - 1Shot API Submit & Wait

Type / Role
n8n-nodes-1shot.oneShotSynch - oneShotSynch
Config choices
Version 1

Block 9 - Check POST Payload

Type / Role
n8n-nodes-base.if - if
Config choices
Version 2.2

Block 10 - /supported

Type / Role
n8n-nodes-base.webhook - webhook
Config choices
Version 2.1

Block 11 - Response: Return Supported Networks

Type / Role
n8n-nodes-base.respondToWebhook - respondToWebhook
Config choices
Version 1.3

Block 12 - Sticky Note

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 13 - Sticky Note1

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 14 - Sticky Note2

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 15 - Sticky Note3

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 16 - Sticky Note4

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 17 - Supported Networks Config

Type / Role
n8n-nodes-base.code - code
Config choices
Version 2

Block 18 - Sticky Note5

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 19 - Sticky Note6

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 20 - Unsupported Token

Type / Role
n8n-nodes-base.if - if
Config choices
Version 2.2

Block 21 - verify or settle

Type / Role
n8n-nodes-base.if - if
Config choices
Version 2.2

Block 22 - Response: Unsupported Token (/verify)

Type / Role
n8n-nodes-base.respondToWebhook - respondToWebhook
Config choices
Version 1.3

Block 23 - Response: Unsupported Token (/settle)

Type / Role
n8n-nodes-base.respondToWebhook - respondToWebhook
Config choices
Version 1.3

Block 24 - Bad Payload

Type / Role
n8n-nodes-base.if - if
Config choices
Version 2.2

Showing the first 24 of 26 workflow blocks. Download the JSON for the full node graph.

3. Summary Table

Workflow Create a self-hosted blockchain payment processor with x402 and 1Shot API
Complexity advanced
Nodes 26
Categories Crypto Trading, Multimodal AI
Author 1Shot API
Published 14 Aug 2025

4. Reproducing the Workflow from Scratch

  1. 1. Download the workflow JSON

    Use the JSON export at /data/workflows/7364/7364.json as the source template for this automation.

  2. 2. Import the template into n8n

    Open n8n, import the downloaded JSON, and review each node before activating the workflow.

  3. 3. Configure credentials and variables

    Replace placeholder credentials, API keys, webhook URLs, account IDs, and environment-specific values with your own settings.

  4. 4. Test with sample data

    Run the workflow manually or in a staging workspace, inspect node output, and confirm downstream systems receive the expected data.

  5. 5. Activate and monitor

    Enable the workflow only after testing, then monitor executions, errors, and rate limits during the first production runs.

5. General Notes & Resources

Review imported nodes carefully before activation. This catalog entry is intended to help you inspect the workflow structure, understand required services, and find related templates faster.

Node names, credentials, schedules, webhook paths, and external service limits may need adjustment for your workspace.

Frequently asked questions

What does Create a self-hosted blockchain payment processor with x402 and 1Shot API do?

This workflow contains community nodes that are only compatible with the self hosted version of n8n. Self Hosted x402 Facilitator In the [x402](https://x402.o...

What do I need before importing this workflow?

Review the workflow JSON, configure any required credentials in n8n, and test the automation in a safe workspace before using it in production.

Can I customize this workflow?

Yes. Use the block-by-block analysis and the downloadable JSON to inspect each node, then adjust credentials, prompts, schedules, filters, or destinations for your Crypto Trading, Multimodal AI use case.