PISCES

主题

卖单接口（卖出USDT） ​

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

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

端点 ​

POST /addons/huanyu/merchant/createOrderSimple

WARNING

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

请求参数 ​

参数名类型必填说明
order_typeint是订单类型，卖单固定为 2
cny_amountdecimal是卖出 CNY 金额，必须大于 0
customer_namestring否客户姓名（可空，用于风控留底）
id_cardstring否客户身份证号（可空，用于风控留底）
mobilestring否客户手机号（可空，用于风控留底）
merchant_order_nostring否商户单号，商户自定义业务单号，用于对账（限长 255）
payment_methodobject是客户收款方式信息

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

payment_method 对象参数 ​

签名注意

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

参数名类型必填说明
method_typestring是收款方式类型：bank=银行卡、wechat=微信、alipay=支付宝（默认 bank）
real_namestring是收款人姓名（三种类型均必填）
bankstring条件必填银行名称（仅 bank 类型必填）
sub_bankstring条件必填支行名称（仅 bank 类型必填）
card_numberstring条件必填银行卡号（仅 bank 类型必填）
accountstring条件必填微信号 / 支付宝账号（仅 wechat/alipay 类型必填）
qr_codestring条件必填收款码图片 URL（仅 wechat/alipay 类型必填）

类型与必填字段对照：

method_type必填字段
bankreal_name、bank、sub_bank、card_number
wechatreal_name、account、qr_code
alipayreal_name、account、qr_code

请求示例 ​

银行卡类型：

json
{
    "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",
    "merchant_order_no": "MOS20260713001",
    "payment_method": {
        "method_type": "bank",
        "bank": "中国工商银行",
        "sub_bank": "北京朝阳支行",
        "card_number": "6222021234567890123",
        "real_name": "张三"
    }
}

微信类型：

json
{
    "payment_method": {
        "method_type": "wechat",
        "account": "zhangsan_wx",
        "qr_code": "https://example.com/wx-qr.png",
        "real_name": "张三"
    }
}

支付宝类型：

json
{
    "payment_method": {
        "method_type": "alipay",
        "account": "zhangsan@example.com",
        "qr_code": "https://example.com/alipay-qr.png",
        "real_name": "张三"
    }
}

响应参数 ​

参数名类型说明
order_idint订单 ID
order_nostring订单编号
merchant_order_nostring商户单号（下单时传入，原样回传）
statusstring订单状态（matching = 待匹配）
order_typeint订单类型（2 = 卖出）
cny_amountdecimalCNY 金额
usdt_amountdecimalUSDT 数量
merchant_amountdecimal商户需要支付的 USDT 数量
merchant_actual_amountdecimal商户实际扣款 USDT 数量
customer_payment_methodobject客户收款方式信息
createtimeint创建时间戳

响应示例 ​

json
{
    "code": 1,
    "msg": "订单创建成功",
    "data": {
        "order_id": 12345,
        "order_no": "ORD202511041234567891",
        "merchant_order_no": "MOS20260713001",
        "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": {
            "method_type": "bank",
            "bank": "中国工商银行",
            "sub_bank": "北京朝阳支行",
            "card_number": "6222021234567890123",
            "account": "",
            "qr_code": "",
            "real_name": "张三",
            "full_info": "中国工商银行 - 张三 (0123)"
        },
        "createtime": 1699065600
    }
}