Attach a KYC document

POST

/api/v1/marketplace-api/merchants/{ref}/documents

Attaches an already-uploaded file (by fileKey from the presigned
upload flow) to the merchant's KYC record. Most partners let merchants
upload documents inside the embedded journey instead, which handles the
full presign/upload/confirm/attach flow automatically.

Request

Authorization

API Key

Add parameter in header

X-OpenSylo-Secret-Key

Example:

X-OpenSylo-Secret-Key: ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

Document attached to the merchant's KYC.

This response does not have a body.

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.opensylo.com/api/v1/marketplace-api/merchants/mkt_merchant_8421/documents' \
--header 'X-OpenSylo-Secret-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "documentType": "CAC_CERTIFICATE",
    "fileName": "cac_certificate.pdf",
    "fileKey": "string",
    "fileSize": "524288",
    "mimeType": "application/pdf"
}'

Response Example

{
    "statusCode": 400,
    "message": "string",
    "error": "Bad Request"
}

Modified at 2026-06-10 14:59:36

Add directors (bulk)

Submit KYC for review