GetMyBot 知识库

收款与余额

通过机器人收款并在付款后开通服务:连接收款账户、查看状态与退款,以及单独支付平台费用。

本页内容

要通过机器人销售商品或服务,请连接您在支付服务商处的账户,本文称为收款账户。机器人创建账单,客户付款后,付款成功反应可开通服务或确认订单。

控制台中有两种不同的付款:

  • 机器人向客户收款:机器人向订阅者开账单,款项直接进入您的账户。本文主要介绍此流程。
  • 平台请求余额:您为 GetMyBot 自身运行支付的费用,见本文最后几节。

什么是收款账户

这里的收款账户,是指连接到机器人的支付服务商账户。您在服务商控制台取得凭据,填入 GetMyBot;机器人使用您的密钥开账单。

钱进入您在支付服务商处的商户账户。GetMyBot 不收取或保管这些款项,也不按交易额抽成。平台只向支付服务请求创建账单,并接收付款通知以启动反应。

因此:

  • 合同、手续费、提款、审核和限额属于您与支付服务商之间的关系;
  • 密钥加密存储,之后不会重新显示。再次打开设置时密钥字段为空;保持空白表示沿用原密钥;
  • 退款也是您的商户操作,平台只是用您的密钥调用服务商 API。

一个机器人可以连接多个收款账户,例如分别收取卢布和外币。可将其中一个设为默认收款账户,供未明确指定账户的账单使用。

能否收款取决于套餐。如果当前套餐不包含此功能,“收款账户”页面会提示,开具账单动作也不会创建账单。

连接收款账户

  1. 打开收款账户区域。付款日志右上角也有入口。
  2. 点击连接收款账户并选择服务商。各服务商需要的字段不同,表单会随之调整。
  3. 填写账户名称和凭据。名称只供您自己在列表中区分账户。
  4. 如果机器人主要用此账户收款,开启默认收款账户。
  5. 保存后,账户卡片会显示 Callback URL,即服务商发送付款通知的地址。
  6. 复制此地址,在服务商控制台填为通知地址;不同系统可能称为 webhook、Result URL 或 notification URL。
  7. 点击检查连接。系统检查凭据是否填写且被服务商接受。显示“连接正常”后即可开账单。

务必在服务商处填写 Callback URL。若没有设置,服务商可能已经扣款,GetMyBot 却收不到消息:账单仍显示“等待付款”,付款反应也不会启动。

账户卡片上的开关可暂时停用账户,保留凭据。删除账户不会删除已有付款记录,日志仍会保存。

支付服务商

以下列出各服务商需从其控制台取得的凭据。以连接表单中的实际字段为准,表单由服务商配置生成。

多个服务商要求填写税制,用于俄罗斯 54-FZ 收据。可选:一般税制、简化税制(收入)、简化税制(收入减支出)、单一推算所得税、统一农业税、专利税制。

MIXPLAT

  • 项目 ID:MIXPLAT 控制台的“项目”。
  • API 密钥:项目的“API 设置”,属于保密字段。
  • 支付方式:银行卡、手机支付、钱包或银行;默认银行卡。
  • 测试模式:不用真实款项测试流程。

货币:RUB、EUR、BYN、KZT、UAH。支持收据、全额及部分退款。

ЮKassa

  • 商店 ID:ЮKassa 控制台“设置 → 商店”。
  • 密钥:“设置 → API”,属于保密字段。

货币:RUB。支持收据、全额及部分退款。

Telegram Payments

这种收款方式不同于其他服务商。订阅者在 Telegram 聊天中收到内置账单,而非支付链接;Telegram 通过普通机器人更新确认付款,不向 Callback URL 发请求。因此无需在服务商处填写通知地址,{payment:url} 对它也为空。

  • 支付服务商令牌:在 BotFather 中依次打开 /mybots → 您的机器人 → Payments → 连接服务商(如 ЮKassa、Сбербанк),复制令牌。若只收 Telegram Stars,则无需该令牌。
  • 默认货币:RUB、USD、EUR 或 XTR(Telegram Stars)。未在账单中明确指定货币时使用。

GetMyBot 控制台不能为此类付款办理退款;普通付款须到所连接服务商的控制台操作。构建器也不会显示此方式的收据项目,因为收据由机器人连接的服务商生成。

Робокасса

  • 商店标识(MerchantLogin):Робокасса 控制台的商店设置。
  • Password1 与 Password2:两种不同密码。前者用于创建支付链接,后者用于验证付款通知,请勿填反。
  • 若开启测试模式,还需单独的一对测试密码。
  • 税制及测试模式开关。

货币:RUB。支持收据;退款须在 Робокасса 控制台办理,GetMyBot 控制台不能操作。

Продамус

  • 支付表单子域名:若表单位于 my-shop.payform.ru,填写 my-shop。
  • 支付表单密钥。

货币:RUB。支持收据,不能从 GetMyBot 控制台退款。

CloudPayments

  • Public ID:CloudPayments 控制台“设置 → API”。
  • API 密钥:同一位置,属于保密字段。
  • 税制。

货币:RUB、USD、EUR。支持收据、全额及部分退款。

Т-Касса

  • TerminalKey:Т-Касса 控制台“终端”。
  • 终端密码:保密字段。
  • 税制。

货币:RUB。支持收据、全额及部分退款。

Stripe

  • Secret key:Stripe Dashboard 的“Developers → API keys”,属于保密字段。
  • Signing secret:Stripe Dashboard 的“Developers → Webhooks”,选择对应端点,属于保密字段。

客户在 Stripe Checkout 页面付款。收到通知后,GetMyBot 会检查签名与发送时间;发送超过五分钟的通知会被拒绝,防止重放。

对于 JPY、KRW 等没有小数单位的货币,账单金额必须是整数。不能开具 199.90 日元账单,因为日元没有百分之一的单位。

货币:USD、EUR、GBP、JPY、AUD、CAD、CHF、CNY、HKD、SGD、SEK、NOK、DKK、PLN、CZK、KRW、INR、BRL、MXN、ZAR、TRY、AED、ILS、NZD、THB、IDR、PHP、VND、BHD、KWD。支持全额及部分退款。不提供俄罗斯 54-FZ 收据,因此不会显示收据项目设置。

Lava.top

  • 商店 ID(Shop ID):Lava.top 控制台“商店”。
  • API 密钥:同处“API 密钥”,属于保密字段。
  • Webhook 密钥:同处“Webhook”,用于签署付款通知,属于保密字段。

货币:USD、EUR、GBP。控制台不支持收据或退款;退款须在 Lava.top 控制台处理。

此账户也不支持查询付款状态。如果通知未送达,账单不会自动变成已付款:请到 Lava.top 控制台核对付款,并联系支持进行人工核对。

CryptoCloud

  • 商店 ID(Shop ID):CryptoCloud 控制台“商店”。
  • API 密钥:“API”,保密字段。
  • Postback 密钥:“商店 → Postback”,用于签署通知令牌,保密字段。

账单使用普通法定货币计价,买家在 CryptoCloud 页面选择支付用的加密货币。汇率由服务商在创建账单时确定。

通知虽有签名,但不能单凭通知认定付款。平台会重新向 CryptoCloud 查询账单,并以查询响应中的金额为准。少付不会结清账单:它仍为“等待付款”,付款反应不会触发;多付则视为已付款。

货币:USD、EUR、RUB。支持查询状态。不支持收据和退款;链上转账不可逆,退款只能另行转账给买家。

NOWPayments

  • API 密钥:NOWPayments 控制台“Settings → API keys”,保密字段。
  • IPN 密钥:“Settings → IPN”,用于签署通知,保密字段。

与 CryptoCloud 相同,账单按普通货币计价,付款人在 NOWPayments 页面选择加密货币。IPN 通知(含状态与金额)整体经过签名,因此无需再向服务商查询。

平台会在账单中直接向服务商提供通知地址,但账户设置中仍须开启 IPN 机制。

部分付款不会结清账单:收到的金额小于账单金额时,状态仍为“等待付款”。

货币:USD、EUR、RUB。支持查询状态,不支持收据和退款。

VK Pay

与 Telegram Payments 一样,它仅适用于自己的聊天渠道。用户在 VKontakte 对话中通过支付按钮收到账单,而非链接;确认付款通过社区普通事件送达,不请求 Callback URL。因此无需填写通知地址,{payment:url} 也为空。

  • VK 社区 ID(group_id):接收转账的社区数字 ID,不带负号。

若使用该账户的反应在 Telegram 或 WhatsApp 触发,则不会创建账单:只有 VKontakte 能显示 VK Pay 按钮。拒绝原因会显示在反应卡片的“账单”步骤。

货币:RUB。不支持收据、查询状态或从控制台退款;有争议的转账须在 VK Pay 控制台处理。

“付款 → 开通服务”流程

要在付款后开通服务,需创建两个反应:第一个开账单,第二个在付款确认后触发。两个事件之间可能间隔较久,买家也可能先关闭聊天,稍后再回来。

反应 1:开具账单

触发器可以是命令、文本或按钮点击。接着添加开具账单动作并设置:

  • 收款账户:选择具体账户或“默认收款账户”。
  • 金额:以货币主要单位填写,如卢布而非戈比。小数可用点或逗号(199.90)。也可用占位符或公式,例如 {user:cart_total}。
  • 货币:从所选账户支持的货币中选择,或用“账户默认货币”。
  • 说明:订阅者在支付页面看到的文字,支持占位符。
  • MyBot 本地账单有效期,秒:0 表示不在 MyBot 本地过期;否则填 300 至 2592000 的整数秒。此设置不会使服务商的支付链接失效。若服务商随后确认收到钱,账单仍会变成“已付款”。
  • 把链接保存到订阅者参数:可选,便于在另一个反应中提醒付款。
  • 收据项目:各项目的名称及以戈比计的金额。只有支持收据的账户才显示此区域。
  • 赠礼:收件人:可选,填写收礼订阅者的 tg_user_id 数字或占位符,例如 {user:gift_to}。若与付款人不同,账单视为赠礼。
  • 赠礼:留言:赠礼人写给收件人的文字,支持占位符,仅在赠礼账单中保存。

动作后添加包含支付链接的消息,在正文中插入 {payment:url};否则订阅者收不到链接。若已开账单但消息中没有此占位符,构建器会警告。Telegram Payments 和 VK Pay 使用内置账单按钮,链接本来就是空的。

还可使用 {payment:id}(MyBot 内部 ID)、{payment:provider_id}(服务商付款 ID,如 ЮKassa 的 payment_id)、{payment:order}(订单号)、{payment:amount}、{payment:currency}、{payment:description}、{payment:charge_kind}(one_off、initial 或 recurring)、{payment:plan}(订阅计划键)。赠礼时还可用 {payment:gift}(1/0)、{payment:gift.from_id}、{payment:gift.to_id}、{payment:gift.message}。在状态变化反应中,{payment:audience} 为 buyer 或 recipient。

反应 2:开通服务

创建独立反应并选择付款触发器。它的设置包括:

  • 付款状态:已付款、失败或已退款,默认为已付款。
  • 收款账户:仅匹配某个账户,或匹配全部账户。
  • 最低金额,戈比:排除小额账单;比较的是账单金额,此处以戈比填写。
  • 扣款类型:任意、单次、订阅首付款或自动续扣。“失败”加“自动续扣”对应续扣失败事件。
  • 订阅计划键:仅匹配特定订阅计划的付款。
  • 接收对象:默认“买家”,也可选“赠礼收件人”。收件人反应只在赠礼账单上触发;若收件人已给机器人发过消息,反应会送到其 Telegram 私聊。买家仍会独立收到面向买家的反应。

随后可用普通动作开通服务、加“已付款”标签、将订单写入集合、发送资料。消息中可使用同样的 {payment:...} 占位符,包括 {payment:status}、{payment:refunded}。

付款触发器也可处理退款:创建状态为“已退款”的反应,可在退款后自动撤销服务。

自动续扣订阅

订阅通过保存的支付方式定期收费。ЮKassa(save_payment_method)和 Stripe(setup_future_usage,将卡绑定至客户 customer 记录)完整支持自动续扣。

开通订阅

开通订阅动作会开第一张账单,并要求收款账户保存支付方式。设置账户、计划键(例如 premium)、金额、货币、周期(week、month 或 year)、说明,以及需要时的收据项目。首笔付款成功后订阅生效,下一次自动扣款安排在一个周期后。若账户没有返回已保存的支付方式,订阅以 method_not_saved 为原因取消;已经支付的首个周期仍有效。

第一张账单尚未付款时,重复执行动作会取消此前未付款账单并创建新账单。若同一计划键已有 active 或 past_due 状态的订阅,则不再开新账单。

自动扣款与失败尝试

周期结束时自动扣款。每次尝试在付款日志中都是一张单独账单,类型为 recurring。首次失败后状态为 past_due,一天后再试;第二次失败后三天再试。第三次失败后订阅变为 expired。失败尝试触发“付款 → 失败 + 自动续扣”反应,成功尝试触发“已付款 + 自动续扣”反应。

停止和更改条件

取消订阅动作可按计划键停止该订阅者的自动扣款,或停止其所有活跃计划。修改订阅从下一次扣款开始更改周期和/或金额。两种动作都可在付款反应中使用,例如退款后停止自动续扣;但不能在付款反应中执行开通订阅。

订阅占位符

反应可用 {subscription:id}、{subscription:plan}、{subscription:status}(none、pending、active、past_due、canceled、expired)、{subscription:period}、{subscription:amount}、{subscription:currency}、{subscription:period_end}、{subscription:next_charge_at}、{subscription:attempts} 及 {subscription:method}(经遮蔽的支付方式名称)。在付款反应外,它们引用该订阅者最新的 active 或 past_due 订阅;若不存在,状态为 none。

所有者也可通过 REST 和 MCP 访问订阅。通过 cancel_subscriber_subscription 停止订阅,不会退回已扣的款。

限时访问:按订阅加入私密社群

若访问权限应随已付款周期结束,可使用有期限的标签:

  1. 在付款反应中用修改标签添加“社群”标签,有效天数设为 30。随后发送私密聊天链接和申请加入的说明。
  2. 创建单独反应:系统事件 → 入群申请。加入具有“社群”标签条件,防止批准未付款用户,再执行修改权限 → 批准申请,明确填写私密聊天的 chat_id。机器人只能批准已经提交的申请;此反应针对申请者本人运行。
  3. 为系统事件 → 标签过期创建反应,用修改权限 → 移除成员,填写同一个 chat_id。反应运行时标签仍在;只有事件成功处理后才自动移除。动作失败则事件会重试,标签不会丢失。消息中可使用 {{event.label_name}}、{{event.expired_at}}。
  4. 到期前提醒可在给订阅者的消息中使用 {{label.社群.days_left}} 与 {{label.社群.expires_at}}。再次付款会从付款时起重新赋予 30 天标签。

同一流程也适用于 VK Donut(用订阅事件代替“付款”触发器,见渠道 → VK Donut),以及营销活动:先用延迟节点,再接动作 → 修改权限,明确指定 chat_id。

账单状态

状态显示在付款日志及付款详情中。

  • 已创建:本地账单已建立,服务商尚未反馈;通常只持续到支付链接生成前的几秒。
  • 等待付款:链接已发,订阅者尚未付款。
  • 已付款:资金已到,金额与货币都匹配账单。此时才触发付款反应。
  • 错误:付款失败,例如银行拒绝或银行卡验证失败。这不是最终状态;若服务商稍后确认付款,会转为“已付款”。
  • 已取消:付款被取消,不再变化。
  • 已过期:本地有效期已结束。若之后确实收到款,仍会转为“已付款”;实际到款总会记录。
  • 已退款:全额退还。
  • 部分退款:只退还一部分;以后还可退还余额,届时变为“已退款”。

同一状态的重复通知不会造成变化,因此不会重复开通服务。后到的通知也不能把已付款账单退回“等待付款”。

付款日志

付款区域列出机器人的全部账单,可按订单号搜索,并按状态及收款账户筛选。付款卡片还显示服务商付款 ID、赠礼字段和相关订阅链接(如适用)。

点击某行可查看金额、状态、账户、付款人、创建和付款时间、说明及事件日志。日志显示每次尝试改变状态的事件及类型:回调(服务商通知)、状态查询、人工核对、退款。发生问题时,请先看这里。

退款

支持从控制台退款的账户有 MIXPLAT、ЮKassa、CloudPayments、Т-Касса 和 Stripe。Робокасса、Продамус、Lava.top、VK Pay 和 Telegram Payments 须到相应服务商控制台办理。CryptoCloud 与 NOWPayments 完全不支持原交易退款:链上转账不可逆,只能另行转账给买家。

操作路径:付款 → 选择付款 → 在详情中点击办理退款。只有已付款账单且收款账户支持退款时才显示此按钮。系统会再次请求确认。

不必一次退全款。上述五家均支持部分退款,因此按钮旁会出现金额字段,默认是账单尚未退还的全部余额。您可退还较少金额,之后再退剩余部分,但不能超过未退余额。

服务商确认后,账单变成“已退款”;只退一部分则为“部分退款”。退款事件会写入付款事件日志。若配置了状态为“已退款”的付款触发器反应,也会运行。

税务收据

俄罗斯 54-FZ 收据由您的支付服务商生成,GetMyBot 不生成。平台只把开具账单动作中的项目及账户设置中的税制传递给它。

因此:

  • 各项目金额之和须与账单一致,否则服务商会拒绝账单;
  • 每项的增值税率须明确选择,默认“不含增值税”;未另设时数量为一;
  • 商品名称、税率及计税项目类型的正确性由您作为卖家负责。首次正式销售前,请在服务商控制台核对测试收据。

出现问题时

已扣款但反应未执行

打开付款卡片,查看状态和事件日志,再逐项检查:

  • 状态不是“已付款”:服务商未发确认或确认被拒绝。检查账户卡片上的 Callback URL 是否已填入服务商控制台,并查看付款事件。
  • 状态为“已付款”,却没有反应:检查付款触发器的账户和最低金额筛选。若反应只匹配另一账户,就不会运行。
  • 账单在聊天以外创建:若付款记录没有付款人,就无人接收反应。付款仍记录在日志中,但不会发送消息。
  • 套餐不含收款功能:这种情况下既不会开账单,付款事件也不会触发反应。
  • 订阅者没收到链接:消息中缺少 {payment:url}。检查开账单的反应文本;Telegram Payments 和 VK Pay 则使用渠道原生按钮。

要了解反应实际执行情况,打开用户或聊天中的订阅者对话。消息下方的卡片列出反应步骤;“账单”步骤既显示成功创建,也会显示失败原因,例如“账户不存在”或“不支持 USD”。

服务商不断重复发送通知

支付系统在获得确认前重复发送通知属于正常行为。重复通知是安全的:已应用的状态不会再次改变,也不会重复开通服务。

若重试一直不停,服务商可能收不到确认。常见原因是控制台中的通知地址错误,或签名不匹配,即账户密钥填错。签名不正确的通知会被整体拒绝,绝不会改变账单状态,防止伪造回调开通服务。

实付金额与账单不符

若服务商报告的金额与账单金额不同,账单不会标记为已付款,事件日志会记录拒绝。这是保护措施,避免少量付款开通昂贵商品。

请到服务商控制台核对金额。钱在您的账户中,接下来由您决定:向买家退款,或按正确金额另开账单。如果该付款确实有效且需要入账,请联系支持;人工核对是一项单独操作,会以“人工核对”记录到事件日志。

当前套餐不能使用收款账户

收款账户页面会提示更换套餐,连接按钮不可用。已连接账户不会被删除,但无法开账单,付款事件也不会启动反应。换到合适套餐后,可继续使用原有凭据。

平台余额与套餐

GetMyBot 的运行费用与买家的付款分开。消耗以请求计:运行反应时从账户余额扣除已执行动作的费用,至少计一个请求。详见统计与日志。

付款区域显示当前余额和可选套餐。各套餐有价格、请求额度及限额,例如机器人数量上限。点击选择启用套餐。

余额根据只能追加的收支记录计算,包括注册奖励、套餐发放、充值和使用扣减。历史记录不会改写,当前余额等于记录总和,便于核对。

充值会为所需请求额度创建付款。服务商确认后余额自动到账;重复通知不会重复入账。

接下来

共享余额与机器人钱包

共享余额和各机器人的独立钱包都属于同一控制台。没有独立钱包的机器人使用共享余额。在余额分配区域选择转出方与接收方,输入不超过可用余额的正数,并在预览中核对双方余额。此转账只分配已有余额,既不是充值,也不是提现。

推荐奖励与提现

在推荐计划区域复制邀请链接。日志按货币分别列出待释放和可用奖励、扣减及提现。申请提现时,选择有可用余额的货币,填写不超过余额的金额和付款信息。关注申请状态:待处理、已批准、已拒绝或已付款。获批本身不意味着款项已汇出。