报备信息查询接口
功能概述
本接口用于商户查询客户信息报备结果,报备结果已此接口返回状态为准。
接口地址
https://apis.5upay.com/foreign/customs/report/query
| 参数名称 |
参数中文名称 |
类型& 长度 |
参数说明 |
是否必填 |
| merchantId |
商户编号 |
varchar(9) |
商户在首信易系统的唯一id,可在商户后台查看 |
M |
| channelType |
通道类型 |
varchar(30) |
通道类型,用于区分所报备的通道枚举值:PINGAN |
C |
| custCode |
组织机构代码 |
varchar(9) |
已报备的实际交易的付款人证件号,对公:9位的企业代码 |
M |
| hmac |
参数签名 |
varchar(500) |
商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 |
M |
参数示例
{
"channelType": "PINGAN",
"custCode": "000000000",
"hmac": "304402201c88dd122049b081045beaf964e72b24ef7bc5a548f3a077ecf365617d8d430402203a1b6b7fd9538b84
21f87cefda9d51078ff1b8bb86f9bde367b017c4b10af183",
"merchantId": "120140134"
}
请求同步返回参数列表
| 参数名称 |
参数中文名称 |
参数说明 |
| merchantId |
商户编号 |
同请求参数 |
| custCode |
组织机构代码 |
同请求参数 |
| status |
请求状态 |
本次请求状态 |
| reportStatus |
处理状态 |
SUCCESS 成功 |
| FAIL-失败 |
| PROCESSING-处理中 |
| errorMessage |
错误原因 |
错误原因 |
| hmac |
参数签名 |
商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 |
示例
{
"merchantId": "120140134",
"hmac": "3046022100d23730499237deefce36583bb99aef0ffaf6828f09f4d37812f5565d22ed2843022100f21b8dfdbd3f
7a9527f57337716b66f140de612a42b5feb461ecc23684c4b3b1",
"errorMessage": "企业报备记录不存在",
"reportStatus": "ERROR",
"custCode": "000000000",
"status": "SUCCESS"
}