票付通门票供应接口 - 广州自我游 - 自我游客户支持服务平台

修改日期：20230207
修改人：符娇珠

特别声明！！！

采购票付通系统的产品再对接到抖音抖音/美团/飞猪/快手等渠道进行分销，订单退改申请，商家必须按时处理。目前对接所有第三方渠道（包括但不限于抖音/美团/飞猪/快手等，及未来新增加的渠道），客人发起退改申请，超过要求的期限商家未处理，第三方会直接退款给客人。如因商家逾期未处理造成损失，由商家承担，自我游不承担责任。
商家每天应登录自我游系统查看订单退改申请列表，及时联系供应商处理订单退改。
目前已知的退改时限（客人发起推该请求算起），抖音72小时，美团24小时，去哪儿24小时，飞猪24小时（部分景区产品飞猪是按即时退款执行）。
关于退改时限要求会有调整，请以各平台官方通告为准。

接口实现功能

重新发码(支持)
主动抓取核销(支持)
取消订单(支持)
获取对方订单详情(支持)
查询对方接口日志(支持)
接口返码（支持，并支持回传二维码）

****温馨提示**** :API接口受网络影响较大，会存在一定风险，请运营商时刻留意接口订单状态及订单收款如有问题，请联系自我游公众号：自我游运营中心

合作协议

（运营商与票付通之间的合作协议）

票付通系统提供参数

图片.png

运营商需要提供参数

运营商给票付通接口开一个供应商账号，用于区别产品是哪个供应商系统提供的产品。【供应商帐号开通，参考该链接： http://kf.zowoyoo.cn/hc/kb/article/191732/】

00158cb9875300f30130fe9490cf98a

票付通技术配置

验证推送地址：http://运营商域名/api/piaofutong/finish.jsp（(票付通接口需要先配置回调地址才能提供接口参数)。

异步出票地址：http://运营商域名/api/piaofutong/printNotice.jsp

自我游系统发布及设置

一、产品导入

运营商到【供应商接口管理】---【已开通接口】，找到对应的票付通接口，操作同步供应商产品进入产品列表，搜索票付通后台的商品id，进行同步产品到系统。导入产品成功后会进入到产品发布编辑界面，产品基本信息都会同步，但是产品景点标志图等还有其他信息需要手工完善跟供应商产品设置一致即可。

①产品生成通知单需设置为：在预订(支付)成功后自动锁定订单，无需生成通知单。自我游系统的订单是在下达通知单时才同步到票付通。

00158cb98e33e48eb1516c63c071639

②产品短信：若是使用票付通的出票短信，在发布产品的时候就无需设置短信。

③如需要运营商发短信：【出票操作】设置为“需要”；【短信内容】需要编辑出票短信。出票短信内容编辑加入： $excode$ ， $excode2$ 这个是二维码链接

④对应接口：产品导入时自动对应接口。

⑤产品编码：产品接口编码位置绑定的产品编码后面加,1。如对接票付通产品编码是15452,75456,1452414 。那接口编码绑定的产品编码是15452,75456,1452414,1）

二、手工发布

运营商手工在自我游后台发布属性一致的门票产品，将以下列出的信息严格按照下面的要求来设置。

①产品生成通知单设置：在预订(支付)成功后自动锁定订单，无需生成通知单。自我游系统的订单是在下达通知单时才同步到票付通。

00158cb98e33e48eb1516c63c071639

②产品短信：若是使用票付通的出票短信，在发布产品的时候就无需设置短信。是自我游运营商发送短信：【出票操作】设置为“需要”；【短信内容】需要编辑出票短信。出票短信内容编辑加入： $excode$ ， $excode2$ 这个是二维码链接

③：对应接口：由自我游配置好接口后才会显示，选择自我游配置的票付通接口。

④产品编码：点击产品编码参考进入产品列表查询对应的票付通产品，将对应的绑定编码填写上。如下图：

【注：自我游填写的产品编码：景区ID,门票ID,供应商 ID （逗号要用英文小写逗号隔开），票付通后台的产品编码格式是：供应商id|景区id，门票id】

⑤票付通产品异步返码设置：产品接口编码位置绑定的产品编码后面加,1。如对接票付通产品编码是15452,75456,1452414 。那接口编码绑定的产品编码是:15452,75456,1452414,1 (产品是同步返码还是异步返码需跟票付通方核实）

测试环节

产品发布完毕，用分销商账号下单测试。

订单退款

订单状态“已出票”：客人/分销商发起退改申请，自我游系统会自动将退改申请请求推送到票付通系统，如存在自动推送退改申请请求到票付通系统失败的情况，运营商需在【订单管理】给订单操作“异常处理”允许取消并点击退款后，取消的申请才会下发到票付通系统，票付通系统返回是否取消成功的值（返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看）。票付通系统返回取消成功后，自我游系统的订单直接显示“撤单”。

订单状态“已完成”：分销商先线下联系运营商，然后运营商在【订单管理】给订单操作“异常处理”允许取消并点击退款后，取消的申请才会下发到票付通系统。然后票付通系统返回是否取消成功的值（返回取消成功的状态可以在自我游系统的订单详情-接口日志里查看）。票付通系统返回取消成功后，自我游系统的订单直接显示“撤单”。