交易收单接口(trade.create) - shoufuyou/Shoufuyou-SDK-Doucument-for-core-client GitHub Wiki


<<返回文档首页

功能描述

method: trade.create
商户请求首付游生成首付游交易单。

注：测试环境验证码：1234

app接入请尽量将webview上面native bar的底背景置成白色

请求参数说明

参数 参数名称 类型 必填 描述 范例
merchant_order_id 商户订单号 String 是 用户在商家的订单侧重旅游业务，称之为业务订单 10010101
product_type 产品类型 String 是 产品类型：free_tour：自由行 group_tour：跟团游 local_tour：当地游 flight：机票 hotel:酒店 flight
product_name 产品名称 String 是 产品名称 上海到东京五天三晚自由行
product_url 产品url String 否 产品url http://xx.com/products/10847841
product_id 产品id String 否 产品id号 10847841
order_amount 订单总价 Int 是 订单总价（单位为分），最小为1200 200000（2000元）
periods 分期数 Int 是 订单分期数，目前支持0,1,3,6,12，若分期选择在信用飞侧则传0 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
suppiler_name 供应商名称 Int 否 供应商名称 xx旅游
supplier_level 供应商评级 Int 否 供应商评级：1, 2, 3, 4, 5 5
hotel_class 酒店星级 Int 否 酒店星级：1, 2, 3, 4, 5 4
source_type 订单来源类型 String 是 订单来源类型：ios, android, pc, wap, sdk可以根据此字段自动路由到pc或mobile. android
extra_param 额外参数 String 否 若使用该字段，则用户传非空值，收单接口原样返回 android
return_url 回调地址 String 是 页面回调地址 https://xxx.com/return
notify_url 通知地址 String 是 异步通知地址 https://xxx.com/after-pay-notify
apply_id 额度申请id String 否 额度申请id号 1010110
apply_notify_url 额度开通通知地址 String 否 异步通知地址 https://xxx.com/after-apply-notify
tourists 出行人列表(只传大人信息) Array 是 出行人列表，根据出行人数填写，Tourist定义详见下方。 出行人列表，根据出行人数填写，Tourist定义详见下方。
loan_user 融资人 String 否 当出行人和融资人为一人时候，loan_user和tourists中的信息一致。(目前阶段，仅川航需要。) {"name":"刘少帅", "mobile": "610481199207013xxx", "id_card_number": "610481199207013xxx"}

备注：

  • 请求参数务必要真实，必须和商户处的订单信息一致
  • 首付游会从tourists里让用户选择一个作为贷款人，承担支付首付和后续还款的责任，因此商户需要在tourists里传输至少一个人的信息
  • 如果出行人多于一人，且商户拥有这些人的信息，则商户应该把这些人的信息传给首付游

Tourist：出行人列表里单个出行人的信息说明(只传大人信息)

参数 参数名称 类型 必填 描述 范例
name 姓名 String 是 出行人姓名 周小发
name_spelling 姓名拼音 String 否 出行人姓名拼音 Zhou Xiaofa
id_card_number 身份证号 String 是 出行人身份证号码 640521198608123792
mobile 手机号 String 是 出行人手机号码 1388888888
email 邮箱 String 否 出行人邮箱地址 [email protected]

备注：

  • Tourist只需传成年出行人信息即可
  • Tourist里至少要有一个人要满足：a) 姓名和拼音二者至少传一项；b)若商户无此人的身份证号和手机号，商户可以不传该信息，下单人进入到首付游页面后，首付游会要求补填身份证号和手机号
  • 除贷款人之外的其他出行人信息，商户如果有这些信息，需要把信息传过来；如果没有，可以不传

请求参数示例

{
　　"merchant_order_id":"201604181725081345",
　　"product_id":"1001215",
　　"product_name":"北京到东京自由行",
　　"product_type":"flight",
　　"product_url":"https://m.shoufuyou.com/products/1001363",
　　"price":180000,
　　"time_limit":30,
　　"tourist_number":1,
　　"departure":"北京",
　　"arrival":"东京",
　　"departure_date":"2016-03-05",
　　"return_date":"2016-03-08",
　　"hotel_class":4,
　　"source_type":"wap",
　　"emergency_name":"丁力",
　　"emergency_mobile":"18811701130",
　　"emergency_relationship":"朋友",
　　"return_url":"https://m.shoufuyou.com/pay/after_pay_return",
　　"notify_url":"https://m.shoufuyou.com/pay/after_pay_notify",
　　"tourists":[
　　　　{
　　　　　　"name":"王小二",
　　　　　　"id_card_number":"330281xxxxxxxx1756",
　　　　　　"mobile":"136xxxx4541",
　　　　　　"email":"[email protected]"
　　　　}
　　]
}

响应参数说明

参数 参数名称 类型 必填 描述 范例
code 返回的结果码 String 是 10000- 成功生成订单；非10000为错误码 10000
message 返回结果码对应的字符串解释 String 是 如code参数里的描述 请求成功
merchant_order_id 商户订单号 String 是 用户在商家的订单侧重旅游业务，称之为业务订单 10010101 如果成功生成交易单则应答里包含下述结果
trade_number 首付游交易号 String 是 本次请求首付游内部的交易号，可供今后商户查询或者对账使用 20151125181509213
order_amount 支付金额 Int 是 用户支付的订单金额（不包含首付游服务费） 180000（1800元）
trade_status 交易状态 String 是 'WAIT_PAY'，等待支付 'PAY_SUCCESS'，支付成功 'CANCELED'，已取消 PAY_SUCCESS
bill_url 首付游账单链接 String 是 首付游生成的账单地址： https://m.shoufuyou.com/user/bills?mobile=13888888888 https://bill-mobile.shoufuyou.com

响应参数示例

{
　　"code":"10000",
　　"message":"",
　　"trade_number":"201604281451098465",
　　"trade_status":"PAY_SUCCESS",
　　"merchant_order_id":"201604181725081345",
　　"order_amount":"180000",
　　"bill_url":"https://bill-mobile.shoufuyou.com"
}

首付游信用消费接口V2.4.0
2016.9

⚠️ **GitHub.com Fallback** ⚠️