创建订单

该接口用于创建票牛订单,创建订单会锁定商品库存。创建后订单会保留15分钟,超时后会关闭。创建成功后,可以支付订单

POST /openapi/v2/order/makeOrder

参数

context-type "application/x-www-form-urlencoded"
name 类型 是否必填 意义 取值
sign String 签名 483DFD2E8BE0AF2D486F04C7320C7C5E
appId int 代理商的唯一id 1
timeStamp long 时间戳 有效期10分钟 1482995969920
orderId String 代理商订单id js8asa8su
count int 数量 1
amount Bigdecimal 金额 (单位元,精度小数点后一位,没有邮费必须和商品金额一样,如果有邮费则是商品金额加上邮费) 100
ticketGroupId int 直接购票商品id 121 (deprecated,建议使用ticketCategoryId)
ticketCategoryId int 直接购票票档id 111
areaTicketType int 选座方式 0:"直接购票", 1:"选座" , 3:"选排" ,目前仅支持直接购票
ticketGroupIds List 选座/选排参数 商品数组 选座/选排 必填
deliverType int 配送方式 1快递,2门店自取,3现场自取,4电子票
postage Bigdecimal 邮费 快递全国统一收取邮费10元,免邮则不收取(具体和商务洽谈),如果传了邮费则amount字段需要加上邮费
receiverName String 收货人姓名 老王
phone String 收货人手机号码 13700000000
district String (快递必填)行政区,按照给出 district.md 上海市上海市静安区
address String (快递必填)收货地址 余姚路339号(百乐门商务楼)2楼东区
idCards String (演出要求则必填)身份证信息:姓名,身份证号(这里使用json字符串), 需要拓展实名类型见关于实名信息字段 [{"name":"李雷","idCard":"320829199909090009"},{"name":"韩梅梅","idCard":"320829199909090009"}]
关于实名信息字段

对于实名信息进行升级,增加多种证件类型,部分存在强实名校验

name 类型 定义
name String 姓名
idCardType int 证件类型, 默认为1身份证, 详见下方关于实名类型
idCard String 证件号
关于实名类型
证件类型 idCardType
身份证 1
护照 2
港澳居民来往内地通行证 3
台湾居民来往大陆通行证 4
港澳台居民居住证 5
外国人永久居留身份证 6
请求示例(测试环境):
   curl -X POST http://openapibeta.piaoniu.com/openapi/v2/order/makeOrder\
   -v -d "orderId=js8asa8su&count=1&amount=100&ticketGroupId=121&receiverName=%E8%80%81%E7%8E%8B&phone=13700000000&district=%E4%B8%8A%E6%B5%B7%E5%B8%82%E4%B8%8A%E6%B5%B7%E5%B8%82%E9%9D%99%E5%AE%89%E5%8C%BA&address=%E4%BD%99%E5%A7%9A%E8%B7%AF339%E5%8F%B7%EF%BC%88%E7%99%BE%E4%B9%90%E9%97%A8%E5%95%86%E5%8A%A1%E6%A5%BC%EF%BC%892%E6%A5%BC%E4%B8%9C%E5%8C%BA&appId=10000&timeStamp=1489795985518&sign=13D25407EE9E2332545DA1AF186056E5"\
   -H "Content-Type: application/x-www-form-urlencoded"

返回值 :

name 意义 取值
success 是否成功,成功后会返回订单号,错误会返回错误码及提示 true/false
orderId 票牛订单,方便对账 12102910
errorCode 错误码,详见下表 PRAM_ERROR
errorHint 错误提示 收货地址不全
errcode含义:
错误码 含义
PARAM_ERROR 参数错误,例如:收货地址不全
USER_ERROR 用户被限制下单,例如:未支付订单数超过3单
CAMPAIGN_ERROR 活动错误(目前第三方系统对接没有活动信息,故不会出现此错误),例如:没有参加活动资格
TICKET_ERROR 商品错误,例如:该商品已下架
STOCK_ERROR 数量错误,例如:库存不足
PRICE_ERROR 价格错误,例如:总金额与商品金额不匹配
OTHER_ERROR 其他未知错误
建议联调时通过业务对齐,减少PARAM_ERROR/USER_ERROR出现。
建议当出现TICKET_ERROR/STOCK_ERROR/PRICE_ERROR时,重新调用商品库存及价格查询接口同步该商品信息。
示例(成功):
   {
     "success":true,
     "orderId":12102910
   }
示例(失败):
   {
     "success":false,
     "errorCode":"STOCK_ERROR",
     "errorHint":"商品已售空"
   }

results matching ""

    No results matching ""