付款與餘額
透過機器人收款並在付款後開放權限。連接收款帳戶、付款狀態、退款,以及平台費用的獨立支付方式。
本頁內容
若要透過機器人銷售,先連接自己的支付系統帳戶,這裡稱為收款帳戶。機器人會建立帳單,客戶付款後,付款成功的反應就能開放權限或確認訂單。
管理介面有兩種付款:
- 機器人向客戶收款:機器人向訂閱者開帳單,款項直接進入你的帳戶。本文大部分內容都在說明這種付款。
- 平台請求餘額:你為 GetMyBot 本身的服務支付的費用,見本文最後幾節。
什麼是收款帳戶
收款帳戶是已連接機器人的支付系統帳戶。你在供應商後台取得憑證,填入 GetMyBot,機器人就會用你的金鑰開立帳單。
款項進入你在支付系統的商戶帳戶。GetMyBot 不接收或保管這些款項,也不從交易額抽成。平台只是請支付服務建立帳單,並接收付款通知來觸發反應。
這表示:
- 契約、手續費、提領、審查及額度,取決於你和支付系統之間的關係。
- 密鑰會加密儲存,之後不再顯示。重新開啟設定時密鑰欄為空;保持空白表示沿用原值。
- 退款也是你的交易操作;平台只是用你的金鑰呼叫供應商 API。
機器人可連接多個收款帳戶,例如盧布與外幣帳戶。其中一個可設為預設收款帳戶,供未明確選擇帳戶的帳單使用。
能否收款取決於方案。若目前方案不包含此功能,「收款帳戶」頁面會提示,開立帳單動作也不會建立帳單。
如何連接收款帳戶
- 開啟收款帳戶區。付款紀錄右上角也有前往此區的收款帳戶按鈕。
- 按連接收款帳戶並選擇供應商。表單會依支付系統顯示不同欄位。
- 填寫帳戶名稱與憑證。名稱僅供自己在清單中辨識。
- 如果大多數帳單要由此帳戶處理,開啟預設收款帳戶。
- 儲存後,帳戶卡片會顯示 Callback URL,即供應商傳送付款通知的地址。
- 按複製,到供應商後台把地址設為通知地址。各系統可能稱它 webhook、Result URL、通知 URL 或 notification URL。
- 按檢查連線。系統會檢查憑證是否填齊、供應商是否接受。「連線正常」表示可開立帳單。
請務必在供應商端設定 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。支援收據,不支援從平台介面退款。
CloudPayments
- Public ID:CloudPayments 後台「設定 → API」。
- API 密鑰:同一頁,屬密鑰欄位。
- 稅制。
貨幣:RUB、USD、EUR。支援收據、全額及部分退款。
Т-Касса
- TerminalKey:Т-Касса 後台「終端」。
- 終端密碼:密鑰欄位。
- 稅制。
貨幣:RUB。支援收據、全額及部分退款。
Stripe
- 密鑰(Secret key):Stripe Dashboard 的「Developers → API keys」,屬密鑰欄位。
- Webhook 密鑰(Signing secret):Stripe Dashboard 的「Developers → Webhooks」,選定端點的密鑰欄位。
客戶在 Stripe Checkout 頁面付款。收到通知時,GetMyBot 會驗證簽章及傳送時間;超過五分鐘的通知會被拒,以防重複利用。
JPY、KRW 等沒有小數單位的貨幣,帳單金額必須是整數。例如 JPY 帳單不能填 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 通知,包括狀態和金額,都有簽章,因此不需再向供應商查詢。
平台會在帳單中直接提供通知地址,但必須先在 NOWPayments 帳戶設定中開啟 IPN。
部分付款不會結清帳單;收到的金額低於帳單時,狀態維持「等待付款」。
貨幣:USD、EUR、RUB。支援狀態查詢,不提供收據或退款。
VK Pay
和 Telegram Payments 一樣,此帳戶只能在所屬即時通訊平台使用。訂閱者會在 VK 對話中看到付款按鈕,而非連結;確認付款的是一般社群事件,不是對 Callback URL 的請求。因此無須設定通知地址,{payment:url} 也為空。
- VK 社群 ID(group_id):收款社群的數字 ID,不含負號。
如果使用此帳戶的反應在 Telegram 或 WhatsApp 觸發,便無法開立帳單,因為只有 VK 能顯示 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 停止訂閱,不會退回已扣款項。
限期權限:訂閱制私人俱樂部
若要讓權限隨已付款週期結束,可使用暫時標籤:
- 在付款觸發的反應中,新增修改標籤 → 加入「俱樂部」,將**期限(天)**設為 30。然後傳送私人聊天連結與申請加入的說明。
- 另建系統事件 → 申請加入反應。加入有「俱樂部」標籤條件,以免核准未付款者;再新增變更權限 → 核准申請,明確填入私人聊天的
chat_id。機器人只能核准已送出的申請,反應會針對申請者執行。 - 再建系統事件 → 標籤到期反應,以相同
chat_id執行變更權限 → 移除。反應執行期間標籤仍在,事件成功處理後才自動移除。若動作失敗,事件會重試,標籤不會遺失。訊息中可使用{{event.label_name}}與{{event.expired_at}}。 - 到期提醒可使用
{{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},請檢查開立帳單反應的文字。
若要查明反應內的狀況,請在使用者或聊天室中打開訂閱者對話。訊息下方的卡片會顯示反應步驟;「帳單」步驟會顯示成功或拒絕原因,例如「找不到收款帳戶」或「此帳戶不接受 USD」。
供應商持續重複通知
支付系統在收到確認前會重複通知,這是正常行為。重複通知是安全的:已套用的狀態不會再變,權限也不會重複開通。
如果重試一直不停,表示供應商沒有收到確認。常見原因是後台通知地址錯誤,或簽章不符(收款帳戶金鑰填錯)。簽章錯誤的通知會整筆遭拒,絕不改變帳單狀態,以防偽造回呼開通權限。
付款金額與帳單不同
若供應商回報金額與帳單不符,帳單不會標記為已付款,事件紀錄會顯示拒絕。這是保護機制,避免小額付款取得高價商品權限。
先到供應商後台核對金額。款項由你持有,後續由你決定退款或按正確金額重新開帳單。若付款確實正確並需要入帳,請聯絡支援;人工對帳是一項獨立操作,會記在事件紀錄中。
目前方案無法使用收款帳戶
「收款帳戶」頁面會提示可前往方案頁,連接按鈕不可用。既有帳戶不會刪除,但不能開立新帳單,付款事件也不會觸發反應。升級到合適方案後,可沿用原有憑證。
平台餘額與方案
GetMyBot 服務費與客戶向你支付的款項分開計算。用量以請求衡量:反應執行時,會依實際動作從帳戶餘額扣除費用,但至少扣一個請求。詳見統計與日誌。
付款區顯示目前餘額與可選方案。方案列出價格、請求額度和限制,例如機器人數上限。按選擇即可啟用方案。
餘額依不可變的入帳與扣款紀錄計算,包括註冊獎勵、方案額度、加值及用量。紀錄只會新增,因此可隨時核對歷史;目前餘額就是紀錄總和。
加值會為所需請求額度建立付款。供應商確認後,餘額自動入帳;重複通知不會重複入帳。
下一步
共用餘額與機器人錢包
共用餘額與個別機器人錢包都屬於同一管理帳戶。沒有獨立錢包的機器人使用共用餘額。在餘額分配區選擇來源與收款方,輸入不超過可用餘額的正數金額,並在預覽中核對雙方餘額。轉移只是重新分配現有餘額,不是加值或提領。
推薦獎勵與提領
在推薦計畫區複製邀請客戶的連結。紀錄會按貨幣分別列出保留中及可用獎勵、扣款與提領。申請提領時,選擇有可用餘額的貨幣,填入不超過餘額的金額及付款資料。留意申請狀態:等待中、已核准、已拒絕或已支付。核准本身不代表款項已匯出。