Telegram Payments
Accept credit cards and wallets through Telegram's payment system.
Telegram Payments lets you accept payments directly inside the Telegram app using 20+ payment providers.
Setting up
Get a payment token from BotFather
- Open @BotFather in Telegram
- Send
/mybotsand select your bot - Go to Bot Settings → Payments
- Choose a payment provider (Stripe, PayPal, YooKassa, etc.)
- Follow the provider's instructions to get a token
- BotFather will return a token like:
1234567890:TEST:xxxxx
Select Telegram Payments mode
Go to Storefront Settings → Orders & Payments and select Telegram Payments.
Add the provider
In the Payment Providers section, click Add Provider:
- Provider Name — a recognizable name (e.g., "Stripe")
- Provider Token — paste the token from BotFather
- Test Mode — enable for testing
- Active — enable to make available to customers
Multiple providers
You can add multiple payment providers. Customers will be able to choose between them.
Invoice fields
Configure what information to request during payment:
- Name — customer's name
- Phone — phone number
- Email — email address
- Shipping Address — full shipping address
- Tips — allow customers to add a tip
See Tips & Invoice Fields for details.
Test mode
Enable test mode on a provider to test payments without real charges.
Stripe test card: 4242 4242 4242 4242 with any CVV and future expiry date.
Troubleshooting
If you see PAYMENT_PROVIDER_INVALID errors, your provider may not support your store currency. Check that the payment provider supports the currency configured in your store settings.