凭证查询

请求地址

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

请求参数

Key	Value
Content-Type	application/json

请求体

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

请求示例

{
  "countryId": "MEX",
  "merId": "PF800202512020002",
  "merOrderNo": "2025120817241671236103130",
  "nonceStr": "8c3b9027611d45c4a383996449af4009",
  "platformOrderId": "202512080302029eaa059c3eba94f",
  "sign": "89CF7F929C1153624F786879918BEF04"
}

签名组装字符串

countryId=MEX&merId=PF800202512020002&merOrderNo=2025120817241671236103130&nonceStr=8c3b9027611d45c4a383996449af4009&platformOrderId=202512080302029eaa059c3eba94f&key=4dfd9eb679bb4c07b4a3ed850aa2bb30

响应参数

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

响应示例

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