Uploading Supporting Documents for Payouts

Providing supporting documents is a key requirement for certain payouts on Kora, ensuring all transactions 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 fulfil all document requirements for a payout.
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 - this can be `payout_supporting_document`.
`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"
    }
}