跳到主要内容

Telegram Bot 命令说明

本文档汇整后台 Telegram 机器人目前开放的查询指令、使用方式与回传示例，供运营与客服参考。

1. /pay​

用途
查询代收或代付订单的详细资讯。订单编号可为商户订单号、平台订单号，或系统映射后的编号。

指令格式

/pay <订单号>
  • <订单号> 为必填参数，长度不超过 32 字符且不可包含空白。

使用范例

/pay PM00012345

回传示例

订单[PM00012345]查询结果:
订单类型:代收
商户号:PF0001
订单时间:2024-06-01 10:15:03
商户订单号:CL202406010001
平台订单号:PM00012345
订单金额:1000.00
实收金额:995.00
手续费:5.00
入帐金额:995.00
订单状态:成功

若订单不属于授权商户或不存在，则回复 No payment or payout information available。

2. /balance​

用途
查询授权商户的钱包余额。可指定单一商户，或不带参数一次查看所有授权商户。

指令格式

/balance [PFxxxx]
  • 参数可省略；若提供需为合法商户号（如 PF0001）。

使用范例

/balance PF0001

回传示例

商户号[PF0001] 示例商户
余额查询结果:
cny 总额: 12345.67
usd 总额: 890.12

3. /daily​

用途
统计当日总收款与总出款，依币别显示总笔数、成功笔数、进行中笔数与成功金额。可选填商户号。

指令格式

/daily [PFxxxx]
  • 参数可省略；若提供需为合法商户号。

使用范例

/daily

回传示例

商户号[PF0001] 示例商户
今日统计:
📥 收款统计
──────────
💱 人民币 (CNY)
└ 总笔数:5｜成功:4｜进行中:1
   ✅ 成功金额: 4,880.00
💱 美元 (USD)
└ 总笔数:2｜成功:2｜进行中:0
   ✅ 成功金额: 300.00
──────────

📤 出款统计
──────────
💱 人民币 (CNY)
└ 总笔数:3｜成功:2｜进行中:1
   ✅ 成功金额: 1,500.00
──────────

若查询结果为空，会回传 暂无收款/出款数据；若商户不存在，则回传 商户号[PFxxxx]不存在。 币别会自动转换为对应的简体中文名称（如 CNY → 人民币、VND → 越南盾）。

4. /okx​

用途
查询 OKX 交易所 C2C 市场的 USDT 人民币实时卖出报价（前 10 笔）。此指令无需群组授权即可使用。

指令格式

/okx [支付方式代码]
  • 参数可省略；若提供需为以下有效代码：
    • 0 - 银行卡
    • 1 - 支付宝
    • 2 - 微信支付

使用范例

/okx
/okx 1

回传示例

OKX C2C USDT 人民币报价 (全部支付方式) 前10笔:
──────────
1. 7.23 CNY ｜ 5,000.00 USDT ｜ 大商家A | 银行卡/支付宝
2. 7.24 CNY ｜ 3,200.00 USDT ｜ 优选商家B | 微信支付
3. 7.24 CNY ｜ 1,500.00 USDT ｜ 认证商家C | 银行卡
...

若查询失败或暂无数据，会回传 获取 OKX 价格失败 或 暂无 OKX 价格资讯。
若支付方式代码不正确，会回传：不支持的 OKX 支付方式参数，请输入 0（银行卡）、1（支付宝）、2（微信支付）。

5. 错误与权限提示​

  • 未授权的群组或商户会收到提示：无查询权限。
  • 指令格式错误时，机器人会回传：指令错误。
  • 请确认机器人已加入目标群组，且后台已绑定对应的商户权限。
  • /okx 指令为公开指令，无需授权即可在任意群组使用。

6. 指令速查表​

指令用途参数需授权
/pay <订单号>查询代收/代付订单必填，最多 32 字符✅
/balance [商户号]查询钱包余额可选，格式 PFxxxx✅
/daily [商户号]查询今日收付款统计可选，格式 PFxxxx✅
/okx [支付方式]查询 OKX C2C 报价可选，0/1/2❌

如需扩充指令或调整回传格式，请与后台开发团队确认需求后建立任务。