Open a Joint Account

POST /onboarding/applyForJointAccount

A joint account in a bank works like a regular bank account and is shared by two or more people (In Choice, 2 or 3 people).

These accounts can be created permanently, for example, an account between two family members or spouses where both can deposit their salaries.

It can also be created temporarily for a shorter period of time between two parties to collect funds.

Parameters

Parameters	Type	Description	Required?
userId	String	Channel user id	Mandatory
mandate	Int	Singly Anyone or survivor	Mandatory
applicationForm	File	Allow pdf or image	Mandatory
applicationFormType	string	pdf/image default image	Optional
primaryOwnerInfo	object
firstName	String	Full name	Mandatory
middleName	String	Middle name	Optional
lastName	String	Last name	Mandatory
idType	Int	Id type 101 - National ID 102 - Alien ID 103 - Passport	Mandatory
idNumber	String	Id number	Mandatory
kraPin	String	Kra pin number	Mandatory
countryCode	String	Country code	Mandatory
mobile	String	Mobile number	Mandatory
email	String	Email address	Optional
idFrontSideFile	File	Front side of the id Allow pdf and image	Mandatory
idFrontSideFileType	string	pdf/image, default image	Optional
idBackSideFile	File	Allow pdf and image	Mandatory
idBackSideFileType	string	pdf/image,default image	Optional
kraPinFile	File	Allow pdf and image	Mandatory
kraPinFileType	string	pdf/image,default image	Optional

Response

00000

{
  "onboardingRequestId": ""
}

Adding a joint account owner

POST /onboarding/addJointAccountOwner

This endpoint will be used to request the addition of joint account holders. Account holders will be added one at a time

This API can be called after the OTP has passed but before the onboarding request is approved.

Parameters

Parameters	Type	Description	Required?
onboardingRequestId	String	Onboarding request id	Mandatory
firstName	String	Full name	Mandatory
middleName	String	Middle name	Optional
lastName	String	Last name	Mandatory
idType	Int	101 - National ID 102 - Alien ID 103 - Passport	Mandatory
idNumber	String	Id number	Mandatory
kraPin	String	Kra pin number	Mandatory
countryCode	String	Country code	Mandatory
mobile	String	Mobile number	Mandatory
email	String	Email address	Optional
idFrontSideFile	File	Front side of the id Allow pdf and image	Mandatory
idFrontSideFileType	File	pdf/image, default image	Opyional
idBackSideFile	File	Allow pdf and image	Mandatory
idBackSideFileType	string	pdf/image, default image	Optional
kraPinFile	File	Allow pdf and image	Mandatory
kraPinFileType	string	pdf/image default image	Optional

Response

00000

{
  "memberId": "", returned for user to remove owner(s) in processing stage
}