What is Crypto Pay?
Crypto Pay is the app’s payment API for businesses and bots. You create an app, get an API token, and use it to bill Telegram users, pay them out, and read your balance — all from your own code.
It’s the developer side of the same rails users see: an invoice you create through the API is the invoice they pay from their balance with one tap.
What you can do with it
- Invoices — create a payment request, send the payer its link, and get a signed callback the moment it’s paid.
- Transfers — send crypto from your app balance to a Telegram user.
- Checks — issue redeemable links anyone can claim, from your app balance.
- Balances, currencies, exchange rates and stats — read-only endpoints for your own bookkeeping.
How it fits together
- Your app holds a balance, separate from your personal wallet.
- Invoices paid by users credit that app balance.
- Transfers and checks spend from it.
- Every event that matters can be pushed to your server as a signed webhook.
Payments settle inside the app, not on-chain: no network fee, no confirmations to wait for, and the money is usable the instant it lands.
Compatible with Crypto Bot
The API deliberately mirrors Crypto Bot’s: same method names, same
{ok, result} envelope, same decimal-string amounts, same webhook signature
scheme. An existing Crypto Bot integration is pointed at us by changing the base
URL and the token — the request and response shapes don’t change.
The canonical token header is TgCryptoPay-API-Token, and Crypto-Pay-API-Token
is accepted as an alias so existing client libraries keep working unmodified.
⚠️ Your API token is a spending key
Anyone holding it can transfer your app’s balance out. Keep it server-side, out of client apps and repositories, and rotate it the moment you suspect it leaked. See Getting started as a developer.
Next
Was this article helpful?
Thanks for the feedback.