UploadFile API

Testing Env

https://testpay.onlinepay.ai

POST

/v2/file/upload

V2 File Upload endpoint. Uses multipart/form-data with V2 signing rules.

Differences from V1

signType is NOT a request parameter — resolved from merchant DB config (encryption field)

version field is required and must be V2.0.0

file field does NOT participate in signing

Signing parameters: merNo, type, version

Response does NOT include sign/signType (consistent with V1)

Note

Access to this endpoint is restricted. Please contact us to request the necessary permissions before integration.

Request

Body Params multipart/form-data

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://testpay.onlinepay.ai/v2/file/upload' \
--form 'file=@""' \
--form 'type=""' \
--form 'merNo=""' \
--form 'sign=""' \
--form 'version=""'

Responses

🟢200

application/json

Bodyapplication/json

Example

{
    "code": "00000",
    "message": "SUCCESS",
    "data": "1727235173391.jpg"
}

Modified at 2026-05-26 04:16:58

Add VPA Scene API

Query Payout Order API