Telegram Payments: Custodial vs Non-Custodial Explained

To understand payment custody, ask who controls the funds and what you must do to access them. A bot interface, balance display or blockchain explorer alone does not answer that question.

I build GramBase. Its stablecoin infrastructure verifies a payment to the seller’s configured wallet rather than receiving funds into a GramBase pooled wallet. Stars are different: Telegram manages their earnings and reward process. Digital goods and services sold inside Telegram bots and Mini Apps must use Stars under Telegram’s rules.

This guide explains the responsibilities of each model. It does not assume every membership tool holds your money, or that self-custody eliminates risk.

Four different payment arrangements

Arrangement	Where earnings are managed	What to investigate
Platform or custodian balance	A third party controls funds and authorizes payouts	Terms, withdrawal availability, fees, holds and dispute handling
Your payment-processor account	A processor settles through your connected account	Processor rules, identity requirements, reserves and payout timing
Direct payment to a seller-controlled wallet	The receiving address is controlled by the seller	Keys, network, confirmation, asset issuer and refund responsibilities
Telegram Stars	Telegram manages the Stars balance and reward process	Eligibility, reward terms, availability period and current conversion process

The table describes payment arrangements, not a blanket classification of vendors. For example, Ko-fi says payments go directly to the creator’s connected PayPal or Stripe account. That is not the same as Ko-fi holding a pooled crypto wallet. A processor remains a dependency even when the commerce tool does not hold the funds.

What custody changes

If a provider controls a pooled wallet or payout balance, you depend on that provider to preserve it and honor withdrawals. A security incident, financial distress, account restriction or contractual hold can affect access. Read the actual arrangement rather than assuming a fee, waiting period or failure outcome.

A bot outage can interrupt checkout or delivery. It does not by itself prove that funds have disappeared. Distinguish a service being unavailable, a payout being delayed and a loss being confirmed. Keep payment references, receipts and relevant records so support can investigate.

Custody can come with useful services, such as payment processing or managed tax collection. Compare responsibilities and costs for your business rather than treating every intermediary as dishonest. The payment-method guide separates the major Telegram payment contexts.

Where Telegram Stars fit

Stars are required for digital goods and services sold through Telegram bots or Mini Apps. They are not a direct buyer-to-seller stablecoin transfer. A seller’s reward follows Telegram’s current terms and available reward process.

As checked on October 3, 2026, Telegram’s developer terms state a reward reference of $0.013 per Star and say eligible Stars earnings may be unavailable for up to 21 days. Reward terms and availability can change. The buyer’s cost per Star varies by purchase channel, package and applicable charges, so a fixed universal 35-40% fee would be misleading.

Use the Stars price calculator with the package your buyer actually sees. Compare the gross reward reference with GramBase usage and other business costs. The Stars guide explains buyer price, seller reward and refund responsibilities in more detail.

How GramBase’s supported stablecoin flow works

For a permitted wallet-payment context:

1. Configure the supported chain, token and your receiving address in a payment profile.
2. The buyer transfers funds to the address saved on the order.
3. GramBase checks the transfer and confirmations against that order.
4. After payment confirmation, the configured delivery work runs.

GramBase does not need the wallet’s private key or recovery phrase to watch a public address. It does not hold the stablecoin funds in this flow. Read the payment-profile documentation and wallet-payment setup guide.

The address must actually be yours to control. An exchange deposit address still depends on the exchange’s account and withdrawal rules. Calling it “your address” does not make it self-custody.

What happens if the tool becomes unavailable?

Stablecoins already confirmed at your seller-controlled address remain at that address; a GramBase outage does not move them. Checkout, verification, delivery and access management may still be interrupted. Keep records and a recovery procedure for those operations.

This statement does not guarantee the asset’s market value, protect a compromised wallet or prevent an issuer or network restriction. Stars earnings continue to depend on Telegram’s process rather than this direct-wallet model.

What fees remain?

There is no GramBase withdrawal from a pooled stablecoin balance in the described flow. The buyer’s wallet or exchange may charge transfer costs, and later movement of funds can incur network costs.

GramBase consumes Usage Credits for order processing at 2.5% of an internal USD valuation, minimum five and maximum 2,000 credits per order. With 100 credits per dollar, this is $0.05-$20 per order. Other actions can use additional credits. See pricing and distinguish tool usage from payment-rail costs.

Five checks before trusting a payment arrangement

1. Identify the legal and technical provider. Who offers the checkout, processes payment and owes the payout?
2. Read the payout terms. Check conditions, holds, limits, charges, disputes and account restrictions on the provider’s current official pages.
3. Verify the receiving destination. For a direct wallet payment, compare the configured address with the order and a confirmed transaction on the correct network. An on-chain payment to someone else’s address is not evidence of your control.
4. Confirm who controls the key or account. Do not share recovery phrases or use private-key entry as a custody “test.” Ask for a clear architecture explanation.
5. Test recovery as well as payment. Inspect the paid order and delivery result separately. Know how to handle a failed delivery, refund request and unavailable bot.

A balance screen may summarize verified orders rather than hold funds. A withdrawal delay may come from a connected processor. Neither UI clue is a conclusive custody test on its own.

Refunds and seller responsibility

A final blockchain transfer does not erase contractual or legal refund obligations. You may need to arrange a separate transfer, and should confirm the destination safely before doing so. Stars have a Telegram refund API and seller support requirements; keep the payment reference needed to investigate a request.

Avoid promises such as “no chargeback risk,” “no refund risk” or “funds cannot be frozen.” Different rails have different failure modes, and the seller still owes the purchased service or a resolution under the applicable terms.

Frequently asked questions

What is a non-custodial Telegram payment tool?

In a direct-wallet flow, the payment tool checks transfers without controlling the receiving wallet’s private key or holding funds in its own payout balance. This description applies to the verified flow, not automatically to every payment option the same tool offers.

Do all membership bots hold funds?

No. Some use connected payment processors, others manage balances, and some verify direct transfers. Check current provider documentation and the actual account arrangement. Do not infer custody from the words “membership bot.”

Can I switch tools without losing members?

You need an entitlement migration plan: groups, members, expiry dates, old paid periods and overlapping permissions. Existing payment mandates and payout balances do not automatically move to a new tool. The creator migration guide describes a phased approach and its limits.

Questions? DM @Kai, founder of GramBase.