Merchant guide

Getting Started with NodeRails Crypto Payments

This document walks through how merchants can onboard to the NodeRails platform, configure apps and wallets, enable settlements, create payment links, and manage payments, subscriptions, invoices, payouts, and disputes.

1

Access the Merchant Login and Create Your Account

Step 1 of 14

Guide screenshot 1

As a merchant, go to the NodeRails merchant login page.

Guide screenshot 2

From the login page, choose the option to sign up for a new account.

Guide screenshot 3
Guide screenshot 4

Enter your email address and create a secure password, then submit the form to create your account.

Guide screenshot 5

After clicking Create Account, complete the short verification and onboarding flow, which takes about 30 seconds.

Guide screenshot 6
Guide screenshot 9

Indicate whether you are signing up as an individual or a business.

2

Create Your First App (Testnet or Production)

Step 2 of 14

Guide screenshot 10

Next, create an app that will be used to accept payments (for example, your website or product).

Guide screenshot 11
Guide screenshot 12

If you are just testing the platform, create a test app in the sandbox environment. When you are ready to accept real payments, create a production app.

Guide screenshot 13

For this demo, select a test app and give it a name, such as “My Website.”

3

Connect Your Wallet for Settlements

Step 3 of 14

Guide screenshot 14

Configure where your funds will be settled by connecting your crypto wallet.

Guide screenshot 15
Guide screenshot 16

You can skip this step initially, but to actually receive funds when users pay you, the settled funds must be routed directly to your wallet. Connect your wallet, authorize its use with NodeRails, and sign in to verify ownership.

Guide screenshot 17

Once this is done, your basic setup is finished and you are ready to use the platform. NodeRails is non-custodial, so funds settle directly to your own wallet.

4

Explore the Organization-Level Dashboard

Step 4 of 14

Guide screenshot 18

Open the Overview section to view organization-level analytics and details.

Guide screenshot 19

Here you can see which tokens and networks customers are using to pay you, as well as active subscriptions across all of your apps. You can also create multiple apps - for example, one for your website, one for your mobile app, and another for tools or services - so you can accept payments across all of them.

Guide screenshot 20

You already created a test app during onboarding; you can later create a production app in the same way.

5

Configure Bank Settlement and Global Accounts

Step 5 of 14

Guide screenshot 21
Guide screenshot 24

From the banking/settlement section, you can either connect your own bank account or start a new bank account with NodeRails.

Guide screenshot 25

If you prefer to settle funds directly to your bank instead of your crypto wallet, connect your bank account, provide the required information, and complete KYC/KYB verification. Once approved, you can settle funds to your bank.

If you do not have a bank account or want to receive funds in global currencies, you can open global accounts (e.g., USD, EUR, BRL, GBP) with NodeRails at a rate of $30 per year. Funds settle to these accounts, convert to stablecoins, and then to your wallet.

6

Manage Your Organization, Team, and Tax Settings

Step 6 of 14

Guide screenshot 26
Guide screenshot 28

As an organization or individual merchant, you can add team members and define their permissions - controlling what they can monitor and access within your organization.

Guide screenshot 29
Guide screenshot 31

Similarly, configure tax rates (such as GST or VAT) based on the country in which you operate.

7

Review App-Level Analytics and Core Features

Step 7 of 14

Guide screenshot 32

Go to the Apps section to access app-level analytics and configuration.

Guide screenshot 33
Guide screenshot 35

For each app, you can track metrics such as monthly revenue, disputes, refunds, active subscriptions, and total payments. You will also find tools to:

  • Create payment links
  • Create subscriptions
  • Generate invoices and accept invoice payments directly
Guide screenshot 36

You can manage customers: whenever someone pays you, their wallet and activity are tracked automatically so you can analyze their behavior and history.

Guide screenshot 37

You can also create product plans (e.g., $10, $20, $30 plans) tailored to your use cases.

Guide screenshot 38
Guide screenshot 39

Additionally, you can track checkout sessions happening on your website and access a disputes section to monitor and respond to disputes.

8

Enable Networks and Tokens for Your App

Step 8 of 14

Guide screenshot 40
Guide screenshot 42

When you first create an app, you must enable the blockchain networks and tokens on which you want to accept payments.

Enable a network (for example, Ethereum Sepolia), then choose which tokens you will accept on that network.

Guide screenshot 43
Guide screenshot 46

You can enable all available tokens or selectively enable/disable them depending on your business needs.

Guide screenshot 47

These are app-level configurations. If you need per-payment configuration (e.g., only specific tokens or networks for a particular payment), you can do that via the NodeRails SDK. All operations visible in the dashboard are also available programmatically through the SDK.

Once your networks and tokens are configured, ensure the appropriate wallets are connected. If you are accepting payments on networks like Solana or Sui, connect those wallets as well.

9

Configure Payouts and Settlement Rules

Step 9 of 14

Guide screenshot 48

If you want to use NodeRails for payouts (e.g., global salary payments or sending funds to wallets or banks worldwide in stablecoins or crypto), configure the payout functionality.

One of the key settlement features is Convert to One Token. Enable this to accept any cryptocurrency while automatically settling into a chosen stablecoin.

Guide screenshot 49
Guide screenshot 51

With this feature enabled, customers can pay with any supported token (e.g., Bitcoin, Ethereum), and NodeRails converts the payment to stablecoins at payment time, shielding you from crypto price volatility.

Guide screenshot 52
Guide screenshot 55

After enabling token conversion, you can also enable Settle to One Chain.

Guide screenshot 56
Guide screenshot 59

This lets you settle all funds to your wallet on a single blockchain instead of receiving them across multiple chains (such as Ethereum, Solana, Sui, or X Layer). NodeRails handles all bridging and swapping.

Choose which chain you want to settle on and which token you want to settle into.

Guide screenshot 60
Guide screenshot 61

Once selected, your settlement configuration is complete.

Guide screenshot 62
Guide screenshot 63

You can also configure payouts to bank accounts. Before using bank payouts, you must connect your bank account. For this demo, close the banking view and proceed to the Payment Links section.

10

Create a Payment Link

Step 10 of 14

Guide screenshot 64

To create a new payment link, open the Payment Links section.

Guide screenshot 65

Name the payment link (for example, “Pro Payment Link for My Web App”).

Guide screenshot 66
Guide screenshot 68

Optionally, select an existing product plan. If you do not have product plans configured, you can simply specify the amount directly (e.g., 1 USD).

Guide screenshot 69

Add a description for the payment link. You can also configure success and cancel URLs to redirect users after payment. If you have set up tax rates, you can select the applicable tax rate here.

Guide screenshot 70
Guide screenshot 73

Optionally, require billing details from the payer and configure which networks and tokens will be accepted for this specific payment link.

Guide screenshot 74

Once everything is configured, click Create Link.

Guide screenshot 75

A payment link URL will be generated, which you can share with your customers. This link opens the checkout page they will use to pay.

11

Understand the Customer Checkout Experience

Step 11 of 14

Guide screenshot 76
Guide screenshot 79

On the checkout page, customers can choose the network they want to use for payment and select the token with which they want to pay.

Guide screenshot 80
Guide screenshot 82

They can also choose their preferred currency, and NodeRails automatically handles currency conversion.

Guide screenshot 83

In just a few clicks, customers connect their wallets seamlessly.

Guide screenshot 84
Guide screenshot 87

They then provide their email address and billing information and proceed to authorize the payment.

Guide screenshot 88

NodeRails divides the payment lifecycle into three states:

  1. Authorize - The user authorizes spending from their wallet, but funds are not yet deducted.
  2. Capture - Funds are taken from the user’s wallet and are now held for you; you can safely deliver goods or services.
  3. Settle - Funds are moved from the TimeLock escrow to your wallet.

Authorization is a gasless transaction: the user only needs the token they are paying with and does not incur extra gas fees for the authorization itself.

Guide screenshot 89

After authorization, the user clicks the Pay button to complete the transaction.

Within a few seconds, the transaction is processed and the payment is marked as successful.

12

Track Payments and Process Refunds

Step 12 of 14

Guide screenshot 90

Return to your dashboard and open the Payments section to view details of the transaction.

Guide screenshot 91
Guide screenshot 92

Here you can see all payment details: who the user was, when the payment was authorized, when it was captured, the payment source, and the transaction hash.

Guide screenshot 93

From this view, you can issue refunds - something many other platforms do not support at this level of control.

Guide screenshot 94
Guide screenshot 96

You can refund the full amount, a percentage of the amount, or a specific partial amount, depending on your needs.

13

Manage Subscriptions, Invoices, and Payouts

Step 13 of 14

Guide screenshot 97
Guide screenshot 98

You can configure subscriptions to support recurring billing. Create product plans and set billing frequencies such as weekly, monthly, or yearly.

Guide screenshot 99
Guide screenshot 100

Similarly, you can generate invoices, send them via email, and have customers pay directly through the invoice. Payments settle directly to your wallet.

Guide screenshot 101
Guide screenshot 104

You can also configure payouts to global wallets or bank accounts and manage recipients for these payouts.

14

Customer Receipts and Dispute Handling

Step 14 of 14

Guide screenshot 105
Guide screenshot 106

Every customer who pays on your platform receives a payment receipt from NodeRails.

Guide screenshot 107
Guide screenshot 108

They also receive a system-generated PDF document containing all necessary details, which can be used for visa applications, tax filings, or other official purposes.

Guide screenshot 109

Customers can open disputes if there is an issue with a payment. NodeRails provides robust fraud and chargeback support, handling the dispute process for both merchants and users.

This concludes the overview of using NodeRails as a crypto payments infrastructure for merchants.