Create MCA Loan

post

https://embarc-api-qa.lendapi.com/embarc-core/api/v1/mca/loans

Create an MCA-backed loan with a Progressive zero-interest single-balloon schedule, apply the factor fee as a financed origination fee override, and persist MCA companion terms. loanAction must be CREATE_ONLY. revenueSource is not accepted — link revenue source after create via POST /v1/mca/loans/{loanId}/revenue-source. factorRate and holdbackPercent may be omitted if the referenced loan product has defaults configured.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

productId

integer

required

Loan product identifier. Must be an MCA-compatible product.

clientId

integer

required

Client identifier. Must be active and visible in the caller's office hierarchy.

advanceAmount

number

required

Advance principal.

factorRate

number

1.01 to 1.99

Factor rate multiplier. Required unless the product has a defaultFactorRate.

holdbackPercent

number

5 to 25

Holdback percentage. Required unless the product has a defaultHoldbackPercent.

weekendAggregationEnabled

boolean

Defaults to true

Weekend deposit aggregation flag. Defaults to true.

disbursementDate

string

Optional expected disbursement date (MM/dd/yyyy). Defaults to the tenant business date and cannot be in the past.

externalId

string

Optional external identifier passed through to the underlying loan.

charges

array of objects

Optional regular loan charges passed through to the core loan create command. Independent of the factor fee, which is applied separately as a financed-origination-fee override.

charges

loanAction

string

Defaults to CREATE_ONLY

Must be CREATE_ONLY (default). Other values are rejected.

Headers

x-embarc-tenant-id

string

required

Tenant routing identifier used by the Embarc API gateway.

Responses

400

Validation error — unknown parameter, revenueSource supplied (validation.msg.mca.revenueSource.removed), loanAction != CREATE_ONLY (validation.msg.mca.loanAction.requires.revenueSource), or out-of-range field.

Language

Credentials

Bearer

JWT

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Loan created and MCA companion terms persisted; loan is SUBMITTED_AND_PENDING_APPROVAL.