API Reference
Playbook for integrating Stilt Credit Infrastructure with a platform. High-level goals are
  • To give an understanding of Stilt APIs
  • Step by step guide for implementing Loan/Line of credit using Stilt Credit platform

Implementation steps

User creation

  • First implement authentication, HMAC, and encryption implementation
    • All API calls will have an Authentication Header, we highly recommend every new platform to make sure that they understand HMAC implementation, and add appropriate headers before making calls to API. You can reach more about HMAC here.
  • Once you have implemented basic authentication, you can implement a user creation endpoint. As a part of user creation, we require some basic information. Here is the endpoint for creating a new user.
We recommend creating a new user when you have basic information is available like Name, Date of Birth, Email, Phone. We have the capability to patch information later.
  • After creating a user, you should update the user object with other meta-data like banking information, bank transactions, and credit report as you receive it from 3rd party provider. Here is API to update a user.
Please keep in mind some data sets, like credit reports and bank transactions, are very essential for underwriting. Providing more data helps us to do better underwriting and increase more approval.

Application for the loan, line of credit, or build credit

  • Once we have created a user, the platform should submit an application on behalf of the user, using Application APIs.
  • As we receive the application on the backend, instantly Stilt Risk Model makes the decision of approving or rejecting a loan, and based on the response platform should show the option to accept the loan or other product offering in case of rejection.

Loan acceptance and disbursal flow

  • If a loan has been approved, the user will have an option to accept the loan (LoC) offer.
    • At this stage, the platform should show complete TILA disclosure (what's TILA?) and offer it to users so that we are compliant with the state regulators.
    • The platform will get offers details either as the response of the application creation endpoint, or the platform can call the GET endpoint to get details.
    • The platform must also call to Promissory Note retrieval endpoint to get TILA disclosure and show users in the iframe.
  • For accepting the loan offer, a user must have to accept all the terms and conditions and sign the promissory note using this endpoint.
  • Once the loan offer has been accepted Stilt transfers funds to the dedicated bank account, which will be passed as a parameter for the Sign Promissory Note endpoint.

Line of credit and disbursal flow

  • If a line of credit has been approved, the user will have an option to accept the LOC) offer.
    • At this stage, the platform should show complete TILA disclosure (what's TILA?) and offer it to users so that we are compliant with the state regulators.
    • The platform will get offers details either as the response of the application creation endpoint, or the platform can call the GET endpoint to get details.
    • The platform must also call to Promissory Note retrieval endpoint to get TILA disclosure and show users in the iframe.
  • For accepting the loan offer, a user must have to accept all the terms and conditions and sign the promissory note using this endpoint.
  • Once the LOC offer has been accepted, platform can request multiple draw request on user behalf as long as credit limit is available and credit line is active.
Copy link