Evaluate customer and return installment options
POST/partner/pre-loan-request/bnpl
Evaluates a customer for a purchase amount at a given merchant and, when the customer is accepted, returns the available installment options.
The preApproveId returned is valid for 14 days and is used to create the loan request (Create a loan request) and the widget token (Obtain a widget token for initialization).
A rejected evaluation is not an error: it returns 201 with accepted: false.
Request
Responses
- 201
- 400
- 401
- 403
- 404
- 412
- 422
- 503
Evaluation completed. Check accepted to know whether the customer was approved.
Bad Request. Possible causes:
- The merchant has no BNPL product configured.
- A loan already exists for
externalTrxId. emailis not a valid email.emailis verified by another customer.- The API token is not the current API token of the partner.
Unauthorized - Missing or invalid access token
Forbidden. Possible causes:
- The partner is not active.
- The partner does not have the placement access module.
- The merchant is not active.
- The merchant RUT is blacklisted.
Not Found. Possible causes:
- No merchant exists for
entityIdandnewEntityParamswas not sent or is incomplete. - The partner of the API token does not exist.
Precondition Failed. Possible causes:
entityIdis missing.amountis missing or zero.
Unprocessable Entity. The error code is returned in message:
ERR_MISSING_ID_NUMBER:idNumberis missing.ERR_EMAIL_IS_UNDEFINED:emailis missing.
Service Unavailable - The customer's credit data could not be retrieved. Retry later.