买单接口（商户充值）

POST  /merchant/createOrder

商户充值人民币到账户，通过支付渠道系统处理。

流程： 商户创建订单 → 调用支付渠道接口 → 支付渠道处理 → 通知商户回调。

请求参数

参数名	类型	必填	说明
order_type	int	是	订单类型，买单固定为 1
cny_amount	decimal	是	充值的人民币金额，必须大于 0
paychannel_id	int	是	支付渠道 ID，用于指定使用的支付渠道
paychannel_paymethod	string	是	支付方式（wxpay=微信支付、alipay=支付宝、bank=银行卡）
customer_name	string	否	客户姓名，选填

TIP

买单需要提供支付渠道 ID 和支付方式，系统会调用对应的支付渠道接口处理订单。可通过 获取支付渠道列表 查询可用渠道。

请求示例

{
    "api_key": "your_api_key",
    "timestamp": 1699065600,
    "nonce": "abc123def456",
    "signature": "generated_signature_here",
    "order_type": 1,
    "cny_amount": 1000.00,
    "paychannel_id": 1,
    "paychannel_paymethod": "alipay",
    "customer_name": "张三"
}

响应参数

参数名	类型	说明
order_no	string	订单编号
status	string	订单状态（pending=待支付）
order_type	int	订单类型（1=买入）
cny_amount	string	人民币金额
payment_method	string/null	支付方式
merchant_amount	string	商户应到账人民币数量
deposit_amount	int	保证金金额
service_amount	int	服务费金额
merchant_actual_amount	int	商户实际到账人民币数量（扣除服务费后）
pay_url	string	支付跳转 URL
createtime	int	创建时间戳

响应示例

{
    "code": 1,
    "msg": "订单创建成功",
    "time": "1768915718",
    "data": {
        "order_no": "ORD202601202128386362",
        "status": "pending",
        "order_type": 1,
        "cny_amount": "73000",
        "payment_method": null,
        "merchant_amount": "73000",
        "deposit_amount": 0,
        "service_amount": 2192,
        "merchant_actual_amount": 70808,
        "createtime": 1768915718,
        "pay_url": "http://www.huanyu-b2c.com:8032/addons/paychannel/pay/index?order_no=ORD202601202128386362"
    }
}

引导用户访问 pay_url 完成支付。支付完成后系统会通过 回调通知 告知商户结果。