Telegram Bots

Official bots to manage your Merchant888 account, check orders and balances directly from Telegram.

@cowpayglobal_bot

Main merchant bot — private chat

Use this bot in private chat for full control of your merchant account.

Available Commands

/help

Show all available commands and help text.

/balance

查询余额 (Check Balance) — Returns your current merchant balance, available payout amount, frozen amount etc.

/payin <order_no>

查询代收订单 (Check Payin Order) — Query status of a deposit order by order number.

/payout <order_no>

查询代付订单 (Check Payout Order) — Query status of a withdrawal order by order number.

/apidoc

查看API文档 (API Documentation) — Get the link to full API docs.

/bd <order_no> <transaction_id>

补单 (Supplement Order) — Manually supplement / mark an order as paid using order number and transaction ID.

/chkphone <phoneNumber> [bkash|nagad]

检查BD手机号是否属于平台 (Check if BD phone number belongs to the platform). Optional wallet type: bkash or nagad.

Group Admin Bot (second bot)

For groups / team monitoring

Add this bot to your merchant / support group. Authorized users can check balances, payin & payout status using the same commands. Documents and help files are available inside the group.

Group Features

When added to a group, authorized Telegram user IDs can use all commands
Merchant balance, payin status, payout status visible via commands
Document / help files can be sent by the bot on request
Admin-only commands for sensitive actions (supplement order etc.)

Setup: After creating the bots on @BotFather, put the BOT_TOKEN and your Telegram ADMIN_USER_IDS (comma separated) in the configuration section of the bot code. Example values are already placed as placeholders.

How to Deploy the Bots

Create two bots with @BotFather → get the tokens.
Download the Python bot scripts (provided separately).
Install dependencies: pip install python-telegram-bot requests

Edit the top of each script and replace:

BOT_TOKEN = "123456:ABC-DEF..."          # from BotFather
ADMIN_USER_IDS = [123456789, 987654321]  # your Telegram numeric user IDs
API_BASE = "https://api.merchant888.site"
MERCHANT_CODE = "YOUR_MERCHANT_CODE"
SECRET_KEY = "YOUR_SECRET_KEY"

Run: python bot1_main.py and python bot2_group.py
For production use systemd / pm2 / Docker or a VPS process manager.

Need the bot source code?

Full ready-to-run Python scripts with all commands implemented are available. Contact support or check the delivery package.