8.1.1 进件文件上传

正式环境

https://openapi.3ypay.com

POST

/mchAccess/mch/fileUp

上传进件所需的图片或文件材料。文件内容使用Base64编码传递,返回文件的OSS存储URL。

业务规则:

支持图片格式:jpg、png、pdf等常见格式

fileContent可携带MIME前缀(如data:image/png;base64,xxx),也可传纯Base64内容(此时需同时传contentType)

返回的OSS URL用于后续进件接口中的各图片字段

图片大小不允许超过2M，易生1.0图片大小不允许超过1M

请求参数

Body 参数application/json必填

示例

{
    "appId": "APP20250101001",
    "version": "1.0",
    "timestamp": 1700000000000,
    "requestId": "REQ20250101001",
    "sign": "base64encodedSignature==",
    "signType": "RSA2",
    "charset": "UTF-8",
    "bizContent": {
        "fileContent": "data:image/png;base64,iVBORw0KGgo=",
        "contentType": "image/png"
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://openapi.3ypay.com/mchAccess/mch/fileUp' \
--header 'Content-Type: application/json' \
--data '{
    "appId": "APP20250101001",
    "version": "1.0",
    "timestamp": 1700000000000,
    "requestId": "REQ20250101001",
    "sign": "base64encodedSignature==",
    "signType": "RSA2",
    "charset": "UTF-8",
    "bizContent": {
        "fileContent": "data:image/png;base64,iVBORw0KGgo=",
        "contentType": "image/png"
    }
}'

返回响应

🟢200

application/json

上传成功,返回文件OSS访问URL

Bodyapplication/json

示例

{
    "code": 200,
    "msg": "请求成功",
    "appId": "APP20250101001",
    "signType": "RSA2",
    "timestamp": 1700000001000,
    "data": "{\"path\":\"https://oss.3ypay.com/files/2025/01/01/abc123.png\"}"
}

6.2.6 余额退款异步通知

8.1.2 商户入网申请