tgpay cryptoAPI

商户 API(开发者)

商户 API:应用、账单、转账和 webhook。

1

商户 API 是什么?

商户 API 是本应用给商家和机器人用的支付 API。您创建一个应用,拿到一个 API 令牌,就能用 它向 Telegram 用户收款、给他们打款、查自己的余额——全部在您自己的代码里完成。

阅读约 1 分钟
2

开发者上手

在 Mini App 里创建一个应用,把它的 API 令牌复制下来(只有这一次机会),然后就能开始调 API 了。整套设置都在更多 → 商户 API里。

阅读约 1 分钟
3

接入 AI 智能体

把一个 URL——https://app.tgpaycrypto.com/mcp——交给您的 AI 编程智能体,支付集成它就替您 做了:它自己读 API 文档、创建您的商户应用、配好 webhook 并且把代码写出来。您只需要在机器人 里按一个按钮,为新应用授权一次。不用开终端,也不用手抄 API 令牌。

阅读约 1 分钟
4

用账单收款

账单是您向 Telegram 用户收钱的方式。您通过 API 开一张,把链接发给付款人,他一确认,您的应用 余额当即入账。

阅读约 1 分钟
5

商户 API 的费用和限额

账单要收一笔平台手续费,从您到手的那部分里出;转账和红包则受金额上下限的约束。下面这些数字是 当前的设置,不是合同条款——跟您在应用里看到的对不上时,以应用为准,而最靠得住的依据永远是 您自己那些已付账单。

阅读约 1 分钟
6

商户 API 参考

所有方法共用的约定,外加那几个只读的目录类方法。逐个方法的页面: 账单和退款、转账和红包、 订阅、webhook。

阅读约 2 分钟
7

API 参考:账单和退款

账单相关的方法:createInvoice、getInvoices、deleteInvoice、refundInvoice。通用约定 (鉴权、外层结构、金额、spend_id)见商户 API 参考页面; 手把手的走一遍在用账单收款。

阅读约 2 分钟
8

API 参考:转账和红包

打款相关的方法。转账把资金从您的应用余额直接送进某位 Telegram 用户的钱包;红包是一条 您先出钱、别人来领的链接。通用约定(鉴权、外层结构、金额、spend_id)见 商户 API 参考页面。

阅读约 1 分钟
9

API 参考:订阅

周期性扣款——相对 Crypto Bot 的扩展。您建一个套餐(金额 + 周期),把它的授权链接发给 用户,之后平台每一期从他们的钱包余额里扣款,扣掉手续费之后给您的应用余额入账。通用约定见 商户 API 参考页面。

阅读约 1 分钟
10

API 参考:webhook

事件一发生,webhook 就把它推到您的服务器。在更多 → 商户 API里给您的应用设好 Webhook URL;此后您订阅的每一个事件,平台都会 POST 一段带签名的 JSON。

阅读约 1 分钟
在“商户 API(开发者)”里没找到答案?客服在 Telegram 上,什么时候问都有人回。
联系客服