目录

一、订单状态与取值

二、门票的状态及状态取值

三、接口参数

四、支付方式分类

五、关于违约手续费

六、关于门票、取票和退票

七、关于分时段售检票

八、关于返佣

九、门票有效期

十、关于一人一票和多人一票

十一、关于现返

十二、关于异步通知

十三、谁还可以操作你的订单和代理商账户？

十四、整体流程说明

十五、关于官方游客通知

一、订单状态与取值

总个接口为订单设计了7种状态，分别是预定中，退款申请中，已关闭，已交割，已前台现付取票。状态转换如图2-1所示。

其中：

表示终止状态；

表示过程状态（虚线表示可能存在的状态，因系统设置而异）。

各状态转换对应的事件如下：

（1）前台现付取票（或自助机现付取票）；

（2）即时支付（含支付宝支付（即时到账）、微信支付、银联网上支付）；

（3）关闭订单；

（4）返款余额支付授权（使用支付密码或验证码完成支付授权）；

（5）预订金支付授权（使用支付密码或验证码完成支付授权）；

（6）即时支付核准（一般情况下不存在这个过程，不存在这个过程时，该事件的终止状态“已交割”会被事件（2）直接驱动）；

（7）申请退款（是针对整个订单申请的，此时尚不能对订单中的某一部分申请退款）；

（8）开始办理退款；

（9）完成办理退款。

注意：

订单第三方支付完成，且不需要人工核准，按理订单应转换成“已交割”，对于有库存管制且预制门票卡号的系统，尽管在付款前会执行相应的交割准备检查，仍不能保证100%交割成功，此时订单将停留在“第三方支付待核准”状态，由供应商工作人员人工核准并完成交割。交割不成功的主要原因可能是对应的票号没有库存。

各订单状态的取值如下表。

表:订单状态取值

订单状态	取值	隶属版本	备注
预定中	0	V1.0
已交割	3	V1.0
已关闭	4	V1.0
第三方支付退款申请中	7	V1.0
第三方付款退款办理中	B	V1.0
已前台现付取票	X	V1.0
已交割(返款)	D	V2.1

三、接口参数

本系统V2.3及以前的版本一共有六个接口参数，均由供应商（景区或演艺剧场提供），分别为用户名，单位ID，单位类型，加密密码，登陆密码，密钥密文。

本系统V3.0及以后的版本一共有四个参数，均由供应商（景区或演艺剧场提供），分别为用户名、加密密码、密钥密文和登陆密码。

用户名：发起对系统的访问时，唯一地标识某一个用户的代码，类型为字符串；

单位ID：字符串，最大长度36位。

单位类型：1位字符串，取值可以是“1”地接社，“2”组团社，“3”协议单位，“4”地接社部门，“5”组团社部门或办事处，“6”无定义，“7”导游员，“8”官方互联网。

加密密钥：字符串，36字符。需要注意的是，本系统不会以明文形式导出加密密钥，而是以密文的方式导出加密密钥。因此，景区提供给您时，分为加密密钥和密钥密文。密钥密文=TripleDes(加密密钥，加密密码)。加密密码是导出密钥的工作人员在导出时临时指定的。

登陆密码：访问系统时的密码。

密钥密文：TripleDes(加密密钥，加密密码)。

四、支付方式分类

本接口共支持四大类支付形式，分别是“前台现付”，“预订金”，“即时支付”和“返款余额支付”。

对于官方网站、官微、官方APP，对直客仅支持使用“即时支付”和“前台现付”。

对于代理商支持“前台现付”、“即时支付”、“预订金支付授权”和“返款余额支付”。

即时支付当前支持“支付宝”、“微信”和“银联网上支付”三种。

前台现付：下预订单，不进行付款，客人直接到前台付款的方式。

预订金支付：代理商先将资金付往供应商处，供应商将收到的金额存入电子门票系统代理商的账户内，下预订单之后，通过“手机验证码”或“支付密码”进行预订金支付授权，被授权的订单取票或激活时，从代理商的账户内扣除相应的金额。

返款余额支付：供应商将代理商曾经的业绩返佣结算并存储至电子门票系统内的代理商账户里，下预订单之后，通过“手机验证码”或“支付密码”进行返款余额支付授权，被授权的订单取票或激活时，从代理商的返款账户内扣除相应的金额。

注意：代理商在供应商处开设了接口账户，不代表可以使用上述所有的支付方式，代理商可以使用哪些支付方式，是可以被供应商在电子门票系统中设置的，仅有供应商允许的支付方式才可以在交易中使用。使用即时支付时，通过接口发起的支付将被接口接管，钱将付往供应商的指定账户。

五、关于违约手续费

本系统支持对互联网订单扣除违约手续费。扣除违约手续费是一个自动过程，发生在订单的交割、申请退款或退票的过程中。

违约的情形：

（1）前台现付的预订单在任何情形下，均不产生违约。退票时，如果要收取违约手续费，也与代理商无关，由售票员与游客当面交接并收取，退票退还现金。

（2）即时支付之后，订单交割之前（支付核准通过，此过程一般不存在），整单退款的，构成违约。

（3）即时支付并订单交割之后，申请退票的（订单对应的全部门票或部分门票），构成违约。

（4）预订金支付后、返款余额支付后，申请退票的（订单对应的全部门票或部分门票），构成违约。

违约的代价：

违约的代价是供应商在电子门票系统中设置的一组参数。对于景区类供应商，以日为单位作为最小的违约计费周期；对于演艺剧场类供应商，以小时为单位为最小的违约计费周期。违约的情形发生时，是否存在违约代价是依据供应商的设置来自动匹配的。

示例：某景区设置提前两天及以上申请退款或关闭订单不扣手续费；提前两天以内一天以上申请退款或关闭订单扣除每张票10元手续费；1天以内申请退款或关闭订单扣除每张手续费20元；约定取票日期当天或后续日期关闭订单扣除50元每张的手续费。则您关闭订单、少取票等违约的情形发生时，可能产生违约的损失。

一般情况下，游客量没有完全饱和（达到最大接待能力）的景区，是不会设置违约手续费的；接待能力完全饱和的景区设置违约手续费是必须的。演艺剧场因是有限供应，则一般都会设置违约手续费率。

六、关于门票、取票和退票

本接口V3.0以前的版本均只能对订单进行操作，V3.0的版本增加了对门票的操作。订单的取票和激活过程是将订单转化成门票的过程。V4.0接口取消了激活操作，订单一旦支付完成并得到确认，订单立即交割，不再需要调用激活操作（原有的激活操作仍然保留，但不论传入什么参数，都会返回为成功，且不会对订单和售票单执行任何操作）。

对于一个订单，关闭、现付取票或支付完成意味着订单进入终止状态，但代理商的业务并未终结。对于关闭，订单就此完结，没有后续。对于现付取票，订单转化成售票单，游客获得了门票，后续均由游客直接与供应商面对面沟通，进行消费或退票。对于即时支付、预订金支付授权、返款余额支付授权，订单转化成售票单，并下发了对应的手机二维码门票或以身份证作为门票使用并下发了入园许可通知。游客入园的，代理商没有后续业务；游客不入园的，可以直接到窗口或在代理商处办理退票。在代理商处办理退票的，遵循钱从哪来退回哪去的原则执行退款；游客在窗口直接办理退票的，请参看2.7.3关于退款。

6.1门票的表现形式

本系统一共支持三种类型的门票形式。

物理票一：纸制票、IC卡门票、磁条卡门票。前台购票、取票，自助机购票、取票，游客所获得是物理介质的门票。具体客人获得的是纸制、IC卡还是磁条卡或是其他类型的物理介质，是根据景区的现实情况而定的。

物理票二：二代居民身份证。对于有实名制要求、一人一票的门票类型，订单所订门票符合激活要求的，可以直接激活订单。订单被激活后，订单内所指明的身份证可直接检票通过供应商所设道闸或消费机。是否允许使用身份证过闸或消费是供应商可以设置的。

虚拟票：手机二维码（或图片）门票。不论门票类型是否有实名制要求、一人一票还是多人一票，订单所订门票激活的，可以获得从门票系统发来的门票图片，该图片上一般存在一个或多个条码（一维码或二维码），使用这个图片可直接检票通过供应商所设道闸或消费机。是否允许使用手机虚拟票过闸或消费是供应商可以设置的。

6.2关于发票

原则上，订单交割之后，游客或代理商是可以获得发票的。对于直客（来自官网或网微等渠道），可以到供应商前台领取发票；没有领取票，可以要求投递发票。供应商是否支持投递发票，由供应商自行声明。代理商所收客人如何获取发票、代理商本人如何获取发票，不在本文的论述范畴，请在与供应商签订的合作合同中明确。

新版本电子门票系统已事实上支持电子发票（增值税普通发票）的开具，开具后发票将推送到下订单时指定的“手机号码”。也可以凭门票在供应商处的“发票自助打印机”上打印纸质版本。供应商是否提供电子发票请咨询供应商本身。

6.2关于退票退款

根据发起退票方式的不同，系统共支持两种方式退票。

方式一：游客前台退票。

对于前台现付的游客，退票时，直接获得与门票票面价格等额的现金退款（若有手续费，则将扣除相应手续费）。

对于预订金支付的游客，退票时，将与票面价格等额金额（若有手续费，则将从票面价格等额金额中扣除相应手续费）充值至对应的代理商预订金支付账户，客人不能直接从供应商获得退款，客人应退还的余额由供应商再行办理退款手续。

对于支付宝、微信等即时支付，退票时，以现金方式返还票面价格扣除手续费后（如果有）的净额。

对于返款余额支付授权，退票时，将与票面价格等额金额（若有手续费，则将从票面价格等额金额中扣除相应手续费）返还至对应的代理商返款账户，客人不能获得退款，客人应退还的余额由供应商再行办理退款手续。

方式二：客人通过代理商网上退票的。

前台现付取票的，不存在网上办理退票。

即时支付、预订金支付、返款余额支付的，均遵循从哪来退回哪去的原则，按票面价格，扣除相应手续费后（如果有）的净额，返还至来源账户（即时支付的，将产生退款申请等待供应商财务办理）。

6.4订单交割后身份证无法阅读的怎么办？

当您的订单交割后指定二代证过闸，但身份证在闸机处无法阅读的，均在检票点直接受理补出一张物理介质的门票。

七、关于分时段售检票

对于接待超级饱和的景区，使用本公司的电子门票系统的分时段售检票功能的，支持您预订时获得确定的检票时间段。

注意：分时段售检仅适用于景区类型的供应商。演艺剧场类的供应商本身是供给有限的，每张门票都具有特定的场馆、场次和开演时间。

下面是一个分时段售检票纸制一维码门票的示例。

对于启用了分时段售检票的电子门票系统，请保持同一批游客在同一个预订单内。系统会保证一个预订单交割在同一个时段内，则客人可以在相同的时间内排队和游览。否则可能产生同一批游客，预订在不同的时间段，将给游客带来不便。

分时段售检票所分配的时段为检票的预计时间区间，客人在此时间段内前往检票口，可以获得大为缩短的排队时间，获得更好的游客体验。一般情况下，未到达时段的游客前往检票口是不能进行检票排队的，因此请提醒客人不必早到。对于因故延误的，其门票的游览权利仍然有效，可以在后续时段前往检票口，不同的供应商可能有不同的对于延误游客的安排，通常情况下迟到的游客都将会面临比准时到达的游客更长时间的排队。

八、关于返佣

返佣本身并非本文的讨论范畴，此处声明的是，在代理商处销售的门票交割之后，游客再行退票的，代理商是不能获得返佣的。具体的情形请在和景区的合同中进行约定。

九、门票有效期

门票有效期是指从订单生效日期起，对应的门票产品的使用期限，以供应商的官方声明为准。

十、关于一人一票和多人一票

此为电子门票系统的概念，由供应商进行设置。供应商有以下选择：强制一人一票、通常情况下多人一票、一人一票或多人一票自选。

对于实行一人一票的，门票取票或激活后，游客可以单张退票。

对于实行多人一票的，整个订单中的每一种门票类型仅产生一个门票账户，游客退票时一次要退一个类型的门票，不能单张退票。

对于景区实行了现返的情形，一人一票出票的，概不能退。

对于景区实行了现返的情形，多人一票出票的，可以整体退票。

示例：

一个订单订了3张成人票，2张儿童票，若是一人一票制，激活或取票后，客人可以单张退票。若是多人一票制，则该订单只产生两张门票，一张是3成人，另一张是2儿童，则游客退票时，只能一次退完3成人或2儿童，不能一个一个退。

十一、关于现返

现返是供应商直接发布的价格政策，均是N免X政策。如“天门山网络票2016-01-01至2016-03-31十免一”，则表示在此期间购买该门票时，单个订单内“天门山网络票”达到十个时，将直接免除一个人的门票款；达到二十个人时，直接免除两个人门票款，以此类推。

现返的部分是不会计入返佣的。

现返是不允许被代理商截留作为利润的，只能直接让利给游客。

十二、关于异步通知

为让实现了交易接口软件对接的客户更好地开展业务，在本版本中添加了异步通知流程。订单的状态发生变化（订单状态通知）、支付完成或游客发生退票（成交结果变化）的情形时，第三方系统将获得异步通知。通知的地址可以通过本系统的API进行设置。

当一个订单发生了多个需要通知的事件，我们总是会顺序地发出通知，通知不成功时，后续的通知不会偿试传送，但不会因此阻其他订单事件的传送。

对于任何一个订单，我们均会偿试在此事件发生后的24小时内，不段偿试传送，直至事件传送成功。24小时后不再偿试。

对于事件异步通知不成功的，会产生本系统与第三方系统的数据不一致问题，请通过接口查询获得最新数据。

十三、谁还可以操作你的订单和代理商账户？

在我们的系统设计中，供应商拥有至高无上的权利，订单除代理商以外，供应商是可以干预的。干预的职能通常安排在供应商的财务部和市场部。他们可以对代理商账户、订单进行必要的操作。

供应商可以有以下行为：

（1）禁用或启用代理商的账户；

（2）为代理商的账户充值返款余额；

（3）为代理商的账户充值预订金；

（4）从代理商的预订金账户内扣款；

（5）允许或禁止代理商使用某些付款方式；

（6）授权代理商能卖或不能卖某种门票；

（7）更新会话密钥；

（8）修改用户名和密码；

（9）修改绑定的手机；

（10）禁止某个订单出票；

（11）执行退款等。

注意：

供应商是不能查阅和修改支付密码的。

十四、整体流程说明

14.1前台现付、取票的流程

流程说明：

（1）下预订单；

（2）放弃预订或订单过期时关闭订单，流程终结；

（3）购票（在前台现付购票或自助机现付购票），游客获得物理介质门票；

（4）游客持票过闸（消费），流程终结；

（5）游客持票办理退票，流程终结。

注意：

在本流程（2）、（3）、（4）、（5）发生时，将给第三方系统发出异步通知。

14.2预订金支付、取票或激活的流程

流程说明：

（1）下预订单。

（2）若放弃预订则直接关闭订单。

（3）使用支付密码或者手机短信验证码完成预订金支付授权，您预订金账户余额足够时，将从您的预订金账户扣除对应票款，根据订单的属性及系统设置，系统将预订单转换成售票单，预订单状态变为已交割（此时已可以获取订单对应的票号，以便于单张退票），需要且接口方允许给游客发送手机门票或通知短信的，系统将给游客发送手机门票或通知短信。

（4）至前台换票、自助机换票后持票过闸，或直接使用您的二代身份证、收到的手机二维码门票过闸，流程终结。

（5）若放弃使用，已换票的游客可至前台退票；退票后扣除手续费（如果有）的部分将返还至代理商的预订金账户，代理商应为游客办理退款；未换票的游客可以在代理商处申请退票，退票后扣除手续费（如果有）的部分将返还至代理商的预订金账户，代理商应为游客办理退款。

注意：

在本流程（2）、（3）、（4）、（5）将给第三方系统发出异步通知。

14.3即时支付、取票或激活的流程

流程说明：

（1）发起预订。

（2）若放弃预订，可直接关闭订单。

（3）发起并完成支付。

（4）（供应商）执行收款核准（这是一个可选可程，一般为自动核准）；被核准后系统将预订单转换成售票单，预订单状态变为已交割（此时已可以获取订单对应的票号，以便于单张退票），需要且接口方允许给游客发送手机门票或通知短信的，系统将给游客发送手机门票或通知短信。

（5）至前台换票、自助机换票后持票过闸，或直接使用您的二代身份证、收到的手机二维码门票过闸，流程终结。

（6）若放弃使用，已换票的游客可至前台退票；退票后扣除手续费（如果有）的部分将直接退还给游客，代理商不必再为游客办理退款。未换票的游客可以在代理商处申请退票，退票后扣除手续费（如果有）的部分将生成退款申请等待供应商财务部办理，代理商应为游客办理退款。

注意：

在本流程（2）、（3）、（4）、（5）、（6）将给第三方系统发出异步通知

核准过程是在系统发生被黑客攻击的情形，仍能保障业务不中断的措施。一般情况下，供应商处的系统都是自动核准的，实现没有任何操作。核准的过程为：财务人员查询款项是否到账，对应的订单号是否正确，人工确认这个钱收到了。

14.4返款余额支付、取票或激活的流程

流程说明：

（1）下预订单。

（2）若放弃预订则直接关闭订单。

（3）使用支付密码或者手机短信验证码完成返款余额支付授权，若您返款账户余额足够时，将从您的返款账户扣除对应票款，根据订单的属性及系统设置，系统将预订单转换成售票单，预订单状态变为已交割（返款）（此时已可以获取订单对应的票号，以便于单张退票），需要且接口方允许给游客发送手机门票或通知短信的，系统将给游客发送手机门票或通知短信。

（4）至前台换票、自助机换票后持票过闸，或直接使用您的二代身份证、收到的手机二维码门票过闸，流程终结。

（5）若放弃使用，已换票的游客可至前台退票；退票后扣除手续费（如果有）的部分将直接退还至代理商的返款账户，代理商需为游客办理退款。未换票的游客可以在代理商处申请退票，退票后扣除手续费（如果有）的部分将直接退还至代理商的返款账户，代理商应为游客办理退款。

注意：

在本流程（2）、（3）、（4）、（5）将给第三方系统发出异步通知。

十五、关于官方游客通知

当前电子门票系统对于来自互联网的业务，设计了官方通知，将在“交割成功”时发送。

交割成功：订单转入到“已交割”(任何形式的支付完成)时，向订单指明的手机号码发送一条短信(一个订单只有一条短信)，通知其订购成功的信息、取票时间地点，落款均为供应商本身。同时，对于提供了手机号码的游客（每一位游客），若该游客以手机二维码过闸，则将为该游客发送一条带有二维码链接的手机短信；或该游客以二代身份证过闸，则将为该游客发送一条指导如何使用二代身份证过闸的通知短信；如果游客确定换票后过闸，则将发送一条如何换票的通知短信。

代理商可以要求不发送官方的通知短信和彩信，本文在后续的接口“SetAgentParameters.aspx”中进行了描述。