Feature · Telegram integration ▓ BOT + MINI APP No install required

Run the gateway
from Telegram.

A merchant bot and a Mini App that run inside Telegram. Check balances, mint invoices, send payouts, receive webhook alerts — without opening a browser. Every dashboard surface has a Telegram twin. Same auth, same permissions, same signed receipts.

Link your account → Read the spec

Merchant bot · Mini App · Alerts

§ Part I / IV · What ships

Three Telegram surfaces.
Same backend. Same signed events.

Bot · Mini App · Alerts
All under one @OrbChainBot

SymSurfaceWhat it doesStatus

BOTMerchant bot/balance, /invoice 50 USD BTC_LN, /payout BTC 0.001 bc1q…, /recent. Command-line ergonomics inside Telegram.LIVE

APPMini AppFull tap-through UI: balances across all 27 coins, Receive picker with server-side QR, Send dialog with TOTP gating, activity history.LIVE

ALRWebhook alertsOpt into payment.paid, payout.confirmed, subscription.failed, and auto-withdraw events as Telegram DMs. Configurable per event type.LIVE

AUTHLink flow/dashboard/settings/telegram emits a one-use code; send it to @OrbChainBot, bot DMs a webhook-signed binding confirmation back.LIVE

TOTP2FA gatingSend + payout flows in the Mini App enforce the same TOTP guard as the web dashboard. No shortcut around 2FA.LIVE

NOKNo-KYC ForeverTelegram binding is a pseudonym, not an identity. We never ask for your phone number beyond what Telegram already exposes.LIVE

§ Part II / IV · How it works

Three steps to a
Telegram-native gateway.

Walkthrough
Done in under 60 seconds

SymStepWhat you doResult

1Start the botOpen @OrbChainBot in Telegram, hit /start. Bot returns a welcome card with a "Link account" button.20s

2Paste binding codeDashboard → Settings → Telegram → Generate code. Paste the 8-digit code into the bot. Binding lands in the database as webhook-signed.10s

3Open Mini AppBot keyboard → "Open App". Telegram's WebView loads your merchant dashboard in-app. All subsequent actions come through the binding.5s

§ Part III / IV · Example

Mint an invoice
from a phone, one command.

Bot mode
No dashboard needed

DM @OrbChainBotresponse · signed receipt attached

// merchant sends:
/invoice 50 USD BTC_LN

// bot replies with an inline card:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Invoice · $50.00 USD
Pay in: BTC · Lightning
Amount: 0.00073 BTC
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
lightning:lnbc730u1pn…
+ server-side QR image
+ /pay link
+ Open in wallet button

// on settlement (~1s over LN):
✓ Paid · 0.00073 BTC
+ event_id: 01H8K…
+ signed receipt (verifiable offline)

§ Part IV / IV · Questions

Does the Mini App
touch custody?

Answered
In full, with links

Q.01Does Telegram custody my keys?

No. The Telegram binding is an authentication token for hitting our API; your hot-wallet keys stay in our HD wallet tree, exactly like the browser dashboard. Telegram sees the same JSON responses a browser sees — nothing more.

Q.02What happens if Telegram is down?

Nothing — the gateway runs on our infra. The browser dashboard, the public API, webhooks, the hosted /pay page all keep operating normally. Telegram is an optional surface, not a critical path.

Q.03How is the binding signed?

The initial binding is confirmed via an out-of-band Telegram webhook that Telegram signs with a shared secret. After binding, every Mini App request carries a Telegram initData HMAC that we verify on the server before executing. No client-side trust.

Q.04Can customers pay via Telegram?

Yes. The /pay/<trackId> hosted checkout works inside Telegram's in-app browser, and for Lightning invoices the lightning: deep-link pops the customer's wallet without leaving Telegram. For donations, /tip/<accountId> behaves the same way.

Q.05Is the bot available right now?

Yes — link your account from Dashboard → Settings → Telegram. The bot username + webhook URL are configured via env on our end; no install on yours.

Your gateway.
Where you live.

Merchants spend all day in Telegram. We put the gateway there too — same API, same signed receipts, same no-KYC positioning. No other gateway in our category ships this.

Link your account → Read the spec

§ Feature stack · Telegram

Every Telegram action
rides the full stack.

Same infra
Bot, Mini App, alerts

SymFeatureMechanismStatus

LNInstant LightningAccept and pay out Bitcoin over Lightning. Atomic settlement, zero confirmations, sub-cent fees. On-chain fallback is one parameter.LIVE

ASAuto SettleCustomer pays any accepted coin. You always receive the settlement coin you configured — pay-with-BTC, get-USDT. Swap runs at checkout, no extra setup.LIVE

APAuto PayoutSet a balance threshold. We sweep to your cold wallet the moment you hit it. 30-minute cooldown on failure. No manual clicks, no scheduled cron.LIVE

SRSigned ReceiptsEvery PAID payment gets an Ed25519-signed receipt. Verify offline with our public key. No other gateway in our category ships this.LIVE

NKNo-KYC ForeverEmail + password, that's it. No documents, no verification wall, no volume gates. We don't touch your customers' identity — your gateway, your rules.LIVE

DWDeterministic WebhooksEvery webhook carries a SHA-256 event_id derived from (event_type, entity_id). Retry 1,000×, same id. True idempotency without an extra DB column.LIVE

Run the gateway from Telegram.

Three Telegram surfaces.Same backend. Same signed events.

Three steps to aTelegram-native gateway.

Mint an invoicefrom a phone, one command.

Does the Mini Apptouch custody?

Your gateway.Where you live.

Every Telegram actionrides the full stack.