XPayLabs: Self-Hosted Crypto Payment Infrastructure

XPayLabs is a self-hosted, non-custodial crypto payment infrastructure. Deploy on your own servers to accept stablecoin payments across TRON, EVM chains, and SUI with zero gateway fees.

XPayLabs is a self-hosted crypto payment infrastructure that lets you accept and manage stablecoin payments across multiple blockchains through a single API. Unlike hosted payment gateways, XPayLabs runs entirely on your infrastructure — your private keys stay on your servers, your funds go directly to your wallets, and you pay zero gateway fees.

Quick Start

Deploy your payment gateway and create your first collection in minutes

Authentication

Generate API tokens and sign your requests securely

API Reference

Explore every endpoint, parameter, and response field

Guides

Step-by-step walkthroughs for collection and payout flows

Supported Blockchains

XPayLabs natively supports the following blockchain networks:

Chain	Type	Stablecoins
TRON	TRC20	USDT, USDC
Ethereum	ERC20	USDT, USDC, DAI
BNB Chain	BEP20	USDT, USDC, BUSD
Polygon	ERC20	USDT, USDC, DAI
Avalanche C-Chain	ERC20	USDT, USDC
SUI	Native	USDC

How It Works

1. Deploy the gateway

   Run docker compose up -d on your server. The XPayLabs core container starts all services — API server, blockchain scanners, webhook dispatcher, and the checkout UI.

2. Generate API credentials

   Configure your merchant token in the gateway dashboard. This token is used to sign every API request with HMAC-SHA256.

3. Create a collection

   Send a POST /v1/order/createCollection request with amount, symbol, and chain. XPayLabs returns a unique deposit address and checkout URL.

4. Listen for webhooks

   Register your callback URL. When the blockchain scanner detects the incoming transaction, XPayLabs delivers a signed webhook notification.

Key Concepts

Concept	Description
Collection	A request for payment that generates a unique deposit address
Payout	A funds transfer from your gateway wallet to an external address
Settlement	Automatic sweep of received funds from hot wallets to your cold storage
Webhook	An HTTP callback triggered by order or collection status changes
Scanner	A blockchain indexer that monitors incoming transactions in real-time

Since XPayLabs is self-hosted, you have complete control over your funds. No third party holds your private keys, and no gateway fees are deducted from your transactions — you only pay blockchain network gas fees.