> ## Documentation Index
> Fetch the complete documentation index at: https://docs.payreque.st/llms.txt
> Use this file to discover all available pages before exploring further.

# Telegram Payment Bot

> Accept payments and receive instant payment notifications directly in Telegram — no coding required. Free for all PayRequest users.

# Telegram Payment Bot

Turn Telegram into your payment terminal. With the PayRequest Telegram bot, you can create a payment link in seconds, share it instantly in any chat, and get notified the moment money hits your account — all without leaving Telegram.

<Info>
  **Free for all plans.** The Telegram bot is included with every PayRequest account. Connect once and it works forever.
</Info>

## Why Use the Telegram Bot?

<CardGroup cols={2}>
  <Card title="Create links in seconds" icon="bolt">
    Type `/pay 50 for design work` and the bot instantly returns a payment link ready to share. No dashboard login needed.
  </Card>

  <Card title="Instant payment alerts" icon="bell">
    The moment a customer pays, you get a Telegram notification with the amount, customer name, and invoice number.
  </Card>

  <Card title="Works in any chat" icon="paper-plane">
    Share payment links in private chats, group chats, channels, or anywhere else. The link opens your branded PayRequest checkout.
  </Card>

  <Card title="No app switching" icon="mobile">
    If your business runs on Telegram, your payments can too. Stay in the app you already use all day.
  </Card>
</CardGroup>

## Who Is This For?

The Telegram bot is especially useful for:

* **Freelancers** who discuss projects with clients on Telegram and want to send a payment request without switching apps
* **Community owners** selling access, courses, or memberships to their Telegram audience
* **Online sellers** who take orders via Telegram and need a fast, professional way to collect payment
* **Service businesses** that want instant payment alerts on the go

## How to Connect

<Steps>
  <Step title="Open the bot">
    Search for **@payrequestme\_bot** in Telegram, or [click here to open it](https://t.me/payrequestme_bot). Tap **Start**.
  </Step>

  <Step title="Get your connect link">
    The bot sends you a personal connect link. Tap it — it opens PayRequest in your browser.
  </Step>

  <Step title="Log in to PayRequest">
    If you're not already logged in, enter your email to receive a magic link. Click it and you're in.
  </Step>

  <Step title="Done">
    Your Telegram account is now linked to PayRequest. The bot confirms with a message and you're ready to go. The connection is permanent — you only need to do this once.
  </Step>
</Steps>

## Commands

Once connected, these commands are available inside the bot:

| Command                   | What it does                                                          |
| ------------------------- | --------------------------------------------------------------------- |
| `/pay 50 for design work` | Creates a payment link for €50 with the description "for design work" |
| `/pay 125`                | Creates a payment link for €125 (uses "Payment link" as description)  |
| `/links`                  | Shows your 5 most recent payment links with their URLs                |
| `/status`                 | Shows your 5 most recent transactions and their status                |
| `/disconnect`             | Unlinks your PayRequest account from this Telegram chat               |

<Tip>
  You can send a payment link to a customer in seconds: `/pay 200 website project` → copy the URL the bot returns → paste it in your chat with the client.
</Tip>

## Payment Notifications

Every time a payment is completed, you'll receive a message in the bot:

```
💰 Payment received!

Amount: €200.00
From: Jan Janssen
Invoice: #INV-2026-042
Time: 14:32
```

Notifications are instant — they arrive the moment the payment is processed, so you always know in real time.

## Managing Your Connection

You can disconnect the bot at any time by sending `/disconnect`. This removes the link between your Telegram account and PayRequest — notifications will stop and commands will no longer work until you reconnect via `/start`.

If you want to connect a different Telegram account to your PayRequest, first disconnect from the old account, then start fresh with the new one.

<AccordionGroup>
  <Accordion title="Can multiple team members connect their own Telegram?">
    Currently, one Telegram account can be connected per PayRequest account. If you use team members, the connected Telegram user receives all payment notifications for the account.
  </Accordion>

  <Accordion title="What currency does /pay use?">
    Payment links are created in your default account currency (EUR by default). You can change your default currency in **Business Settings → Invoice Settings**.
  </Accordion>

  <Accordion title="Is the connect link safe to click?">
    Yes. The link goes directly to `payrequest.app` and is unique to you. It expires after 15 minutes and can only be used once.
  </Accordion>

  <Accordion title="Do payment links created via Telegram show up in my dashboard?">
    Yes. Every link created via `/pay` appears as a Smart Link in your PayRequest dashboard under **Payment Links**, just like links created through the web interface.
  </Accordion>

  <Accordion title="Can I use this in a Telegram group or channel?">
    The bot works best in private messages. To share payment links in a group, create the link privately with `/pay` and then paste the URL in your group chat manually.
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Smart Links" icon="link" href="/payment-processing/smart-links">
    Learn more about the payment links the bot creates — you can also manage them from your dashboard.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/organization-and-automation/webhook-configuration">
    Build custom automations triggered by payment events using webhooks.
  </Card>

  <Card title="Payment Methods" icon="credit-card" href="/payment-processing/payment-methods-overview">
    See which payment methods your customers can use on your checkout page.
  </Card>

  <Card title="API Reference" icon="code" href="/api/payment-links">
    Create payment links programmatically via the PayRequest API.
  </Card>
</CardGroup>
