Upload Merchant Onboarding Document
POST/v1/users/merchant-onboarding/:id/documents
Upload required documents for merchant onboarding (max size: 10 MB).\n\nRequired documents depend on Dock configuration for each client.
Request
Path Parameters
Merchant Onboarding ID.
Header Parameters
The nonce ID is a UUID (v4) used to uniquely identify the request. All requests must have an identifier.
Possible values: [pt-BR, en-US]
Indicates the preferred language. Defaults to Brazilian Portuguese if unspecified.
The product ID is a UUID (v4) used to identify the Z.ro product configuration.
The product target user ID is a UUID (v4) used to identify what user account this request must be executed. Require: x-product-uuid.
- multipart/form-data
Body
required
Possible values: [cnpj_card, social_contract, identity_document, address_proof, bank_statement, selfie]
Document type. Possible values: cnpj_card, social_contract, identity_document, address_proof, bank_statement, selfie.
Document slug identifier for the document type.
Allowed file formats: image/jpg, image/jpeg, image/png, application/pdf.
Responses
- 201
- 400
- 401
- 403
- 422
The document uploaded successfully.
- application/json
- Schema
- Example (from schema)
Schema
Merchant Onboarding ID.
Merchant Onboarding status.
Document ID created by this upload.
File ID associated with the uploaded document.
Possible values: [cnpj_card, social_contract, identity_document, address_proof, bank_statement, selfie]
Document type. Possible values: cnpj_card,social_contract,identity_document,address_proof,bank_statement,selfie
Document creation date.
Document update date.
{
"merchant_onboarding_id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"merchant_onboarding_status": "WAITING_DOCUMENTS",
"document_id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"file_id": "151cddb6-1b0d-4a8c-bd21-e3bcf8b63226",
"document_type": "cnpj_card",
"document_created_at": "2025-12-30T17:32:13.032Z",
"document_updated_at": "2025-12-30T17:32:13.032Z"
}
If any required params are missing or has invalid format or type.
User authentication failed.
If the authenticated user does not have permission.
If any required params are missing or has invalid format or type.