latestOpenAPI 3.1.02026-08-105812.2 KB

aec0b312e372

Methods

List Shops

Returns the authenticated user's active shops, ordered by creation (oldest first). Inactive shops are never listed. Single-shop owners always see one element; multi-shop owners use this endpoint to discover shop IDs to pass to the other shop endpoints via ?shopId=.

get/shops

Response

Successful response

idinteger required

Shop ID

userIdinteger required

Shop owner user ID

namestring required

Shop name

linkstring required

Shop link/slug

callbackUrlstring uri required

Webhook callback URL for order notifications

recurrentboolean required

Whether recurring payments are available

onlyStarsboolean required

Whether only Telegram Stars payment is accepted

tokenChargingboolean required

Whether merchant-initiated token charging is enabled

status0 | 1 required

Shop status (0 = inactive, 1 = active)