# 交易下单（买单）

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

# 请求地址

环境

HTTPS请求地址

正式生产环境

/v1/api/s/order/create/buy

测试环境

/v1/api/s/order/create/buy

# 更新记录

时间

更新内容

2020-04

创建订单接口新增付款方式可选参数（pay_method）

# 请求方式

  • 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
pay_method String 否 - 付款方式 支付宝：ALIPAY；银行卡：BANKPAY
coin_name String 是 - 币种 USDT
legal_currency String 是 - 法币币种 CNY
coin_amount String 是 - 下单数量 1000
legal_currency_amount String 是 - 法币订单金额 7020
merchant_order_no String 是 - 商户订单编号 1235558888
face_vali_return_url String 是 - 人脸核身KYC验证后，跳转的地址 https://**.****.io/buy_order={order_no}
callback_url String 是 - 回调地址 https://**.****.io/notify_test
price_timestamp String 是 - 报价时间戳 15764312370

# 业务响应参数

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

# 响应成功示例

{
    "code": 0,
    "data": {
        "token": "793f2c6583cd44bd8da6e5ed81f969646d2687c...",
        "face_vali": false,   //是否需要人脸核身KYC认证，如果返回为true，请向用户打开face_vali_url中的页面
        "face_vali_url": "",  //当face_vali为true时，请向用户打开该页面地址
        "order_info":{     //如果face_vali为true时，进入人脸核身流程，将不返回order_info
          "order_no": "20200310024801992",
          "currency": "USDT",
          "legal_currency": "CNY",
          "legal_amount": "582.16",
          "side": "BUY",
          "amount": "79.00000000",
          "coin_price": "7.36920000",
          "status": "CREATED",
          "name": "张三",
          "bank_account_name": "李四",
          "bank_account_no": "62170000382626288",
          "bank_name": "招商银行",
          "bank_branch_name": "成都世豪广场支行",
          "alipay_account_no": "13322228888",
          "alipay_account_name": "维也纳粮油批发门市部",
          "alipay_account_qrlink": "data:image/jpeg;base64,..../vVD3Vt8tV3dVeOsd6+27nnnvuc889d3nfcmFJlC6T2u12KhQK",
          "plan_end_time": "2020-03-10 03:03:02",
          "created_time": "2020-03-10 02:48:02"
        }
    },
    "msg": "SUCCESS"
}

买币订单-付款 keyboard_arrow_right