上传业务文件

能力概览

• 付款单据所需用户身份证、签名等文件的上传服务，响应文件路径供提交付款业务单据时使用

注意

1. 本接口通过 form data 格式提交文件与业务参数。
2. 本接口不启用 AES 加密，响应报文中的 data 字段同样保持明文返回。
3. 本接口仍需完成调用签名校验，参与签名的 body 固定为空字符串 ""。

调用地址

• /pay/files/upload

请求参数

• body

字段	提交要求	数据类型	长度限制	业务含义
merchantId	是	String	32	平台分配给接入方的唯一商户标识
file	是	File	-	随请求提交的待上传文件内容
type	是	String	32	文件分类： images：图片文件，单个文件不超过 2MB files：非图片文件，单个文件不超过 10MB
scene	是	String	32	文件使用场景： customer：付款用户相关资料

请求示例

curl --location 'https://openapi-uat.saudipays.cn/open-api/pay/files/upload' \
--header 'merchantKeyId: a81f6c4d2e5b4a7f93c102d8e6b74590' \
--header 'version: 1.0' \
--header 'timeStamp: 1778284860' \
--header 'signature: RmFrZVNpZ25hdHVyZUZvckRvY1NhbXBsZVZhbHVlMDAxQmFzZTY0PT0=' \
--header 'content-language: en-US' \
--form 'merchantId="MER74021658"' \
--form 'file=@"/Users/demo/Pictures/payout-customer-id.jpg"' \
--form 'type="images"' \
--form 'scene="customer"'

响应参数

• data

字段	数据类型	业务含义
path	String	平台返回的文件存储路径，提交付款订单时按该值引用

响应示例

响应数据中的 data 无加密

{
    "code": 10000,
    "message": "success",
    "data": {
        "path": "images/customer/20260509/8b63f1a42d7e4c9aa12d87f30e61c5b2.jpg"
    },
    "success": true
}