Revolving Loan Intro

Introduction to loans product

Currently in Beta

This product is currently in beta. Following are still to-dos on our side that we will be finishing:

  • Repayment Transactions: Everyday we will check if a payment is due, if it is, we will create a repayment transaction for the user.
    Interest accrual logic: Currently daily interest accrual is disabled on sandbox.
  • Credit Checks: Some developers wish to issue loans based on a credit box, currently we do not have this feature enabled on sandbox.
  • Payment due message alerts: Text message alerts for repayments are disabled. But when we will enable the repayment logic, this will be a part of that release as well.
  • Email for agreements and decisioning: This will come with the PDF generation release.
  • Closing Account: With the above releases, we will also add a feature to let you close loan accounts for users.

Our loan product allows you to quickly issue and service short-term unsecured loans without the need to register as a lender. Loans are built on top of our Node architecture and are treated as accounts with a negative balance.

A revolving loan is similar to a credit card, in that a user is issued a line of credit which they can draw against. Users will not be able to overdraw on this credit line and must pay off some of the balance to utilize credit.

To issue a revolving loan, Create a User with the necessary KYC. Then OAuth the user and apply for a loan by creating a LOAN-US node. This node will have all loan details, including credit limit, payment account, disbursement account, APR etc. The user will then either be denied or approved for the loan based on your custom requirements.

Note: Loans are considered unsecured loans because they are not backed by anything.

Node Type

Default Permissions


A loan account issued to a user with standard APR, credit limit, and payment details

Who is the lender? How is decisioning done?

Our partner banks act as the lender. This allows you to issue loans without registering as a lender yourself. However, you will still be guarantor of the loans issued to users. This means if the end user is unable to pay the loan, you will have to make the payments on their behalf.

When setting up your loan program, Synapse will underwrite your business and set an appropriate limit on how many loans your platform is allowed to underwrite at any given time. At this point, we will also work with you to establish decisioning for loan approval.

To be set up as the guarantor of loans your platform will hold a loan reserve account with the amount you’ll be giving out in loans. We will not debit this account as you are giving loans out, but this account will function more as collateral. We will only debit this account when the user does not pay back the loan after their agreed period of time. The platform's loan reserve account guarantees that loans are paid back. You can only issue loans based on the balance in your reserve account.

Interest Accrual and Cap amounts

Statements cycle: Statements will correspond to regular months. A statement is always the first day of the month to the last day of the month.
Statements delivery: Statements are delivered no later than the 10th of each month.
Payment date: Payment is due on the 20th of each month. No interest is charged if the total amount due is paid on this date.
Interest accrual: If the total amount due is not paid on the 20th of the month following the statement cycle, the interest accrued will include everything back to the initial day of expenditure/credit use.
Payments distribution: Partial or late payments shall offset the first expense made (in the timeline) and the interests accrued proportionally (ex.: if there is one 50 dollar payment plus $5 in interest ($55) and the user paid 11, then we will apply 10 for principal and 1 for interest, and the balance will be 40 principal and 4 interest).

Just like for our One-Time Loan, we cap APR on Revolving Credit Loans. We also do not charge end users for late payments. The APR is the only fee they have to worry about.

What that means is, for example, if an end user has a balance of $100 loan with an APR of 10% and cap of $40 dollars, then the interest will only accrue up to $40, not more.

Required KYC

For revolving loans, our KYC at a minimum would be base doc, SSN and government ID as the functionality more closely resembles a deposit account.

Node Object

_id :

ID of the loan account

allowed :

permisisons granted to the loan account

extra.note :

All reasons for rejecting a loan

info.agreements :
array of objects

Reference ID for the loan

info.agreements.type :

Type of agreement

info.agreements.url :

URL of the agreement

info.balance.amount :

Balance on the loan account

info.balance.currency :

currency of the loan account

info.credit_limit.amount :

limit of how much money can be borrowed out of this loan account

info.credit_limit.currency :

currency of the loan account

info.disbursement_node_id :

node id of where the funds will be disbursed to.

info.document_id :

KYC document ID of the user

info.installment_amount :

amount for each payment installment.

info.interest.accrued :

how much interest has accrued so far on the loan. In USD

info.interest.apr :

APR on the loan in percentage

info.interest.cap :

Max interest that will be charged on the loan in USD.

info.next_payment :

when the next payment is due. In unixtime (milliseconds)

info.nickname :

nickname of the loan account

info.num_payments :

number of payments in the loan term

info.payment_node_id :

node ID of where we will collect payments from

info.schedule :

Payment schedule. All schedules are listed below

info.loan_type :


type :


user_id :

ID of the user

Allowed Statuses



This allowed type is used for a revolving line. It means you can pay back the loan and also draw funds out of the account.


When the loan gets rejected, a loan account will be created but with allowed as REJECTED. The loan account will have details of rejection in the extra.notes section and also the adverse action letter under info.agreements.


In case of a revolving line, when a loan account is closed, it will be marked as LOCKED.


A node can be marked as INACTIVE if the balance is zero and it is not currently in use.

Agreement Types

Agreement Types


If a loan is rejected, an adverse action letter will be issued and that will be under the info.agreements object.


If a loan is credit based, then the credit agreement will be under info.agreements object.


If a loan is approved, the approved loan
with all the loan details agreement will be under info.agreements object.

Repayment Schedules



Monthly loan repayment

Revolving Loan Intro

Introduction to loans product

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.