PISCES

主题

买单接口（买入USDT） ​

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

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

端点 ​

POST /addons/huanyu/merchant/createOrderSimple

买单不需要提供支付方式，系统会自动匹配有收款方式（银行卡 / 微信 / 支付宝）且符合金额区间的交易员，按交易员最后接单时间轮询。匹配到的收款方式类型可能是银行卡、微信或支付宝，由系统决定。

TIP

买单不需要提供客户的支付方式，系统会自动匹配有收款方式且符合金额区间的交易员。默认只匹配银行卡类型的交易员；如需匹配微信或支付宝，通过 method_type 参数指定。

请求参数 ​

参数名类型必填说明
order_typeint是订单类型，买单固定为 1
cny_amountdecimal是买入 CNY 金额，必须大于 0
customer_namestring否客户姓名（可空，用于风控留底）
id_cardstring否客户身份证号（可空，用于风控留底）
mobilestring否客户手机号（可空，用于风控留底）
merchant_order_nostring否商户单号，商户自定义业务单号，用于对账（限长 255）
method_typestring否指定匹配交易员的收款方式类型：bank=银行卡（默认）、wechat=微信、alipay=支付宝。不传时默认匹配银行卡

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

响应参数 ​

参数名类型说明
order_nostring订单编号
merchant_order_nostring商户单号（下单时传入，原样回传）
statusstring订单状态（pending = 待支付）
order_typeint订单类型（1 = 买入）
cny_amountdecimalCNY 金额
payment_methodobject匹配的交易员支付方式
merchant_amountdecimal商户实际获得 USDT 数量
deposit_amountdecimal保证金金额
service_amountdecimal服务费金额
merchant_actual_amountdecimal商户实际到账 USDT 数量
createtimeint创建时间戳
pay_urlstring订单详情页链接，浏览器打开可查看收款信息（银行卡 / 收款码）并上传转账凭证

pay_url 使用说明

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

请求示例 ​

json
{
    "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",
    "method_type": "wechat"
}

响应示例 ​

json
{
    "code": 1,
    "msg": "订单创建成功",
    "data": {
        "order_no": "ORD202511041234567890",
        "merchant_order_no": "MOC20260713001",
        "status": "pending",
        "order_type": 1,
        "cny_amount": 1000.00,
        "payment_method": {
            "method_type": "bank",
            "bank": "中国银行",
            "sub_bank": "北京分行",
            "card_number": "6217*********1234",
            "account": "",
            "qr_code": "",
            "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"
    }
}