Skip to main content

Documentation Index

Fetch the complete documentation index at: https://neilyan.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

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:
ChainTypeStablecoins
TRONTRC20USDT, USDC
EthereumERC20USDT, USDC, DAI
BNB ChainBEP20USDT, USDC, BUSD
PolygonERC20USDT, USDC, DAI
Avalanche C-ChainERC20USDT, USDC
SUINativeUSDC

​
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

ConceptDescription
CollectionA request for payment that generates a unique deposit address
PayoutA funds transfer from your gateway wallet to an external address
SettlementAutomatic sweep of received funds from hot wallets to your cold storage
WebhookAn HTTP callback triggered by order or collection status changes
ScannerA 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.