Bot创建订单
此接口支持在telegram生成bot订单，接入前需联系ACH进行配置
简介
在telegram上接入Crypto Payment时可使用此接口，ACH返回web url，拉起页面以用户支付
关于telegram bot，提供三种使用模式，取决于商户在何种前端拉起支付收银台的页面
1.浏览器模式(BROWSER)：商户在浏览器拉起weburl，会在浏览器中打开支付页，结束后会跳转商户上传的redirectURL
2.弹窗模式(MINIAPP)：商户在miniapp拉起weburl，支付页面会内嵌在miniapp当中，支付成功后关闭弹窗
3.bot模式：商户在bot中拉起ACH的bot，支付成功后跳转回商户bot
接口说明
请求方式：POST
请求路径：open/api/tg/payment/V2
参数
请求参数
参数名 | 签名 | 必传 | 类型 | 长度 | 备注 |
|---|---|---|---|---|---|
appId | Y | Y | string | 64 | 商户的唯一标识符 |
sign | N | Y | string | 256 | 签名 |
merchantOrderNo | Y | Y | string | 64 | 客户交易ID |
orderAmount | Y | Y | string | 64 | 订单金额（单位为元） |
payCurrency | Y | Y | string | 64 | 支付货币（EUR / USD） |
userId | Y | Y | string | 128 | 用户的唯一标识符（邮箱 / 手机号码） |
paymentTokens | Y | N | string | 128 |
|
redirectURL | N | N | string | 512 | 成功购买后的重定向地址 |
callbackURL | N | N | string | 512 | 接收订单Webhook的地址 |
customParam | N | N | string | 512 | 商户自定义参数 |
expiredTime | N | N | string | 32 | 超时时间，单位：秒，不大于172800秒（48小时） |
payType | N | N | string | 32 | 支付方式 |
paymentNetworks | N | N | string | 32 | 指定支付网络，逗号分隔，查看支持网络 |
orderModel | N | N | string | 32 | 订单模式（ORDER/ RECHARGE） |
tgModel | N | N | string | 32 | Telegram打开模式: BROWSER/MINIAPP/BOT |
customParam 扩展参数 （tgModel为BOT时需要）
| 参数名 | 签名 | 必传 | 类型 | 备注 |
|---|---|---|---|---|
| botName | N | N | string | bot user name |
| chatId | N | N | string | 用户 tg chatId |
| orderDetail | N | N | string | 订单描述 |
支付方式
| 支付方式 | 支付方式编码/payType |
|---|---|
| 二维码收单 | WALLET |
| 币安支付 | BINANCE_PAY |
Telegram 前端打开方式
| 模式 | 名称 | WebURL差异 | RedirectURL差异 |
|---|---|---|---|
| BROWSER | 浏览器模式 | webUrl 支付http地址 | redirectURL 支付完成商户重定向http地址 |
| MINIAPP | 弹窗模式 | webUrl 支付http地址 | redirectURL 直接关闭弹窗 |
| BOT | 跳转支付bot模式 | webUrl 支付bot地址 | redirectURL 支付完成商户重定向bot地址pleted |
請求示例：
{
"appId": "6fdbaac29eb94bc6b12345ad705e9293",
"callbackURL": "https://crypto-payment-sbx.alchemy.cc/crypto/bot/cpCallback",
"customParam": "{\"botName\":\"ABCDCryptoPaymentTestBot\",\"orderDetail\":\"ABDC Test BAG 🎒\",\"chatId\":\"6831529261\"}",
"expiredTime": "999999",
"merchantOrderNo": "17243134568514",
"orderAmount": "10",
"orderModel": "ORDER",
"payCurrency": "USD",
"sign": "TEST000001",
"tgModel": "MINIAPP",
"userId": "[email protected]"
}响应参数说明
| 参数名 | 类型 | 详情 |
|---|---|---|
| success | boolean | 是否成功 |
| error | boolean | 是否出错 |
| code | long | 响应代码 |
| msg | string | 响应消息 |
| traceId | string | 追踪 ID |
| model | object | 响应详细信息 |
响应示例
{
"code": "0",
"model": {
"orderNo": "300217243809185440066",
"webUrl": "https://sbx-crypto-payment.alchemypay.org?orderNum=300217243809185440066"
},
"msg": "success",
"traceId": "66c7f6f6f7e8c1827f4fe27905f96546"
}Updated 22 days ago