卖单接口（卖出USDT）

商户卖出 USDT，提供客户的收款方式，系统指派交易员付款给客户。

流程： 商户创建订单 → 后端指派交易员 → 交易员付款 → 交易员确认付款 → 通知商户回调。

端点

POST /addons/huanyu/merchant/createOrderSimple

WARNING

卖单必须提供客户收款方式（payment_method）。

请求参数

参数名	类型	必填	说明
order_type	int	是	订单类型，卖单固定为 2
cny_amount	decimal	是	卖出 CNY 金额，必须大于 0
customer_name	string	否	客户姓名（可空，用于风控留底）
id_card	string	否	客户身份证号（可空，用于风控留底）
mobile	string	否	客户手机号（可空，用于风控留底）
payment_method	object	是	客户收款方式信息

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

payment_method 对象参数

签名注意

payment_method 作为对象参数参与签名，签名时需 json_encode 序列化（详见 签名算法）。

参数名	类型	必填	说明
bank	string	是	银行名称
sub_bank	string	是	支行名称
card_number	string	是	银行卡号
real_name	string	是	收款人姓名

请求示例

{
    "api_key": "your_api_key",
    "timestamp": 1699065600,
    "nonce": "abc123def456",
    "signature": "generated_signature_here",
    "order_type": 2,
    "cny_amount": 1000.00,
    "customer_name": "张三",
    "id_card": "110101199001011234",
    "mobile": "13800138000",
    "payment_method": {
        "bank": "中国工商银行",
        "sub_bank": "北京朝阳支行",
        "card_number": "6222021234567890123",
        "real_name": "张三"
    }
}

响应参数

参数名	类型	说明
order_id	int	订单 ID
order_no	string	订单编号
status	string	订单状态（matching = 待匹配）
order_type	int	订单类型（2 = 卖出）
cny_amount	decimal	CNY 金额
usdt_amount	decimal	USDT 数量
merchant_amount	decimal	商户需要支付的 USDT 数量
merchant_actual_amount	decimal	商户实际扣款 USDT 数量
customer_payment_method	object	客户收款方式信息
createtime	int	创建时间戳

响应示例

{
    "code": 1,
    "msg": "订单创建成功",
    "data": {
        "order_id": 12345,
        "order_no": "ORD202511041234567891",
        "status": "matching",
        "order_type": 2,
        "cny_amount": 1000.00,
        "usdt_amount": 138.50,
        "merchant_amount": 138.50,
        "merchant_actual_amount": 139.88,
        "customer_payment_method": {
            "bank": "中国工商银行",
            "sub_bank": "北京朝阳支行",
            "card_number": "6222021234567890123",
            "real_name": "张三",
            "full_info": "中国工商银行 - 张三 (0123)"
        },
        "createtime": 1699065600
    }
}