商户终端报备接口

功能概述

使用付款码支付的商户在微信或支付宝的报备成功之后需要调此接口进行终端报备,终端报备成功之后可获得报备终端号,用于发起付款码支付的订单。接口支持新增、修改、启用、注销终端。

接口地址

https://apis.5upay.com/serviceprovider/report/terminalReport

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
partnerId 服务商编号 varchar(9) 子商户上属服务商商户在首信易系统的唯一身份标识,商户可登录商户后台查看 M
merchantId 商户编号 varchar(9) 商户在首信易系统的唯一身份标识,商户可登录商户后台查看 M
requestId 请求号 varchar(50) 请求号 M
reportSerialNo 报备序列号 varchar(50) 微信&支付宝报备成功后首信易智付提供的的唯一报备序列号 M
reportType 报备类型 固定值 WECHAT 微信 O
ALIPAY 支付宝,若不填默认微信
operationId 操作标识 varchar(2) 取值范围: 00 新增 M
01 修改(启用),(仅支持对deviceType、deviceSerialNo、deviceAddressInfo进行修改,修改时以上字段为非必填)
02 注销,(注销时,仅需上送reportTerminalNo字段)
reportTerminalNo 报备终端号 varchar(8) 终端修改(启用)和注销时必填,终端报备成功时会返回该参数 C
deviceType 设备类型 varchar(2) 取值范围:(终端注销时非必填) M
01 自动柜员机(含ATM和CDM)和多媒体自助终端
02 传统POS
03 mPOS
04 智能POS
05 II型固定电话
06 云闪付终端
07 保留使用
08 手机POS
09 刷脸付终端
10 条码支付受理终端
11 辅助受理终端
12 行业终端(公交、地铁用于指定行业的终端)
13 MIS终端
deviceSerialNo 终端序列号 varchar(50) 出现要求:终端类型(device_type)填写为 02、03、04、05、06、08、09 或10时,必须填写终端序列号。 C
deviceAddressInfo 终端布放地址 json 终端布放地址,省-市-区-详细地址,详细地址长度控制在30个汉字以内。注:取值范围可参考《省市区结构说明》 注:终端注销时非必填 M
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

请求参数(deviceAddressInfo,终端布放地址)

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
deviceAddressProvince 终端布放所在省 varchar(6) 取值范围可参考《省市区结构说明》 M
deviceAddressCity 终端布放所在市 varchar(6) 取值范围可参考《省市区结构说明》 M
deviceAddressArea 终端布放所在区 varchar(6) 取值范围可参考《省市区结构说明》 M
deviceAddress 终端布放所在详细地址 varchar(30) 无需再次填写省市区,填写街道门牌号等信息即可,30个汉字以内。省市区详细地址需要同时填写。 M

参数示例

{ "deviceAddressInfo": { "deviceAddress": "大红***1101", "deviceAddressArea": "110101", "deviceAddressCity": "110100", "deviceAddressProvince": "110000" }, "deviceSerialNo": "", "deviceType": "11", "hmac": "tD6zu0lcaXXjqWJxDla2jWLDoAyjuiNYtcH8wPIrrqbfOjPuZ0vIrUJi3gqm9bZj3JqhHxti11v OXzM6ZZngTKwPp3/D/kQY0HPAvqOiRmjuCgDPvj6+mCq+jiwf/3n3ykj95WDmm24gmNuPPAeU9fmm0Eu/C1l fAdX4Ft9YUxB9jz6aWw1bGJQHgusBHcpUHBMyQlf0WFqjnBoleyKXEaxkkt7w0AWzyEiIekuEig7i6i4vLWu WJ81ohq9MgSjABeURKx3C3irSSkbu702jr57tUGmad+Zd0+jyGKockTTLUyJqtlZPgQlghRxGPuayKD4BUnt tMvMlQIjtlldHHQ==", "merchantId": "89***4825", "operationId": "01", "partnerId": "89***6813", "reportRequestId": "167****9958", "reportTerminalNo": "", "reportType": "WECHAT", "requestId": "VJO-1677752801870" }

请求返回参数列表

参数名称 参数中文名称 参数说明
partnerId 服务商编号 同请求参数
merchantId 商户编号 同请求参数
reportTerminalNo 报备终端号 status为SUCCESS时会返回,使用付款码交易时需要上传此参数
status 响应状态 SUCCESS 成功
FAILED 失败
ERROR 错误(此状态的返回参数见异常情况说明)
mchId 商户号 终端报备关联的微信或支付宝的商户号
errorMessage 错误信息 错误信息
hmac 参数签名 首信易生成的参数签名结果,验签过程请参考解密流程

参数示例

{ "hmac": "r/hECaJ6LLYI2/HBxa7OwWSs2OBSgf7vWomGk87fioNsgknoyjyIqO3s6vlZXRGTrTT DdJ/ulpXLIDnLHA7KCL6MQ9BiJ2u7sK5xtIQJC+hkCutapw/KWOHsGDhi4M71veSjB4GhGOTd8ua aIeLe8PB8iD8ykibeTO1sr+5CPUU7CN8aOEEx3DSDTSKrG3/lYMQmUiYS+kdh0NhRbsoIgYlE5XN PPb9wHYMMSzVC+UNuC2QEoBsTm/vfwMNsCL3j3j4CFt/nQFvXtGz1CVgl8PMmeq+4HFaCBNxrtFm Q1ikXry87LQebe1w2JxSi5J7flU1mIQUytBA+pP+ahVghKg==", "mchId": "123456", "merchantId": "89****595", "partnerId": "89****593", "status": "SUCCESS", "reportTerminalNo": "1653****4331" }