---
title: "Uploads a new document."
method: POST
path: "/documents"
---

# Uploads a new document.

`POST /documents`

## Request

- Base URL: `https://api.test.kalixa.com/payment-service/v6`
- URL: `https://api.test.kalixa.com/payment-service/v6/documents`
- Auth: HTTP basic

Uploads a new document.

## Request body `multipart/form-data`

- object
  - `content` string, binary, required: Contains the document (file) content base64 encoded to be uploaded. Used for screening purposes by the PXP Financial Risk Team.
  - `type` 'AddressProofForMerchantLocation' | 'AnnualReport' | 'ArticlesOfAssociation' | 'BankReferenceLetter' | 'BankStatement' | 'BusinessLicenseOrAuthorization' | 'CardProcessingHistory6Months' | 'CertificationOfIncorporation' | 'ChargebackAndFraudPolicyAndProcedures' | 'CompanyAMLPolicyAndGuidelines' | 'Contract' | 'ExternalRiskChecksResult' | 'ExternalCompanyRiskChecksResult' | 'ExternalCustomerRiskChecksResult' | 'LegalOpinion' | 'Organogram' | 'PassportOrGovernmentID' | 'PCIQuarterlyASVReport' | 'PCIReportOnCompliance' | 'PCISelfAssessmentQuestionnaire' | 'PersonalUtilityBill' | 'ProofOfAuthorisedSignatory' | 'ProofOfDomainOwnership' | 'TaxFilings', required: The type of the document to be uploaded. Used for validation and screening purposes by the PXP Financial Risk Team.
  - `name` string, required: The file name (including the file extension) of the document to be uploaded. Used for association and filtering.
  - `merchantId` string: The id of the merchant to which this document belongs/relates to. Used for association and filtering.
  - `shopId` string: The id of the shop to which this document belongs/relates to. Used for association and filtering.
  - `relatedPersonId` string: The id of the person to which this document belongs/relates to. Used for association and filtering.
  - `relatedCompanyId` string: The id of the company to which this document belongs/relates to. Used for association and filtering.
  - `bankAccountId` string: The id of the bank account to which this document belongs/relates to. Used for association and filtering.

## Response `201`

Successful operation

- Document: Contains the document data.
  - `id` string: The server-generated id of the document which was uploaded/returned.
  - `name` string: The name of the document (file).
  - `type` 'AddressProofForMerchantLocation' | 'AnnualReport' | 'ArticlesOfAssociation' | 'BankReferenceLetter' | 'BankStatement' | 'BusinessLicenseOrAuthorization' | 'CardProcessingHistory6Months' | 'CertificationOfIncorporation' | 'ChargebackAndFraudPolicyAndProcedures' | 'CompanyAMLPolicyAndGuidelines' | 'Contract' | 'LegalOpinion' | 'ExternalRiskChecksResult' | 'ExternalCompanyRiskChecksResult' | 'ExternalCustomerRiskChecksResult' | 'Organogram' | 'PassportOrGovernmentID' | 'PCIQuarterlyASVReport' | 'PCIReportOnCompliance' | 'PCISelfAssessmentQuestionnaire' | 'PersonalUtilityBill' | 'ProofOfAuthorisedSignatory' | 'ProofOfDomainOwnership' | 'TaxFilings': The type of the document (file).
  - `merchant` ObjectWithId: Contains only the id of the resource. Used for future extensibility.
    - `id` string: The id of the resource.
  - `shop` ObjectWithId: Contains only the id of the resource. Used for future extensibility.
    - `id` string: The id of the resource.
  - `bankAccount` ObjectWithId: Contains only the id of the resource. Used for future extensibility.
    - `id` string: The id of the resource.
  - `relatedPerson` ObjectWithId: Contains only the id of the resource. Used for future extensibility.
    - `id` string: The id of the resource.
  - `relatedCompany` ObjectWithId: Contains only the id of the resource. Used for future extensibility.
    - `id` string: The id of the resource.

## Other responses

- `400`: Error occurred

---

[API](https://skmtc.dev/kalixa/apis/payment-service-v6-merchant-onboarding.md) - [All operations](https://skmtc.dev/kalixa/apis/payment-service-v6-merchant-onboarding/llms.txt) - [OpenAPI document](https://skmtc.dev/kalixa/apis/payment-service-v6-merchant-onboarding/revisions/066120f66046?raw)