凭证查询

请求地址

环境名称	URL
SandBox	POST https://api.supefina.tech/api/supefina/transactions/search-voucher
正式环境	POST https://api.supefina.net/api/supefina/transactions/search-voucher

请求参数

Key	Value
Content-Type	application/json

请求体

变量名	必填	类型	描述
merId	是	String	商户ID 商户ID获取路径：Supefina商户后台-商户管理-基本信息-商户ID
countryId	是	String	国家编号 参照：字典表-国家编号 墨西哥：MEX
merOrderNo	是	String	商户订单号
supefinaOrderId	是	String	supefina订单号
nonceStr	是	String	随机字符串 长度不能超过32位
sign	是	String	签名 具体参照：签名算法

请求示例

{
	"countryId": "BRA",
	"merId": "8302996847200585",
	"merOrderNo": "P02024051517452550031527899",
	"nonceStr": "d36d0832e81845158559c30d35a84942",
	"sign": "381DD9CFDB603CB804E5467FE55D0144",
	"supefinaOrderId": "20250623060617181000059022"
}

签名组装字符串

countryId=BRA&merId=8302996847200585&merOrderNo=P02024051517452550031527899&nonceStr=d36d0832e81845158559c30d35a84942&supefinaOrderId=20250623060617181000059022&key=9dbb958a68f04252bae26a6b6d98e0ab

响应参数

变量名	类型	描述
code	String	响应编码 具体参照：响应状态码
msg	String	响应信息
data	Object	响应数据
multiple	Boolean	是否多条数据 是:true 否:false
target	Array	目标数组
voucher	String	凭证链接 一条或者多条

响应示例

{
	"code": 200,
	"msg": "success",
	"data": {
		"multiple": false,
		"target": [
			{
				"voucher": "https://supefina-official-new.s3.us-west-2.amazonaws.com/PaymentVoucher-dev/20250623/CEP20250623060617181000059022.pdf"
			}
		]
	}
}