交易创单API(rest.create) - shoufuyou/Shoufuyou-SDK-Doucument-for-core-client GitHub Wiki
method: rest.create
商户请求首付游生成首付游交易单。
app接入请尽量将webview上面native bar的底背景置成白色
| 参数 | 参数名称 | 类型 | 必填 | 描述 | 范例 |
|---|---|---|---|---|---|
| merchant_order_id | 商户订单号 | String | 是 | 用户在商家的订单侧重旅游业务，称之为业务订单 | 10010101 |
| product_type | 产品类型 | String | 是 | 产品类型：free_tour：自由行group_tour：跟团游local_tour：当地游flight：机票 | flight |
| product_name | 产品名称 | String | 是 | 产品名称 | 上海到东京五天三晚自由行 |
| product_url | 产品url | String | 否 | 产品url | http://xx.com/products/10847841 |
| product_id | 产品id | String | 否 | 产品id号 | 10847841 |
| order_amount | 订单总价 | Int | 是 | 订单总价（单位为分） | 200000（2000元） |
| periods | 分期数 | Int | 是 | 订单分期数，目前支持1,3,6,12 输入0等于输入1 | 12 |
| time_limit | 订单有效时长 | Int | 是 | 订单有效时长（分钟），超过有效时间首付游将关闭该交易 | 30 |
| tourist_adult_number | 成年出行人数 | Int | 是 | 大于12周岁的是成年 | 1 |
| tourist_kid_number | 儿童出行人数 | Int | 是 | 2周岁（含）到12周岁（含）间的是儿童 | 0 |
| tourist_baby_number | 婴儿出行人数 | Int | 是 | 小于2周岁的是婴儿 | 0 |
| flight_number | 航班号 | String | 否 | 航班号（联程机票只需传输第一个航段的航班号） | Ca9583 |
| departure | 出发城市 | String | 是 | 出发城市（联程机票只需传输第一个出发城市） | 上海 |
| arrival | 目的地城市 | String | 是 | 目的地城市（联程机票只需传输最后一个目的地城市） | 东京 |
| departure_date | 出发日期 | String | 是 | 出发日期（格式yyyy-MM-dd） | 2016-03-04 |
| return_date | 返程日期 | String | 是 | 单程机票该项可为空 | 2016-03-26 |
| departure_time | 出发时间 | String | 是 | 出发时间（格式yyyy-MM-dd HH:mm:ss） | 2016-03-04 09:52:00 |
| arrival_time | 到达时间 | String | 是 | 到达时间（格式yyyy-MM-dd HH:mm:ss） | 2016-03-04 12:35:00 |
| hotel_class | 酒店星级 | Int | 否 | 酒店星级：1, 2, 3, 4, 5 | 4 |
| source_type | 订单来源类型 | String | 是 | 订单来源类型：ios, android, pc, wap, sdk可以根据此字段自动路由到pc或mobile. | android |
| extra_param | 额外参数 | String | 否 | 若使用该字段，则用户传非空值，收单接口原样返回 | android |
| tourists | 出行人列表(只传大人信息) | Array | 是 | 出行人列表，根据出行人数填写，Tourist定义详见下方。 | [{"name":"刘少帅","name_spelling":"liushaoshuai","id_card_number":"610481199207013453","mobile":"18629488128","email":"[email protected]"}] |
| loan_user | 主贷款人 | String | 是 | 主贷款人，有可能与出行人相同，也有可能不同。 | {"name":"刘少帅","name_spelling":"liushaoshuai","id_card_number":"610481199207013453","mobile":"18629488128","email":"[email protected]"} |
| ip | 用户ip | String | 必填 | 客户端IP | '127.0.0.1' |
| 参数 | 参数名称 | 类型 | 描述 | 范例 |
|---|---|---|---|---|
| trade_number | 交易号 | String | 首付游交易号 | 201803131853052215 |
| merchant_activity | 商家活动 | jsonArray | 商家活动 | 参照返回 |
| pay_info | 支付信息 | jsonArray | 支付信息 | 参照返回 |
| coupons | 优惠券 | jsonArray | 当前订单可用优惠券信列表 | selected为创建订单所选优惠券id，items为当前用户在当前商户可用所有券列表 |
| code | 状态码 | Int | 10000 | |
| message | 错误消息 | String | 参照返回 |
{
"trade_number":"201803281846070825",
"merchant_activity":[
],
"pay_info":{
"order_amount":120000,
"down_payment":0,
"monthly_payment":120000
},
"coupons":{
"selected":[
],
"items":[
{
"id":1,
"created_time":"2018-01-19 10:18:25",
"discount_amount":110000,
"periods":"all",
"discount_name":"总价立减1100.00元",
"discount_type":"order",
"is_valid":"1"
},
{
"id":5039,
"created_time":"2017-12-04 16:18:39",
"discount_amount":110000,
"periods":"4",
"discount_name":"三期免息",
"discount_type":"free_interest",
"is_valid":"1",
"discount_rate":"0.000000"
},
{
"id":5381,
"created_time":"2018-01-08 15:25:34",
"discount_amount":110000,
"periods":"3,4",
"discount_name":"砍价活动3期免息券",
"discount_type":"free_interest",
"is_valid":"1",
"discount_rate":"0.000000"
}
]
},
"code":"10000",
"message":"请求成功"
}
| 参数 | 参数名称 | 类型 | 描述 | 范例 |
|---|---|---|---|---|
| code | 状态码 | Int | 4005为需要绑卡的code，可做判断依据 | |
| message | 错误消息 | String | 参照返回 | |
| trade_number | 首付游订单号 | String | 201803131853052220 |
{
"code":4005,
"message":"请完善信息",
"trade_number":201803131853052220
}