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 nameDescriptionField typePossible values
nameName of the programstringMaximum length is 50 characters
typeType of program, which specifies the template that the Pismo platform usesstringTypical values for a lending program include CURRENT ACCOUNTS, INTERNAL_ACCOUNTS, CORRESPONDENT ACCOUNTS, and LENDING. For more information, refer to Program types
timezoneProgram time zonestringInternet Assigned Numbers Authority (IANA) time zone database "Region/City" format
currency_numeric_codeProgram ISO 4217 currency codestringFor example: 978 = Euro
country_codeISO 3166 Alpha-3 program country codestringFor 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.





Did this page help you?