Introduction
This guide builds upon our previous tutorial on installing TokenPay, focusing on seamless integration with EasyPay to accept cryptocurrencies like USDC, BNB, and ETH. For foundational setup steps, refer to our earlier installation guide.
👉 Discover advanced payment integrations
Step-by-Step Integration Process
1. TokenPay Plugin Installation for EasyPay
TokenPay supports multiple platforms via plugins, including:
- Card-system
-独角数卡 (Dujiao Digital Card)
-彩虹易支付 (Rainbow EasyPay) - V2board
Procedure:
- Download the
epayplugin directory from the TokenPay GitHub repository. - Upload all files to your EasyPay installation directory, preserving folder structures (especially
/plugins).
2. Database Configuration
Execute these SQL commands via phpMyAdmin:
ALTER TABLE `pay_plugin`
MODIFY COLUMN `types` varchar(4096) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL AFTER `link`;
INSERT INTO `pay_type` (`name`, `device`, `showname`, `status`) VALUES
('TRX', 0, 'TRX', 1),
('USDT_TRC20', 0, 'USDT-TRC20', 1),
('EVM_ETH_ETH', 0, 'ETH', 1),
('EVM_ETH_USDT_ERC20', 0, 'USDT-ERC20', 1),
('EVM_ETH_USDC_ERC20', 0, 'USDC-ERC20', 1),
('EVM_BSC_BNB', 0, 'BNB', 1),
('EVM_BSC_USDT_BEP20', 0, 'USDT-BEP20', 1),
('EVM_BSC_USDC_BEP20', 0, 'USDC-BEP20', 1),
('EVM_Polygon_MATIC', 0, 'MATIC', 1),
('EVM_Polygon_USDT_ERC20', 0, 'USDT-Polygon', 1),
('EVM_Polygon_USDC_ERC20', 0, 'USDC-Polygon', 1);3. Enabling EVM Chains
Edit EVMChains.json to activate desired payment methods:
{
"EVMChains": [
{
"Enable": true,
"ChainName": "Ethereum",
"ChainNameEN": "ETH",
"BaseCoin": "ETH",
"ApiKey": "YOUR_ETHERSCAN_API_KEY",
"ERC20": [
{
"Name": "USDT",
"ContractAddress": "0xdAC17F958D2ee523a2206206994597C13D831ec7"
},
{
"Name": "USDC",
"ContractAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
}
]
},
{
"Enable": true,
"ChainName": "Binance Smart Chain",
"ChainNameEN": "BSC",
"BaseCoin": "BNB",
"ApiKey": "YOUR_BSCSCAN_API_KEY",
"ERC20": [
{
"Name": "USDT",
"ContractAddress": "0x55d398326f99059ff775485246999027b3197955"
},
{
"Name": "USDC",
"ContractAddress": "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d"
}
]
}
]
}Key Requirements:
- API keys from Etherscan, BscScan, or PolygonScan
- Valid Ethereum wallet address in
appsettings.json
👉 Get started with multi-chain payments
Final Configuration Steps
- Restart TokenPay's daemon process
- Add activated payment methods in EasyPay admin panel
- Test transactions for each enabled cryptocurrency
FAQ Section
Q1: Why isn't TokenPay showing in my EasyPay plugins list?
A1: Ensure you've correctly uploaded plugin files and executed all SQL commands. Refresh your browser cache if needed.
Q2: How do I obtain blockchain API keys?
A2: Register on the respective blockchain explorer (Etherscan/BscScan) and generate keys in the API section of your account.
Q3: Can I use multiple EVM chains simultaneously?
A3: Yes! Enable multiple chains in EVMChains.json and configure each with valid API keys.
Q4: What's the transaction confirmation time?
A4: Varies by network: ETH (2-5 mins), BSC (~15 secs), Polygon (~2 secs).
Q5: Are there minimum deposit amounts?
A5: Yes, each token has network-specific minimums to cover gas fees.
Conclusion
This integration empowers merchants with decentralized payment options while maintaining EasyPay's user-friendly interface. For optimal performance, regularly update TokenPay plugins and monitor blockchain API rate limits.