尊敬的服务商您好：

人民银行针对条码支付进行升级，对收单侧接口规范进行了调整，新增终端信息相关字段， 收单机构需在交易中完整、准确上送终端相关信息。根据相关要求，天阙平台针对此次改造，对部分接口做出变更。

改造内容

流程说明：

1.商户入网本次不涉及改造;

2.新增终端添加/解绑接口，服务商在完成商户入网后，需要调用终端绑定接口向天阙上报终端信息；

3.修改交易相关接口，请求交易时，服务商需上送该笔交易的受理终端信息（此前已在天阙绑定），天阙侧会校验商户终端信息是否已完成报送

终端报送相关

1.服务商通过天阙提供的终端绑定接口完成终端信息报备;

2.天阙将代为向支付机构完成终端信息报备;

3.天阙完成绑定后，向服务商返回结果和终端号等信息（该终端号在交易时上送使用）;

4.天阙提供终端解绑接口，若终端与商户的绑定关系出现变动，服务商可调用该接口解绑

具体可参考查看相关接口文档

交易上送相关

交易接口改动点如下：

1.原有字段deviceNo：

报备终端后可在交易时通过天阙终端号“deviceNo”上送报备完成的终端编号，非必送。（涉及接口：主扫、被扫、聚合支付、聚合包装主扫、预授权主扫、预授权被扫、预授权完成）

2.新增字段encryptRandNum、secretText：

被扫接口增加加密随机因子“encryptRandNum”、密文数据“secretText”字段，非必送。（涉及接口：被扫）

3.交易相关接口新增字段longitude、 latitude：

终端经度“longitude”、终端纬度“ latitude ” 非必送 。（涉及接口：主扫、被扫、聚合支付、聚合包装主扫）

4.原有字段ylTrmNo：

银联二维码交易，若想通过“ylTrmNo”上送活动终端参数，需先完成终端报备后再进行上送。（微信与支付宝交易无影响，按原有流程上送即可。）

具体可参考查看交易相关接口

改造时间、范围说明

时间节点：

银联 259 号文改造要求，需在2022年 3月1日前完成增量商户改造;

天阙平台提供服务商改造时间，需在 2022年3月17日前完成增量商户改造;

以3月1日为分界时间线，3月1日前入网商户视为存量商户，需于2022年10月1日前完成信息补充采集。

改造联调时间节点

预期 API 接口提供时间：2022 年2月25日

预期开始受理联调时间： 2022 年3月 1日

本次新规改造除对新增终端报备作要求，还涉及存量终端信息报备问题，故服务商需尽快完成改造，保证 259号文调整后正常交易。

注：259号文正式执行后，支付机构将进一步加强终端校验，请各位服务商尽快按照要求完成改造。