Create a KYC document

Creates a KYC document.

SecurityAPI Key: SecretApiKey or HTTP: JWT
Request
Request Body schema: application/json

Kyc document resource.

fileIds
required
Array of strings

IDs of linked file objects.

Uploaded identity-proof files must have the following tags attached to be used for KYC purposes: ['kyc', 'id-front'], ['kyc', 'id-back'], ['kyc', 'face-proof'].

documentType
required
string (KycDocumentTypes)

Document type submitted for validation. Only the identity-proof and address-proof types are analyzed automatically.

documentSubtype
string or null (KycDocumentSubtypes)

Document subtype submitted for validation.

Enum: "passport" "id-card" "driver-license" "birth-certificate" "utility-bill" "rental-receipt" "lease-agreement" "copy-credit-card" "credit-card-statement" "bank-statement" "inheritance-documentation" "tax-return" "salary-slip" "sale-of-assets" "public-health-card" "proof-of-age-card" "reverse-of-id" "public-service" "ewallet-holder-details" "ewallet-transaction-statement" "marriage-certificate" "firearms-license" "insurance-letter" "income-statement" "debtors-letter" "other" null
customerId
required
string (CustomerId) <= 50 characters

ID of the customer resource.

notes
string or null

Reviewer notes.

reason
string or null

Reason for uploading.

matchLevel
integer [ 1 .. 2 ]

Tolerance level setting for document matches.

post
/kyc-documents
Request samples
application/json
{ "fileIds": [ "file_0YV7HZ7KDCC5WBV9Q7WRKG1H6N" ], "documentType": "identity-proof", "documentSubtype": "passport", "customerId": "cus_0YV7DDSDD1C8DA64KHH2W33CPF", "notes": "string", "reason": "string", "matchLevel": 2, "settings": { } }
Responses

201

KYC document created.

401

Unauthorized access. Invalid credentials used.

403

Access forbidden.

422

Invalid data sent.

Response samples
application/json
{ "id": "kyc_doc_0YV7JHY705C6DA487BFTAA33V8", "fileIds": [ "file_0YV7HZ7KDCC5WBV9Q7WRKG1H6N" ], "documentType": "identity-proof", "documentSubtype": "passport", "status": "pending", "rejectionReason": { "type": "document-unreadable", "message": "Provided document is unreadable" }, "requestId": "4f6cf35x-2c4y-483z-a0a9-158621f77a21", "createdTime": "2019-08-24T14:15:22Z", "updatedTime": "2019-08-24T14:15:22Z", "processedTime": "2019-08-24T14:15:22Z", "customerId": "cus_0YV7DDSDD1C8DA64KHH2W33CPF", "reviewerId": "44433322-2c4y-483z-a0a9-158621f77a21", "reviewerName": "string", "reviewStartTime": "2019-08-24T14:15:22Z", "reviewTime": "2019-08-24T14:15:22Z", "notes": "string", "tags": [ ], "reason": "string", "matchLevel": 2, "revision": 0, "documentMatches": { "score": 0.75, }, "parsedData": { "score": 0.75, }, "settings": { }, "_links": [ ], "_embedded": { "customer": { }, "files": [ ] } }