Manage documents

Overview

Onboarding documents are required business information about the entities and persons that want to start accepting payments, such as bank account ownership verification, company registration, and other types of proof documents.

Providing the onboarding documents allows the entities and persons to have a seamless onboarding for accepting payments experience with reduced manual labor required.

For entities

To upload the documents for an entity, call POST /entities/{entity_id}/documents:

curl -X POST 'https://api.sandbox.monite.com/v1/entities/{entity_id}/documents' \
     -H 'accept: */*' \
     -H 'X-Monite-Version: 2023-06-04' \
     -H 'X-Monite-Entity-Id: ENTITY_ID' \
     -H 'Authorization: Bearer ACCESS_TOKEN'
     -H 'Content-Type: application/json' \
     -H 'Content-Type: multipart/form-data' \
     -F 'bank_account_ownership_verification=@bank_acc_own_decl_1.png;type=image/png' \
     -F 'bank_account_ownership_verification=@bank_acc_own_decl_2.png;type=image/png' \
     -F 'company_ministerial_decree=@comp_mini.png;type=image/png' \
     -F 'proof_of_registration=@proof_reg.png;type=image/png' \
     -F 'verification_document_back=@verif_doc_back.png;type=image/png' \
     -F 'verification_document_front=@verif_doc_front.png;type=image/png' \
     -F 'company_tax_id_verification=@comp_tax_id_verif.png;type=image/png' \
     -F 'additional_verification_document_front=@add_verif_doc_front.png;type=image/png' \
     -F 'additional_verification_document_back=@add_verif_doc_back.png;type=image/png' \
     -F 'company_license=@comp_licen.png;type=image/png' \
     -F 'company_registration_verification=@comp_reg_verif.png;type=image/png' \
     -F 'company_memorandum_of_association=@comp_memo_association.png;type=image/png'

The documents to be informed:

bank_account_ownership_verification: One or more documents that verify the bank account ownership.
company_ministerial_decree: One or more documents with the ministerial decree legalizing the company’s establishment.
proof_of_registration: One or more documents that prove the company’s registration with the national business registry.
verification_document_*: An identifying document for the entity, either a passport or local ID card.
company_tax_id_verification: One or more documents that prove a company’s tax ID.
additional_verification_document_*: A document showing address, such as a passport, local ID card, or bill from a well-known utility company.
company_license: One or more documents that demonstrate prove the company’s license to operate.
company_registration_verification: One or more documents that prove a company’s registration with the appropriate local authorities.
company_memorandum_of_association: One or more documents with the company’s Memorandum of Association.

For persons

To upload the documents for a person POST /persons/{person_id}/documents:

curl -X POST 'https://api.sandbox.monite.com/v1/persons/aea39c7e-630f-4664-a449-de899ebd4912/documents' \
     -H 'accept: */*' \
     -H 'X-Monite-Version: 2023-06-04' \
     -H 'X-Monite-Entity-Id: ENTITY_ID' \
     -H 'Authorization: Bearer ACCESS_TOKEN'
     -H 'Content-Type: multipart/form-data' \
     -F 'verification_document_front=@verif_doc_front.png;type=image/png' \
     -F 'verification_document_back=@verif_doc_back.png;type=image/png' \
     -F 'additional_verification_document_front=@add_verif_doc_front.png;type=image/png' \
     -F 'additional_verification_document_back=@add_verif_doc_back.png;type=image/png'

The documents to be informed:

verification_document_*: An identifying document for the person, either a passport or local ID card.
additional_verification_document_*: A document showing address, either a passport, local ID card, or bill from a well-known utility company. Only applicable if entity_type equals to individual.