Telegram bots

Accept payments in a Telegram bot

Telegram’s own payments need a provider like Stripe, and a provider needs a company. Norpo needs an email and a wallet. Drop a small library into the bot you already run and take cards and crypto — no merchant account, no business verification.

Download the library
PriceFree — Python and Node, no dependencies
Fees4.8% per settled card order · 1.5% per crypto order to your wallet, 0.4% to your Norpo balance
RequirementsPython 3.9+ or Node 18+, and a bot you already run
Public address for your botNot needed — no domain, no certificate, no webhook
ConfigurationTwo values: your Norpo API key and your bot’s @name
SettlementPer order, to your wallet, in ETH, USDC, USDT or POL

How it works.

01

Open an order

One call with the amount. You get back a checkout link and an order id to store against the customer; the money settles to your account’s payout wallet.

02

Show it as a URL button

The customer pays in their real browser, not Telegram’s in-app webview — 3-D Secure fails there for some banks, and a payment that cannot complete costs more than a tidier flow is worth.

03

Deliver on the answer, not the arrival

A deep link brings the customer back to the chat, and a background sweep catches the ones who close the browser instead. Either way the library confirms the payment with the API before your bot hands anything over.

Questions people ask first.

Because `sendInvoice` needs a provider token, and those are issued to payment providers connected to Telegram directly — in practice, licensed PSPs that will ask you for a company and documents. That is the door this closes.

No. The customer returns through a deep link and the library asks our API about the order, so nothing has to reach your bot from outside. Long polling from any machine works.

The library sweeps your pending orders in the background and delivers when the payment settles, whether or not the customer ever returns to the chat. Keep those orders in storage that survives a restart — the sweep can only settle orders it is told about.

They can replay the link — it sits in their own URL bar. They cannot fake the answer: delivery waits on the order status from the API, never on the arrival.

Both, on the same checkout — one order accepts a card or a coin, and the customer picks. Either way you are paid in crypto on your own wallet. Payouts may be sent in ETH, USDC or USDT (Polygon or BEP-20), or POL, Polygon’s native token.

Full integration guide · No company either? · What it costs