Skip to main content
POST
/
api
/
v3
/
kyc
/
document
Create Kyc Document
curl --request POST \
  --url https://sandbox-api.kotanipay.io/api/v3/kyc/document \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "kycId": "<string>",
  "nationality": "<string>",
  "documentNo": "<string>",
  "documentExpirationDate": "<string>",
  "country": "<string>",
  "documentName": "<string>"
}
'
{
  "success": true,
  "message": "Kyc Document created successfully",
  "data": {
    "status": "<string>",
    "kycId": "<string>",
    "kycStatus": true
  }
}
This API will create a new KYC document record for customer verification.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
kycId
string
required
​
nationality
string
required

example Ghanian, Nigerian

​
documentNo
string
required
​
documentExpirationDate
string
required

should be of this format YYYY-MM-DD

​
country
string
required

example Ghana, Nigeria, Kenya

​
documentName
string
required

example PASSPORT, GOVERNMENT ID, VOTERS ID

Response

200 - application/json
​
success
boolean
Example:

true

​
message
string
Example:

"Kyc Document created successfully"

​
data
object