Fincheck

Environments

How UAT and Production differ, and what to confirm before going live.

FincheckEngine has two environments for integrations. Each has its own API origin, data, and keys.

EnvironmentAPI originUse it forData
UAThttps://api.engine-v2.uat.fincheck.co.zaBuilding your integration, validating payloads, and acceptance testingFictional applicants only
Productionhttps://api.engine-v2.fincheck.co.zaSending real applicants after Fincheck approves your integrationLive applicant data

The key decides the environment. A key is rejected by every other environment. Leads, offers, and batches never move between environments.

Base URL

Every endpoint is under /api/v2. The complete base URLs are:

EnvironmentBase URL
UAThttps://api.engine-v2.uat.fincheck.co.za/api/v2
Productionhttps://api.engine-v2.fincheck.co.za/api/v2

The Connection details section of the Overview shows the base URL for the environment these docs are connected to.

Before you go live

Confirm that your integration:

  • calls the Production origin with the Production key;
  • sends the Authorization header on every request;
  • keeps the key on your server and calls the API over HTTPS;
  • corrects 422 validation errors instead of dropping the lead;
  • stores the returned lead id for follow-up and support; and
  • handles every response your integration can receive, as described in Errors and, for Comparisons, Accepting an Offer.

Never send a real applicant to UAT or a fictional one to Production.