Telegram intake

Let people send you payment requests through your own Telegram bot. Their messages land straight in your queue — you review and send. Your token, your privacy: the bot talks only to Telegram, with your own credentials.

Create your bot

The bot is yours — Payanvil never uses a shared bot. Setting one up takes a minute:

  1. Open @BotFather in Telegram and send /newbot.
  2. Follow the prompts to pick a name and a username for your bot.
  3. BotFather replies with a token — a long string like 123456:ABC-DEF....
  4. In Payanvil open Settings, paste the token into the Token field, and save.

The token is stored only in your locally encrypted database and is sent to no one but Telegram. Nobody else can post to your queue.

How to send a payment

Write a message to the bot in this order — the address is the anchor:

  1. Full name — optional
  2. Wallet address — required
  3. Purpose — optional
  4. Amount — required

Everything before the address is the name; everything between the address and the last token is the purpose; the last token is the amount.

Ivanov TJnRioDipVbRx7hz8ApdeUpygdjN9gy4a3 invoice 12.50

The amount accepts both a dot and a comma: 12.50 or 12,50.

Several payments at once

You don't have to send one message per payment. Put each payment on its own line, or separate them with a semicolon ; — both work, and you can mix them.

One per line

Ivanov TJnRioDipVbRx7hz8ApdeUpygdjN9gy4a3 invoice 12,50
Petrov TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t advance 5

Or in a single line, separated by ;

TJnRioDipVbRx7hz8ApdeUpygdjN9gy4a3 5; TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t 10

One record must contain exactly one address. If two addresses end up in the same record, the bot asks you to separate the payments with a semicolon or a line break.

Files work too

Instead of typing, you can send the bot a .xlsx, .csv or .txt file — the same four-column format the desktop app reads. See the input file format for details.

What happens to bad messages

Each record is judged on its own. Valid ones go to the queue; problem ones get a reply explaining what to fix. Plain chatter with no address is ignored, so the bot won't clutter your chat.

ReplyWhat it means
Invalid addressLooks like a Tron address but fails the checksum — a typo or wrong characters
No amountAn address was found, but no amount after it
Amount not recognizedThe last token isn't a number
Amount must be positiveThe amount is zero or negative
Multiple addresses in one recordSeparate the payments with a semicolon «;» or a line break

The same reference is built into the app — send /help to your bot and you'll get the format and commands in your interface language.

← Back to home