文档

Telegram bot

1.请求地址（POST）

生产 API: https://api.futurepay.global/telegram/bind

沙盒 API: https://api.futurepay-develop.com/telegram/bind


2.请求参数:

{
  "botToken": "8991066777:AAEMGSBkbi_5IxVbma-gJj-PxDg4",
  "botName": "TEST_FUTUREPAY_BOT"
}
字段类型必填说明
botTokenstring是Telegram Bot Token
botNamestring是Telegram Bot 名称

3. 成功响应

{
    "code": "0",
    "msg": "succeeded",
    "serverTime": 1784277767929,
    "success": true
}

如何创建Telegram bot

https://web.telegram.org/k/#@BotFather

1. 收单订单查询

1.1 命令格式


订单号:平台订单号(pspReference)或商户订单号(merchantReference)、渠道订单号(providerReference)

普通查询：

/payinQuery <订单号>

指定 Bot：

/payinQuery @<botName> <订单号>

1.2 示例

普通：

/payinQuery 2077308257730428928

指定 Bot：

/payinQuery @TEST_FUTUREPAY_BOT 2077308257730428928

1.3 返回结果

2. 代付订单查询


订单号:支付平台交易号(pspReference)或商户订单号(merchantReference)

2.1 命令格式

普通查询：

/payoutQuery <订单号>

指定 Bot：

/payoutQuery @<botName> <订单号>

2.2 示例

/payoutQuery ljw1783924348932

指定 Bot：

/payoutQuery @TEST_FUTUREPAY_BOT 2077308257730428928

2.3 返回结果

3. 商户余额查询

3.1 命令格式

普通查询：

/balanceQuery <余额类型>

指定 Bot：

/balanceQuery @<botName> <余额类型>

3.2 示例

普通：

/balanceQuery pay_out_balance

指定 Bot：

/balanceQuery @TEST_FUTUREPAY_BOT pay_out_balance

3.3 支持余额类型

Code名称
total_balance总余额
acquiring_balance收单余额
collection_balance代收余额
available_balance可用余额
recharge_balance充值余额
freeze_amount冻结金额
pending_settlement待结算金额
exchange_pending换汇处理中金额
pending_paying待支付金额
pay_out_balance代付余额

3.4 返回结果

成功：

4. 支持命令列表

命令功能
/payinQuery收单订单查询
/payoutQuery代付订单查询
/balanceQuery商户余额查询

Updated 1 day ago

Did this page help you?