Skip to navigation
Corporate Accounts

Resend Corporate KYC OTP

View as Markdown

Resends the OTP for an in-progress corporate KYC session. Same rate limits as Initiate Corporate KYC.

Body

FieldTypeRequiredRules
session_idstringyessession_id returned by Initiate Corporate KYC. Must belong to your company. Not schema-validated - omitting it produces a 500 with an internal error message.

Behaviour

  • Re-initiates BVN verification with the provider (a new provider reference and a new OTP); the session’s previous OTP should be treated as void.
  • Shares the 3-attempt limit and 60-second cooldown with Initiate Corporate KYC (the initial send counts as attempt 1, so at most 2 resends).
  • A session that is already VERIFIED (or otherwise closed) returns 400 Session closed.
  • message on success/provider-failure is passed through from the provider (fallbacks OTP re-sent / Unable to retry).

Authentication

AuthorizationBearer

Access token from Generate Access Token (valid 15 minutes).

Request

This endpoint expects an object.
session_idstringOptional

Response

OK
statusstringOptional
messagestringOptional
dataobjectOptional

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error