GAgalileo-ft
Loan

Create SMB Loan

Use the Create SMB Loan endpoint to create a small and midsize business (SMB) installment loan for a customer. Loan subproducts are configured for your installment loans product and are assigned a subproduct ID. Ensure you have the required <a href="doc:setup-for-installment-loans#manage-customer-records" target="_blank">customer data</a> to create a loan.

For optional parameters, do not pass an empty string or null value.

post/1.0/createSMBLoan

Request

  • Base URL
    lending-{corename}.{env}.gpsrv.com/lending/ (relative, and the document’s source URL is not known)
  • URL
    lending-{corename}.{env}.gpsrv.com/lending/1.0/createSMBLoan
  • Auth
    none declared

Request body application/x-www-form-urlencoded

apiLoginstring required

Provider's web service username, as provided by Galileo for the requesting IP address. Pattern: Max 50 characters Example: "AbC123-9999"

apiTransKeystring required

Web service password, as provided by Galileo for the requesting IP address. Pattern: Max 15 characters Example: "4sb62fh6w4h7w34g"

providerIdinteger required

Galileo-issued unique provider identifier. Pattern: Max 10 digits Example: 9999

transactionIdstring required

A provider-generated ID that is unique to each API call. A UUID is preferred. Do not reuse this identifier for multiple API calls. Pattern: Max 60 characters Example: "984513-395483653-4483483478"

providerTransactionIdstring

An optional provider-generated ID for the API request. Pattern: Max 60 characters Example: "47823438032233777"

providerTimestampstring

An optional provider-generated timestamp for the API request. Pattern: Max 60 characters Example: "2017-05-01 13:01:01"

customerPmtRefNostring required

PRN for the customer’s primary account. Galileo uses the PRN to retrieve customer information, like business name, date of birth, SSN, address, etc. When the loan is created, the loan_id will be associated with this PRN. Pattern: PRN Example: "074103447228".

subProductIdstring required

Identifier for the loan subproduct. Pattern: Max 15 characters. Example: "442824720".

simulationIdstring

Unique identifier associated with each loan simulation returned by the Simulate Loan endpoint. Required when creating a loan from a simulation. Do not pass the following fields when the simulationId is provided: totalLoanAmount, loanTerm, and capitalTerm. Pattern: Max 9 characters. Example: "450825953".

taxIdType'EIN' | 'ITIN' | 'SSN' required

Identifies whether the tax ID is Employer Identification Number (EIN), Social Security Number (SSN), or an Individual Taxpayer Identification Number (ITIN). Pattern: EIN, SSN, ITIN. Example: "EIN".

taxIdstring required

Loan applicant’s 9 digit taxpayer identification number. Pattern: Exactly 9 digits, no hyphens or other characters. Example: "222554444".

ownerIdstring required

Indicates the ownership of the loan assets. Pattern: Max 30 characters. Example: "845dk-39fdk3fj3-4483483478".

phonestring

Loan applicant’s phone number. Pattern: Exactly 10 digits, no hyphens or other characters. Example: "1115553333".

emailstring

Loan applicant’s email address. Pattern: Email address, 3–63 characters. Example: "user@fakedomain.com".

address1string required

Loan applicant’s first address line. Cannot be a P.O. box. Validation rules for address1. Pattern: 4–40 alphanumeric characters. Example: "33 Maple Street".

address2string

Loan applicant’s second address line. Pattern: Max 30 characters. Example: "#4B".

citystring required

Loan applicant’s city. Pattern: Max 30 characters: letters, spaces, hyphen and period. Example: "Salt Lake City".

statestring required

Loan applicant’s state or province. Pattern: 2-character state or province abbreviation. Example: "UT".

postalCodestring required

Loan applicant’s postal code (ZIP code). Pattern: Min 5 characters and max 10 characters (12345, 12345-1234, or K1A-1A1). Example: "84121".

countryCode'840' required

Loan applicant’s country. Three-digit UN M49 country code. Currently the only allowed value is 840 for the USA. Pattern: 3-digit country code.

applicationNumberstring

Unique identifier that you generate for the loan application. This identifier is associated with loan simulations. You can give this identifier to customers for customer service purposes.

totalLoanAmountnumber

Total amount for the loan. Pattern: Decimal number (14,2). Example: "700.00".

loanTerminteger required

Number of installments to pay off the loan. Pattern: Min 1 characters and max 9 characters. Example: 4.

capitalTerminteger required

Length of time between payments, in units specified by the subproduct. For example, if you specify “2” and the loan subproduct is set to weeks then installments will be due every two weeks. Pattern: Max 9 digits. Example: 2.

loanStartDatestring date

Start date for the loan. This may be different from loan_creation_date.

Response

Success

status_codeinteger nullable required

The response status code. May return a string for some statuses.

statusstring nullable required

The condition of a process or response

processing_timenumber float nullable required

The time elapsed in processing the transaction

system_timestampstring date-time nullable required

A system generated timestamp

rtokenstring nullable required

A Galileo-generated ID used for tracking

errorsstring[]

A list of errors generated while the request was processed

Example response

{
  "response_data": {
    "loan_id": "450825953",
    "loan_apr": 15,
    "rate_type": "FIXED",
    "late_fee": 5,
    "initial_projected_maturity_date": "2022-07-01",
    "application_number": "589841564",
    "itemization_of_amount_financed": {
      "loan_amount": 10000,
      "disbursed_amount": 10000,
      "projected_interest_amount": 10,
      "projected_fees_amount": 10
    },
    "amortization_schedules": [
      {
        "amort_installment_number": 1,
        "amort_payment_due_date": "2022-02-01",
        "amort_payment_amount": 1740.34,
        "amort_payment_principal": 1000,
        "amort_payment_fees": 7.51,
        "amort_payment_interest": 10,
        "amort_payment_balance": 2000
      }
    ],
    "count_of_installments": 4,
    "installment_amount": 1740.34,
    "loan_start_date": "2022-06-02",
    "first_installment_due_date": "2022-02-01"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.