交易查询

注意：

代付请求超时仅代表未能在预定时间内获得响应，这并不意味着业务失败。遇到超时情况时，商户应采取以下标准流程： 首先将相关订单标记为挂起状态，随后等待至少2分钟后通过查询接口检索订单状态。切勿在超时后立即尝试重新提交请求，这可能导致重复交易。 因未遵循上述规定流程而造成的任何资金损失，将由责任方全权承担，我司概不负责。

请求地址

环境名称	URL
SandBox	POST https://sandbox-gateway.payful.com/api/platform/transactions/search-status
正式环境	POST https://gateway.payful.com/api/platform/transactions/search-status

请求参数

Key	Value
Content-Type	application/json

请求体

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

请求示例

{
  "countryId": "MEX",
  "merId": "PF800202512020002",
  "merOrderNo": "2025120817252153395353423",
  "nonceStr": "c22b2d3690e64ae581732f49bbc46f4a",
  "platformOrderId": "2025120803020295969aa5148f04d",
  "sign": "CDA88F0D3330F4365F1F3B93968203F1"
}

签名组装字符串

countryId=MEX&merId=PF800202512020002&merOrderNo=2025120817252153395353423&nonceStr=c22b2d3690e64ae581732f49bbc46f4a&platformOrderId=2025120803020295969aa5148f04d&key=4dfd9eb679bb4c07b4a3ed850aa2bb30

响应参数

变量名	类型	描述
code	String	响应编码 具体参照：响应状态码
msg	String	响应信息
data	Object	响应数据
transactionStatus	String	交易状态 字典表——交易订单状态
platformOrderId	String	Payful订单号
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",
		"platformOrderId": "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"
	}
}