TokenPay对接易支付：开通USDC、BNB与ETH加密货币收款

·

在数字支付日益普及的今天，支持多种加密货币收款已成为提升业务竞争力的关键。TokenPay作为一款开源支付网关，能够帮助商户轻松集成TRX、USDT、ETH等主流数字货币支付功能。本文将详细介绍如何将TokenPay对接到易支付系统，并成功开通USDC、BNB及ETH等加密货币的收款服务。

准备工作

在开始对接之前，请确保您已经完成了TokenPay的基础安装。如果尚未安装，请参考相关安装指南进行部署。TokenPay支持多种常见支付程序，包括Card-system、独角数卡、彩虹易支付以及v2board等。本文将以易支付为例，演示完整的插件安装与配置流程。

易支付插件安装步骤

获取插件文件

首先，从TokenPay的官方GitHub仓库下载最新版本的源码。在源码的Plugs目录下，找到名为epay的文件夹，该文件夹内包含易支付插件所需的全部文件。

上传文件到易支付

将epay目录中的所有文件及文件夹上传到您的易支付安装目录。请注意，plugins文件夹需要整体上传，并覆盖目标目录中的现有内容。

数据库配置

登录phpMyAdmin管理工具，选择易支付所使用的数据库。在SQL执行界面，依次运行以下两条命令：

第一条命令用于修改数据表结构：

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);

执行完成后，刷新易支付后台的插件列表，即可看到TokenPay插件已成功安装。

配置TokenPay支持多链加密货币

编辑EVMChains配置文件

要启用ETH、BNB等加密货币收款，需要修改TokenPay安装目录下的EVMChains.json文件。该文件包含了多条区块链网络的配置信息，默认情况下所有网络均处于关闭状态。

以下是主要网络的配置说明：

以太坊网络(ETH)配置：

{
  "Enable": true,
  "ChainName": "以太坊",
  "ChainNameEN": "ETH",
  "BaseCoin": "ETH",
  "Decimals": 18,
  "ScanHost": "https://etherscan.io",
  "ApiHost": "https://api.etherscan.io",
  "ApiKey": "您的API密钥",
  "ERC20Name": "ERC20",
  "ERC20": [
    {
      "Name": "USDT",
      "ContractAddress": "0xdAC17F958D2ee523a2206206994597C13D831ec7"
    },
    {
      "Name": "USDC",
      "ContractAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
    }
  ]
}

币安智能链(BSC)配置：

{
  "Enable": true,
  "ChainName": "币安智能链",
  "ChainNameEN": "BSC",
  "BaseCoin": "BNB",
  "Decimals": 18,
  "ScanHost": "https://www.bscscan.com",
  "ApiHost": "https://api.bscscan.com",
  "ApiKey": "您的API密钥",
  "ERC20Name": "BEP20",
  "ERC20": [
    {
      "Name": "USDT",
      "ContractAddress": "0x55d398326f99059ff775485246999027b3197955"
    },
    {
      "Name": "USDC",
      "ContractAddress": "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d"
    }
  ]
}

Polygon网络配置：

{
  "Enable": true,
  "ChainName": "Polygon",
  "ChainNameEN": "Polygon",
  "BaseCoin": "MATIC",
  "Decimals": 18,
  "ScanHost": "https://polygonscan.com",
  "ApiHost": "https://api.polygonscan.com",
  "ApiKey": "您的API密钥",
  "ERC20Name": "ERC20",
  "ERC20": [
    {
      "Name": "USDT",
      "ContractAddress": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F"
    },
    {
      "Name": "USDC",
      "ContractAddress": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174"
    }
  ]
}

申请API密钥

每个区块链网络都需要相应的API密钥：

将获取到的API密钥填写到对应网络的ApiKey字段中。

配置钱包地址

编辑根目录下的appsettings.json文件，找到"EVM"配置项，在其中填入您的ETH钱包地址。这将作为接收加密货币款项的主要地址。

重启守护进程

完成所有配置后，建议重启TokenPay的守护进程以确保所有更改生效：

systemctl restart tokenpay

或者使用您最初安装时设置的进程管理命令。

易支付后台设置

回到易支付后台，在支付方式设置中添加已配置好的加密货币支付类型。现在您的系统已经可以接受USDC、BNB、ETH等多种数字货币付款了。

👉 获取更多加密货币支付集成方案

常见问题

TokenPay支持哪些加密货币？

TokenPay支持多种主流加密货币，包括TRX、USDT（TRC20、ERC20、BEP20等多种协议）、ETH、BNB、USDC以及MATIC等。用户可以根据实际需求选择开启相应的支付方式。

为什么需要申请区块链浏览器的API密钥？

API密钥用于访问区块链网络的数据，包括查询交易状态、获取账户余额等重要信息。这是TokenPay能够正常处理加密货币支付的基础保障。

配置完成后无法正常收款怎么办？

首先检查所有配置步骤是否正确完成，特别是API密钥和钱包地址的填写。确保守护进程已重启，并且服务器网络能够正常访问各区块链网络的API接口。如问题仍存在，建议查看TokenPay的日志文件以获取详细错误信息。

如何确保加密货币支付的安全性？

建议采取以下安全措施：使用硬件钱包存储大量加密货币、定期更新系统和软件补丁、设置网络防火墙限制不必要的访问、监控异常交易活动，并保持私钥的绝对安全。

TokenPay是否支持其他支付程序？

是的，TokenPay除了支持易支付外，还提供对Card-system、独角数卡、v2board等多种程序的插件支持。您可以在TokenPay的GitHub仓库中找到所有支持的插件列表及安装说明。

通过以上步骤，您应该已经成功将TokenPay对接到易支付系统，并开通了多种加密货币收款功能。这将为您的业务带来更广泛的支付选择和更便捷的跨境收款体验。