element


对接前必读

  • 测试环境地址为:http://test.tuzyp.com/
appid:10000000000
appSecret:0f73ec201b877338541a54f49394bccb
所有接口均需要签名, 详情请看[基本参数及校验]
  • 正式环境地址为:https://dy.tuzyp.com/

关于业务流程的模拟

测试环境没有真实的商家在报价和出票,因此需要开发者自行模拟竞价、出票、同步取票码、结算、订单关闭5个事件。

模拟方式为:

1. 开发者调用【回调流程测试】对应的5个接口;

2. 服务方系统接收到回调请求会对所要模拟的订单号进行对应的动作触发;

3. 开发者配置的回调接收地址会收到回调响应内容;

因回调流程测试会改变被操作的订单号对应的状态,一张订单重复模拟同一个回调事件无效。 线上正式环境对应的这5个事件是系统根据业务实际情况自然流转进行的,不需要开发者进行模拟。

流程

4. 回调事件触发后, 接入方需要接收并返回一个成功标识, (重要)

{
    code: 200
    message: "success"
}

如果开发者商户的应答不是成功或超时,将被服务方认为通知失败,服务方会通过一定的策略重新发起通知,尽可能提高通知的成功率,但不保证通知最终能成功。(通知频率为15/15/30/180/1800/1800/1800/1800/3600,单位:秒)

关于影票费用的结算

开发者使用接口下单之前,服务方仅提供市场参考价(对标淘票票),即“场次排期”接口对应的netPrice响应字段。个别场次有价格分区,请根据[场次排期接口]的scheduleArea分区列表进行定价参考。

服务方接收到开发者提交的受理订单后,递交商家报价,报价金额不高于市场价netPrice - 折扣sale(高于这个价格将出票失败,订单关闭)。具体报价金额以订单提交后,WAIT_TICKET回调事件返回的orderPrice为准。开发者也可以任意时候通过订单查询接口获知票价结算成本(WAIT_TICKET事件之后才有该数值)。

订单服务方提供的影票成本价已包含运营费用,在订单提交之后预先冻结余额中的影票市场价原价。影片播放结束后结算实际的影票成本并释放冻结金额。

页面列表

ITEM_HTML