Description
Perform a login process with a 2-factor auth handling. All merchant can LogIn except co 139.
Request
Url - {baseUrl}/API/v7/UserAuth/
These parameters will be sent in the request body. (POST method)
Parameter | Data Type | Description |
|
|---|---|---|---|
userName | Text | - | Mandatory |
userPassword | Text | - | Mandatory |
userPin | Number | The 2 FA Value. | Optional |
| Text |
| Mandatory |
The Flow
After receiving the parameters, the userName will be used to check if this user has 2FA enabled. if so, and the userPin parameter is missing an error will respond back to the user - “Missing 2FA value“.
Then the user will send again his credentials with the userPin (the 2FA value). The user’s credentials and pin code will be verified to approve a successful login.
If the user does not has 2FA option enabled, the login process continues to verify the userPassword.
Request (XML)
<?xml version="1.0" encoding="utf-8"?>
<API3G>
<userName>{userName}</userName>
<userPassword>{userPassword}</userPassword>
<companyCode>{companyCode}</companyCode>
<userPin>{userPin}</userPin>
</API3G>
Response (XML)
Success
<?xml version="1.0" encoding="UTF-8"?>
<API3G>
<Code>000</Code>
<UserToken>{UserToken}</UserToken>
<CompanyName>{CompanyName}</CompanyName>
<CompanyBrandName>{CompanyBrandName}</CompanyBrandName>
<CompanyCode>{CompanyCode}</CompanyCode>
<CompanyToken>{CompanyToken}</CompanyToken>
<Currencies>
<Currency>EUR</Currency>
<Currency>GHS</Currency>
<Currency>KES</Currency>
</Currencies>
</API3G>
Error
<?xml version="1.0" encoding="UTF-8"?>
<API3G>
<Code>999</Code>
<Error>Missing 2FA value</Error>
</API3G>