Skip to main content
This is Step 2 of 6 in the onboarding journey. View the full onboarding overview →

​
Why email verification exists

Before you can upload your company documents or access any part of the platform, you need to prove that you have access to the email address you registered with. This matters for two reasons. First, it prevents anyone from accidentally registering with someone else’s email address. Second, your email is how we send you security alerts, document review results, API key notifications, and production approval updates. Verifying it now means those messages reach the right person.

​
What to expect in the verification email

Within seconds of completing registration, an email is sent to the address you provided. Here is what to look for:
Email detailValue
Fromnoreply@unionbank.ng
SubjectUBN BaaS — Verify your email address
ContentsA 6-digit OTP code and a link to the verification page
OTP stands for One-Time Password — a code that can only be used once. Even if someone else sees the code, they cannot use it after you have submitted it. The code expires after 24 hours, so do not wait too long.
Check your spam or junk folder if you do not see the email within 5 minutes. Some corporate email servers apply aggressive filtering to automated messages. If your IT team manages your email, ask them to whitelist noreply@unionbank.ng.

​
How to submit your verification code

You have two options: use the web portal or submit the code via the API directly.

​
Option A: Verify via the web portal

  1. Open the verification email and copy the 6-digit code
  2. Go to sandbox.api.unionbank.ng/verify-email
  3. Enter your email address and the 6-digit code
  4. Click Verify Email
You will see a confirmation message and your account status will update to PENDING_KYB_DOCUMENTS.

​
Option B: Verify via the API

Endpoint: POST /api/Auth/verifyEmailCode Base URL: https://sandbox.api.unionbank.ng 
curl -X POST https://sandbox.api.unionbank.ng/api/Auth/verifyEmailCode \
  -H "Content-Type: application/json" \
  -d '{
    "email": "cto@techfin.ng",
    "code": "847291"
  }'
Request body fields:
FieldTypeRequiredDescription
emailstringYesThe exact email address you registered with
codestringYesThe 6-digit OTP from the verification email

​
Success response

{
  "success": true,
  "message": "Email verified successfully.",
  "data": {
    "partnerId": "prt_7f3a9b2c1d4e5f6a",
    "email": "cto@techfin.ng",
    "status": "PENDING_KYB_DOCUMENTS",
    "verifiedAt": "2025-03-25T10:48:00Z"
  }
}
Understanding the response fields:
FieldWhat it means
partnerIdYour unique partner identifier. This is unchanged from registration.
emailThe email address that was just verified.
statusPENDING_KYB_DOCUMENTS means email verification is complete and you are ready for Step 3 — uploading your business documents.
verifiedAtThe exact time your email was verified, in UTC.

​
What happens next

Your account status is now PENDING_KYB_DOCUMENTS. This means:
  • You can log in to the portal
  • You can see the document upload section
  • You cannot make authenticated API calls yet (you do not have an API key at this stage — that comes after KYB approval)
The next step is to upload your company’s compliance documents. Continue to Step 3: Submit KYB Documents →

​
Troubleshooting

Try the following steps in order:
  1. Wait 5 minutes. Email delivery can occasionally take a few minutes, especially through corporate mail servers.
  2. Check your spam or junk folder. Search for noreply@unionbank.ng or UBN BaaS.
  3. Check your email address. Log in to the portal and confirm the email address shown in your profile is the one you intended. A typo at registration is a common cause.
  4. Request a resend. On the portal login page, click Resend verification email and enter your email address.
  5. Check with your IT team. Some corporate email systems block automated messages from external senders. Ask your IT team to whitelist noreply@unionbank.ng.
If you have tried all of the above and still have no email after 30 minutes, contact baas-support@unionbank.ng with your registered email address and the time you registered.
The OTP code is valid for 24 hours from the time it was sent. If it has expired, you cannot use that code.To get a new code:
  • Go to the portal login page and click Resend verification email
  • Or call POST /api/Auth/resendVerificationCode with your email address
curl -X POST https://sandbox.api.unionbank.ng/api/Auth/resendVerificationCode \
  -H "Content-Type: application/json" \
  -d '{"email": "cto@techfin.ng"}'
A new code will be sent immediately. The old code is invalidated as soon as the new one is generated.
Do not re-register if your code has expired. Re-registering with the same email address will fail. Use the resend option instead.
An OTP code can only be used once. If you receive a “code already used” error, it means the code was submitted successfully at some point — possibly by you in a different browser tab, or by a team member who also has access to the email inbox.Check your account status:
  • Log in to the portal at sandbox.api.unionbank.ng
  • If you see a PENDING_KYB_DOCUMENTS status, your email is already verified and you can proceed to Step 3
If you cannot log in and the code is already used, contact baas-support@unionbank.ng.
After 5 incorrect attempts, the code is locked for security reasons. You will need to request a new code using the resend option described above.If your account is locked, contact baas-support@unionbank.ng to have the lock cleared manually.
If you registered with an email address you do not have access to, you will not be able to receive the verification code. In this case:
  1. Contact baas-support@unionbank.ng with your partnerId (from the registration response) and the correct email address you intended to use
  2. Our team will update the email on your account and trigger a new verification email
You cannot change your own email address at this stage — it requires manual intervention from our support team.