交易查询

请求地址

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

请求参数

Key	Value
Content-Type	application/json

请求体

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

请求示例

{
	"countryId": "BRA",
	"merId": "8302996847200585",
	"merOrderNo": "P02024051517452550031527899",
	"nonceStr": "9ad3edf6d8084801bae04bfbdb788cc5",
	"sign": "8A3B428CE13F9DAB27E41C70F825B5D6",
	"supefinaOrderId": "20250623060617181000059022"
}

签名组装字符串

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

响应参数

变量名	类型	描述
code	String	响应编码 具体参照：响应状态码
msg	String	响应信息
data	Object	响应数据
transactionStatus	String	交易状态 字典表——交易订单状态
supefinaOrderId	String	supefina订单号
merOrderId	String	商户订单号
merId	String	商户ID
transactionType	String	交易类型 01：代收 02：代付
amount	BigDecimal	订单金额
realityAmount	BigDecimal	实收金额
fee	BigDecimal	预收手续费
realityFee	BigDecimal	实收手续费
successTime	Date	交易成功时间
identifier	String	付款参考标识符
stampTime	String	交易成功时间（时间戳格式，精确到秒）
clave	String	央行流水标识符
errorMsg	String	失败原因（交易失败和下单失败状态返回）

响应示例

{
	"code": "200",
	"msg": "success ",
	"data": {
		"transactionStatus": "01",
		"supefinaOrderId": "20250623060617181000059022",
		"merOrderId": "P02024051517452550031527899",
		"merId": "8302996847200585",
		"transactionType": "02",
		"amount": "1300.00",
		"realityAmount": "1300.00",
		"fee": "70.00",
		"realityFee": "70.00",
		"successTime": "2025-06-23 06:23:56",
		"identifier": "",
		"stampTime": 1750659836000,
		"clave": "E3038525920250601124521530b8bdb4"
	}
}