XYB Credit - Quick Start Guide
Designing a credit product on the platform involves a layered approach that builds flexibility, control, and reuse into your credit lifecycle. This structure ensures that you define reusable building blocks once, then assemble them to create purpose-specific products, and finally deploy those products at a customer level through contracts. Below is a detailed breakdown of how this works across three levels:
Level 1: Service Configuration: Define the Rules
This foundational layer focuses on configuring reusable logic that will later power multiple products. Think of this as defining your global settings for credit. Read below the services you will need to configure or directly jump into Configure Global Settings for Credit Products to get started.
Key Services You Configure:
Entity Service Define sectors, segments, custom fields, and supported currencies. This ensures every entity (e.g. customers, partners) is correctly profiled for downstream credit use. Learn more.
Collateral Service Configure collateral types like
CASH,IMMOVABLE, and their subtypes. These definitions are referenced later when assigning guarantees to contracts. Learn moreInterest Service Set up interest categories such as
PRINCIPAL,PENALTY, andCOMMITMENT, with types like flat, reducing balance, or variable. These settings ensure consistency in interest logic across products. Learn moreContract Service Define defaults for repayment terms, schedule types (e.g.,
ANNUITY,BULLET,BALLOON), component settlement orders, customer applicability, and more. This helps encapsulate how a typical credit agreement behaves. Learn moreProduct Configuration Service Configure product states, transitions, and permissible workflows like activation, suspension, or termination. Learn more
Once these services are configured, they act as global libraries that can be selectively applied to specific product versions.
Level 2: Product Configuration: Assemble the Use Case
After setting up services, you move to the Product Configuration tab to create actual credit product definitions like Small Business Loans or BNPL Pay Later. These are version-controlled containers where you link services configured at Level 1.
Steps to Configure a Credit Product:
Create New Product Define a name, unique product reference, and version.
Add Services to Product Select from the configured services: Ledger, Product Config, Accounts, Credit Contracts, etc.
Credit Product Setup You now see all options pulled from Level 1:
Choose owner and length type
Set first principal and interest repayment periods
Select settlement order and schedule type (
FIXED,ANNUITY, etc.)Define customer applicability (sector and segment)
Choose currencies, interest types, and agreement length attributes
Templates and Collateral Link to predefined templates like
CreditAgreementTemplate, and assign collateral types if required.
This stage is where the credit product logic becomes concrete you define exactly how the loan or credit behaves for a specific use case. Learn more
Level 3: Contract Disbursal and Manage Repayment
With the credit product now fully configured and activated, you can move to the Contracts > Lending section and start creating individual customer contracts.
How This Works:
Select the product (e.g. Small Business Loans)
Choose the linked entity (customer, partner, etc.)
Auto-fill terms and interest based on product version
Assign collateral if applicable
Generate the contract document using the linked template
Activate and monitor repayments via the ledger and payments tab
This level is where business teams operate daily creating actual agreements tied to real-world borrowers. Learn more about Disbursing & Managing Credit Contracts.
Last updated

