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	1. 指定支付数币，可以传输多个数币 2. 转账后，用户只能使用列出的数币进行支付 3. 必须包含在商户配置的数币表中 4. 适用于转账和交易所 查看支持数币
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

請求示例：

JSON

{
    "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	响应详细信息

响应示例

JSON

{
    "code": "0",
    "model": {
        "orderNo": "300217243809185440066",
        "webUrl": "https://sbx-crypto-payment.alchemypay.org?orderNum=300217243809185440066"
    },
    "msg": "success",
    "traceId": "66c7f6f6f7e8c1827f4fe27905f96546"
}