Developer Documentation

KYC

KYC

SikaaHub supports customer and merchant KYC submissions before high-trust financial actions.

Customer Basic KYC

• POST /kyc/customer/basic

Typical fields:

• ghana_card_number
• date_of_birth
• address

Ghana Card format should look like GHA-123456789-1.

Merchant KYC

• POST /kyc/merchant/basic
• POST /kyc/merchant/documents
• GET /kyc/me/status

Merchant documents are stored outside the public web root in storage/kyc. API responses never expose direct local file paths.

Allowed document types:

• ghana_card
• business_registration
• utility_bill
• business_photo
• owner_photo
• other

Allowed file extensions:

• jpg
• jpeg
• png
• pdf

Admin Review

• GET /admin/kyc/submissions
• GET /admin/kyc/submissions/{id}
• POST /admin/kyc/submissions/{id}/approve
• POST /admin/kyc/submissions/{id}/reject
• POST /admin/kyc/documents/{id}/approve
• POST /admin/kyc/documents/{id}/reject

Every submission and review action is audited.