Get started with lending
Use Pismo's lending solution to build loan products for your customers and to manage those loans throughout their lifecycle. Use this step-by-step guide to get started.
For an overview of lending concepts, refer to Lending overview.
Step 1: Create your organization (org)
An org is an object that represents your organization on the Pismo platform. Your Pismo support team creates your org. For more information about org creation and all other onboarding tasks, refer to Onboarding for new customers.
Step 2: Create programs
Programs define the types of accounts a customer can open with your org, such as credit, debit, and lending accounts. You can't create customer accounts without at least one program, so you must complete this step.
There are three methods available for creating your program. You can use Control Center or APIs with each method.
Method | Description |
|---|---|
Use a template | Choose a program from one of our templates, enter the basic details about your program, and submit. We then create the program, and you can customize it when you’re ready. This method is the default.
|
Copy an existing program | If you have existing programs, you can copy (or clone) a program and change some of the details. Be aware that you can’t change all the details.
|
Import a program | You can use this method if you have programs in an existing test environment or another organization defined on the Pismo platform.
|
If you're using the Create program endpoint, use the following fields. All fields are required. Fields for program setup that are not listed in this table are not applicable to lending.
| Field name | Description | Field type | Possible values |
|---|---|---|---|
name | Name of the program | string | Maximum length is 50 characters |
type | Type of program, which specifies the template that the Pismo platform uses | string | Typical values for a lending program include CURRENT ACCOUNTS, INTERNAL_ACCOUNTS, CORRESPONDENT ACCOUNTS, and LENDING. For more information, refer to Program types |
timezone | Program time zone | string | Internet Assigned Numbers Authority (IANA) time zone database "Region/City" format |
currency_numeric_code | Program ISO 4217 currency code | string | For example: 978 = Euro |
country_code | ISO 3166 Alpha-3 program country code | string | For example: ESP = Spain |
The following sample code shows how to use this endpoint to create a lending program named Sample_lending_program:
curl --request POST
--url <https://sandbox.pismolabs.io/programs/v1/programs/template>
--header 'Accept: application/json'
--header 'Authorization: Bearer <token value>'
--header 'Content-Type: application/json'
--data '
{
"timezone": "America/Sao_Paulo",
"currency_numeric_code": "986",
"name": "Sample_lending_program",
"type": "LENDING"
}'When you set up a program, you are prompted to accept default processing codes. If you choose not to accept them, then you must set up your own processing codes. If you don’t accept the default codes or set up your own, your disbursement and repayment requests will return errors.
Step 3: Configure accounting
The Pismo platform provides tools to keep track of business and financial transactions for accounting purposes. It enables you to create general ledger accounts based on your organization's balance sheet. You can then configure accounting scripts that generate accounting entries based on accounting events.
For more information, refer to Accounting overview.
Step 4: Create loan products
Create loan products to match your lending business requirements. A loan product defines the options and rules individual loans inherit, including how often repayments are due, how interest is calculated, what limits apply, and so on. Loan products act as templates for your loans, so configuring them is a required first step before you can create any individual loan.
For more information, refer to Create loan products.
Step 5: Book and manage loans
With your loan products configured, you can now simulate, book, and disburse loans for your customers based on these products. You can also manage these loans at every stage, through settlement.
For more information, refer to Manage loans.
Updated 2 months ago