买单接口（买入USDT）

商户买入 USDT，系统自动匹配交易员收款。

流程： 商户创建订单 → 自动匹配交易员 → 交易员收到款项 → 交易员确认收款 → 通知商户回调。

端点

POST /addons/huanyu/merchant/createOrderSimple

买单不需要提供支付方式，系统会自动匹配有支付方式的交易员。

请求参数

参数名	类型	必填	说明
order_type	int	是	订单类型，买单固定为 1
cny_amount	decimal	是	买入 CNY 金额，必须大于 0
customer_name	string	否	客户姓名（可空，用于风控留底）
id_card	string	否	客户身份证号（可空，用于风控留底）
mobile	string	否	客户手机号（可空，用于风控留底）

另需携带 通用参数（api_key / timestamp / nonce / signature）。

响应参数

参数名	类型	说明
order_no	string	订单编号
status	string	订单状态（pending = 待支付）
order_type	int	订单类型（1 = 买入）
cny_amount	decimal	CNY 金额
payment_method	object	匹配的交易员支付方式
merchant_amount	decimal	商户实际获得 USDT 数量
deposit_amount	decimal	保证金金额
service_amount	decimal	服务费金额
merchant_actual_amount	decimal	商户实际到账 USDT 数量
createtime	int	创建时间戳
pay_url	string	订单详情页链接，浏览器打开可查看收款银行卡信息并上传转账凭证

pay_url 使用说明

该链接为订单详情页地址，请引导用户在浏览器中直接打开。页面将展示收款银行卡信息、转账金额，并支持上传转账凭证和取消订单。页面无需登录即可访问。

请求示例

{
    "api_key": "your_api_key",
    "timestamp": 1699065600,
    "nonce": "abc123def456",
    "signature": "generated_signature_here",
    "order_type": 1,
    "cny_amount": 1000.00,
    "customer_name": "张三",
    "id_card": "110101199001011234",
    "mobile": "13800138000"
}

响应示例

{
    "code": 1,
    "msg": "订单创建成功",
    "data": {
        "order_no": "ORD202511041234567890",
        "status": "pending",
        "order_type": 1,
        "cny_amount": 1000.00,
        "payment_method": {
            "bank": "中国银行",
            "sub_bank": "北京分行",
            "card_number": "6217*********1234",
            "real_name": "李四"
        },
        "merchant_amount": 138.50,
        "deposit_amount": 2.77,
        "service_amount": 1.38,
        "merchant_actual_amount": 134.35,
        "createtime": 1699065600,
        "pay_url": "https://api.pisces-pay.cn/addons/huanyu/order_page/detail?order_no=ORD202511041234567890"
    }
}