GetMyBot 知識庫

付款與餘額

透過機器人收款並在付款後開放權限。連接收款帳戶、付款狀態、退款,以及平台費用的獨立支付方式。

本頁內容

若要透過機器人銷售,先連接自己的支付系統帳戶,這裡稱為收款帳戶。機器人會建立帳單,客戶付款後,付款成功的反應就能開放權限或確認訂單。

管理介面有兩種付款:

  • 機器人向客戶收款:機器人向訂閱者開帳單,款項直接進入你的帳戶。本文大部分內容都在說明這種付款。
  • 平台請求餘額:你為 GetMyBot 本身的服務支付的費用,見本文最後幾節。

什麼是收款帳戶

收款帳戶是已連接機器人的支付系統帳戶。你在供應商後台取得憑證,填入 GetMyBot,機器人就會用你的金鑰開立帳單。

款項進入你在支付系統的商戶帳戶。GetMyBot 不接收或保管這些款項,也不從交易額抽成。平台只是請支付服務建立帳單,並接收付款通知來觸發反應。

這表示:

  • 契約、手續費、提領、審查及額度,取決於你和支付系統之間的關係。
  • 密鑰會加密儲存,之後不再顯示。重新開啟設定時密鑰欄為空;保持空白表示沿用原值。
  • 退款也是你的交易操作;平台只是用你的金鑰呼叫供應商 API。

機器人可連接多個收款帳戶,例如盧布與外幣帳戶。其中一個可設為預設收款帳戶,供未明確選擇帳戶的帳單使用。

能否收款取決於方案。若目前方案不包含此功能,「收款帳戶」頁面會提示,開立帳單動作也不會建立帳單。

如何連接收款帳戶

  1. 開啟收款帳戶區。付款紀錄右上角也有前往此區的收款帳戶按鈕。
  2. 按連接收款帳戶並選擇供應商。表單會依支付系統顯示不同欄位。
  3. 填寫帳戶名稱與憑證。名稱僅供自己在清單中辨識。
  4. 如果大多數帳單要由此帳戶處理,開啟預設收款帳戶。
  5. 儲存後,帳戶卡片會顯示 Callback URL,即供應商傳送付款通知的地址。
  6. 按複製,到供應商後台把地址設為通知地址。各系統可能稱它 webhook、Result URL、通知 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。支援收據,不支援從平台介面退款。

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 停止訂閱,不會退回已扣款項。

限期權限:訂閱制私人俱樂部

若要讓權限隨已付款週期結束,可使用暫時標籤:

  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},請檢查開立帳單反應的文字。

若要查明反應內的狀況,請在使用者或聊天室中打開訂閱者對話。訊息下方的卡片會顯示反應步驟;「帳單」步驟會顯示成功或拒絕原因,例如「找不到收款帳戶」或「此帳戶不接受 USD」。

供應商持續重複通知

支付系統在收到確認前會重複通知,這是正常行為。重複通知是安全的:已套用的狀態不會再變,權限也不會重複開通。

如果重試一直不停,表示供應商沒有收到確認。常見原因是後台通知地址錯誤,或簽章不符(收款帳戶金鑰填錯)。簽章錯誤的通知會整筆遭拒,絕不改變帳單狀態,以防偽造回呼開通權限。

付款金額與帳單不同

若供應商回報金額與帳單不符,帳單不會標記為已付款,事件紀錄會顯示拒絕。這是保護機制,避免小額付款取得高價商品權限。

先到供應商後台核對金額。款項由你持有,後續由你決定退款或按正確金額重新開帳單。若付款確實正確並需要入帳,請聯絡支援;人工對帳是一項獨立操作,會記在事件紀錄中。

目前方案無法使用收款帳戶

「收款帳戶」頁面會提示可前往方案頁,連接按鈕不可用。既有帳戶不會刪除,但不能開立新帳單,付款事件也不會觸發反應。升級到合適方案後,可沿用原有憑證。

平台餘額與方案

GetMyBot 服務費與客戶向你支付的款項分開計算。用量以請求衡量:反應執行時,會依實際動作從帳戶餘額扣除費用,但至少扣一個請求。詳見統計與日誌。

付款區顯示目前餘額與可選方案。方案列出價格、請求額度和限制,例如機器人數上限。按選擇即可啟用方案。

餘額依不可變的入帳與扣款紀錄計算,包括註冊獎勵、方案額度、加值及用量。紀錄只會新增,因此可隨時核對歷史;目前餘額就是紀錄總和。

加值會為所需請求額度建立付款。供應商確認後,餘額自動入帳;重複通知不會重複入帳。

下一步

共用餘額與機器人錢包

共用餘額與個別機器人錢包都屬於同一管理帳戶。沒有獨立錢包的機器人使用共用餘額。在餘額分配區選擇來源與收款方,輸入不超過可用餘額的正數金額,並在預覽中核對雙方餘額。轉移只是重新分配現有餘額,不是加值或提領。

推薦獎勵與提領

在推薦計畫區複製邀請客戶的連結。紀錄會按貨幣分別列出保留中及可用獎勵、扣款與提領。申請提領時,選擇有可用餘額的貨幣,填入不超過餘額的金額及付款資料。留意申請狀態:等待中、已核准、已拒絕或已支付。核准本身不代表款項已匯出。