Skip to main content

Credit Decisions

A Bank-sponsored lending program requires daily reporting of all credit decisions, for all submitted credit applications. This includes credit applications that are submitted but denied at KYB.

Credit Decisions can be made for different entities, like Application or Credit Account, each of those requiring a different relationship in the request.

A credit decision can be either Approved, Denied or ManualReview. After creating a ManualReview decision and finishing the manual review process, a second decision of Approved or Denied needs to be created. Each decision requires different attributes for the request:

Approved Decision Attributes

creditLimit
Integer (Cents)
Credit limit for application as evaluated per policy.

Denied Decision Attributes

decisionReason
string
Reason for denial per credit policy. Max 200 char.
adverseActionReasons
Array of strings
Array of strings representing Adverse action reasons (must have at least one). Max 200 char per reason.

For each type of decision there is also a different request, as can be seen in the APIs documentation.

  • APIs - Create, retrieve, and list credit decisions
  • Events - Webhook events for credit decision lifecycle changes
  • Resources - JSON:API resource schemas