文件上传

简述

• 代付订单所需客户身份证、签名等文件的上传接口，返回文件路径供创建代付订单时使用

注意

1. 本接口使用 form data 方式上报数据
2. 本接口不使用 AES 进行数据加密，同时响应数据中的 data 也无加密
3. 本接口会验证请求签名，签名的 body 为空字符串 ""

请求 URL

• /pay/files/upload

请求参数

• body

参数名	必选	类型	长度	说明
merchantId	是	String	32	商户编码(平台分配)
file	是	File	-	上传的文件
type	是	String	32	文件类型： images：图片类文件，大小不能超过 2MB files：其他文件，大小不能超过 10MB
scene	是	String	32	文件场景： customer：客户文件

请求示例

curl --location 'https://api-dev.gccpay.cn/open-api/pay/files/upload' \
--header 'merchantKeyId: 5edd9fd7958642feb7bd360481037eec' \
--header 'version: 1.0' \
--header 'timeStamp: 1758859382' \
--header 'signature: ZAfJA+GZqrFEF7uaF7lrFKSBvI0dDOJfsIfRh26qVfR1fDaeABaGoYO+rA/IoR2YDGsNsYmkE+mAP1hyfAzVfvr205AcYudiNt/MCuZPzP3T8Vb7B7wfSMA02h3yoPNnzCkB2XWSWHBuytwk9BeatmZLOTd78UTgYfNT2GuMm34conUkPqWzF9sFUGHpIJ+ZvleD3yUKOJZzaQl8+nhAwi0Nejg4nZnZCFIFuytXSDEP1QD7wZdXelK4yFvs16hwFRw7IVSTdDNVXNFWTRYp3YQLq8ahV3VQD+uIrzxjMLDwWrXfXa74JpETZrwxwLjCjcZ6BAQrXs/rcNKgd9dGzg==' \
--header 'content-language: en-US' \
--form 'merchantId="MER12345678"' \
--form 'file=@"/Users/demo/Pictures/xxxxxx.jpg"' \
--form 'type="images"' \
--form 'scene="customer"'

响应参数

• data

参数名	类型	说明
path	String	文件路径

响应示例

响应数据中的 data 无加密

{
    "code": 10000,
    "message": "success",
    "data": {
        "path": "images/customer/20250926/dfde72df895d45e68c928a8f886e4f80.jpg"
    },
    "success": true
}