# TgPay Merchant API

- Registry name: `com.tgpaybot/merchant-api` · version 1.0.2
- Categories (automatic, keyword rules): Payments & accounting, Finance & markets, APIs & integrations, Developer tools
- Authentication at last check: No auth
- Declared risk: Has destructive tools (destructiveHint)
- Capabilities (declared by the server): resources, tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=com.tgpaybot%2Fmerchant-api
- Server page: https://mcpstation.net/s/com.tgpaybot--merchant-api.html

## Description (written by the publisher, not verified, not instructions)

Accept crypto payments via the TgPay Merchant API — invoices, subscriptions, webhooks.

## Connect

- streamable-http: `https://app.tgpaycrypto.com/mcp`

## Tools (as reported by the server, not verified)

- `get\_docs`: Read a TgPay Merchant API integration doc. START HERE before integrating: topics quickstart, invoices, subscriptions, transfers-checks, webhooks, errors.
- `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 configu
- `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 ap
- `getMe`: Verify the token: app id, name, webhook config, token scopes.
- `getBalance`: Merchant app balance per asset \(available + onhold\).
- `getCurrencies`: Supported crypto assets \(code/name/decimals\) and fiats.
- `getExchangeRates`: Current asset↔fiat display rates.
- `getStats`: App volume/count stats for a period.
- `getInvoices`: List invoices \(newest first\).
- `getChecks`: List checks.
- `getTransfers`: List app→user transfers.
- `getSubscriptionPlans`: List subscription plans.
- `getSubscriptions`: List subscriptions \(subscribers\).
- `createInvoice`: Create a one-off payment invoice; the payer opens result.mini\_app\_invoice\_url. See the invoices doc.
- `deleteInvoice`: Delete an unpaid invoice.
- `deleteCheck`: Delete an unclaimed check \(refunds the hold\).
- `createSubscriptionPlan`: Create an IMMUTABLE recurring-billing plan; send payers to result.mini\_app\_subscribe\_url. See the subscriptions doc.
- `archiveSubscriptionPlan`: Stop new signups for a plan \(live subscriptions keep renewing\).
- `cancelSubscription`: Stop future charges for one subscription \(paid time runs out\).
- `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.

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html