Skip to main content
POST
/
merchants
/
{merchant_id}
/
documents
Upload Documents
curl --request POST \
  --url https://api-sandbox.cashfree.com/partners/merchants/{merchant_id}/documents \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-partner-apikey: <x-partner-apikey>' \
  --form 'document_type=<string>' \
  --form file='@example-file'
{
  "document_type": "bank_statement",
  "uploaded_on": "2006-01-02T15:04:05-0700"
}
The document_type parameter accepts the following values organised by document category:

ā€‹
Business proof documents

Document typeDescription
businessproof_saecertificateCertificate or licence issued by the appropriate authorities under Shops and Establishment Act and any other Acts as applicable to the firm
businessproof_regproofOther government-issued registration proof
businessproof_municipalMunicipal certificate
businessproof_udhyogUdyog Aadhaar
businessproof_taxreturnSales tax and income tax return
businessproof_rocRegistration certificate from ROC (Registrar of Company for a Jurisdiction)
businessproof_taxreturnfullFull tax return
businessproof_customeragreementCustomer agreement
businessproof_platformconfirmPlatform confirmation
businessproof_invoicesBusiness invoices

ā€‹
Entity proof documents

Document typeDescription
entityproof_partnershipdeedPartnership deed
entityproof_trustdeedTrust deed
entityproof_societycertificateSociety certificate
entityproof_hufdeedHUF deed
entityproof_llpLLPIN document

ā€‹
Line of business proof documents

Document typeDescription
lobproof_nonprofitDomestic: 80 G, 12 A or International: FCRA
lobproof_travelIATA certificate or IRCTC agency certificate
lobproof_pcidssAOC for PCI-DSS compliance
lobproof_gamingRNG certificate (if applicable), legal opinion
lobproof_foodFSSAI
lobproof_bbpsBBPS certificate
lobproof_jewelleryBIS certificate, 916 Hallmark, 925 Hallmark, or GII certificate
lobproof_nbfcNBFCs or Service Level Agreements with RBI approved NBFCs
lobproof_papgPA-PG licence
lobproof_pharmacyPharmacy licence, retail or wholesale drug licence, undertaking of authorised signatory under Drugs and Cosmetics Act 1940, declaration (Form 20, Form 21, Form 21B, Form 20B)
lobproof_ppiBank PPI licence or Non Bank PPI licence
lobproof_mutualfundsAMFI certificate
lobproof_femaFEMA registration, FFMC certificate (FFMC state wise)
lobproof_ayushAyush (manufacturing licence - Form 24D)
lobproof_sebiSEBI certificate
lobproof_insuranceIRDA: Life insurance, general insurance, health insurance or SLA with the insurer if this is being issued by a different party
lobproof_educationUGC certificate, ICSE, CBSE, or AICTE

ā€‹
Other documents

Document typeDescription
bank_statementBank statement
certificate_of_incorporationCertificate of incorporation
board_resolutionBoard resolution
gst_certificateGST certificate
localtax_identifierLocal tax identifier
bene_owner_id_proof_1 to bene_owner_id_proof_6Beneficial owner ID proofs

Headers

ā€‹
x-partner-apikey
string
required

Your partner API key for authentication

ā€‹
x-api-version
string
default:2023-01-01

API version to be used for the request

Path Parameters

ā€‹
merchant_id
string
required

Unique identifier for the merchant

Body

multipart/form-data
ā€‹
document_type
string

The type of document being uploaded. For the complete list of supported document types, see Supported Document Types.

ā€‹
file
file

The KYC document file to upload. Supported formats include PDF, JPG, JPEG, and PNG.

Response

OK

ā€‹
document_type
string

Enter the valid document type as given

ā€‹
uploaded_on
string

time when document was uploaded