接入与交付 / 客户技术方、票务方与机构方
票务与机构服务接入边界
明确通用适配能力与客户专属协议的边界，按契约开展真实联调。
按客户确认接入契约
门票和文交所是可挂接的客户应用，不是所有客户必须启用的平台功能。当前适配依据心中上海项目提供的三份合作接口 PDF；其他客户需提供自己的业务范围、服务商、协议版本、权限及验收条件。原合作文档不随官网发布。
票务适配
| 环节 | 当前实现与约束 |
|---|---|
| 查询 | 票种与预约时段接口，用户主动查询票务状态 |
| 预约 | 锁票 → 15 分钟内确认出票 → 查询 |
| 退回 | 未使用门票退回；结果未知时等待明确供应商证据 |
| 签名 | 服务端表单 POST 与合作文档规定的签名方案；私钥不进入客户端 |
| 消费 | 出票消耗兑换额度，入场同步仅更新票券状态 |
| 未交付部分 | 真实网关及闸机验收、多人/儿童票、生产轮询调度 |
当前合作文档没有直接的闸机核销写入接口，也没有核销 webhook。不能据此对外承诺实时双向闸机同步。票号与可扫码通行凭证必须单独确认。
机构资产服务
当前提供 /market 前缀下的 V1.6 兼容接口，服务端 POST JSON。appSecret 只能由登记的机构服务端携带。
/customInfo /own /rights
/lock /trade /unlock
/tradeResult /tradeStatus /assets- 锁定期间限制所有权变更和权益兑换；对应交割操作必须匹配机构、订单和锁。
- thirdId 对应系列，tokenId 对应实例；rightsCount 的剩余次数口径需由双方确认。
- 旧协议缺少锁轮次标识，默认同一资产单一锁生命周期。可选 lockNo 扩展必须由双方约定，不能假定对方支持。
- 交易幂等不等于资金已清算；金额单位、最终成功状态及资金最终性需明确。
- 当前客户市场地址和生产业务授权待确认，平台不会自动授予机构交易资格。
联调交付清单
- 服务方名称、业务用途、协议版本、测试与生产域名。
- 签名测试向量、回调白名单、时钟偏差和超时策略。
- 库存、配额、重复请求、未知结果、补偿及退回语义。
- 真实入场凭证、使用人及儿童/证件规则。
- 机构资产和资金状态最终性、冻结轮次及授权依据。
- 验收回执、值班联系人、密钥轮换与异常工单流程。
本地完整字段与现有适配器使用方法见仓库 docs/接口接入与联调.md。密钥、原合作 PDF 和客户测试账号不放入对外手册。