Resolve FIRS TIN

​

Body

​

Behaviour

• The company must have an rcNumber on file; otherwise the request is rejected.
• If a job is genuinely in flight (vouchmarkTools.tin.firs.pending === true), the request is rejected.
• If firsTinPending is stale (the worker crashed without clearing it), the endpoint logs the reset and re-queues automatically.
• If the queue rejects the job, firsTinPending is rolled back to false and a 500 is returned.

curl -X POST https://api.vouchmark.com/v1/check-firstin \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"companyId":"cmp_aBcD..."}'

{
  "success": true,
  "message": "TIN verification initiated successfully",
  "jobId": "1234",
  "company": {
    "id": "cmp_aBcD...",
    "companyName": "TEKCIFY TECHNOLOGIES LTD",
    "rcNumber": "8511136",
    "firsTinPending": true
  }
}

​

Errors