商户 API
让自己的机器人也能收款
获取令牌，在代码中创建账单，通过 Webhook 接收付款通知。上线前可用测试网令牌跑通完整付款流程。
8 种币 · 16 个网络，共用一份余额 支持 MCP，AI 智能体可帮您完成接入 →
Webhook 已送达
测试网
步骤 1
获取令牌
在应用内创建商户应用，获取商户 API 令牌。
步骤 2
创建账单
一次 API 请求，提交金额、币种和说明。Webhook 地址在应用设置中配置。
步骤 3
展示付款链接
向用户提供链接或按钮，付款在 Telegram 中完成。
步骤 4
处理 Webhook
接收付款事件，验证后在您的服务中交付商品或开通权限。
AI 智能体
接入工作，也可交给 AI 智能体
商户 API 提供 MCP 服务器。把地址交给 AI 智能体，它即可阅读文档、创建应用、配置 Webhook 并编写代码。无需打开终端或手动复制令牌。
- 步骤 1
把提示词发给 AI 智能体
- 步骤 2
在 Telegram 中确认应用授权
- 步骤 3
AI 智能体完成后续配置
通用接入提示词
Connect the tgpay MCP server (https://app.tgpaycrypto.com/mcp) and integrate payments via the TgPay Merchant API.
功能
把收款接入自己的产品
通过请求创建账单，通过 Webhook 接收状态，其余业务流程由您决定。
令牌与测试网
使用独立的测试令牌，在向真实用户开放前验证付款流程。
用代码创建账单
普通 HTTP 请求即可创建、取消和查询账单，无需 SDK。
周期扣款
为产品开通订阅：用户首次授权后，商户 API 按周期自动扣款。
付款 Webhook
付款后触发事件，投递失败时自动重试，方便同步订单状态。
文档与示例
公开开发文档提供接口说明、错误码和可直接参考的请求示例。
8 种币 · 16 个网络，共用一份余额
GRAM
BTC
ETH
SOL
BNB
LTC
DOGE
TRX
USDTTRC-20 · ERC-20 · BEP-20 · TON · SOL
USDCERC-20 · BEP-20 · SOL
Earn
USDT
4%
前 500 USDT
1%
超过 500 的部分
GRAM
6%
前 300 GRAM
3%
超过 300 的部分
余额也能带来收益
将部分余额存入 Earn，自动计息，收益发放到钱包。随时存入或转出。
年利率
每小时计息
USDT
4%
前 500 USDT
1%
超过 500 的部分
GRAM
6%
前 300 GRAM
3%
超过 300 的部分
每天 00:30 UTC 发放到钱包
存入、转出均无手续费
地址一致
安全
发送前，先核对
提现会将资金转到外部地址。点按“确认”前后，钱包会进行以下检查。
- 确认之前
- 完整显示地址、网络和 Memo 不会省略成“4f3a…9c2b”：资金去往哪个地址、通过哪个网络，都能看清。
- 提现白名单 可自行开启，仅允许向预先保存的地址提现。
- PIN 码或 Face ID 每笔提现都需要确认，并非登录后只确认一次。
- 点按“确认”
- 确认之后
- 大额提现延迟发出 开启后，符合条件的大额提现会延迟发出。在“延迟中”状态下，仍可取消。
- 交易反洗钱检查 资金到达收款方之前，会先进行交易筛查。
- 每笔操作都有通知 如有非本人操作，您能及时收到通知。
使用条件
费用清楚，确认再付
确认前始终显示扣款金额，没有隐藏费用。
当前手续费和最低金额以应用内显示为准。完整列表见 帮助中心.
常见问题
常见问题
了解钱包、转账、Earn 和收款。
更多解答见 帮助中心
没有找到答案？请联系 @tgpayhelpbot
