Skip to main content

Setup Guide

Welcome to the setup tutorial! This guide will help you configure your account!

1. Choosing Cryptocurrencies and Networks​

info

By default, only coins are enabled as they do not require a fee wallet to cover blockchain fees. (Blockchain transfer fees are paid directly by deducting a small portion of the transferred amount).
These fees are unrelated to SwayCoin.io and are set by the blockchain.

You can enable or disable any cryptocurrency or network as you wish within the crypto selection page.

On this page, you can:

  • Choose the cryptocurrencies you want to receive.
  • Select which networks you want to accept for each cryptocurrency.

Important note on tokens:​

⚠️ Warning: Tokens require a fee wallet to cover transaction fees. You can fund your fee wallet when prompted here. You don’t need to fund this wallet unless requested on your dashboard.

  • If you want to accept tokens (e.g., USDT, Chainlink), you must deposit native coins (ETH, BNB, etc.) into your fee wallet when prompted on your dashboard.
  • If you only accept coins (e.g., BTC, ETH, BNB), you don’t need to deposit funds into the fee wallet.
  • By default, only coins are enabled, as they don’t require additional fees for transfers.

Real Example​

  • To withdraw 0.5 ETH (coins) received from your clients, a small portion (e.g., 0.0001 ETH) will be used to cover the transfer fee, sending 0.4999 ETH to your wallet. This process does not use the fee wallet.
  • To withdraw 50 USDT (tokens), some ETH from the fee wallet will be used to cover the 0.0001 ETH transaction fee, sending 50 USDT to your wallet. This process requires the fee wallet.

None of theses fees are taken by SwayCoin.io, theses are only blockchain ones.

note

As you're reading this guide, we are in beta, and we understand this process is a bit inconvenient...
We're working on covering these token blockchain fees for you and eliminating the fee wallet in future updates.
We will update this guide and make an announcement when it will be the case

Blockchain Fees Explained Simply
FeatureCoinsTokens
DefinitionNative coin of a blockchainBuilt on top of an existing blockchain
ExamplesBTC, ETH, BNBUSDT (ERC-20), USDT (BEP-20)
Network DependencyIndependent (fees are paid using a portion of the coin)Requires a native coin for transfers (ETH for ERC-20 & BNB for BEP-20)
Fee Wallet RequirementNoYes (needs ETH, BNB, etc.) for blockchain fees

2. Configuring Your Payout Addresses​

For each supported network (Ethereum, Sepolia, BSC, etc.), you can set your payout wallet address here. When a client completes a payment, a withdrawal request is automatically created and sent to the registered address.

note

If you don’t have a payout address yet, you can add it later. The withdrawal will remain pending until a destination address is provided.

How to add a payout address:​

  1. Open the Payout Addresses page.
  2. Enter your wallet address for each network.
  3. Save your settings.
info

Withdrawals are automatically queued once your client has sent the required amount of crypto.

3. Integrating Webhooks​

Webhooks enable your server to receive real-time notifications about your payments. While optional, they are very useful if you need to know immediately when a client has paid or canceled an invoice.

This process may require a developer, but can be done by yourself if you have some knowledge regarding servers and coding basics.

Generate a Webhook URL​

  1. Set up an endpoint on your server (e.g., https://yourdomain.com/random-webhook-url).
  2. Ensure the endpoint accepts POST requests.
  3. Register your webhook URL on the Webhook Settings page.
  4. Secure your webhook with the Webhook Token from your dashboard.
  5. You can test your webhook using the Test Webhook button.
tip

We provide the webhook code, and you can find Code Examples & Real Integrations to use in your webhook file.

Verify Everything is Working​

  1. Create a Test Payment using faucets ("fake cryptocurrencies") to verify everything is working.
  2. Ensure the ALLOW_TEST_PAYMENT variable is set to true in your webhook file (php/js) during the test.
  3. Once the payment is confirmed, you should receive the webhook notification.
  4. From there, you can customize the webhook code to fit your requirements (e.g., insert payment status into your database, send a product, join a Telegram channel, etc.)

Webhook Documentation​

You can find the official SwayCoin.io webhook documentation here.

Guide Completed​

info

You're all set! 😊​

We'll keep this guide updated as new features are added.