Upload Merchant Onboarding Document
POST/v1/users/merchant-onboarding/:id/documents
Upload required documents for merchant onboarding (max size: 10 MB).
Required documents depend on Dock configuration for each client.
Request
Path Parameters
Merchant Onboarding ID.
Header Parameters
The transaction ID is a UUID (v4) used to uniquely identify the object that will be created. All objects must have an identifier.
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.
UUID (v4) of the product that the request should use. Send it explicitly when the authenticated user has more than one product or when the integration must select a specific product. If omitted and the endpoint does not require it, the API uses the authenticated user's default product.
UUID (v4) of the user on whose behalf the request should run within the selected product. If omitted, the request runs as the authenticated user. Requires 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": "2026-03-26T14:02:59.231Z",
"document_updated_at": "2026-03-26T14:02:59.231Z"
}
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.