Apply for a Revolving Credit Loan

Posting a loan with Synapse

After you Create a User and OAuth the User, the user is ready to apply for a loan.

Upon applying for a loan, users will know instantly if they are approved and rejected, along with rejection reason.

Following are permissible reasons an application could be rejected:

  1. Loan rejected because KYC is not finished.
  2. Loan rejected because currently we do not issue loans for your user type.
  3. Loan rejected because the requested loan amount is higher than what we currently allow. The limit platform_limit
  4. Loan rejected because you are over the limit of loans we currently allow. The limit is platform_limit.
  5. Loan rejected because your credit score is low. Your credit needs to be over platform_limit.

Loan Program:

Here are all the features you can customize on your spec sheet for a loan:

Program Details
Comment
Details

Agreement Delivery

Platform or Synapse

You can decide if you want to send your end user the agreement or use our white labeled email notifications

Transaction Notification

Platform or Synapse

You can decide if you want to send your end users notifications about loans or use our white labeled text message notifications

Loan Type

One Time and/or Revolving

You can decide if you want to issue a one time loan or a revolving line of credit

Credit Score

N/A

You can factor in soft credit score pulls as part of your decision. Here you can set a minimum credit score users should have to receive a loan

APR

XX%

This is the amount of interest charged on the loan that the user takes out

Cap Amount

XX%

Although the APR on a loan can increase, there will be cap on the amount of interest that an end user gets charged. That way the interest can only increase to a certain amount at the most

Max Amount per Loan

$XX

The maximum dollar amount that can be taken out per loan for the user.

Repayment

Auto-Debit

This is how the user will repay their loan. Auto-debit means that the user will be automatically debited on the same day/date either on a daily, weekly or monthly schedule

Schedule

Daily/Weekly/Monthly

Loan repayment can be scheduled to happen on a recurring daily, weekly, or monthly

Custom Rules

N/A

This accounts for any additional customization that you would have for loan decisioning

user_id :
required
string

The user ID of the user you wish to add the LOAN-US node under

BODY PARAMETERS

type :
required
string

LOAN-US

info.loan_type :
required
string

Type of loan (`REVOLVING`)

info.nickname :
string

nickname of the loan account

info.credit_limit.amount :
required
float

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

info.credit_limit.currency :
required
string

currency of the loan account

info.interest.apr :
float

APR on the loan in percentage

info.interest.cap :
float

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

info.payment_node_id :
string

node ID of where we will collect payments from

info.disbursement_node_id:
string

node id of where the funds will be disbursed to.

info.document_id :
required
string

KYC document ID of the user

info.schedule :
required
string

Payment schedule. All schedules are listed below

info.next_payment :
long

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

info.installment_amount :
float

amount for each payment installment.

extra.supp_id :
string

Supplement id for node

Example Request

Applying for a loan is a POST API call to a Node.

POST /v3.1/users/5be92ff1321f48008fac90b3/nodes HTTP/1.1
Host: https://uat-api.synapsefi.com
X-SP-USER-IP: 255.127.79.76
X-SP-USER: oauth_9QacXjr56hOldHp8tN|e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json
{
  "type": "LOAN-US",
  "info": {
  	"loan_type":"REVOLVING",
    "nickname":"My Loan",
    "credit_limit":{
    	"amount":500.2,
    	"currency":"USD"
    },
    "document_id":"2a4a5957a3a62aaac1a0dd0edcae9",
    "schedule":"MONTHLY"
  },
  "extra":{
  	"supp_id":"xx123c"
  }
}
curl -X POST \
  https://uat-api.synapsefi.com/v3.1/users/5be92ff1321f48008fac90b3/nodes \
  -H 'Content-Type: application/json' \
  -H 'X-SP-USER: oauth_9QacXjr56hOldHp|e83cf6ddcf778e37bfe3d48fc78a6502062fc' \
  -H 'X-SP-USER-IP: 255.127.79.76' \
  -d '{
  "type": "LOAN-US",
  "info": {
  	"loan_type":"REVOLVING",
    "nickname":"My Loan",
    "credit_limit":{
    	"amount":500.2,
    	"currency":"USD"
    },
    "document_id":"2a4a5957a3a62aaac1a0dd0edcae96ea",
    "schedule":"MONTHLY",
  },
  "extra":{
  	"supp_id":"xx123c"
  }
}'
body= {
  "type": "LOAN-US",
  "info": {
    "loan_type":"REVOLVING",
    "nickname":"My Loan",
    "credit_limit":{
      "amount":500.2,
      "currency":"USD"
    },
    "document_id":"2a4a5957a3a62aaac1a0dd0edcae9",
    "schedule":"MONTHLY"
  },
  "extra":{
    "supp_id":"xx123c"
  }
}

user.create_node(body)
const body = {
  "type": "LOAN-US",
  "info": {
    "loan_type":"REVOLVING",
    "nickname":"My Loan",
    "credit_limit":{
      "amount":500.2,
      "currency":"USD"
    },
    "document_id":"2a4a5957a3a62aaac1a0dd0edcae9",
    "schedule":"MONTHLY"
  },
  "extra":{
    "supp_id":"xx123c"
  }
};

user.createNode(body);
body= {
  "type": "LOAN-US",
  "info": {
    "loan_type":"REVOLVING",
    "nickname":"My Loan",
    "credit_limit":{
      "amount":500.2,
      "currency":"USD"
    },
    "document_id":"2a4a5957a3a62aaac1a0dd0edcae9",
    "schedule":"MONTHLY"
  },
  "extra":{
    "supp_id":"xx123c"
  }
}

user.create_node(payload: body)
$extra = (object)[
  "supp_id" => "xx123c"
];
$credit_limit = (object)[
 "amount" => 40.10,
 "currency" => "USD"
];

$info = (object)[
 "loan_type" => "REVOLVING",
 "nickname" => "My Loan",
 "credit_limit" => $credit_limit, 
"document_id" =>"2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8",
 "schedule"=>"MONTHLY"
];

$body = (object) [
 "type" => "LOAN-US",
 "info" => $info,
 "extra" => $extra,
];

$user->create_node($body);
body := `{
  "type": "LOAN-US",
  "info": {
    "loan_type":"REVOLVING",
    "nickname":"My Loan",
    "credit_limit":{
      "amount":500.2,
      "currency":"USD"
    },
    "document_id":"2a4a5957a3a62aaac1a0dd0edcae9",
    "schedule":"MONTHLY"
  },
  "extra":{
    "supp_id":"xx123c"
  }
}`

data, err := user.CreateNode(body)

Examples Responses:

{
    "error_code": "0",
    "http_code": "200",
    "limit": 20,
    "node_count": 1,
    "nodes": [
        {
            "_id": "5be9301af8733300bb5fbf78",
            "_links": {
                "self": {
                    "href": "https://uat-api.synapsefi.com/v3.1/users/5be92ff1321f48008fac90b3/nodes/5be9301af8733300bb5fbf78"
                }
            },
            "allowed": "CREDIT-AND-DEBIT",
            "client": {
                "id": "589acd9ecb3cd400fa75ac06",
                "name": "Synapse"
            },
            "extra": {
                "note": null,
                "other": {},
                "supp_id": "xx123c"
            },
            "info": {
                "agreements": [
                    {
                        "type": "LOAN_AGREEMENT",
                        "url": "https://cdn.synapsepay.com/uploads/2018/11/12/ky23utZXqds9f4GonVLbvxIjRU7EW6r8SJMBATzO1N5FiDaYlC.pdf"
                    }
                ],
                "balance": {
                    "amount": 0,
                    "currency": "USD"
                },
                "credit_limit": {
                    "amount": 500.2,
                    "currency": "USD"
                },
                "document_id": "2a4a5957a3a62aaac1a0dd0edcae96",
                "interest": {
                    "accrued": 0,
                    "apr": 0.02,
                    "cap": 0.05
                },
                "loan_type": "REVOLVING",
                "name_on_account": " ",
                "nickname": "My Loan",
                "schedule": "MONTHLY"
            },
            "is_active": true,
            "timeline": [
                {
                    "date": 1542008851860,
                    "note": "Node created."
                }
            ],
            "type": "LOAN-US",
            "user_id": "5be92ff1321f48008fac90b3"
        }
    ],
    "page_count": 1,
    "success": true
}
{
    "error_code": "0",
    "http_code": "200",
    "limit": 20,
    "node_count": 1,
    "nodes": [
        {
            "_id": "5be9306bf8733300bb5fbf84",
            "_links": {
                "self": {
                    "href": "https://uat-api.synapsefi.com/v3.1/users/5be92ff1321f48008fac90b3/nodes/5be9306bf8733300bb5fbf84"
                }
            },
            "allowed": "REJECTED",
            "client": {
                "id": "589acd9ecb3cd400fa75ac06",
                "name": "SynapseFI"
            },
            "extra": {
                "note": "The LOANTYPE amount requested is higher than what we can offer you. Your limit is 1000.",
                "other": {},
                "supp_id": "xx123c"
            },
            "info": {
                "agreements": [
                    {
                        "type": "ADVERSE_ACTION",
                        "url": "https://cdn.synapsepay.com/uploads/2018/11/12/CU6qZT01svIEDGrnO0Fbh4tfdLglAcojNXmHYu9kwep28WMSP3.pdf"
                    }
                ],
                "balance": {
                    "amount": 0,
                    "currency": "USD"
                },
                "credit_limit": {
                    "amount": 0,
                    "currency": "USD"
                },
                "document_id": "2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8",
                "interest": {
                    "accrued": 0,
                    "apr": 10,
                    "cap": 0.05
                },
                "loan_type": "REVOLVING",
                "name_on_account": " ",
                "nickname": "My Loan",
                "schedule": "MONTHLY"
            },
            "is_active": true,
            "timeline": [
                {
                    "date": 1542008937322,
                    "note": "Node created."
                }
            ],
            "type": "LOAN-US",
            "user_id": "5be92ff1321f48008fac90b3"
        }
    ],
    "page_count": 1,
    "success": true
}

For revolving credit loans, we will not automatically create the loan disbursement. To draw against the loan, all you need to do is create a transaction from the loan node to the destination node. The end user will be able to pull funds from the loan account up to the credit_limit.amount.

Variable APRs

You can also specify the APR when you create a loan object. Any APR below what has been approved by us will work as a valid input. All you would need to do is add info.interest.apr in %.

Example:

POST /v3.1/users/5b9ee70e04707a0067a724d5/nodes HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-USER-IP: 255.127.79.76
X-SP-USER: oauth_F0rsnYzBpfZkNh91aERc5d|e83cf6ddcf778e37bfe3d48fc78a6502062fc
Content-Type: application/json
Cache-Control: no-cache

{
  "type": "LOAN-US",
  "info": {
  	"loan_type":"REVOLVING",
    "nickname":"For a Tesla Model X",
    "credit_limit":{
    	"amount":500.2,
    	"currency":"USD"
    },
    "interest": {
    	"apr": 10
    },
    "document_id":"2a4a5957a3a62aaac1a0dd0edcae96ea2cdee68",
    "schedule":"MONTHLY",
  },
  "extra":{
  	"supp_id":"xx123c"
  }
}

Subscribe to Webhooks

We recommend that you subscribe to webhooks to stay updated on the status of nodes.

Apply for a Revolving Credit Loan


Posting a loan with Synapse

Suggested Edits are limited on API Reference Pages

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