OpenViSTAI · Agents · Blockchain · Crypto
Submit a project
Menu
Payments & Stablecoins

Xcash

Xcash is an open-source, self-hosted cryptocurrency payment gateway for merchant invoices and user top-ups. Its Python/Django service tracks payments and sends notifications, while smart contracts route receipts to a configured merchant wallet.

Explore the practical guide ↓

Independent OpenViST project profile, based on linked sources.

Xcash — OpenViST project profile in Payments & Stablecoins.
OpenViST project illustration. See the linked sources for product details.
Understand the project

Practical overview

When it fits

Use Xcash when you need to operate your own gateway for EVM-token or Tron USDT payments and can manage server deployment, RPC access, wallet configuration and integration.

Who it is for

  • Merchants accepting token payments for ecommerce orders or subscriptions.
  • Platforms that credit user balances from dedicated cryptocurrency deposit addresses.
  • Developers integrating crypto billing through a REST API or EasyPay V1-compatible system.

Documented uses

  • Create fixed-amount, time-limited payment invoices.
  • Assign dedicated deposit addresses and credit top-ups after blockchain confirmation.
  • Match incoming transactions to bills, track confirmations and notify connected systems.
  • Connect payment events to an existing service using API calls and webhooks.
Before you choose

Requirements & limits

The primary service is self-hosted. The repository describes Docker Compose deployment on a Linux server and identifies the software as MIT-licensed and open source. A separate cloud service is mentioned, but its terms are not covered here.

  • The invoice and top-up workflows serve different needs: time-limited fixed bills versus reusable user deposit addresses.
  • EVM chains accept ERC-20 tokens; Tron support is specified for USDT and native TRX, not other TRC-20 assets.
  • Operators configure RPC endpoints and fund the system wallet with gas; Tron requires a TronGrid API key.
  • The API uses HMAC-SHA256 authentication, and documented webhooks retry events with nonce-based deduplication.
  • The system’s smart-contract routing and automatic collection behavior depend on correct wallet and chain configuration.

Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.

Source-based practical guide

Deploy the Xcash gateway with Docker Compose

Start the self-hosted service and configure its initial administrative access.

Before you start

  • Linux server with Docker
  • A domain name pointed to the server
  • Reverse proxy configured to forward traffic and provide TLS

Steps

  1. Clone the Xcash repository and enter its directory.

  2. Run ./scripts/init_env.sh to create .env and generate random secrets.

  3. Set SITE_DOMAIN in .env to the deployment domain.

  4. Run the command below.

    Documented command
    docker compose up -d

  5. Store the generated administrator password from the script output or .env in a password manager.

Expected outcome

The Docker Compose service is started, with an initial administrator account and domain setting configured.

Guide limitations

  • This setup does not complete chain or payment configuration; RPC endpoints, gas funding, project settings and API integration are subsequent stages.
  • The repository describes a reverse-proxy and TLS requirement; this guide does not establish that deployment or connectivity has been tested.
Documentation 1 ↗
Evidence and transparency

Sources & review

Official repository ↗
Source record details
Source availability
Active
Sources checked
6 October 2026
Original website title
xca-sh/xcash · Official homepage title · retained in its source language
How we review sourcesSuggest a correction