明细校验查询

功能概述

商户通过跨境收款明细校验查询首信易支付平台的校验明细

接口地址

https://apis.5upay.com/foreignpayExchangesettlement/batch/validateQuery

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在首信易系统的唯一身份标识,商户完成首信易系统注册后可登录商户后台商户服务查看。 M
requestId 订单号 varchar(50) 订单号为商户自行拟定,提交的订单号必须在自身平台交易中唯一。首信易支付系统已付或撤销的订单,商户平台不能以相同的订单号再次提交。 M
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

参数示例

{ "merchantId": "896667346", "requestId": "278e75194c72459ba5264441045397cc", "hmac": "Xm4cZdFLLf6bMzoKY8MX7lV0tK6Bc5ZSH/v0OLsPlTJ5DjPI7VE0PFGbK4dG6GHi1gA==" }

查询返回参数列表

参数名称 参数中文名称 参数说明
failDetailPath 失败详情路径 此字段有值时,值为失败详情文件的sftp下载路径
merchantId 商户编号 同请求信息
requestId 订单号 同请求信息
validateId 校验号 首信易系统校验号
creditedCurrency 到账货币 见货币列表
status 状态 SUCCESS
ERROR
FAILED
hmac 参数签名 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程

示例

{ "failDetailPath": "/foreignpay/details/errorfile/20251113/fail_8a808b671e7c49a08e57a43a9bd50d1e.xlsx", "merchantId": "896667346", "requestId": "8a808b671e7c49a08e57a43a9bd50d1e", "validateId": "2c98a75c9a7c7b53019a7d086764000c", "creditedCurrency": "CNY", "status": "FAILED", "hmac": "mSKaITh5zbQZ+vlV4eUkFX9q80b+XnGnoubKvw==" }