# 交易下单（买单）

通过接口创建OTC买币订单。买币订单在未付款之前，可通过接口进行取消。

# 请求地址

环境

HTTPS请求地址

正式生产环境

/v1/api/order/create/buy

测试环境

/v1/api/order/create/buy

# 请求方式

  • POST

# 业务请求参数

参数 类型 是否必填 最大长度 描述 示例值
kyc_name String 是 -- 姓名 赵小帅
kyc_id_card_type String 是 - 证件类型(1.身份证 2.护照 3.其他) 1
kyc_card_num String 是 - 证件号码 110122199506081123
area_code String 是 - 国际区号(默认+86，香港+852/台湾+886/澳门+853) +852
mobile String 否 - 手机号码 57176688
email String 是 - 电子邮件 abc@xpay.pro
coin_name String 是 - 币种 USDT
legal_currency String 是 - 法币币种 CNY
coin_amount String 是 - 下单数量 1000
legal_currency_amount String 是 - 法币订单金额 7020
merchant_order_no String 是 - 商户订单编号 1235558888
return_url String 是 - 返回地址 https://**.****.io/pay/success
callback_url String 是 - 回调地址 https://**.****.io/notify_test
price_timestamp String 是 - 报价时间戳 15764312370

# 业务响应参数

参数 类型 是否必填 最大长度 描述 示例值
code Integer 是 -- 状态码 0
msg String 是 -- 网关返回码描述 SUCCESS
data Object 是 - 返回信息

# 响应成功示例

{
    "code": 0,
    "data": {
        "pay_url": "https://paygate.xpay.pro/buy?token=793f2c6583cd44bd8da6e5ed81f969646d2687c...",
        "token": "793f2c6583cd44bd8da6e5ed81f969646d2687c..."
    },
    "msg": "SUCCESS"
}

买币订单-取消 keyboard_arrow_right