Create a loan request

POST 
/partner/pre-loan-request/loan-request

Creates a new loan request for a pre-approved BNPL transaction, using the installment option selected by the customer.

If the pre-approval already has a loan request that is not expired, that loan request is returned with status 206 instead of creating a new one.

Request

Responses

201

Created - Loan request created successfully

206

Partial Content - The pre-approval already has a loan request that is not expired; that loan request is returned

400

Bad Request. Possible causes:

• A loan already exists for externalTrxId.
• The pre-approval belongs to another partner.
• The API token is not the current API token of the partner.

401

Unauthorized - Invalid or missing partner token

403

Forbidden. Possible causes:

• The partner is not active.
• The merchant of the pre-approval is not active.

404

Not Found. Possible causes:

• The evaluation of the pre-approval was not found.
• The merchant of the pre-approval was not found.
• The partner of the API token does not exist.

412

Precondition Failed. Possible causes:

• amount is missing or zero.
• externalTrxId is missing.
• installmentOption is missing or zero.
• installmentOption is greater than the maximum number of installments of the pre-approval.
• The customer has an active loan that prevents a new one.

413

Payload Too Large - The pre-approval already has a signed loan request

422

Unprocessable Entity. The error code is returned in message:

• ERR_PREAPPROVE_EXPIRED: the pre-approval is more than 14 days old.
• ERR_INVALID_STEP: the evaluation is not in a step that allows creating a loan request (for example, it was rejected or archived).

503

Service Unavailable - The pre-approval could not be retrieved (for example, preApproveId does not exist or is not a valid UUID)