Uploading Supporting Documents

Providing supporting documents is a key requirement for certain processes and transactions on Kora, ensuring they are legitimate and follow financial regulations. We have created an API that simplifies this process, helping you and your customers securely submit all the necessary documents.

This API will enable you to:

Upload: Submit single file to fulfill all document requirements for a transaction/action.
Confirm: Receive a secure confirmation that your documents have been uploaded.

Uploading Supporting documents

To upload a supporting document, make a POST request to the Upload document endpoint:

{{file_utility_baseurl}}/api/v1/files

The request body (multipart/form-data) should have the following parameters:

Field	Data Type	Required?	Description
`file`	File (Image or PDF)	True	This is the file to be uploaded.
`purpose`	String	True	This is the reason for which the upload is being made. For example, this can be `payout_supporting_document`, `chargeback_supporting_document`, etc.
`reference`	String	True	This is the unique file reference.

Here's an example of a response to this request:

{
    "status": true,
    "message": "File upload successful",
    "data": {
        "reference": "sample-file-reference",
        "purpose": "payout_supporting_document"
    }
}