Unified Credit Decisioning

HCSCORE Scoring Engine

A single scoring workflow that processes all channels through bureau integration, scorecard selection, and risk classification — returning channel-specific responses in real time.

Workflow Pipeline

From Request to Response

Every scoring request follows a seven-stage pipeline, ensuring consistent decisioning across all channels.

Stage 1

HCSCORE API

Inbound scoring request received via REST API. The request carries applicant identifiers, channel code, and any pre-populated data from the origination system.

Channels: AO (Affordability Online), CR (Credico), WA (WhatsApp/InfoBip).

POST /api/hcscore

Stage 2

Pre-Score Validation

Identity verification, duplicate detection, and input sanitisation. Checks for existing active accounts, blacklisted IDs, and mandatory field completeness before proceeding.

Early exits for invalid or duplicate applications reduce unnecessary bureau costs.

VALIDATE → DEDUPE → BLACKLIST

Stage 3

Bureau Pull

Automated credit bureau enquiry routed to the correct regional Experian endpoint based on the applicant's country of origin. Full credit profile retrieved and parsed.

Four bureaus: Experian SA, Lesotho, Namibia, Eswatini.

EXPERIAN → PARSE → ENRICH

Stage 4

Scorecard Selection

The engine selects the appropriate scorecard based on the applicant's credit profile: Paying Segment for customers with payment history, Non-Paying for thin-file applicants, or Thin-File for those new to the bureau.

Scorecard selection is fully automated based on bureau response data.

PAYING | NON-PAYING | THIN-FILE

Stage 5

Score Calculation

The selected scorecard computes a numeric score, credit limit segment, maximum term, risk grade, and strikethrough indicator (approve/decline). All variables logged for audit.

Deterministic scoring with full variable-level traceability.

SCORE → GRADE → LIMIT

Stage 6

Post-Score Processing

Additional business rules applied after scoring: showroom risk indicators for physical stores, rating scale mapping, and lead source classification for downstream reporting.

Nine lead sources tracked for conversion analytics.

RULES → CLASSIFY → ROUTE

Stage 7

Response

Channel-specific response formatting. AO receives a simplified score with flags. CR and WA receive a full response including lead wording for agent or conversational consumption.

Average response time under 2 seconds end-to-end.

AO: flags | CR: full | WA: full

Scorecard Types

Three Scorecards, One Pipeline

Scorecard selection is automated based on the applicant's credit bureau profile.

Segment 1

Paying Segment

For customers with established payment history on the bureau. Uses historical payment behaviour, existing facility performance, and account tenure as primary scoring inputs.

Segment 2

Non-Paying Segment

For applicants with a bureau record but no meaningful payment history. Relies on demographic data, enquiry patterns, and address stability for risk assessment.

Segment 3

Thin-File

For applicants new to the credit bureau with minimal or no records. Conservative scoring with lower initial limits, relying on identity verification and basic demographic signals.

Score Output

What HCSCORE Returns

Every scored application produces a structured response with these key fields.

Field Description
Score Numeric credit score computed by the selected scorecard
StrikethroughIndicator Approve or decline flag based on score thresholds and policy rules
MaxTerm Maximum repayment term in months allowed for this risk profile
CL_Segment Credit limit segment determining the maximum facility size
ShowroomRiskIndicator H/M/L risk classification for physical store transactions
RiskGrade Overall risk grade for reporting and portfolio segmentation
RatingScale Mapped rating scale for regulatory and internal reporting purposes

Channel Routing

Channel-Specific Responses

The same scoring pipeline delivers tailored responses based on the originating channel.

AO

Affordability Online

Simplified response — score and flags only. The self-service front end consumes a minimal payload to drive the customer-facing approve/decline experience.

CR

Credico

Full response with lead wording. Agents receive the complete score output plus pre-formatted text for customer communication and next-step guidance.

WA

WhatsApp / InfoBip

Full response with lead wording. The conversational bot formats the scoring result into WhatsApp message templates for immediate customer delivery.

52,500
Monthly Volume
3
Scorecard Types
4
Regional Bureaus
9
Lead Sources

See the Full HomeChoice Platform

The scoring engine is one part of a complete credit lifecycle — from origination through collections.