Upload File

Endpoint: POST /v2/gc/files/upload

Description: Upload a supporting document (KYC, contract, logistics, payee proof, etc.) and obtain a reusable file path for use in other API calls.

Request

Request Form-Data Field Descriptions

Field Name	Type	Required	Description
bizType	string	Yes	Document category. Enum: PAYMENT | UPLOAD | REPORT | CUSTOMS_RECEIPT | NETWORK_ACCESS | COMMERCIAL | LOGISTICS | PAYEEINFO | OTHER
file	file	Yes	The binary document to upload (e.g. PDF, image).

Request sample

// multipart/form-data request — see the form-data field table above; no JSON body.

Response

Response Field Descriptions

Field Name	Type	Description
code	number	Response code.
state	number	State of the response.
data	object	Uploaded file details.
message	string	Response message.
neoResponseId	string	Unique NeoX response identifier.

data object fields:

Field Name	Type	Description
fileName	string	Original file name of the uploaded document.
path	string	Reusable file reference path. Pass this value in other API calls (e.g. kycFiles, contractFiles, paymentProofList, detailPath, frontPath).

Response sample

{
  "code": 1,
  "state": 2,
  "data": {
    "fileName": "contract_2024.pdf",
    "path": "gpt/merchant/20240815/a3f8c1d2-4e56-7890-bcde-f12345678901.pdf"
  },
  "message": "Successful",
  "neoResponseId": "ac23ea1c-98db-4ed6-b927-7e7692ef2f69"
}

Example cURL

curl -X POST "https://{base_url_openapi}/v2/gc/files/upload" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Content-Type: multipart/form-data" \
  -H "Accept-Language: en" \
  -F "bizType=PAYMENT" \
  -F "file=@/path/to/document.pdf"

Notes

• Requires Bearer token in the Authorization header.

• The Accept-Language header can be used to specify the response language (Support: "vi", "en").

• The request must be sent as multipart/form-data; do not use application/json.

• The returned path value is used as a file reference in other API calls, including kycFiles, contractFiles, paymentProofList, detailPath, frontPath, and similar fields.

• Choose the bizType value that best matches the document's intended purpose.