TgPay Merchant API
Accept crypto payments via the TgPay Merchant API — invoices, subscriptions, webhooks.
| Endpoint | https://app.tgpaycrypto.com/mcp (streamable-http) |
|---|---|
| Registry version | 1.0.2 |
| Now | 20 tools · grade C (76) · pin ts_1b6bad826a42d0a03ebec7e7c2d0b41e · protocol 2025-06-18 |
| First / last listed | 2026-10-26 02:39 UTC / 2026-10-26 02:39 UTC |
| Grade over time | 2026-10-26: C (76), 20 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: get_docs connect connect_status getMe getBalance getCurrencies getExchangeRates getStats getInvoices getChecks getTransfers getSubscriptionPlans getSubscriptions createInvoice deleteInvoice deleteCheck createSubscriptionPlan archiveSubscriptionPlan cancelSubscription updateApp
get_docs | Read a TgPay Merchant API integration doc. START HERE before integrating: topics quickstart, invoices, subscriptions, transfers-checks, webhooks, errors. params: topic* |
connect | Start token issuance WITHOUT the Mini App UI: creates a merchant-app request and returns a t.me approve link plus a poll_secret. Show the link to the human — they approve with one button in the @tgpaycryptobot bot — then call connect_status with the poll_secret. Use only when no API token is configured yet. params: app_name* |
connect_status | Poll a connect request. Returns pending | denied | expired, or — once approved — the app id and the API TOKEN (returned exactly once: save it to the project's .env immediately, never print it in logs). The token is SCOPED (read, invoices, subscriptions, webhooks) — it cannot move money out of the app; transfers/refunds/checks need the primary token the human holds in the Mini App. Poll every 3-5 s params: poll_secret* |
getMe | Verify the token: app id, name, webhook config, token scopes. params: none |
getBalance | Merchant app balance per asset (available + onhold). params: none |
getCurrencies | Supported crypto assets (code/name/decimals) and fiats. params: none |
getExchangeRates | Current asset↔fiat display rates. params: none |
getStats | App volume/count stats for a period. params: start_at, end_at |
getInvoices | List invoices (newest first). params: asset, fiat, invoice_ids, status, offset, count |
getChecks | List checks. params: asset, check_ids, status, offset, count |
getTransfers | List app→user transfers. params: asset, transfer_ids, spend_id, offset, count |
getSubscriptionPlans | List subscription plans. params: none |
getSubscriptions | List subscriptions (subscribers). params: plan_id, user_id, status |
createInvoice | Create a one-off payment invoice; the payer opens result.mini_app_invoice_url. See the invoices doc. params: currency_type, asset, amount, fiat, accepted_assets, rate_lock_seconds, description, hidden_message, payload, paid_btn_name, paid_btn_url, allow_comments, allow_anonymous, expires_in, swap_to |
deleteInvoice | Delete an unpaid invoice. params: invoice_id* |
deleteCheck | Delete an unclaimed check (refunds the hold). params: check_id* |
createSubscriptionPlan | Create an IMMUTABLE recurring-billing plan; send payers to result.mini_app_subscribe_url. See the subscriptions doc. params: name*, asset*, amount*, period_days* |
archiveSubscriptionPlan | Stop new signups for a plan (live subscriptions keep renewing). params: plan_id* |
cancelSubscription | Stop future charges for one subscription (paid time runs out). params: subscription_id* |
updateApp | Update app name / webhook_url (https) / webhook_events opt-in list. Needs the 'webhooks' scope (the connect-issued token has it) or the primary token. See the webhooks doc for the event types and signature verification. params: name, webhook_url, webhook_events |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.