结算状态查询

Payful结算状态请求地址

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

请求参数

Key	Value
Content-Type	application/json

请求体

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

请求示例

{
  "countryId": "MEX",
  "merId": "PF800202512020002",
  "merOrderNo": "2025120817252153395353423",
  "nonceStr": "b3f3352f83fa4f48ad2d6a74e93cdf6e",
  "platformOrderId": "2025120803020295969aa5148f04d",
  "sign": "869AB92EF3443A434A76202F772FEFCF"
}

签名组装字符串

countryId=BRA&merId=8302996847200585&merOrderNo=P02024051517452550031527899&nonceStr=11b2a7f327e946b3aa52bb713332a366&platformOrderId=20250623060617181000059022&key=9dbb958a68f04252bae26a6b6d98e0ab

响应参数

变量名	类型	描述
code	String	响应编码 具体参照：响应状态码
msg	String	响应信息
data	Object	响应数据
multiple	Boolean	是否多条数据 是:true 否:false
target	Array	目标数组
settleStatus	String	结算状态 01：已结算 02：未结算
platformOrderId	String	Payful订单号
merOrderId	String	商户订单号
merId	String	商户编号
transactionType	String	交易类型 01：代收 02：代付
amount	String	订单金额
realityAmount	String	实收金额
fee	String	预收手续费
realityFee	String	实收手续费
successTime	Date	交易成功时间
identifier	String	付款参考标识符

响应示例

{
  "code": "200",
  "msg": "success",
  "data": {
    "multiple": false,
    "target": [
      {
        "transactionType": "02",
        "identifier": "",
        "amount": "100.00",
        "realityAmount": "",
        "fee": "10.00",
        "successTime": "",
        "realityFee": "",
        "merId": "PF800202512020002",
        "platformOrderId": "2025120803020295969aa5148f04d",
        "merOrderId": "2025120817252153395353423"
      }
    ]
  }
}