Manage documents
Learn how to provide the documents that the entities and persons need for a seamless onboard for payment acceptance experience.
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 ifentity_type
equals toindividual
.
Updated about 1 month ago