...
Parameter | Data Type | Description | |
|---|---|---|---|
userName | Text | - | Mandatory |
userPassword | Text | - | Mandatory |
userPin | Number | The 2 FA Value. | Optional |
| Text | Mandatory | |
userIP | Text | - | Optional |
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)
| Code Block |
|---|
<?xml version="1.0" encoding="utf-8"?>
<API3G>
<userName>{userName}</userName>
<userPassword>{userPassword}</userPassword>
<companyCode>{companyCode}</companyCode>
<userPin>{userPin}</userPin>
</API3G> |
Response (XML)
Success
| Code Block |
|---|
<?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
| Code Block |
|---|
<?xml version="1.0" encoding="UTF-8"?>
<API3G>
<Code>999</Code>
<Error>Missing 2FA value</Error>
</API3G> |
...