Telegram Bot

Take crypto payments inside Telegram with @Payid19Bot. You create an invoice by sending one message, your customer pays from any wallet without leaving Telegram, and both of you get a message the moment the payment is confirmed. There is nothing to install and no code to write; the bot uses your existing Payid19 account.

1. Connect your account

In your dashboard open Settings → Telegram and press Connect, then Open Telegram. The bot answers linked to your email and that is it. If you prefer, send the one-time code shown on the page to the bot yourself:

/link YOURCODE

A code is valid for 30 minutes and works once. You can disconnect from the same page at any time; the bot then stops creating invoices for your account.

2. Create an invoice

Send the amount, the currency and what it is for. The currency is optional (USD by default), the title is optional too.

/pay 9.99 USD Premium subscription
/pay 250 EUR Logo design, final payment
/pay 1 USD Trial test

The bot replies with the invoice number, a customer link for one customer and three buttons: Send to customer (opens Telegram’s share sheet), Pay it myself and Details / cancel. Adding the word test at the end creates a test invoice: open it, pick any coin and send nothing. It completes by itself within a minute, so you can see the whole flow, notifications included, without sending money. Every invoice created through the bot is a normal Payid19 invoice: it appears in your Invoices page, your callback URL is called when it is paid, and the money lands in your balance exactly as with the API.

3. Send it to the customer

Three ways, pick the one that fits the conversation:

• Share the link. Press Send to customer and choose the chat, or copy the link. This link is one invoice for one customer: once someone opens it, nobody else can pay it.
• Inline, in any chat. In the conversation with your customer type @Payid19Bot 9.99 USD Premium, tap the card that appears above the keyboard, and a payment card with a Pay with crypto button is posted right there. Every customer who taps Pay gets their own invoice, so the same card works in a group or channel post too.
• In a group. Add the bot to your group and send /pay@Payid19Bot 9.99 USD Premium there (with the bot’s name, so it reaches the bot even when other bots are in the group; picking /pay from the command menu adds it for you). A public card with a Pay with crypto button appears; every buyer who taps it gets their own invoice in a private chat with the bot, and your paid notification names the buyer.
• In a channel. While writing a channel post, type @Payid19Bot 9.99 USD Premium and pick the card. Channel posts are not sent to bots as commands, so use the inline card there.

Link or card?

A link from /pay in your private chat with the bot is one invoice for one customer: use it for something you sell to a specific person, like the final payment for a logo. A card (inline in any chat or channel post, or /pay@Payid19Bot in your group) is a product anyone can pay: every buyer who taps Pay with crypto gets their own invoice, and a buyer who taps again simply continues the invoice they already have. Use it for anything you sell to many people at one price, like a monthly plan.

When a card is posted the bot sends you a private note with a Stop this card button, and /cards lists your active cards. A stopped card tells new buyers it is no longer active; invoices already opened from it stay valid until they expire.

4. What your customer sees

The customer opens the link and the bot shows the invoice: title, amount, your seller name and the deadline, followed by one button per coin with the amount already converted (USDT · BEP20 · 9.99, Bitcoin · 0.00013, and so on). After choosing a coin the bot sends the exact amount, the deposit address (tap to copy) and a QR code, plus an I have paid button to check. When the payment is confirmed on the network the customer gets a receipt message with a link to the receipt page. There is also an Open payment page button that opens the regular hosted page inside Telegram for those who prefer it.

5. Notifications you receive

• Paid: invoice number, amount, coin and network, within about 15 seconds of confirmation.
• Partial payment: the customer is told how much is still missing; you are told the invoice is waiting for the rest.
• Expired: a customer who took an address but did not pay is warned not to use it any more.
• Refund: when the normal flow creates a refund for an over- or underpayment, the customer receives the refund link in the bot instead of by email, and a second message with the transaction link once the refund is sent. Refund links never go to you.

Commands

Invoices from the API or the dashboard

Any invoice can be paid through the bot, not only the ones created with /pay. Append the invoice alias to the bot’s start link and give that to the customer, for example as a Pay in Telegram button next to your regular payment link:

https://t.me/Payid19Bot?start=ALIAS

The alias is the last part of the payment page URL returned by create_invoice (https://payid19.com/invoice/ALIAS).

Limits and safety

• The bot can never withdraw: a stolen Telegram session can create invoices or read your balance, but cannot move money. Keep withdrawals in the dashboard.
• Your API keys never enter Telegram. The bot signs invoices on our server with the keys of the connected account.
• In a group, only the group’s admins can post payment cards, so nobody can post a card for their own account in your group.
• An invoice can be cancelled only until the customer takes a deposit address; after that a payment may already be on its way, so it simply expires.
• A customer can take addresses for at most three coins on one invoice. Account commands (/balance, /invoices, /cards) only answer in your private chat with the bot.
• Up to 60 invoices an hour per account through the bot. For bulk invoicing use the API.
• Invoices are valid for 16 hours, like every Payid19 invoice. Customers who paid in the bot do not receive an email receipt; the bot is their receipt, and the receipt page link is always included.