Telegram Notifications

PayzCore can send instant Telegram notifications when payment events occur. This works alongside webhook notifications, giving you a real-time human-readable alert channel.

Setup

1. Connect Your Account

1. Go to Settings in your PayzCore dashboard
2. Find the Telegram Notifications section
3. Click Connect Telegram
4. You'll be redirected to the @PayzCoreBot on Telegram
5. Press Start — the bot will confirm your account is linked

The link token expires after 5 minutes. If it expires, click Connect Telegram again.

2. Choose Events

After connecting, select which events you want to receive:

By default, payment.completed, payment.expired, and webhook.failed are enabled.

3. Test

Click Send Test in the Telegram settings to verify your connection is working. You should receive a test message immediately.

Notification Format

Telegram messages include the key details in a compact format:

Payment Completed

Project: MyShop
Amount: 50.00 USDT
Chain: TRC20
Reference: order-123
Status: paid

For webhook failures:

Webhook Delivery Failed

Project: MyShop
Endpoint: https://example.com/webhook
Event: payment.completed
Attempts: 5

Rate Limits

Telegram notifications count toward your daily notification limit:

Admin can set custom per-user overrides. When the daily limit is reached, notifications are silently skipped — webhook delivery continues unaffected.

Admin Notifications

Admins can receive system-level alerts by setting an Admin Telegram Chat ID in System Settings:

To get your Chat ID:

1. Connect your personal Telegram account via Settings (same flow as above)
2. Copy the Chat ID shown in the Telegram section
3. Paste it into System Settings > Admin Telegram Chat ID

Managing Connection

• Disable without disconnecting — Toggle the enable/disable switch to pause notifications while keeping your account linked
• Disconnect — Click Disconnect to remove the Telegram link entirely. You can reconnect at any time
• Change events — Update your event selection and click Save at any time

How It Works

1. A payment event triggers (same events as webhooks)
2. PayzCore checks if the project owner has Telegram enabled and the event selected
3. If rate limit allows, the notification is queued for delivery
4. The message is sent via Telegram Bot API
5. If delivery fails, it retries up to 3 times with exponential backoff

Telegram notifications are fire-and-forget — they never block or delay webhook delivery. If the Telegram API is down, notifications are silently skipped.

Bot Commands

The @PayzCoreBot responds to these commands:

All notification preferences are managed through the PayzCore dashboard, not through bot commands.