Upload accreditation document (PDF)
Registers a PDF slot and returns a presigned uploadUrl (HTTP PUT,
1 hour). Company kinds are PJ-only and allowed while status is
PENDING_BIOMETRY, BIOMETRY_APPROVED, or PENDING_REVIEW
(rejected for FAILED / INTEGRATING / ACTIVE).
account_opening_terms is optional for PF and PJ and stays accepted
until status is ACTIVE or FAILED (including INTEGRATING). After this 201,
PUT the PDF bytes to uploadUrl before the URL expires. sizeBytes
is required and is part of the URL signature: the PUT must send
exactly that many bytes (max 50 MiB). A required slot does not fulfil
the documentary requirement — GET keeps that kind in missingDocumentKinds
until the object exists in the KYC archive with size > 0 (and, when
the sanitizer is on, after a successful scan). kind=other is capped
at 10 files per accreditation.
Required kinds by company.legalForm:
mei,ltda:company_articlessa,cooperative: the above pluscnpj_card,financial_statements
Optional for all: company_proof_of_address, business_license,
regulatory_license, account_opening_terms, other (other allows
multiple files, max 10; fileName required). account_opening_terms
does not block account opening. Typed kinds are one-per-accreditation
(re-upload replaces). Document freshness (e.g. proof of address) is
checked by the CorpX operator during review, who may still request it.
Upload in parallel with biometrics. Missing required kinds block
operator approve unless they set forceIncompleteDocuments (audited).
BaaS integrators only.
Centralized biometry tenants: there is no uploadUrl. Send the
PDF in contentBase64 (up to 4 MB) and it is forwarded to the
tenant’s KYC. Only company_articles, company_proof_of_address and
financial_statements are accepted; the response is 201 with
deliveryStatus: forwarded.
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
Accreditation (onboarding) identifier returned on creation.
Headers
Optional client-generated idempotency token (recommended for safe retries).
Request
Actual PDF size in bytes (max 50 MiB). Part of the upload URL signature.
Required when kind=other (shown to reviewers).
Response
Document slot created; upload the PDF via uploadUrl.
Presigned S3 URL — PUT exactly sizeBytes bytes with the same Content-Type.
Uploads are archived only after real type detection, antivirus and sanitization (the PDF is rasterized), which takes a few seconds. Infected, corrupted or unexpected-type files are rejected and shown as rejected in the operator review.