Credit lines

The Credit Lines service allows you to create and manage both credit products and credit lines

Want to know more about credit lines? Check out our documentation.

Create Product

The lending/v1/products endpoint allows you to create a product.

At this moment, you will be able to define the cutoff and due dates, limits and available balances, rates and fees, how the minimum payment is composed and more.

Available parameters
Body Parameters
namestringrequired
Product name
Example: Gold Credit Card
typerequired
Product type
Example: CREDIT_CARD
Enum: CREDIT_CARD
statusrequired
Product status
Example: PAUSED
Enum: ACTIVEPAUSEDINACTIVE
countryrequired
Product country
Example: BRA
Enum: BRA
start_datestring(format: date)required
Effective date of the product
Example: 2022-04-20
end_datestring(format: date)
Product expiration date
Example: 2027-04-20
grace_period_daysobjectrequired
Grace period after expiration for payment without penalty
credit_cardobjectrequired
Credit card settings
pricingobjectrequired
Centrally define the interest rates and commissions that will be applied to the product.
available_balance_settingsstring
Balance restitution strategy. Only selectable for BRASIL products, in other countries its only possible value is RESTRICTED
Example: RESTRICTED
Enum: RESTRICTEDEXTENDED
statementobjectrequired
Statement settings
refinancingobject
Mandatory refinancing setup, only available in Brazil
cancellationobject
Configuración de cancelación de línea de crédito por mora. Solo disponible para Brasil.
Response details
dataobject

Was this section helpful to you?

POST/lending/v1/products
{
"name":
"Gold Credit Card"
"type":
"CREDIT_CARD"
"status":
"PAUSED"
"country":
"BRA"
"start_date":
"2022-04-20"
"end_date":
"2027-04-20"
"grace_period_days":{
"pausing":
10
"interest_accrual":
10
}
"credit_card":{
"max_allowed_installments":
1
"limits":{
...
}
"billing_cycle_config":{
...
}
"minimum_payment":
100
"minimum_payment_composition":{
...
}
"affinity_group_id":
"afg-20MpN8vmIPj77ujhb9cSeXAmPLe"
}
"pricing":{
"rates":{
...
}
"fees":[
...
]
}
"available_balance_settings":
"RESTRICTED"
"statement":{
"generate_pdf":
"true"
}
"refinancing":{
"mandatory":{
...
}
}
"cancellation":{
"enabled":
"true"
"delinquency_days_amount":
6
}
}
Response examples
{
"data":{
"id":
"lpr-2HMvSzWjc5La6WDTlgFweXAmPle"
"type":
"CREDIT_CARD"
"name":
"Gold Credit Card"
"status":
"PAUSED"
"country":
"BRA"
"start_date":
"2022-04-20"
"end_date":
"2024-05-17"
"credit_card":{
...
}
"grace_period_days":{
...
}
"pricing":{
...
}
"available_balance_settings":
"RESTRICTED"
"statement":{
...
}
"refinancing":{
...
}
"cancellation":{
...
}
}
}

Get products

The endpoint lending/v1/products allows you to retrieve data from all products created

Available parameters
Response details
dataarray

Was this section helpful to you?

GET/lending/v1/products
Response examples
{
"data":[
0:{
...
}
]
}

Get product

The lending/v1/products/{id} endpoint allows you to retrieve data from a specific product.

Available parameters
Path Parameters
product_idstringrequired
Unique Product Identifier
Example: lpr-2HMwKzetERdOEhbT86UweXamPle
Response details
dataobject

Was this section helpful to you?

GET/lending/v1/products/{product_id}
Response examples
{
"data":{
"id":
"lpr-2HMvSzWjc5La6WDTlgFweXAmPle"
"type":
"CREDIT_CARD"
"name":
"Gold Credit Card"
"status":
"PAUSED"
"country":
"BRA"
"start_date":
"2022-04-20"
"end_date":
"2024-05-17"
"credit_card":{
...
}
"grace_period_days":{
...
}
"pricing":{
...
}
"available_balance_settings":
"RESTRICTED"
"statement":{
...
}
"refinancing":{
...
}
"cancellation":{
...
}
}
}

Update product

The lending/v1/products/{id} endpoint allows you to update data for a specific product.

Available parameters
Body Parameters
namestring
Product name
statusstring
Product status
Enum: ACTIVEPAUSED
start_datestring
Effective date of the product
Example: 2022-01-01
end_datestring
Product expiration date
Example: 2027-04-20
grace_period_daysobject
Grace period after expiration for payment without penalty
credit_cardobject
Credit card settings
statementobject
Statement settings
cancellationobject
Configuración de cancelación de línea de crédito por mora. Solo disponible para Brasil.
Path Parameters
product_idstringrequired
Unique Product Identifier
Example: lpr-2HMwKzetERdOEhbT86UweXamPle
Response details
dataobject

Was this section helpful to you?

PATCH/lending/v1/products/{product_id}
{
"name":
"string"
"status":
"ACTIVE"
"start_date":
"2022-01-01"
"end_date":
"2027-04-20"
"grace_period_days":{
"pausing":
5
"interest_accrual":
10
}
"credit_card":{
"max_allowed_installments":
1
"billing_cycle_config":{
...
}
"minimum_payment":
100
"minimum_payment_composition":{
...
}
"affinity_group_id":
"string"
}
"statement":{
"generate_pdf":
"true"
}
"cancellation":{
"enabled":
"true"
"delinquency_days_amount":
6
}
}
Response examples
{
"data":{
"id":
"lpr-2HMvSzWjc5La6WDTlgFweXAmPle"
"type":
"CREDIT_CARD"
"name":
"Gold Credit Card"
"status":
"PAUSED"
"country":
"BRA"
"start_date":
"2022-04-20"
"end_date":
"2024-05-17"
"credit_card":{
...
}
"grace_period_days":{
...
}
"pricing":{
...
}
"available_balance_settings":
"RESTRICTED"
"statement":{
...
}
"refinancing":{
...
}
"cancellation":{
...
}
}
}

Deactivating a product

The endpoint lending/v1/products/{id} allows you to deactivate a specific product.

Available parameters
Path Parameters
product_idstringrequired
Unique Product Identifier
Example: lpr-2HMwKzetERdOEhbT86UweXamPle
Response details
dataobject

Was this section helpful to you?

DELETE/lending/v1/products/{product_id}
Response examples
{
"data":{
"id":
"lpr-2HMvSzWjc5La6WDTlgFweXAmPle"
"type":
"CREDIT_CARD"
"name":
"Gold Credit Card"
"status":
"PAUSED"
"country":
"BRA"
"start_date":
"2022-04-20"
"end_date":
"2024-05-17"
"credit_card":{
...
}
"grace_period_days":{
...
}
"pricing":{
...
}
"available_balance_settings":
"RESTRICTED"
"statement":{
...
}
"refinancing":{
...
}
"cancellation":{
...
}
}
}

Get credit lines

The lending/v1/products endpoint allows you to retrieve data on credit lines according to specific search criteria.

Filters

You can find more information on how to apply filters in the section Filters and pagination.

Available parameters
Query Parameters
filter[id]string
Allows you to retrieve the credit line associated with the specified ID
Example: lcr-2HMvRUOZ9C3fbsrkdeyOexAmpLe
filter[user_id]string
Allows you to retrieve the credit lines associated with the specified user ID
Example: usr-2HMvSDccc5PZzCvZ98lfeXamPle
filter[status]string
Allows you to retrieve the credit lines associated with the specified status
Example: ACTIVE
Enum: OFFEREDACTIVEPAUSEDCANCELEDEXPIRED
filter[offer_start_date][from]string(format: date)
Allows you to retrieve the credit lines from the specified offer date
Example: 2022-03-10
filter[offer_start_date][to]string(format: date)
Allows you to retrieve credit lines up to the specified offer date
Example: 2022-03-20
filter[activation_date][from]string(format: date)
Allows you to retrieve the credit lines from the specified activation date
Example: 2022-04-12
filter[activation_date][to]string(format: date)
Allows you to retrieve the credit lines up to the specified activation date
Example: 2022-04-22
filter[user_scoring]string
Allows you to retrieve the credit lines associated with the specified user scoring
Example: A
Response details
dataarray
metaobject

Was this section helpful to you?

GET/lending/v1/credit-lines
Response examples
{
"data":[
0:{
...
}
]
"meta":{
"pagination":{
...
}
}
}

Create credit line

The lending/v1/products endpoint allows you to create a credit line.

Available parameters
Body Parameters
user_idstringrequired
Beneficiary user identifier
Example: usr-2HMwJZo114goVi7xdSseYfujP79
product_idstringrequired
Product identifier
Example: lpr-2HMvSzWjc5La6WDTlgFweXAmPle
limitsoneOf
offer_start_datestringrequired
Offer start date
Example: 2022-04-20
offer_end_datestring
Offer end date
Example: 2023-05-20
due_dateintegerrequired
Expiration date
Example: 28
user_scoringstringrequired
User scoring identifier
Example: A
person_typestring
Type of person
Example: NATURAL
Enum: LEGALNATURAL
Response details
dataobject

Was this section helpful to you?

POST/lending/v1/credit-lines
{
"user_id":
"usr-2HMwJZo114goVi7xdSseYfujP79"
"product_id":
"lpr-2HMvSzWjc5La6WDTlgFweXAmPle"
"offer_start_date":
"2022-04-20"
"offer_end_date":
"2023-05-20"
"due_date":
28
"user_scoring":
"A"
"person_type":
"NATURAL"
}
Response examples
{
"data":{
"id":
"lcr-2HMvRUOZ9C3fbsrkdeyOexAmpLe"
"user_id":
"usr-2HMvSDccc5PZzCvZ98lfeXamPle"
"country":
"MEX"
"person_type":
"NATURAL"
"product_id":
"lpr-2HMvSzWjc5La6WDTlgFweXAmPle"
"status":
"ACTIVE"
"status_detail":{
...
}
"offer_start_date":
"2022-04-12"
"offer_end_date":
"2022-04-12"
"activation_date":
"2022-04-12"
"balances":{
...
}
"due_date":
28
"user_scoring":
"A"
"delinquency":{
...
}
"clearance_date_at":
"2024-07-01T20:37:33.180085009Z"
}
}

Get credit line

The endpoint lending/v1/credit-lines/{id} allows you to retrieve data for a specific credit line.

In this instance, you can define the specific limit and closing date for this credit line, always within the parameters that you have defined for the product.

Want to know more about credit lines? Check out our documentation.

Available parameters
Path Parameters
credit_line_idstringrequired
Unique Line of Credit Identifier
Example: lcr-2HMwKzetERdOEhbT86UweXamPle
Response details
dataobject

Was this section helpful to you?

GET/lending/v1/credit-lines/{credit_line_id}
Response examples
{
"data":{
"id":
"lcr-2HMvRUOZ9C3fbsrkdeyOexAmpLe"
"user_id":
"usr-2HMvSDccc5PZzCvZ98lfeXamPle"
"country":
"MEX"
"person_type":
"NATURAL"
"product_id":
"lpr-2HMvSzWjc5La6WDTlgFweXAmPle"
"status":
"ACTIVE"
"status_detail":{
...
}
"offer_start_date":
"2022-04-12"
"offer_end_date":
"2022-04-12"
"activation_date":
"2022-04-12"
"balances":{
...
}
"due_date":
28
"user_scoring":
"A"
"delinquency":{
...
}
"clearance_date_at":
"2024-07-01T20:37:33.180085009Z"
}
}

Update credit lines

The lending/v1/credit-lines/{id} endpoint allows you to update data for a specific credit line.

Available parameters
Body Parameters
limitsoneOf
statusstring
Credit line status
Example: PAUSED
Enum: ACTIVEPAUSED
status_detailobject
Information about the status change
offer_start_datestring
Offer start date
Example: 2022-04-20
offer_end_datestring
Offer end date
Example: 2023-05-20
due_dateinteger
Expiration date
Example: 28
user_scoringstring
User scoring identifier
Example: A
person_typestring
Type of person
Example: NATURAL
Enum: LEGALNATURAL
Path Parameters
credit_line_idstringrequired
Unique Line of Credit Identifier
Example: lcr-2HMwKzetERdOEhbT86UweXamPle
Response details
dataobject

Was this section helpful to you?

PATCH/lending/v1/credit-lines/{credit_line_id}
{
"status":
"PAUSED"
"status_detail":{
"reason":
"FRAUD"
"text":
"Additrional information"
}
"offer_start_date":
"2022-04-20"
"offer_end_date":
"2023-05-20"
"due_date":
28
"user_scoring":
"A"
"person_type":
"NATURAL"
}
Response examples
{
"data":{
"id":
"lcr-2HMvRUOZ9C3fbsrkdeyOexAmpLe"
"user_id":
"usr-2HMvSDccc5PZzCvZ98lfeXamPle"
"country":
"MEX"
"person_type":
"NATURAL"
"product_id":
"lpr-2HMvSzWjc5La6WDTlgFweXAmPle"
"status":
"ACTIVE"
"status_detail":{
...
}
"offer_start_date":
"2022-04-12"
"offer_end_date":
"2022-04-12"
"activation_date":
"2022-04-12"
"balances":{
...
}
"due_date":
28
"user_scoring":
"A"
"delinquency":{
...
}
"clearance_date_at":
"2024-07-01T20:37:33.180085009Z"
}
}

Cancel credit lines

The lending/v1/credit-lines/{id} endpoint allows you to cancel a credit line.

Available parameters
Body Parameters
reasonstring
Credit line cancellation reason
Enum: BY_USER_WITHOUT_DEBT_ACCELERATIONBY_CLIENT_WITHOUT_DEBT_ACCELERATION
Path Parameters
credit_line_idstringrequired
Unique Line of Credit Identifier
Example: lcr-2HMwKzetERdOEhbT86UweXamPle
Response details
dataobject

Was this section helpful to you?

DELETE/lending/v1/credit-lines/{credit_line_id}
{
"reason":
"BY_USER_WITHOUT_DEBT_ACCELERATION"
}
Response examples
{
"data":{
"id":
"lcr-2HMwKzetERdOEhbT86UweXamPle"
}
}

Create price update

The /products/{product_id}/pricing endpoint allows you to create new price updates for products with ACTIVE or PAUSED status

Available parameters
Body Parameters
start_datestring(format: date)required
Effective date of the price update
Example: 2022-04-30
ratesobjectrequired
Rate settings
feesarrayrequired
Fees settings
Path Parameters
product_idstringrequired
Unique Product Identifier
Example: lpr-2HMwKzetERdOEhbT86UweXamPle
Response details
dataobject

Was this section helpful to you?

POST/lending/v1/products/{product_id}/pricing
{
"start_date":
"2022-04-30"
"rates":{
"financing":
"15.00"
"late_fee":
"25.00"
"cash_advance":
"50.00"
"revolving":
"100.00"
}
"fees":[
0:{
...
}
]
}
Response examples
{
"data":{
"start_date":
"2022-04-30"
"rates":{
...
}
"fees":[
...
]
}
}

Get price update history

The endpoint /products/{product_id}/pricing allows you to obtain the price update history related to a product

Available parameters
Path Parameters
product_idstringrequired
Unique Product Identifier
Example: lpr-2HMwKzetERdOEhbT86UweXamPle
Response details
dataarray

Was this section helpful to you?

GET/lending/v1/products/{product_id}/pricing
Response examples
{
"data":[
0:{
...
}
]
}

Modify pending price update

The endpoint /products/{product_id}/pricing/{start_date} enables you to modify a pending price update

Available parameters
Body Parameters
ratesobject
Rate settings
feesarray
Fees settings
Path Parameters
product_idstringrequired
Unique Product Identifier
Example: lpr-2HMwKzetERdOEhbT86UweXamPle
start_datestringrequired
Effective date of the price update
Example: 2022-04-30
Response details
dataobject

Was this section helpful to you?

PATCH/lending/v1/products/{product_id}/pricing/{start_date}
{
"rates":{
"financing":
"15.00"
"late_fee":
"25.00"
"cash_advance":
"50.00"
"revolving":
"100.00"
}
"fees":[
0:{
...
}
]
}
Response examples
{
"data":{
"start_date":
"2022-04-30"
"rates":{
...
}
"fees":[
...
]
}
}

Status change notifications

Provide us with this endpoint to receive notifications about changes in credit line status.

If you have any questions about how to configure a webhook, visit our documentation.

You must respond with an HTTP 2xx code so that we do not resend the notification. Otherwise, we will keep sending it indefinitely.

Available parameters
Header Parameters
X-Api-Keystringrequired
This header helps you identify which api-secret to use if multiple api-key and api-secret pairs were configured.
Example: X-Api-Key: h3Ws4Cv09JcCdw7732ig+1Eq3I2b+IWOI1anUu1A4dE=
X-Signaturestringrequired
This header contains the digital signature (body + timestamp + endpoint) that must be verified to ensure request integrity. If the signature does not match, reject the order.
Example: X-Signature: hmac-sha256 N70BkBKch1gwQDPj0jF0ooB9QQVXBEp5VQE+SGe6Z0k=
X-Timestampstringrequired
This header has the moment the order was signed in unix-epoch format so that you can verify the signature has not expired.
Example: X-Timestamp: 1637117179
X-Endpointstringrequired
The endpoint where the order is placed and used to create the signature. Use this header to regenerate the signature to be validated, check with your service endpoint and confirm that they match.
Example: X-Endpoint: /<client-url>/credit-lines
Body Parameters
event_idstringrequired
Event identifier.
Example: credit_line_paused
Enum: credit_line_pausedcredit_line_unpausedcredit_line_canceled
idempotency_keystringrequired
Idempotent identifier for creating the event.
Example: lcr-27KxRhP9YB4ouoyt6a5vVJlY9fR
dataobject
Information on the affected line of credit

Was this section helpful to you?

POST/lending/v1/<client-url>/credit-lines
{
"event_id":
"credit_line_paused"
"idempotency_key":
"lcr-27KxRhP9YB4ouoyt6a5vVJlY9fR"
"data":{
"credit_line_id":
"lcr-27KxRhP9YB4ouoyt6a5vVJlY9fR"
"status":
"PAUSED"
"reason":
"IN_ARREARS"
}
}
Response examples

Notifications of User Entry, Exit, or Continued Delinquency

Provide us with this endpoint to receive notifications of a user's entry, exit, or continued delinquency.

If you have any questions about how to configure a webhook, visit our documentation.

You must respond with an HTTP 2xx code so that we do not resend the notification. Otherwise, we will keep sending it indefinitely.

Available parameters
Header Parameters
X-Api-Keystringrequired
This header helps you identify which api-secret to use if multiple api-key and api-secret pairs were configured.
Example: X-Api-Key: h3Ws4Cv09JcCdw7732ig+1Eq3I2b+IWOI1anUu1A4dE=
X-Signaturestringrequired
This header contains the digital signature (body + timestamp + endpoint) that must be verified to ensure request integrity. If the signature does not match, reject the order.
Example: X-Signature: hmac-sha256 N70BkBKch1gwQDPj0jF0ooB9QQVXBEp5VQE+SGe6Z0k=
X-Timestampstringrequired
This header has the moment the order was signed in unix-epoch format so that you can verify the signature has not expired.
Example: X-Timestamp: 1637117179
X-Endpointstringrequired
The endpoint where the order is placed and used to create the signature. Use this header to regenerate the signature to be validated, check with your service endpoint and confirm that they match.
Example: X-Endpoint: /<client-url>/credit-lines
Body Parameters
event_idstringrequired
Event identifier.
Example: user_in_arrears
Enum: user_in_arrearsuser_out_of_arrearsuser_remains_in_arrears
idempotency_keystringrequired
Idempotent identifier for creating the event.
Example: 27KxRhP9YB4ouoyt6a5vVJlY9fR
dataobject
Information on the affected user

Was this section helpful to you?

POST/lending/v1/<client-url>/debt
{
"event_id":
"user_in_arrears"
"idempotency_key":
"27KxRhP9YB4ouoyt6a5vVJlY9fR"
"data":{
"user_id":
"usr-27KxRhP9YB4ouoyt6a5vVJlY9fR"
"credit_line_id":
"lcr-27KxRhP9YB4ouoyt6a5vVJlY9fR"
"effective_at":
"2022-12-15T13:55:00"
}
}
Response examples